5 資料集

(c)2004-2007 CSSJ T.MIYABE 販売元:合資会社GNN

http://www.cssj.jp/

資料集

入出力プロパティ

以下は、各種プログラミング言語からCSSJにアクセスする際に設定できるプロパティの一覧です。 プロパティの設定方法の詳細は開発マニュアルをご参照ください。

情報

infoレベルのメッセージに出力される情報の一覧です。

CSSのサポート

主な制限事項

first-line擬似要素

first-line擬似要素に含まれるインライン要素にはスタイルが適用されません。

改ページ可能な場所

次の場所では改ページすることができません。

絶対位置・固定位置で配置されたボックスの内部

これはCSS 2.1の仕様に従ったものです。 これらのボックスがページをはみ出す場合の扱いについてはCSSでは規定されていません。

CSSJは、ページをはみ出したボックスはページの端(トンボがある場合は断ち切り線の端)の部分で切り落とします。 従って、ページからはみ出た部分の内容は印刷されません。

浮動体の内部

CSS 2.1の仕様では浮動体内部での改ページは出来るだけ避けることが推奨されていますが、 CSSJは浮動体内部での改ページを全く行いません。

浮動体がページの下端をはみ出す場合、その浮動体の直前で改ページされます。 また、ページの大きさを超える浮動体は、絶対位置で配置されたボックス同様に、ページの端で切り落とされます。 また、切り落としを防ぐために、浮動体の大きさはページに対してなるべく小さくしてください。

テーブルのセルおよびキャプション・ヘッダ・フッタの内部

CSS 2.1の仕様ではテーブル内部での改ページは出来るだけ避けることが推奨されていますが、 CSSJはテーブルの行間で改ページを行い、かつセルの内部で改ページすることはありません。

従って、rowspan属性によって連結されたセルが存在しない行間のみで改ページが可能です。 行がページの下端をはみ出す場合は、その行の直前の行間で改ページされます。 また、ページの大きさを超えるセルは、絶対位置で配置されたボックス同様に、ページの端で切り落とされます。 切り落としを防ぐためには、セルの大きさをページに対してなるべく小さくし、 rowspan属性によって多数の行を連結することを避けてください。

また、改ページが可能なのはテーブルのボディ(tbody要素内あるいはtbodyタグを省略した場合)内部だけです。 キャプション、ヘッダ(thead要素)、フッタ(tfoot要素)内での改ページはできません。 レイアウトが崩れたり、切り落とされるのを防ぐために、これらの大きさはページの大きさに対してなるべく小さくしてください。

テーブルの改ページ

テーブルにキャプション、ヘッダ、フッタが存在する場合、それらは分割されたテーブルの断片全てに付けられます。 また、テーブルのボディには少なくとも1行が存在します。

従って、テーブルの高さはキャプション、ヘッダ、フッタの高さと、ボディの1行の高さを足した高さの合計よりも小さくなることはありません。 切り落としを防ぐには、この高さが常にページの高さよりも小さくなるようにしてください。

改ページ制御

page-break-before特性またはpage-break-after特性にalways,left,rightのいずれかを指定することで強制改ページできます。 強制改ページの指定が有効なのはブロック、テーブル行です。 ただし、元々改ページができない場所での強制改ページの指定は無視されます。

また、同じ特性にavoidを指定して前後の改ページを抑制できるのは、絶対配置または浮動体でないブロック、テーブル行です。 同様にpage-break-inside特性にavoidを指定することにより内部での改ページを抑制できます。 ただし、元々内部での改ページができないボックスに対しては、この指定は意味を持ちません。 強制改ページと改ページの抑制が競合する場合、CSS 2.1に従い強制改ページが優先されます。

拡張機能

@namespace指示子

CSSJは複数の名前空間が混在したXML文書をスタイル付けすることができます。 その仕様は、W3Cワーキングドラフト CSS Namespace Enhancements (Proposal) に従っています。 現在、Netscape7,Firefox1.0など一部のブラウザがこの機能をサポートしています。 ここでは、基本的な使い方のみを紹介しておきます。

CSSスタイルシート中で名前空間の接頭辞(prefix)とURIを指定するためには、@namespace指示子を使って以下のように宣言します。

