XSL FormatterAntenna House によるXSL拡張仕様

Apr 24, 2003
RevSep 8, 2003

Antenna House によるXSL拡張の namespace の URI は、http://www.antennahouse.com/names/XSL/Extensions である。

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions">

拡張要素

axf:document-info [V2.5]

Common Usage:

文書情報を指定する。これらの情報は、もっぱらPDF中に埋め込むために利用される。

Areas:

なし。

Constraints:

axf:document-info 拡張要素は、fo:root の直下の任意の位置に置くことができる。また、そのプロパティは name と value で、いずれも必須である。name の値は、"title"、"subject"、"author"、"keywords" のいずれかでなければならない。

Contents:

EMPTY

Examples:
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions">
  <axf:document-info name="title" value="文書のタイトルを指定する"/>
  <axf:document-info name="subject" value="文書のサブタイトルを指定する"/>
  <axf:document-info name="author" value="著者名を指定する"/>
  <axf:document-info name="keywords" value="キーワードをコンマ区切りで列挙します"/>
......

拡張プロパティ

1. PDFのためのしおり

Sample Bookmark

axf:outline-expand

PDFの「しおり」の初期状態で、下位の階層を表示するかどうかを指定する。

Value:true | false
Initial:true
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

true の場合は下位項目が展開されて表示され、false の場合はたたみ込み表示される。

axf:outline-group [V2.5]

PDFの「しおり」をグループ化して、まとめて出力する。

Value:<string>
Initial:empty string
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

このプロパティが省略された場合や空文字列の場合、グループ化は行なわれない。何か文字列が指定された場合、その文字列はグループ名として扱われ、同一のグループ名を持つしおりがまとめて出力される。

axf:outline-level

PDFの「しおり」の項目の階層レベルを示す。

Value:<number>
Initial:0
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

<number> の値は、非負の整数値でなければならない。 初期値は0で、このとき、しおりは作成されない。 しおりの最上位の項目は1で、しおりの中に階層化されるに従って、2以上の値となる。

axf:outline-title

PDFの「しおり」のタイトルとして表示される文字列を指定する。

Value:<string>
Initial:empty string
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

このプロパティが省略された場合や空文字列の場合、このプロパティが付加されているオブジェクトのテキストがタイトルになる。

2. 段組脚注

axf:footnote-position [V2.5]

脚注を段ごとに配置するかどうかを指定する。

Value:page | column
Initial:page
Applies to:fo:region-body
Inherited:no
Percentages:N/A

値の意味は以下のとおり。

page

各ページの region-body 内の after 側に配置。XSL 1.0 仕様の標準の脚注。

column

各段の after 側に配置。横組みでの標準的な脚注。

3. 改訂バー

Revision Bar Model

axf:revision-bar-color [V2.5]

改訂バーの色を指定する。

Value:<color> | inherit
Initial:the value of the 'color' property
Applies to:all block-level and inline-level formatting objects which are descendants of fo:flow
Inherited:yes
Percentages:N/A

axf:revision-bar-offset [V2.5]

改訂バーの表示オフセットを指定する。

Value:<space> | inherit
Initial:0
Applies to:all block-level and inline-level formatting objects which are descendants of fo:flow
Inherited:yes
Percentages:N/A

axf:revision-bar-position [V2.5]

改訂バーの表示位置を指定する。

Value:start | end | inside | outside | alternate | both | inherit
Initial:start
Applies to:all block-level and inline-level formatting objects which are descendants of fo:flow
Inherited:yes
Percentages:N/A

値の意味は以下のとおり。

start

改訂バーを start 側に配置する。

end

改訂バーを end 側に配置する。

inside

奇数ページでは start 側に、偶数ページでは end 側に配置する。

outside

奇数ページでは end 側に、偶数ページでは start 側に配置する。

alternate

段組のとき、最終段では改訂バーを end 側に、それ以外では start 側に配置する。

both

改訂バーを start 側と end 側に配置する。

axf:revision-bar-style [V2.5]

改訂バーのスタイルを指定する。

Value:<border-style> | inherit
Initial:none
Applies to:all block-level and inline-level formatting objects which are descendants of fo:flow
Inherited:yes
Percentages:N/A

axf:revision-bar-width [V2.5]

改訂バーの幅を指定する。

Value:<border-width> | inherit
Initial:medium
Applies to:all block-level and inline-level formatting objects which are descendants of fo:flow
Inherited:yes
Percentages:N/A

4. 段間罫

Revision Model

