Copper PDF ドキュメント

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

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

..1. スタイルシートの型

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

..2. メディアタイプ

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. ドキュメント中にスタイルシートを記述する

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

HTMLのstyle属性

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

<html>
<body style="border: 1px Black dashed;">
<h1 style="font-style: italic;">題名</h1>
<p style="text-decoration: underline;">本文<span style="font-size: x-large;">大きなテキスト</span>本文</p>
</body>
</html>

題名

本文大きなテキスト本文

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

<?xml version="1.0">
<body xmlns:html="http://www.w3.org/1999/xhtml" html:style="border: 1px Black dashed;">
<h1 html:style="font-style: italic;">題名</h1>
<p html:style="text-decoration: underline;">本文<span html:style="font-size: x-large;">大きなテキスト</span>本文</p>
</body>

HTMLのstyle要素

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

<html>
<head>
<style type="text/css" media="print">
	body {
		border: 1px Black dashed;
	}
	h1 {
		font-style: italic;
	}
	p {
		text-decoration: underline;
	}
	span {
		font-size: x-large;
	}
</style>
</head>
<body>
<h1>題名</h1>
<p>本文<span>大きなテキスト</span>本文</p>
</body>
</html>

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の属性と同様の形式で記述し、スタイルシートは'[]'で囲みます。

<?jp.cssj.stylesheet type="text/css" media="print" [
	body {
		border: 1px Black dashed;
	}
	h1 {
		font-style: italic;
	}
	p {
		text-decoration: underline;
	}
	span {
		font-size: x-large;
	}
] ?>
<html>
<body>
<h1>題名</h1>
<p>本文<span>大きなテキスト</span>本文</p>
</body>
</html>

..4. 外部のCSSの使用

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

HTMLのlink要素

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

<link rel="stylesheet" type="text/css" media="print" href="スタイルシートのURL">

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

<link rel="alternate stylesheet" title="a" type="text/css" media="print" href="a.css">
<link rel="alternate stylesheet" title="b" type="text/css" media="print" href="b.css">

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

CSSの@import指示子

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

<style type="text/css" media="print">
	@import url(スタイルシートのURL);
</style>

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

<?jp.cssj.stylesheet type="text/css" media="print" [
	@import url(スタイルシートのURL);
] ?>

xml-stylesheet処理命令

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

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

<?xml-stylesheet type="text/css" media="print" href="スタイルシートのURL"?>

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

<?xml-stylesheet alternate="yes" title="a" type="text/css" media="print" href="a.css"?>
<?xml-stylesheet alternate="yes" title="b" type="text/css" media="print" href="b.css"?>

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

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

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

..6. 長さの単位

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

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

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

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

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

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