/* デフォルトの名前空間のURIをhttp://www.w3.org/1999/xhtmlとする。 */
@namespace url(http://www.w3.org/1999/xhtml);

/* 接頭辞rdfのURIをhttp://www.w3.org/1999/02/22-rdf-syntax-ns#とする。 */
@namespace rdf url("http://www.w3.org/1999/02/22-rdf-syntax-ns#");

スタイルシートの選択子(selector)で接頭辞を使う場合は、'|'で区切ります。 (':'でないことに注意してください。)

/* 要素のスタイルを指定する。 */
rdf|Description { display: block; }

/* ref:about属性がhttp://foo.com/barであるitem要素のスタイルを指定する。 */
item[rdf|about=http://foo.com/bar] { color: Red; }

ページのヘッダ・フッタ

W3Cの勧告候補である CSS3 Paged Media Module では、ページの内容の外側にページ番号などを表示するための規格が提案されていますが、 CSSJはこれをサポートしません。 その代わり、CSSJ 1.2.0から-cssj-regeneratableという、ページ毎に生成される内容のための、拡張プロパティが用意されています。

position: fixed;指定されたブロックもページ毎に再生成されますが。 CSSJ 1.2.0以降では、この方法を使ってページのヘッダやフッタを生成することは非推奨とします。

-cssj-regeneratableの値にnone以外を指定したボックス(再生成ボックス)はページ毎に再生成されます。 配置方法は、position: fixed;指定されたボックスに似ています。 ページ毎に再生成されるため、例えばcounter-incrementなどのカウンタ操作が指定されている場合、 ページ毎にカウンタが操作されることになります。

再生成ボックスは、上位にあるボックスのスタイルの影響を受けません。 すなわち、上位のボックスにcolor: Red;という指定がされている場合も、再生成ボックス内の文字色は黒です。 ただし、セレクタは再生成先の上位のボックスの影響を受けます。 そのため、再生成ボックスに対してはIDセレクタ(#ID形式)またはstyle属性による直接指定を用いてください。

-cssj-regeneratableの引数は、その再生成ボックスの識別名です。 同じ識別名を持つ再生成ボックスは、同じページに1つしか存在できません。 文書中で、同じ名前の再生成ボックスを2度配置すると、2度目の再生成ボックスの配置の際に、 1度目の再生成ボックスは再生成されなくなります。

再生成ボックスは、ページ番号を各ページに表示するために有用です。 例えば以下のブロックが文書の始めに存在すると、各ページの下部中央にページ番号が表示されます。

<style type="text/css">
  #page-number {
    -cssj-regeneratable: footer;
    bottom: -1cm;
    text-align: center;
    width: 100%;
  }
  #page-number:before {
    counter-increment: page;
    content: counter(page);
  }
</style>
<div id="page-number"></div>

また、どのページにブロックが生成されるかによってスタイルを変えるために、 本来は@page指示子のためである:first,:left,:right擬似クラスをセレクタで利用することができます。 上の例で、左ページでは左寄せで、右ページでは右寄せでページ番号を表示するには、 さらに以下の記述をスタイルシートに加えます。

  :left #page-number {
    text-align: left;
  }
  :right #page-number {
    text-align: right;
  }

なお、再生成ボックスが配置される際は、、 ブロックに対するtop,left,right,bottom,width,heightプロパティは常にページの範囲を基準とします。

各特性のサポート状況

以下の表はW3C CSS2.1仕様の各特性のサポート状況です。

HTMLのサポート

概要

CSSJのCSSフォーマッタはXMLをスタイル付けするものですが、 HTMLをスタイル付けされたXMLに変換することにより、HTMLをサポートしています。 この機能はinput.filtersプロパティによりデフォルトでオンになっているため、特に意識する必要はありません。

