Copper PDFはドキュメントがHTMLかXMLであるかを、以下の情報をもとに判別します。
1の情報は、2より優先されます。 上記の情報以外によりCopper PDFがドキュメントの型を判別することはありません。 HTMLとして判別されたドキュメントは、<?xml~で開始していても、HTMLとして認識します。 ただし、HTMLと認識されても、XMLやXHTMLがサポートしている名前空間は認識されます。
HTMLと認識された文書は、ゆるやかに解釈されるため、文法ミスが許容されます。
一方、XMLと認識された文書は厳密に解釈されます。 XHTMLを記述する場合、全ての要素名と属性名は小文字で記述してください。 文法エラーがあった場合、処理が停止します。
Copper PDFはHTMLのmeta要素から取得した情報を、PDFの文書情報として使用します。 文書情報はHTMLの<meta name="名前" content="値">要素によって設定することができます。 ただし、TITLEはHTMLのtitle要素の内容も使われます。
| 名前 | PDFの属性名 | 説明 |
|---|---|---|
| TITLE | Title/タイトル | 文書の表題。 |
| DESCRIPTION SUBJECT |
Subject/サブタイトル | 文書に内容についての簡潔な説明。 |
| KEYWORDS | Keywords/キーワード | スペースまたはカンマ区切りで羅列した、文書の内容に関連するキーワード。 |
| AUTHOR | Author/作成者 | 文書の作成者。 |
| PRODUCER | Producer/PDF変換 | PDFを生成したプログラム。 省略した場合はCopper PDFの名前とバージョンが入ります。 |
| GENERATOR CREATOR |
Creator/アプリケーション | HTML文書を生成したプログラム、エディタ、オーサリングツールなど。 |
なお、meta要素のname属性は大文字小文字を区別しません。 <meta name="AUTHOR" content="作者名">としても、 <meta name="Author" content="作者名">としても、 PDF文書に作者名が設定されます。
HTMLのh1~h6要素は、見出しとして特別な意味を持ちます。 h1~h6要素の数字は見出しのレベルとして認識され、 数字が大きいものほど深い階層にあるものとして処理されます。
また、任意の要素にhtml:header="レベル"という属性を付与することで、 任意の要素をHTMLのh1~h6要素と同様の意味を持たせることができます。
output.pdf.bookmarks をtrueにすると、PDFのブックマーク(しおり)が生成されます。 ブックマークは、見出しのレベルによって自動的に階層化されます。
ページの内容として出力済みの見出しを、content プロパティ内で-cssj-heading関数によって生成することができます。
上の例はレベル1とレベル2の見出しを表示します。 すなわち、ドキュメントの先頭から、前ページの最後までの間で、 一番最後のh1とh2の内容を表示します。
-cssj-heading関数を -cssj-page-content が設定されたページで使用すると、ドキュメントの先頭から現在のページの最後までの間で、 一番最後の見出しを表示することができます。 これは、ノンブルに見出しを表示する場合に便利です。
見出しは、目次の生成に利用することができます。 目次を生成するためには、Copper PDFが文書全体の見出しと、 見出しのあるページ番号を収集している必要があります。
]]>
ドキュメントの末尾に目次を生成する場合は、目次の生成の開始時点で本文が全て処理されていますが、 ドキュメントの先頭や途中に目次を生成する場合は、2パス以上の処理が必要です。
counter属性はページ番号を振るために使用するページカウンタの名前です。 typeは、ページ番号のタイプです。CSSのlist-style-type で使われるのと同じタイプ名が利用可能です。
生成される目次は、次のようなリストの形式をしています。
例として、以下のようなスタイルシートを使うことで目次を整形してください。
output.pdf.hyperlinks をtrueに設定すると、文書内のハイパーリンクがPDFに反映されます。
output.pdf.hyperlinks.fragment をtrueに設定すると、ドキュメントの一部に対してフラグメント識別子によるリンクが可能になります。 フラグメントの作成方法は通常のHTMLと同じで、任意の要素のid属性と、a要素のname属性をサポートしています。
Copper PDFは、フラグメントが存在するページを表示するために、 content内で使用できる-cssj-page-ref関数を用意しています。
-cssj-page-ref関数の最初の引数は、参照するフラグメント識別子です。 2番目の引数はページ番号の表示に使うページカウンタです。 3番目の引数は数字のスタイルで、 list-style-typeで使われるのと同じスタイル名です。 3番目の引数を省略するとdecimalスタイルで表示されます。 4番目の引数(Copper PDF 2.0.2以降)は同じ名前のフラグメントが複数存在する場合、 複数のページ番号を表示するための区切り記号です。 4番目の引数を省略すると、最初のフラグメントのページ番号だけが表示されます。
フラグメント識別子の部分はattr関数を使うことができます。 上の例のように、HTMLのa要素でhref属性の値を使うと、 フラグメントへリンクすると同時に、フラグメントが存在知るページの番号を表示することができます。 なお、フラグメント識別子の最初の'#'はあってもなくても構いません。
-cssj-page-ref関数を使うためには、一般的に2パス以上の処理の処理が必要です。 ドキュメント全体の処理が一度終わらないと、ドキュメントの後の方にあるフラグメントのページが分からないためです。
完全ではありませんが、Copper PDFはWindows Internet Explorerに近いレイアウトを再現します。 このモードを有効にするには、 output.compatible_mode にtrueを設定してください。 ただし、次のいずれかのpublic idを持つDOCTYPE宣言がある場合は、通常のモードでレイアウトします。
XSLTスタイルシートはxml-stylesheet処理命令により適用されます。 詳細はxml-stylesheet処理命令の節を参照してください。
cssj:annot属性は、Copper PDFを利用するアプリケーションに、メッセージを送るものです。 例えば、日付順に内容が並んでいる文書を処理する場合に、cssj:annot属性に日付を入れることで、 ドキュメント中でCopper PDFが現在処理中の部分をアプリケーションが知ることができます。
名前空間 http://www.w3.org/1999/xhtml を使用することで、 画像(img要素)、テーブルセルの結合(colspan, rowspan属性)といった HTMLの一部の要素や属性はXML内でも使用することができます。
利用可能な要素や属性のリストは資料集のXMLの拡張の章を参照してください。