axf:column-rule-align [V2.5]

段間罫の位置を指定する。

Value:top | middle | bottom | inherit
Initial:middle
Applies to:fo:region-body
Inherited:yes
Percentages:N/A

これは、CSS3 Multi-column layout にはない。

axf:column-rule-color [V2.5]

段間罫の色を指定する。

Value:<color> | inherit
Initial:the value of the 'color' property
Applies to:fo:region-body
Inherited:no
Percentages:N/A

CSS3 Multi-column layout を参照のこと。

axf:column-rule-length [V2.5]

段間罫の長さを指定する。

Value:<length> | inherit
Initial:100%
Applies to:fo:region-body
Inherited:no
Percentages:refer to the size of the column

これは、CSS3 Multi-column layout にはない。

axf:column-rule-style [V2.5]

段間罫のスタイルを指定する。

Value:<border-style> | inherit
Initial:none
Applies to:fo:region-body
Inherited:no
Percentages:N/A

CSS3 Multi-column layout を参照のこと。

axf:column-rule-width [V2.5]

段間罫の幅を指定する。

Value:<border-width> | inherit
Initial:medium
Applies to:fo:region-body
Inherited:no
Percentages:N/A

CSS3 Multi-column layout を参照のこと。

5. ページ背景

ページ背景は評価版では無効。

axf:background-color [V2.5]

fo:simple-page-master に対する背景色。

Value:<color> | transparent
Initial:transparent
Applies to:fo:simple-page-master
Inherited:no
Percentages:N/A

axf:background-image [V2.5]

fo:simple-page-master に対する背景画像。

Value:<uri-specification> | none
Initial:none
Applies to:fo:simple-page-master
Inherited:no
Percentages:N/A

6. ページ番号

axf:suppress-duplicate-page-number

重複ページ番号参照の除去を指定する。

Value:true | false
Initial:false
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

一般的な索引の組版をする場合、1つの索引項目には複数の fo:page-number-citation が連続する。このような場合に、標準のプロパティでは fo:page-number-citation が同じページ番号を参照していると、ページ番号が重複して出力されてしまう。 true を指定すると、前の fo:page-number-citation と同じページ番号を参照しているとき、間の要素(コンマなど)と共にそのページ番号は非表示になる。

7. テキスト処理

axf:hanging-punctuation [V2.5]

句読点のぶら下げを行うかどうかを指定する。

Value:none | end | inherit
Initial:none
Applies to:fo:block
Inherited:yes
Percentages:N/A

値の意味は以下のとおり。

none

ぶら下げを処理しない。

end

行末の句読点のぶら下げを処理する。

処理される句読点は、全角の「。、.,」のみ。

axf:kerning-mode [V2.5]

隣接する全角約物の詰めを行なうかどうかを指定する。

Value:none | contextual | auto | inherit
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:N/A

値の意味は以下のとおり。

none

隣接する全角約物詰めを処理しない。

contextual

隣接する全角約物詰めを処理する。

auto

組版オプションの指定によって、「none」または「contextual」とみなされる。

axf:line-break [V2.5]

行分割の方法を指定する。

Value:normal | strict | inherit
Initial:normal
Applies to:fo:block
Inherited:yes
Percentages:N/A

値の意味は以下のとおり。

normal

拗促音や長音などの文字を禁則処理しない。

strict

拗促音や長音などの文字を禁則処理する。 禁則処理されるのは、拗音「ゃゅょ」や促音「っ」などの小書きのかなと「ーゝゞヽヾ々」。

axf:line-break-at-punctuation-in-word [V2.5 MR3]

英数字列に含まれる記号類直後の行分割を制限する。

Value:loose | normal | restrict | strict
Initial:normal
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

値の意味は以下のとおり。

loose

UAX#14: Line Breaking Properties に従う。

normal

記号類のうち、ISに分類される文字と英字間での改行を起こりにくくする。他は、UAX#14に従う。 数字との間は、もともとUAX#14により改行が禁止されている。
IS前後の英数字列が比較的長く、ハイフネーションもされないときは、ISの直後での改行が起こる。短い場合は、略語などの可能性が高く、積極的には改行しない。

restrict

記号類と英数字間での改行を起こりにくくする。
記号類前後の英数字列が比較的長く、ハイフネーションもされないときは、記号類の直後での改行が起こる。短い場合は、略語などの可能性が高く、積極的には改行しない。

strict

記号類と英数字間での改行を禁止する。

axf:punctuation-spacing [V2.5]