また、META要素、画像、ハイパーリンクなどXMLへの変換には関係なくサポートされる機能もあります。 これらの機能はXHTML名前空間(http://www.w3.org/1999/xhtml)を用いることで、XML中でも利用可能です。

<document xmlns:html="http://www.w3.org/1999/xhtml">
...<html:img html:src="image.jpeg" html:width="100" html:height="200"/>...
</document>

XML文書内では大文字小文字が区別されます。 XHTMLの様式に従って、タグ名、属性名共に小文字で記述してください。

各要素・属性のサポート状況

XML/XSLTのサポート

xml-stylesheet処理命令

CSSJがXML文書にXSLTスタイルシート、またはCSSスタイルシートを関連付ける仕様は、 W3C勧告の Associating Style Sheets with XML documents version 1.0 に従っています。

<?xml-stylesheet href="style.xsl" type="text/xsl"?>

<?xml-stylesheet href="style.css" type="text/css"?>

デフォルトでは、代用でない全てのprintメディアのスタイルシートが順に適用されます。 input.stylesheet.titlesプロパティによって適用するスタイルシートを指定することができます。

拡張処理命令

XMLで利用できる、CSSJ独自の処理命令があります。 これらは、主にHTMLのheadタグ内に記述する設定をXMLでも可能にするものです。

処理命令は <?名前 値?> という形式で、XML宣言以降の任意の場所に記述することができます。 また、処理命令の値は、さらに擬似属性とデータ部に分かれることがあります。 擬似属性はHTML/XML要素の属性に似ています。例えば、以下の処理命令はname,mediaという擬似属性を持ち、 データ部がスタイルシートになっています。

<?jp.cssj.stylesheet type="text/css" media="screen" [
  html {
    background-color: Red;
  }
]?>

XSLTプロセッサ

CSSJはApache Software Foundationが開発したソフトウェアを使用しています。 CSSJサーバーに使用されているXSLTプロセッサはXSLT 1.0,XPath 1.0をサポートしています。 無保証のGUI版CSSJはJavaVMのXSLTプロセッサを使用します。

XSLTプロセッサはconfディレクトリ内のjava.propertiesファイル内の javax.xml.transform.TransformerFactoryプロパティによって変更可能です。 これによりSaxonのような他のXSLTプロセッサを用いることでパフォーマンスや機能が改善されることがありますが、 このような修正については保証の範囲外です。 お客様の責任で行ってください。

フォント設定ファイル

CSSJが利用するフォントに関する設定は、resource/media/pdf/fonts.xmlに記述されています。 このファイルには、以下の事柄が記述されています。

• cmapファイル
• フォント・ファイル
• システム・フォント
• コア・フォント
• 一般フォント
• デフォルトのフォント
• CSS一般フォント・ファミリ

cmapファイル

cmapファイルは、シフトJIS,EUCなどの文字コードと、Adobe社独自のキャラクタ・コードを関連付けるファイルです。 これは、後述する一般フォントに関連します。 fonts.xmlファイルのcmaps要素に記述されていますが、特にこの設定を変更する必要はありません。

フォント・ファイル

フォント・ファイルを追加する場合、fonts.xmlファイルにfont-file要素を追加します。 利用可能なフォント・ファイルはTrueTypeフォント(.ttfファイル)です。 font-fileのsrc属性に、フォント・ファイルへのパスを記述してください。

font-fileのpolicy属性に"type2"を指定すると、CFF/Type2フォントに変換され、PDFに埋め込まれます。 "external"を指定すると、フォントのメトリック情報だけがPDFファイルに記述され、フォント自体は埋め込まれません。 "external"を指定した場合、PDFファイルを正確に表示するには、利用するフォントがインストールされた環境が必要です。 フォントの埋め込みをすると、どの環境でもPDFファイルを正確に表示できますが、 利用するフォントがライセンス上PDFファイルへの埋め込みが許可されているものである必要があります。 CSSJは技術的にフォントが埋め込みライセンスが許可されているものかどうかを判別できないため、 利用するフォントのライセンスについては、各フォント・ベンダの使用許諾契約書などをご参照ください。

フォント名はフォント・ファイルから自動的に取得されます。 CSSから別の名前でも指定できるようにするためには、font-file要素内にalias要素を追加してください。 aliasのname属性にフォントの別名を記述してください。

システム・フォント

フォント・ファイルを直接指定する他に、OSにインストールされたシステム・フォント名を指定する方法があります。 システム・フォントを利用可能にするには、fonts.xmlファイルにsystem-font要素を追加してください。 system-fontのsrc属性にはフォント名を記述します。 また、all-system-fonts要素を追加することで、全てのシステム・フォントを利用可能になります。

これらの要素には、フォント・ファイル同様にpolicy属性の設定が可能です。 また、system-font要素の内部にはalias要素を含めることができます。

コア・フォント

コア・フォントはPDFの標準的な欧文フォントで、AFM(Adobe Font Metrics)ファイルによってメトリック情報が定められています。 fonts.xmlのcore-font要素によって設定されます。 通常は変更する必要はありません。

一般フォント

一般フォントは、フォントの種類のみを指定して、実際にどのようなフォントを利用するかはPDFビューワに任せるものです。 メトリック情報として、一般的な等幅和文フォントのものを用いるため、プロポーショナルフォントを指定することは適しません。 fonts.xmlのgeneric-font要素によって設定されます。 name属性にはフォント名、flags属性にはフォントの種類を示すフラグ、cmap属性にはcmap名前を指定します。 通常、この設定を変更する必要はありません。

デフォルトのフォント

デフォルトのフォントは、CSSJがCSS内で指定されたフォントを探し、最終的に該当するフォントがなかった場合に使われるフォントです。 fonts.xmlファイルのdefault要素のname属性にフォント名を記述してください。 このフォント名は、実際に利用可能なフォントを指定してください。

CSS一般フォント・ファミリ

CSSではserif,sans-serif,monospace,fantasy,cursiveという5種類の一般フォント・ファミリがあります。 fonts.xmlのcss-generic要素で、これらのフォント・ファミリ名と実際のフォントを対応付けることができます。

css-genericのgeneric-family要素には、CSSの一般フォント・ファミリ名を記述してください。 font-family要素には実際に使われるフォントのリストをカンマ区切りで記述します。 フォントのリストの意味はCSSのfont-familyプロパティと同じで、 リストの最初に記述されたフォントが優先的に使われます。

CSSJのデフォルト設定では一般フォントまたはコア・フォントを使うようにしているため、 常に外部フォントが使われます。fantasy,cursiveの設定は適当ではありません。 フォントの埋め込みを行う場合は、適切に設定しておくことを推奨します。

見出しに関する拡張機能

CSSJでは、見出しから目次を生成する機能、ページのヘッダ・フッタに見出しを表示する機能が追加されています。 これらは、T_EXおよびXSL-FOに対抗する機能として、追加されたものです。 これらの機能は非標準で、限定的であり、将来のバージョンでは他の方法に置き換えられる可能性があります。

2パス以上の変換処理

CSSJ 1.1.x以前では文書の変換処理は常にワンパスでしたが、 CSSJ 1.2.0からは、文書を2度以上処理する機能が加えられています。 この目的は、ページ番号によって文書の内容を指し示すためです。 HTML/XML中に存在する任意の位置の内容が、 変換後のPDFの何ページ目に存在するかは一度変換処理を行わないと分からないためです。

次に説明する、目次の自動生成を行うためには、processing.pass-countプロパティに2以上の値を指定し、 複数パスの変換する必要があります。

目次の自動生成

CSSJ 1.2.0で目次(Table of Contents)の生成機能が追加されました。 目次の生成では、1回目の文書処理で各見出し(h1〜h6)が存在するページ番号を収集し、 2回目の文書処理で目次を生成します。 目次の生成場所は、以下のように独自タグcssj:tocで指定します。

cssj:tocは常に目次に変換されるわけではありません。 目次に変換されるのは、以前のパスで見出しの存在するページ番号の収集が行われた場合です。 ページ番号の収集は、のこりのパス数がprocessing.make-toc-beforeプロパティ より多い場合に行われます。デフォルトは1なので、一番最後のパス以外でページ番号の収集が行われます。

offset属性は目次に含まれるページ番号から引かれる値です。 一般的な書籍では前付け(表紙、まえがき、目次)のページ番号をローマ数字で記述し、 本文で再び1から始まるアラビア数字のページ番号を別立てで用意することが行われます。 しかし、CSSJが目次を生成するためのページのカウントは、表紙を1ページとした通し番号で行われるため、 実際のページ番号に合わせるためには、目次が未生成の状態での前付けのページ数分差し引く必要があります。 表紙を1ページとして最後まで通し番号でゆく場合はこの限りではありませんが、目次に使われるページ数も考慮する必要があるため、 文書の変換処理が3パス必要になります。

目次と本文の通し番号を別々にしている場合、何らかの理由で3パスの変換処理を実行した場合、 意図せず目次も含めた通し番号で目次のページが生成されてしまいます。 その場合、processing.make-toc-beforeプロパティを(合計パス数 - 1)に設定することにより、これを防ぐことができます。

生成される目次は、次のようなリストの形式をしています。

例として、これをT_EXライクな見栄えで表示するためには、以下のCSSを使ってください。

ヘッダ・フッダへの見出しの表示

ページのヘッダやフッタに、現在のページに記述されているセクションに対応する見出しを表示することができます。 そのための拡張として、contentプロパティで使用できる-cssj-heading関数が用意されています。

-cssj-headingの引数は、表示する見出しのレベルです。 この値はh1〜h6の数字部分です。例えば、-cssj-heading(2)では直前にh2要素に記述された見出しが表示されます。

注釈

cssj:annot属性を任意のタグに設定することにより、CSSJドライバに、現在処理しているページに含まれる注釈を返すことができます。 cssj:annotの値は、annotという名前の情報でドライバに返されます。 アプリケーションが、現在CSSJがドキュメントのどの部分を処理しているのかを判断するために利用できます。