Copper PDF ドキュメント

CSSによるドキュメントのレイアウト

Copper PDFはHTMLとXMLをCSSによってスタイル付けすることができます。

Copper PDFは CSS Level 2 Revision 1 に準拠しています。 Copper PDFがサポートするCSSプロパティの一覧は資料集を参照してください。

スタイルシートの型

Copper PDFは、特に型が指定されていないスタイルシートをCSS(MIME型text/css)として認識します。 Content-Style-Typeヘッダ (HTML中ではといった記述) やstyle要素のtype属性等によってtext/css以外がスタイルシートの型として指定されている場合は、スタイルシートをCSSとして認識しません。

メディアタイプ

style要素のmedia属性、あるいはCSSの@media指示子等でスタイルシートが適用されるメディアタイプが限定されている場合、通常Copper PDFは印刷メディア向けのスタイルだけを適用します。すなわち、Copper PDFのメディアタイプはall print paged visual bitmap staticのいずれかです。

なお、Copper PDFのユーザーエージェントのメディアタイプは output.media_types 入出力プロパティによって変更することができます。適用するCSS 2.1のメディアタイプ名またはメディアグループ名を列挙してください。例えば、ブラウザの画面表示用のスタイルを適用する場合は"all visual bitmap static screen continuous"を設定してください。

ドキュメント中にスタイルシートを記述する

ドキュメント中にスタイルおよびスタイルシートを記述する方法は以下の3通りがあります。

HTMLのstyle属性
HTMLのstyle要素
jp.cssj.stylesheet処理命令

HTMLのstyle属性

style属性により、各要素に直接スタイルを指定する方法です。 style属性には、適用したいCSSのプロパティを記述してください。



題名
本文大きなテキスト本文

]]>

上記の例は以下のように表示されます。

題名

本文大きなテキスト本文

style要素はHTMLだけではなく、XML文書内でも利用可能です。ただし、style要素が名前空間"http://www.w3.org/1999/xhtml"に属するように、名前空間宣言を行ってください。



題名
本文大きなテキスト本文
]]>

HTMLのstyle要素

一般的なブラウザと同じくstyle要素内にスタイルシートを記述することができます。






題名
本文大きなテキスト本文

]]>

style要素はなるべくhead要素内に記述してください。 Copper PDFは他の場所のstyle要素も認識しますが、ドキュメント中でstyle要素が現れる以前の部分には、記述されたスタイルが適用されなくなります。

また、XMLドキュメント中ではstyle要素によるスタイル指定は行わず、次に説明するjp.cssj.stylesheet処理命令を使用するか、あるいは一般的なブラウザでもサポートされているxml-stylesheet処理命令を使用してください。

jp.cssj.stylesheet処理命令

jp.cssj.stylesheet処理命令はHTMLのstyle要素に相当する機能を処理命令 (<?で始まり?>で終わるHTMLやXML中の特別な記述。) によって実現したものです。 HTML, XMLの両方のドキュメントの先頭で使用することができます。

style要素のtype, media属性に相当する部分はHTMLの属性と同様の形式で記述し、スタイルシートは'[]'で囲みます。




題名
本文大きなテキスト本文

]]>

外部のCSSの使用

ドキュメントと外部のスタイルシートを結びつける方法は以下の3通りがあります。

HTMLのlink要素
CSSの@import指示子
xml-stylesheet処理命令

HTMLのlink要素

一般的なブラウザと同様に、link要素によってスタイルシートをドキュメントに関連付けることができます。

]]>

rel属性にキーワードalternateを加えることで、 1つのドキュメントに対して、複数の代替スタイルシートを用意することができます。 title属性は代替スタイルシートの名前です。

]]>

代替スタイルシートは通常は適用されませんが、 input.stylesheet.titles に代替スタイルシートのtitleを設定することで、適用するスタイルシートを選択することができます。

CSSの@import指示子

これは、HTMLのstyle要素とCSSの@importを組み合わせる方法です。


	@import url(スタイルシートのURL);
]]>

HTMLのstyle要素の代わりに、jp.cssj.stylesheet処理命令を使うこともできます。

]]>

xml-stylesheet処理命令

xml-stylesheet処理命令を使う方法は、一般的なブラウザでXMLとスタイルシートを結びつけるために広くサポートされている方法です。

スタイルシートを適用したいドキュメントの冒頭で、以下のように記述してください。

]]>

alternate属性はlink要素のrel属性に対するalternateの指定に相当するものです。 xml-stylesheet処理命令でalternate="yes"を指定することは、link要素にrel="alternate stylesheet"を設定するのと同じ意味です。

]]>

xml-stylesheetのtype属性にはCSSだけでなくXSLTスタイルシートを指定することもできます。この場合、type属性にtext/xslを設定し、href属性にはXSLTファイルの指定してください。

デフォルトのスタイルシート

Copper PDFでは、ドキュメント内の記述に関係なく、特定のスタイルシートを適用する機能が用意されています。 input.default-stylesheet 入出力プロパティで指定されたスタイルシートが最初に適用されます。

長さの単位

CSSでは、絶対単位としてmm, cm, in, pt, pcが使われます。各絶対単位は、Copper PDFはCSSの仕様どおり次の一定の長さでレイアウトします。 PDFではptが長さの単位の基準となり、Copper PDFでも内部的な単位としてptを使用しています。以下は各単位の関係です。

mm: 1mm = 1/25.4in ≒ 2.835pt
cm: 1cm = 10mm ≒ 28.35pt
in: 1in = 72pt = 25.4mm
pt: 1pt = 1/72in ≒ 0.353mm
pc: 1pc = 1/6in = 12pt ≒ 4.233mm

相対単位としてem, ex, pxがあり、これは状況によって変化します。

em, exはそれぞれフォントの高さとxの高さを基準とした単位です。正確には、文書中の基準となる位置で利用可能なフォントの高さの最大値と、xの高さの最大値を基準とします。 xという文字が存在しないフォントでは、exはxの高さではない「適当な高さ」となります。

pxは、output.resolutionで設定される解像度が基準となります。デフォルトでは96dpiで、この状況では1pt ≒ 1.33pxとなり、1pxは1ptより若干小さくなります。この値は、一般的なブラウザに合わせたものです。

ラスタ画像として結果を出力する場合、デフォルトでは出力結果の1ピクセルは常にCSSの1pxに一致します。詳細は画像の出力を参照してください。