隣接する全角約物の詰めの間隔を指定する。

Value:<length> | inherit
Initial:0.5em
Applies to:fo:block
Inherited:yes
Percentages:refer to the font size

調整されるのは、以下の間隔。

axf:punctuation-trim [V2.5]

行頭、行末の全角約物を半角扱いにするかどうかを指定する。

Value:none | start | end | auto | inherit
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:N/A

値の意味は以下のとおり。

none

行頭行末の全角約物詰めを処理しない。

start

行頭での全角約物(開き括弧など)を半角に扱う。

end

行末での全角約物(閉じ括弧など)を半角に扱う。

both

行頭と行末での全角約物を半角に扱う。

auto

組版オプションの指定によって、「none」または「both」とみなされる。

axf:text-autospace [V2.5]

和欧文間に空きを入れるかどうかを指定指定する。

Value:none | [ ideograph-numeric || ideograph-alpha ] | auto | inherit
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:N/A

値の意味は以下のとおり。

none

空きを入れない。

ideograph-numeric

仮名漢字-数字間に空きを入れる。

ideograph-alpha

仮名漢字-アルファベット間に空きを入れる。

auto

組版オプションの指定によって、「none」または「ideograph-numeric ideograph-alpha」とみなされる。

axf:text-autospace-width [V2.5]

和欧文間の空きの量を指定する。

Value:<length> | inherit
Initial:0.25em
Applies to:fo:block
Inherited:yes
Percentages:refer to the font size

axf:vertical-underline-side [V2.5 MR3]

縦書きでの下線(傍線)をどちら側に付けるかを指定する。

Value:left | right | auto | inherit
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

値の意味は以下のとおり。

left

左側に下線(傍線)を引く。

right

右側に下線(傍線)を引く。

auto

組版オプションの指定によって、「laft」または「right」とみなされる。

8. その他

axf:base-uri

相対指定のURIのベースとなる位置を指定する。

Value:<uri-specification>
Initial:empty string
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

axf:base-uri は、ドキュメント内のすべての相対URIに適用される。例えば、fo:basic-link を記述してリンクを作成するときに相対URIを指定した場合、axf:base-uri で指定された位置をベースURIとして解釈する。 このプロパティが省略された場合や空文字列の場合、対象となっているXMLファイルの位置がベースとみなされる。

axf:soft-hyphen-treatment

SOFT HYPHEN を出力するかどうかを指定する。

Value:auto | preserve | inherit
Initial:auto
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

通常、SOFT HYPHEN (U+00AD) は、行分割しなかったときは表示せず、行分割した場合は表示される。しかし、この処理では、絵文字のようなフォントを使用した場合、U+00AD に割り当てられているグリフが印字されない場合が発生してしまう。axf:soft-hyphen-treatment プロパティを使用することで、この問題を回避することができる。

値の意味は以下のとおり。

auto

SOFT HYPHEN はそこで改行が生じたとき以外は削除される。(従来通り)

preserve

SOFT HYPHEN は削除されず、対応するグリフが出力される。

値の拡張

clear [V2.5]

以下の太字の値が拡張されている。

Value:start | end | left | right | inside | outside | both | none | inherit

値の意味は以下のとおり。

inside

奇数ページでは start と、偶数ページでは end とみなされる。

outside

奇数ページでは end と、偶数ページでは start とみなされる。

float [V2.5]

以下の太字の値が拡張されている。

Value:before | start | end | left | right | inside | outside | none | inherit

値の意味は以下のとおり。

inside

奇数ページでは start 側に、偶数ページでは end 側に配置する。

outside

奇数ページでは end 側に、偶数ページでは start 側に配置する。

writing-mode [V2.5]

以下の太字の値が拡張されている。

Value:lr-tb | rl-tb | lr-bt | rl-bt | tb-rl | tb-lr | bt-rl | bt-lr | lr | rl | tb | inherit

値の意味は以下のとおり。

lr-bt

インラインやテキストは 左から右、行やブロックは 下から上 に進む。

rl-bt

インラインやテキストは 右から左、行やブロックは 下から上 に進む。

tb-lr

インラインやテキストは 上から下、行やブロックは 左から右 に進む。

bt-rl

インラインやテキストは 下から上、行やブロックは 右から左 に進む。

bt-lr

インラインやテキストは 下から上、行やブロックは 左から右 に進む。


Copyright © 1999-2004 Antenna House, Inc. All rights reserved.
Antenna House is a trademark of Antenna House, Inc.