XSL Formatter V2 Q&A

この現象はパーサにMSXMLを使用しているために発生します。

例を示して説明します。

[ファイル名：test.fo]

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE root [ <!ENTITY testseg SYSTEM "testseg.fo"> ]>
<root xmlns="http://www.w3.org/1999/XSL/Format" >
  <layout-master-set>
    <simple-page-master master-name="frame">
      <region-body region-name="frame-body"/>
    </simple-page-master>
  </layout-master-set>

  <page-sequence master-reference="frame">
    <flow flow-name="frame-body">
      &testseg;
    </flow>
  </page-sequence>
</root>

[ファイル名：testseg.fo]

<block>
    This is a test
</block>

MSXML はエンティティごとに namespace の指定がないと null namespace （namespaceなし）であるとみなされます。つまり展開元（testseg.fo）の block の namespace が展開先(test.fo) の方に指定されている namespace 指定に変わるようなことはありません。したがって、次のように展開されます。

[ファイル名：test.fo（展開後）]

<?xml version="1.0" encoding="utf-8"?>
<root xmlns="http://www.w3.org/1999/XSL/Format" >
  <layout-master-set>
    <simple-page-master master-name="frame">
      <region-body region-name="frame-body"/>
    </simple-page-master>
  </layout-master-set>

  <page-sequence master-reference="frame">
    <flow flow-name="frame-body">
      <block xmlns="">This is a test</block>
    </flow>
  </page-sequence>
</root>

エンティティ名「&testseg;」が「 <block xmlns="">This is a test</block>」と展開されます。「xmlns=""」は FO namespace ではないので XSL Formatter は処理をせずに無視します。これにより、組版結果に反映されないのです。
これを回避するためには外部エンティティ（testseg.fo）の block にもFO namespaceを宣言すれば解決します。

[ファイル名：testseg.fo（修正後）]

<block xmlns="http://www.w3.org/1999/XSL/Format">
    This is a test
</block>

XSL-FO仕様の「Keeps and Breaks Properties」を実装していますので、これを使って指定できます。例えば、章見出しを表示するブロックをＡ、章の明細行を表示するブロックをＢとします。

1. Ａにbreak-before="page"を指定すれば、章見出しの前で必ず改ページが発生し、結果として必ずページ内の先頭に配置するようにできます。
2. Ａにkeep-with-next.within-page="always"を指定すれば、次の章の明細行（Ｂ）とページ内で必ず「くっついて」配置されます。したがって、ページの下に章見出しだけが「取り残されて」配置されることはなくなります。

文書内で複数のページマスタを使うことが可能ですので、次のようなポートレートとランドスケープそれぞれのページマスタを作れば表示することはできます。

<fo:simple-page-master master-name="Portrait"
  page-width="210mm" page-height="297mm">
  ...
</fo:simple-page-master>
<fo:simple-page-master master-name="Landscape"
  page-width="297mm" page-height="210mm">
  ...
</fo:simple-page-master>

FOデータでは、「page-width="297mm" page-height="210mm" 」とA4横（landscape）が指定されているとき、これを正しく印刷するには、プリンタのプロパティで用紙サイズと向きを設定しなくてはなりません。そうしないと普通は縦(portrait)の向きに印刷されることになります。それでページの一部がはみだしてしまうことになるので正しく印刷できません。

V2.2では、Windows NT/2000 で実行したときのみ、用紙のタテとヨコを出力時に自動的に変えられるようになっています。

エラーは発生しないようにしています。これは XSL Formatter の「アンテナハウス XSL 拡張仕様」タグをエラーにしないためです。
ただし「順序が決まっており、これに従っていない場合の組版結果は保証できない」となります。XSL Formatter ではできる限りこれをフォローして処理を行っていますが、結果は保証できませんし、この処理全体が恒久的に保証できるものでもありません。

同じサイズの紙でトレイを分けてある場合はできませんが、各トレイが全て異なる用紙サイズ別になっているのならできます。用紙サイズを変更するために"simple-page-master"をFOの中で指定してください。Formatter は異なる用紙に組版して印刷します。プリンタへの出力時に用紙サイズも指定しますのでプリンタが対応していれば、自動的にトレイが変わります。

Tray A (A4)

<fo:simple-page-master page-height="210mm" page-width="297mm">

Tray B (B5)

<fo:simple-page-master page-height="182mm" page-width="257mm">

Tray C (B6)

<fo:simple-page-master page-height="128mm" page-width="182mm">

奇数、偶数という振り分けでしたらこれは可能です。XMLではなくスタイルシート側にページシーケンスマスターを記述することで可能になります。次に簡単なサンプルを記述します。

<fo:layout-master-set>
    <fo:simple-page-master master-name="odd-page-master">
        <fo:region-before region-name="odd-page-header"/>
        その他のリージョンの記述
    </fo:simple-page-master>
    <fo:simple-page-master master-name="even-page-master">
        <fo:region-before region-name="even-page-header"/>
        その他のリージョンの記述
    </fo:simple-page-master>

    <fo:page-sequence-master master-name="main">
        <fo:repeatable-page-master-alternatives>
            <fo:conditional-page-master-reference master-name="odd-page-master" odd-or-even="odd" />
            <fo:conditional-page-master-reference master-name="even-page-master" odd-or-even="even" />
        </fo:repeatable-page-master-alternatives>
    </fo:page-sequence-master>
</fo:layout-master-set>
<fo:page-sequence master-reference="main">
    <fo:static-content flow-name="odd-page-header">
    奇数ページ・ヘッダ用のコンテンツ(右寄せ指定)
    </fo:static-content>
    <fo:static-content flow-name="even-page-header">
    偶数ページ・ヘッダ用のコンテンツ(左寄せ指定)
    </fo:static-content>
    <fo:flow>
    本文コンテンツ
    </fo:flow>
</fo:page-sequence>

これは「force-page-count」というプロパティが規定値では auto になっていてページを「奇数、偶数、・・・」と並べるようにしているために、空白ページを入れて調整しています。

質問の例では表紙が１ページ目ですが次も１ページ目と宣言されているため、「奇数、奇数、偶数・・・」の並びになるので、表紙と本文の間に空白ページを入れて「奇数、偶数、奇数、偶数・・・」と並ぶように調整しているのです。

これを回避する方法は、最初のページの initial-page-number に"0"を指定するか、force-page-count プロパティに"no-force"を指定します。

<fo:block-container>

    <!-- check if the table should have the landscape style -->
    <xsl:if test="@orientation='Landscape'">
        <xsl:attribute
name="page-break-before">always</xsl:attribute>
        <xsl:attribute
name="page-break-after">always</xsl:attribute>

        <xsl:attribute
name="reference-orientation">90</xsl:attribute>
        <xsl:attribute name="height">18.5cm</xsl:attribute>
        <xsl:attribute name="width">24.7cm</xsl:attribute>

    </xsl:if>

    ... rest of the table stylesheet...

</fo:block-container>

これは、block-container を使ってその中にtableを記述しているからです。 fo:block-container のなかではページのオーバーフローが発生しても改ページはされません。

しかし、今回の要望のようにこのtableを横書きで出力したいとなると reference-orientation は fo:block には使えませんし、 別の(横書きの)ページレイアウトを用意してその page-sequence に出力するといった処理が必要になってきます。

<fo:simple-page-master master-name="Portrait"
  page-width="210mm" page-height="297mm">
  ...
</fo:simple-page-master>
<fo:simple-page-master master-name="Landscape"
  page-width="297mm" page-height="210mm">
  ...
</fo:simple-page-master>

fo:simple-page-master に reference-orientation を指定した場合、回転するのは page-reference-area の中身であり、その外側は回転しません。

詳しくは下記のイメージをご覧ください。
6.4.12 fo:simple-page-master

region-body と周りの region-before/after/start/end との間での Z-order の関係は XSL-FO 仕様ではとくに規定がありません。アプリケーションの実装に依存します。

XSL Formatter の実装では、region-body を描画したあと周りの region を描画しているため、周りの region のほうが Z-order が上となっていますが、将来のバージョンで変更される可能性もあります。
region-body には、周りの region と重ならないように margin を指定するようにしてください。

送られてきた FO は次のようになっていました。

<fo:layout-master-set>
    <fo:simple-page-master master-name="firstpage" page-height="210mm" page-width="297mm">
                .
                .
                .
    </fo:simple-page-master>

    <fo:simple-page-master master-name="restpage" page-height="210mm" page-width="297mm">
                .
                .
                .
    </fo:simple-page-master>

    <fo:simple-page-master master-name="blankpage" page-height="210mm" page-width="297mm">
                .
                .
                .
    </fo:simple-page-master>

    <fo:page-sequence-master master-name="document">
        <fo:repeatable-page-master-alternatives>
            <fo:conditional-page-master-reference page-position="first" master-reference="firstpage"/>
            <fo:conditional-page-master-reference page-position="rest" master-reference="restpage"/>
            <fo:conditional-page-master-reference page-position="any" master-reference="blankpage"/>
        </fo:repeatable-page-master-alternatives>
    </fo:page-sequence-master>
</fo:layout-master-set>
            .
            .
            .
            .

W3C XSL-FO 仕様 7.25.14 "page-position" の"rest"の説明には次のように書かれています。

This master is eligible for selection if this is not
the first page nor the last page in the page-sequence.

page-position="rest" は page-position="first"と page-position="last" 以外のページに適応されます。上記のFOにはpage-position="last"を指定した fo:conditional-page-master-reference がありません。
XSL Formatter は fo:repeatable-page-master-alternatives の中に適合する fo:conditional-page-master-reference がない場合、エラーメッセージを出さず、fo:repeatable-page-master-alternative 内の最後の fo:conditional-page-master-reference を次候補として使用して、組版を続行させる仕様になっています。
したがって、上記の FO の場合は page-position="any" が指定されている fo:conditional-page-master-reference が次候補になりますので、これを使用して最終ページが組版されます。
ただし、「間違った FO 」を組版していますので、その結果がどうなるかは保証されません。

これは XSL Formatter V2 の制限です。

<fo:layout-master-set>
    <fo:simple-page-master master-name="master_first"
                        page-height="297mm" page-width="210mm" >
        <fo:region-body margin="10mm" column-count="3"/>
    </fo:simple-page-master>
    <fo:simple-page-master master-name="master_rest"
                        page-height="297mm" page-width="210mm">
        <fo:region-body margin="10mm" column-count="2"/>
    </fo:simple-page-master>
    <fo:simple-page-master master-name="master_last"
                        page-height="297mm" page-width="210mm">
        <fo:region-body margin="10mm" column-count="2"/>
    </fo:simple-page-master>

    <fo:page-sequence-master master-name="main-sequence">
        <fo:repeatable-page-master-alternatives>
            <fo:conditional-page-master-reference
                        master-reference="master_first" page-position="first"/>
            <fo:conditional-page-master-reference
                        master-reference="master_rest" page-position="rest"/>
            <fo:conditional-page-master-reference
                        master-reference="master_rest" page-position="last"/>
        </fo:repeatable-page-master-alternatives>
    </fo:page-sequence-master>
</fo:layout-master-set>

<fo:page-sequence master-reference="main-sequence">
    <fo:flow flow-name="xsl-region-body">
            .
            .
            .
    </fo:flow>
</fo:page-sequence>

この例の場合、本来は１ページ目には３段組が作成され、次ページ以降は２段組となります。しかし、XSL Formatter はフロー内部で段組数を切り替えることができません。したがって、２ページ目以降も３段組が作成されてしまいます。（ただし、文字が流し込まれるのは２段組目までです）
段組数を変えたい場合は段組ごとに別のフローを作成してください。

'fo:break-after' プロパティか、'fo:break-before' プロパティを使用すれば、任意の場所で改ページ／改カラムすることができます。
詳しくは、W3C Recommendationの「7.19.1. break-after」、「7.19.2. break-before」をご覧ください。

z-index は親FOの z-index からの相対値で指定します。したがって、プラスの値は前面に配置されます。マイナスの値が指定された場合は、背面に配置されます。

5.4.5 z-index Property
The value is converted to one that is absolute; i.e., the refined value
is the specified value plus the refined value of z-index of its parent
formatting object, if any.

プラス値、 マイナス値以外の場合は z-index="0" となります。

これは XSL Formatter の制限です。 footnote が次のページに送られても、次のページでエリアが不足した場合はオーバーフローしてしまいます。
footnote-body の文字サイズを小さくしたり文字数を少なくするか、本文に改ページを入れて位置を変えるなどしてください。

この問題は XSL Formatter V2.5 改訂２版で修正されました。ただし、XSL Formatter は footnote の途中で改ページができません。

次のような fo:page-sequence-master の場合、エラーが発生し正常に組版できない場合があります。
FOサンプル：

<fo:page-sequence-master master-name="main">
        <fo:repeatable-page-master-alternatives maximum-repeats="10">
             <fo:conditional-page-master-reference odd-or-even="odd"
master-reference="one"/>
             <fo:conditional-page-master-reference odd-or-even="even"
master-reference="two"/>
        </fo:repeatable-page-master-alternatives>

    <fo:single-page-master-reference master-reference="blank_1"/>

    <fo:repeatable-page-master-alternatives maximum-repeats="4">
         <fo:conditional-page-master-reference odd-or-even="even"
master-reference="two"/>
         <fo:conditional-page-master-reference odd-or-even="odd"
master-reference="one"/>
    </fo:repeatable-page-master-alternatives>
</fo:page-sequence-master>

この問題につきましては XSL Formatter V2.5 改訂３版 にて修正されました。

この場合は <fo:table-cell vertical-align="bottom"> ではなく、<fo:table-cell display-align="after"> を使用すればセル内での文字位置を変更できます。

fo:tabe-cell プロパティに border-width.conditionality="retain" を追加することで罫線を残しておくことができます。

これはstart/end-indent の継承の問題です。V2でstart/end indentがXSL勧告仕様に準拠したからです。V1.1では準拠していませんでした。
XSL勧告仕様によれば継承プロパテイは親から子へと受け継がれます。 fo:table に指定された margin-left="-.2in" margin-right="-.2in" は start-indent、end-indent になり、それは fo:table 内部のセルにまで継承され、border-spacing の .2in と相殺されます。
解決方法は、fo:table-body、fo:table-header、fo:table-footer に start-indent="0in" end-indent="0in" を指定することです。

<fo:table-body start-indent="0in" end-indent="0in">

次のようにするとtableのまわりのborderを消すことができます。

<fo:table border-collapse="collapse" border-style="hidden">

fo:table に border-collapse="separate" が指定されている場合、 fo:table-header の border や padding は無効になります。 XSL 仕様の次のようなところを見ればわかるかと思います。

6.7.6 fo:table-header
......
The following properties apply to this formatting object:
......
    * [7.7 Common Border, Padding, and Background Properties]

      NOTE:
      Only the background properties from this set apply.
      If the value of border-collapse is "collapse" or
      "collapse-with-precedence" for the table the border
      properties also apply.

border-collapse が "collapse" でも "collapse-with-precedence" でもない 場合（つまり "separate" の場合）、border、padding は適用されない。

......

7.26.5 "border-separation"
......
In the separate borders model, each cell has an individual border. The
"border-separation" property specifies the distance between the borders
of adjacent cells. This space is filled with the background of the table
element. Rows, columns, row groups, and column groups cannot have
borders (i.e., user agents must ignore the border properties for those
elements).

table-header というのは row groups のひとつです。その border は無視し なければならないと明記されています。

セルの途中での改ページをさせないようにするには、keep-together.within-page="always" を fo:table-cell を囲む fo:table-row に指定すれば可能です。

送付されてきた FO は次のようになっていました。

<fo:block-container block-progression-dimension="6pc">
 <fo:block keep-together.within-column="auto">
  This is some text.
<fo:block  break-before="column"/>
  This is more text that should be in the next column.
 <fo:block>
</fo:block-container>

block-container のなかでは、改段できません。table を使ったらどうでしょうか。block-progression-dimension="6pc" をtable-rowに指定すればできます。

またはblock-containerを使う必要があるのなら、<fo:block span="all"/> を使って次のように指定してください。

<fo:block-container block-progression-dimension="6pc">
 <fo:block>
  1A) This is some text.
 </fo:block>
</fo:block-container>
<fo:block-container block-progression-dimension="6pc" break-before="column">
 <fo:block>
  1B) This is more text that should be in the next column.
 </fo:block>
</fo:block-container>
<fo:block span="all"/>

<fo:block-container block-progression-dimension="6pc">
 <fo:block>
  2A) This is some text.
 </fo:block>
</fo:block-container>
<fo:block-container block-progression-dimension="6pc" break-before="column">
 <fo:block>
  2B) This is more text that should be in the next column.
 </fo:block>
</fo:block-container>
<fo:block span="all"/>

詳しくはこちらのFOファイルを参照してください。

質問のサンプルはこうなっています。

<fo:table-cell>
<fo:block>This is the info for the step ..
<fo:float float="end">
<fo:block-container>
<fo:block>
<fo:external-graphic src="url(abc.eps)"/>
</fo:block>
</fo:block-container>
</fo:float>
</fo:block>
</fo:table-cell>

希望するのは下記のようなレイアウトと理解して、説明します。

 +------------------------+
 |This is the .---------. |
 |info for    | graphic | |
 |the step    '---------' |
 +------------------------+

floatのアンカーを"This is..."の前に置いてください。理由ですが、文字列は通常floatが見つかるまで流し込みさて、そしてfloatの位置決めが行われます。 下記の IE or Mozilla でのfloatのコードを見てみてください。

<div>
  The quick brown fox jumps over the lazy dog.
  <div style="float:right; width:2cm; background: yellow">Here is float</div>
</div>

floatの位置は"The quick brown..."と同じ位置（線上）に置かれます。 次に、floatの幅はその内容によって決められます。 block-containerの幅はこの祖先(この場合、table-cellですが）と同じ幅と解釈されますのでblock-containerの幅は指定しません。 もし、fo:block-containerの代わりにfo:blockを使用するならば、floatの幅はその内容によって幅が決まります。 下記に修正したコードを付けましたので、参考にしてください。

<fo:table-cell>
<fo:block>
<fo:float float="end">
<fo:block>
<fo:external-graphic src="url(abc.eps)"/>
</fo:block>
</fo:float>This is the info for the step ..
</fo:block>
</fo:table-cell>

この問題は不具合ではありません。それは W3C Recommendation から参照されているCSS2の仕様によるものです。 （こちらを参照してください：http://www.w3.org/TR/REC-CSS2/tables.html#width-layout）

CSS2ではtable-layout="auto" （デフォルト）ときの動作は決定されておらず、組版プログラムに任されています。よって、XSL Formatter V2.2では、table-layout="auto" （デフォルト）のときは、スパンされたカラムに限り、カラムサイズを変更して、文字列が１行になるようにしています。

解決方法としては、fo:table に column-width の合計の width を指定してください。これによってテーブル全体幅が固定され、カラム幅が変更されることが防げます。

なお、XSL Formatter V2.3ではこれを修正して、table-layout="auto" （デフォルト）が指定され、なおかつスパンされていても、スパンされてないカラムと同様に、行を改行してカラムに収めるように変更されました。

これは <fo:table-and-caption text-align="outside"> とすることで、実現することができます。

これはXSL Formatter V2.3までのAutomatic table layout アルゴリズムの不具合でした。

次がFOの一部です。

<table border-collapse="collapse-with-precedence">
<table-body>
<table-row>
<table-cell
    border-end-precedence="9"
    border-end-style="hidden"
    border-end-width="2pt">
    <block>r1c1</block>
</table-cell>
<table-cell
    border-start-precedence="10"
    border-style="solid"
    border-start-width="2pt">
    <block>r1c2</block></table-cell>
</table-row>
</table-body>
</table>

セルの内容の幅をもとにしてカラム幅を決めるのですが、そのとき、セルに指定されているborder幅も考慮します。
この例では、r1c1 の border-end は hidden なのですが、r1c2 に border-style="solid" border-start-width="2pt" の指定があり、それが collapse-with-precedence の条件で、高い優先順位になっているので、それが r1c1 と r1c2 の間の border となります。
table auto layout で r1c1 に必要な最低カラム幅を計算するときに、このような隣に指定された border のことが無視されていました。
このため、auto layout で決まったカラム幅ではセルの幅がそのborderの分だけ 狭くなり、内容が入りきらずに望ましくない行の折り返しが発生するということ があります。

この問題につきましては XSL Formatter V2.4 にて修正されました。

これは XSL Formatterの制限事項です。ネストしたテーブル内で改ページさせることができません。ご了承ください。

XSL Formatter V3 にはこの制限はありません。

次にFOの例を示します。

<fo:table table-layout="auto" inline-progression-dimension="100%">
 <fo:table-column column-width="2in"/>
  <fo:table-column/>
  <fo:table-column/>
  <fo:table-column/>
   <fo:table-body>
    <fo:table-row>
     <fo:table-cell border-start-style="solid" border-before-color="black">

       <fo:block>
        Row 1 Cell 1
       </fo:block>
      </fo:table-cell>
     <fo:table-cell border-start-style="solid" border-before-color="black" >
       <fo:block>
        Row 1 Cell 2
       </fo:block>
      </fo:table-cell>
       ......
       ......
  </fo:table-row>
 </fo:table-body>
</fo:table>

table-layout="auto" の場合、column-width で指定した幅のとおりにはならないことがあります。これは、Automatic table layout のアルゴリズムによります。
参照: CSS2 17.5.2 Table width algorithms: the 'table-layout' property http://www.w3.org/TR/REC-CSS2/tables.html#propdef-table-layout

column-widthに指定された値は、column の最小の幅になります。table の inline-progression-dimension が指定されていてその値が column 幅から決まるテーブルの幅よりも大きいときは、column 幅にその分の幅が分散されて追加されます。
詳しくは、CSS2 17.5.2 の Automatic table layout のところをお読みください。

テーブルを回転させるので、reference-orientationを使用することになると思います。
XSL-FO 仕様では fo:table や fo:table-and-caption に reference-orientation を指定することはできませんので、fo:block-container に reference-orientation を指定して、その中に table を指定することになります。
しかし、XSL Formatter V2 は、fo:block-container のエリア内で、改ページができません。したがって、複数のページにまたがったテーブルを回転させることは残念ながらできません。（テーブルが１ページ内に収まるなら、この方法は有効です）

XSL Formatter V3 にはこの制限はありません。

XSL Fomatter V2 では fo:table がネストされた場合、改ページすることができず、オーバーフローエラーが発生してしまいます。この問題は XSL Formatter V2 での制限事項です。
また、意図して teble をネストしていなくても、XSL スタイルシートの書き方ではネストされてしまう場合があります。 例えば 次のようなXSLスタイルシートでは、table がネストされたFOが組版されてしまいます。

<xsl:template match="paragraph">
  <fo:table>
    <fo:table-body width="165mm">
      <fo:table-row width="165mm">
        <fo:table-cell width="25mm">
          <fo:block id="{@link_id}" font-size="12pt" font-family="Arial">
            <xsl:value-of select="@number"/>
          </fo:block>
        </fo:table-cell>
        <fo:table-cell width="140mm">
          <fo:block font-family="Arial" font-size="12pt" text-align="justify">
            <xsl:apply-templates/>
          </fo:block>
        </fo:table-cell>
      </fo:table-row>
    </fo:table-body>
  </fo:table>
</xsl:template>

paragraph 全体が fo:table で実現されるようになっていて、その paragraph 内に table があると fo:table のネストになります。
解決方法ですが、このような paragraph （左右に分割されたレイアウト）を実現するためには、fo:list-block を使うことです。

<xsl:template match="paragraph">
  <fo:list-block provisional-distance-between-starts="25mm">
    <fo:list-item>
      <fo:list-item-label end-indent="label-end()">
          <fo:block id="{@link_id}" font-size="12pt" font-family="Arial">
            <xsl:value-of select="@number"/>
          </fo:block>
      </fo:list-item-label>
      <fo:list-item-body start-indent="body-start()">
          <fo:block font-family="Arial" font-size="12pt" text-align="justify">
            <xsl:apply-templates/>
          </fo:block>
      </fo:list-item-body>
    </fo:list-item>
  </fo:list-block>
</xsl:template>

併せて、本当に table を出力するところでは、fo:table-header、fo:table-body、fo:table-footer に start-indent="0mm"、end-indent="0mm" を指定して望まないインデントの継承を防止することが必要です。

XSL Formatter V3 には、この制限はありません。

可能です。 fo:table の table-omit-header-at-break(ヘッダーの省略)プロパティをtrueで指定するとヘッダは表示されません。table-omit-header-at-breakプロパティのdefaultは"false"で、改ページしても table-header は出力されます。

space-after="8mm" space-after.conditionality="retain" という指定により、 space-after は reference-area の最後にあっても残ります。
これは、改ページによりページが分かれた場合、その各ページ（分かれた前後のページ）の表を囲むreference-area に space-after がつくことになります。したがって、改ページ前の表の下にも8mmの余白を生成してしまうことになります。
このような場合は、space-after ではなく padding-after を使用してださい。

この場合、cellのcontentsの高さ指定する必要があります。
W3C Recommendation には次のように書かれています。

6.7.10 fo:table-cell
The method for determining the block-progression-dimension of the cell
in the grid is governed by the row-height trait.

よって、table-cell 内の block-container に inline-progression-dimension を指定する必要があります。

この問題は、以下の条件に全て一致したテーブルがあり、そのテーブル内で改段や改ページが発生したときに発生します。

• fo:table に border の指定がある
• テーブル内に fo:table-header または fo:table-footer の一方か、もしくはその両方がある
• table-omit-header-at-break または table-omit-footer-at-break プロパティの値が ”false”である

fo:table-header や fo:table-footer が使用されていない場合は問題は発生しません。 また、border-width が細線(1pt)程度であれば、ほとんど目立ちません。
この問題は、以下の方法で回避することが可能です。

• fo:table-header に border-top/border-right/border-left を指定する。
• fo:table-footer に border-bottom/border-right/border-left を指定する。
• fo:table-body に border-right/border-left を指定する。

この問題は XSL Formatter V2の制限事項です。

XSL Formatter V3 はこの制限はありません。

ページの横幅より大きなテーブルがはみ出しても、そのはみ出した分は出力されません。XSL-FOの仕様ではそのような機能はありません。

指定できません。段抜き（span）の指定は span="all" か span="none" のみです。

XSL仕様ではこのような機能はありません。しかし、fo:flow の最後に <fo:block spam="all" /> を挿入することで最後のページの１段目と２段目を揃えることが出来ます。

footnote単体に段組はできません。XSL V1勧告仕様では footnote-body のエリアの幅は region-body の幅と同じになります。
W3C Recommendation には次のように記述されています:

The fo:footnote is typically used to produce footnote-citations within
the region-body of a page and the corresponding footnote in a separate
area nearer the after-edge of the page.

Additionally, an fo:footnote is not permitted to have as a descendant an
fo:block-container that generates an absolutely positioned area.

なお、XSL Formatter の拡張機能「axf:footnote-position」を使用すれば、脚注を、段ごとに配置することができます。詳しくはXSL Formatter のオンラインマニュアルをご覧ください。

できません。将来のバージョンにて対応できるか検討しています。

送付された FO は次のようになっていました。

  <fo:layout-master-set page-height="11in" page-width="8.5in">
       <fo:simple-page-master master-name="first_page">

スタイルシートでの用紙サイズの指定の仕方が違っています。レターサイズを指定したつもりが、なにも指定されてないことになるので、XSL Formatter はデフォルトのA4を採用します。A4サイズなら入るはずのフッターの部分がレターサイズでは、はみ出て印刷されないのです。
次のように用紙サイズは fo:simple-page-master に指定してください。

<fo:layout-master-set>
       <fo:simple-page-master master-name="first_page" page-height="11in"
page-width="8.5in">

XSL-FOでは同一参照のfootnoteはサポートしていませんので、不可能です。
将来、アンテナハウス拡張機能で実現できるかどうか検討中です。

カレントページのcontentsとヘッダやフッタの内容は、fo:marker と fo:retrieve-marker を使うことで同期させることが可能です。
XSL-FO仕様の6.11.3 fo:marker と 6.11.4 fo:retrieve-marker を参照してください。

XSL Formatter はアンカーと同じページに正常に配置できないときは footnote を次のページに配置することがあります。 これについては、 [No.2003011003] を参照してください。
しかし、同じページに配置されるべき footnote が次、もしくはそれ以降のページに出力される場合があります。 これは、footnote のアンカーの文字列が空の場合に発生します。
この問題につきましては XSL Formatter V2.5 改訂３版 にて修正されました。

<fo:block margin-top="10pt" xsl:use-attribute-sets="MIDASHI">

必要部分へのマージンとして、上記のように設定されているとします。margin-top はCSS2との互換として用意され、XSLでは space-before と同じ扱いです。しかし一部違いがあり、margin-top は space-before.conditionality="retain" として解釈されてしまい、結果として改ページ直後であってもマージンがつけられてしまいます。よって

<fo:block space-before="10pt" xsl:use-attribute-sets="MIDASHI">

と、修正すれば良いでしょう。

margin-left というのは、writing-mode にかかわらず、left は絶対 left というのが XSL の仕様です。writing-mode で左右上下を変えるときには、start-indent、end-indent、space-before、space-after を使ってください。

これは継承によるものです。 W3C Recommendationでは、親要素にて指定されたプロパティが子要素にまで影響するプロパティがあります。これを「継承」と言っています。

'margin-left'プロパティは本来継承されないプロパティです。ただし margin-left は start-indent に変換されて処理されることになっていて、 start-indent の方が継承されるプロパティとなっています。

start-indent = margin-corresponding + padding-corresponding + border-corresponding-width
end-indent = margin-corresponding + padding-corresponding + border-corresponding-width

（W3C Recommendation Extensible Stylesheet Language 5.3.2をご覧ください）

したがって、指定した margin-left は( border、padding が0であるならば) start-indent を指定したのと同じことになり、テーブル内にまで継承されます。

もし、テーブルに start-indent / end-indnet を継承させないようにするためには、 table-body / table-header / table-footer に start-indent="0cm" とすれば良いです。

次のようなFOを組版させた場合、インデントされません。

<fo:block start-indent="from-nearest-specified-value(start-indent) + 1cm">
     First line
<fo:block start-indent="from-nearest-specified-value(start-indent) + 1cm">
     Second line
<fo:block start-indent="from-nearest-specified-value(start-indent) + 1cm">
     Third line
</fo:block>
</fo:block>
</fo:block>

組版結果は下記のような結果になってしまいます。

First line
Second line
Third line

これはXSL Formatter V2.3 までの不具合でした。本来は下記のようにインデントされなければなりません。

First line
    Second line
        Third line

この問題はXSL Formatter V2.4 にて修正されました。

次のようなFOを組版させた場合、fo:leader leader-pattern="dots"の後ろのテキストが次行の先頭に配置されてしまう場合があります。

<fo:block font-size="10pt"
          line-height="12pt"
          start-indent="1.5pc"
          text-align-last="justify"
          end-indent="3pc"
          last-line-end-indent="-3pc">
          AAAA BBBB CCCC DDDD EEEE FFFF GGGG HHHH IIII JJJJ KKKK LLLL MMMM OO
          <fo:leader leader-pattern="dots"/>
          Z
</fo:block>

これはXSL Formatter V2.3までの不具合でした。この問題は XSL Formatter V2.4 にて修正されました。

XSL-FO仕様には次のようにあります。

5.11. Property Datatypes
    If the computed value of a corresponding relative property is set
    from the corresponding absolute property, the latter is used in determining
    all the components of the former.
    For example, assuming a block-progression-direction of "top-to-bottom",
    in a specification of
    margin-top="10.0pt"
    space-before.minimum="4.0pt"
    the explicit setting of one of the components of the corresponding relative
    property will have no effect.

そのため、このような場合には XSL Formatter は margin プロパティを採用します。他社のソフトウェアとは結果が異なる場合があります。

サンプルFO：

<fo:list-item>
  <fo:list-item-label text-align="end" end-indent="label-end()">
    <fo:block>1.</fo:block>
  </fo:list-item-label>
  <fo:list-item-body start-indent="body-start()">
    <fo:block-container>
      <fo:table start-indent="0pt">
        <fo:table-body>
          <fo:table-row>
            <fo:table-cell>
              <fo:block>fo:table start-indent="0pt"</fo:block>
            </fo:table-cell>
          </fo:table-row>
        </fo:table-body>
      </fo:table>
    </fo:block-container>
  </fo:list-item-body>
</fo:list-item>

この場合、fo:block-container には fo:list-item-body の start-indent が継承されます。そして、fo:table に指定された start-indent はこの fo:block-container によって生成された参照エリアの中で有効です。したがって、この参照エリアはインデントされているので、結果として fo:table の開始辺は fo:list-item-body の start-indent="body-start()" の位置になります。
fo:block-container に start-indent="0pt" を指定した場合は、参照エリアのインデントがリセットされます。

#x0A コードはあくまでも通常の文字コードとして処理されます。そして linefeed-treatment プロパティによって U+0020(space) に変換されます。もし #x0A にて改行処理を行いたいときは、fo:block に linefeed-treatment="preserve" を指定してください。

W3C Recommendationには次のように書かれています。

7.29.23 "white-space"

CSS2 Definition:
......
The CSS property shall be treated as a shorthand by XSL and maps as follows:
pre
    linefeed-treatment="preserve"
    white-space-collapse="false"
    white-space-treatment="preserve"
    wrap-option="no-wrap"

white-space="pre" というのは次のこの４つを指定するのと同じ(Shorthandプロパティ)です。wrap-option="no-wrap" が含まれているので、行の折り返しはしなくなります。

下記の指定では行は折り返しません。

<xsl:attribute name="white-space">
pre
</xsl:attribute>

次のように指定してください。

<xsl:attribute name="linefeed-treatment">
preserve
</xsl:attribute>

<xsl:attribute name="wrap-option">
wrap
</xsl:attribute>

fo:character が間違った使い方をされています。fo:character は1文字を指定するものであるのに、複数文字が指定されています。

<fo:character character="Glossary "/>
や
<fo:character character=", "/>  （コンマとスペースの2文字）など。

これらは、XSL の仕様上、誤りです。この現象を避けるには、複数文字の fo:character を、fo:character を使用しないテキストに直してください。

スタイルシートを拝見しましたら、次のように指定されていました。

<fo:block  position="absolute" top="10mm" right="30mm">
     This text should be positioned ?
</fo:block>

position="absolute" プロパティは fo:block には指定できません。fo:block-container に指定してもらう必要があります。次のように指定してください。

<fo:block-container  position="absolute" top="10mm" right="30mm">
   <fo:block>This text should be positioned ?</fo:block>
</fo:block-container>

これは white-space-collapse プロパティが規定値で true であるためです。 white-space-collapse="true" もしくはプロパティ自体を指定しなかった場合は、連続した空白はひとつの空白に置き換えられます。これを回避するためには次のように white-space-collapse="false" を指定する必要があります。

<fo:block white-space-treatment="preserve"
linefeed-treatment="preserve" white-space-collapse="false">
  apple
      4, 7, 7, 12
</fo:block>

"block-progression-dimension" および "reference-orientation" は fo:block には適用されません。fo:block-container を使う必要があります。

word-space を狭くするのであれば、"word-spacing" と "word-spacing.precedence" にはマイナス値を指定する必要があります。デフォルト値のスペース量は使用しているフォントのスペース文字の幅になります。ちなみに Times New Roman などの欧文フォントでは 0.25em であることが多いようです。

狭いカラムで単語間のアキが大きくなるというのは、ある程度避けられないことです。XSL Formatter では、justify で文字間まで広げるということはしていませんので、スペースが目立つ場合があります。また hyphenation="true" としても、単語を分割できるところは限られているので、限界があります。ご了承ください。

改行させるにはfo:blockで囲むか、fo:blockにlinefeed-treatment="preserve"を指定して、改行したい位置に#x0A（改行コード）を指定すれば改行されます。

FOを見ると次のようになっています。

<fo:simple-page-master master-name="master"
     page-height="11in"
     page-width="8.5in">
<fo:region-body/>
        .
  <fo:region-start extent="0.5in"/>
        .
</fo:simple-page-master>
        .
        .
        .
<fo:static-content flow-name="xsl-region-start">
  <fo:block-container reference-orientation="90">
    <fo:block text-align="center">
      content text.
    </fo:block>
  </fo:block-container>
</fo:static-content>

block-containerにサイズの指定がない場合、block-containerのreference-areaのサイズは、自動的に内容の大きさ（幅）になります。よって'text-alain="center"'の効果はありません。そしてこのreference-areaはregion-reference-areaのbefore-edge側に配置されます。もし、中央に配置したい場合は、fo:region-startに display-align="center"を指定してください。

送られてきたファイルは次のようになっています。

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
<fo:layout-master-set>
<fo:simple-page-master master-name="master1"
        page-height="11in"
        page-width="8.5in">
<fo:region-body/>
<fo:region-after extent="0.5in"/>
<fo:region-before extent="0.5in"/>
<fo:region-start extent="0.5in"/>
<fo:region-end extent="0.5in"/>
</fo:simple-page-master>
</fo:layout-master-set>

<fo:page-sequence master-reference="master1" font-size="12pt">
   ...
<fo:flow flow-name="xsl-region-body" display-align="center">
   ...
<fo:block-container
              writing-mode="tb-rl"
              inline-progression-dimension="20%"
              block-progression-dimension="100%">
<fo:block>
      This is a content.
      This is a content.
      This is a content.
</fo:block>
</fo:block-container>
</fo:flow>
</fo:page-sequence>
</fo:root>

エラーがでるのは、fo:block-containerにblock-progression-dimension="100%"と設定しているためです。
用紙の高さが11inch、幅が8.5inch、region-bodyのマージンはゼロです。ページの方向は指定なしなのでデフォルトでlr-tbとなります。fo:block-containerでwriting-modeをtb-rlにしているので、block-progression-dimentionはブロックコンテナの左右のサイズになります。

XSL Formatter V2.3改訂１版までは、block-progression-dimensionを比率で指定すると、最も近い先祖の対応寸法から計算します。
すなわち、flowの直下にblock-containerがあるので、ページのblock-progression- dimensionから算出することになります。ページのwriting-modeはlr-tbなので、 ページのblock-progression-dimensionは11inchで、その100%と指定したことになり ます。実際のページの幅は8.5inchなので、11inch幅のブロックコンテナを配置しよ うとしてoverflowのエラーになります。

このように回転した場合にパーセント値の基準をどこから取得するべきかは、XSL仕様では明確ではありません。将来のバージョンでは、パーセント値の基準のと り方を変更するかもしれません。参照エリアを回転している場合、その大きさにパーセント値を指定することは避けるようにしてください。

fo:block-container の途中での改ページができないというのは、XSL Formatter V2 の制限事項です。

XSL Formatter V3 にはこの制限はありません。

この問題は XSL Formatter V2.3までの不具合でした。
送られてきた FO は次のようになっていました。

<fo:list-item>
    <fo:list-item-label>
        <fo:block text-align="end"> 1 </fo:block>
    </fo:list-item-label>
    <fo:list-item-body>
        <fo:block space-after="1.0em"> aaa </fo:block>
    </fo:list-item-body>
</fo:list-item>

<fo:list-item>
    <fo:list-item-label>
        <fo:block text-align="end"> 2 </fo:block>
    </fo:list-item-label>
    <fo:list-item-body>
        <fo:block space-after="1.0em"> bbb </fo:block>
    </fo:list-item-body>
</fo:list-item>

<fo:list-item>
    <fo:list-item-label>
        <fo:block text-align="end"> 3 </fo:block>
    </fo:list-item-label>
    <fo:list-item-body>
        <fo:block space-after="1.0em"> ccc </fo:block>
    </fo:list-item-body>
</fo:list-item>

この FO で、"aaa" の list-item と "bbb" の list-item の間で改ページが発生した場合、"bbb" の fo:block で指定した space-after="1.0em" が無視されてしまいました。
この問題は、発見当初 XSL Formatter の不具合として処理してきました。 これは list-item内のspaceingに関して、通常のblockのspace resolution ruleを適用していたためです。
しかし XSL Formatter V2.4ではlist-item のスペースの仕様解釈を修正しました。XSL仕様の 6.8.3 fo:list-item に従って、list-item 内の block に指定された space-before、space-after は改ページに関わらず全て無視されます。
したがって、V2.3以前と結果が異なる場合があります。ご了承ください。
なお、下記のように space-after を fo:block ではなく fo:list-item に指定すれば、スペースの を付けることができます。

<fo:list-item space-after="1.0em">
    <fo:list-item-label>
        <fo:block text-align="end"> 1 </fo:block>
    </fo:list-item-label>
    <fo:list-item-body>
        <fo:block> aaa </fo:block>
    </fo:list-item-body>
</fo:list-item>

これはXSLの仕様です。'text-decoration' は text content だけに有効なプロパティです。text content ではないスペースには適応されません。次のW3C仕様書を参考にしてください。

--------------------------------------------------
7.16.4 "text-decoration"
CSS2 Definition:

... If the element has no content or no text content (e.g., the IMG
element in HTML), user agents must ignore this property.

これはできません。
list-blockの位置は 6.8 Formatting Objects for Lists に記述されているように、indentで決定されますので、list-blockにtext-alignの指定はできません。
そして text-align は、CSS 規約の 16.2 Alignment: the 'text-align' property に、'This property describes how inline content of a block is aligned. 'と記述されています。
したがって、含まれたblocklevel objectの整列をするものではありません。
例えば、

<fo:block text-align="center">
<fo:list-block>…

と、指定しても、text-alignが適用されるのは、list-item-labelとlist-item-bodyの中のinline contentsになります。

各値の基準は、その fo:block-container の外側エリアの、次の位置からになります。

• top : 外側エリアの'上端からの'オフセット
• bottom : 外側エリアの'下端からの'オフセット
• right : 外側エリアの'右端からの'オフセット
• left : 外側エリアの'左端からの'オフセット

<fo:float float="outside">
<fo:block>* THIS IS A FLOAT *</fo:block>
</fo:float>

<fo:block  intrusion-displace="block">
<fo:block>
    First Block
</fo:block>
<fo:block>
    Second Block
</fo:block>
<fo:block>
    Third Block
</fo:block>
</fo:block>

上記のようなFOで、"Second Block" において改ページが発生した場合、 "Third Block" の intrusion-displace="block" が有効になりません。
また、これに関連して、fo:float に float="inside/outside" を指定して、 fo:block に intrusion-displace="block" の指定があった場合にこの block で改ページが発生しても side の切り替えが行われないことがあります。
この問題は XSL Formatter V2 の制限事項です。

XSL Formatter V3.1 にはこの制限はありません。

XSL-FO仕様ではリストにspanプロパティを指定することはできません。したがって、メッセージの内容が間違っています。
この問題につきましては XSL Formatter V2.5 改訂３版 にて修正されました。

これは幅が指定された fo:block-container の中の fo:page-number の出力する幅が不足した場合に発生します。
この問題につきましては XSL Formatter V2.5 改訂３版 にて修正されました。

<fo:block/> は inline エリアを生成しません。したがって、それがいくら連続しても空白行にはなりません。 fo:block により inline エリアが生成されるためには、fo:block の中に inline のエリアを生成する FO あるいはテキストが含まれている必要があります。 <fo:block>&#xA0;</fo:block> ならば空白行になります。

この問題につきましては XSL Formatter V2.5 改訂３版 にて修正されました。

<fo:block>3&#x200C;</foblock> や <fo:inline>aa&#x200C;</fo:inline> などが含まれている場合にこの現象は発生します。
この問題につきましては XSL Formatter V2.5 改訂３版 にて修正されました。

keep-together.within-page="always" が指定されたブロック内で改段または改ページが発生したときにこの問題が発生します。
この問題は XSL Formatter V2 の制限事項です。

XSL Formatter V3 はこの制限はありません。

keep-together="always" は、以下の指定と同じ意味になります。

 keep-together.within-line="always"
 keep-together.within-colums="always"
 keep-together.within-page="always"

keep-together.within-line="always" が指定された場合、XSL Formatter はハイフネーションを行いません。 これは改行されない行でのハイフネーションは必要ないからです。
XSL-FOの仕様上、keep-together="always" は子要素に継承されるべきですが、XSL Formatter V2 は継承しません。 これは XSL Formatter V2 の制限です。
keep-together.within-line/.within-columns/.within-page のように指定した場合は問題ありません。または、以下のように fo:block の内容を fo:inline で囲むことで継承されます。

<fo:block keep-together="always">
    <fo:inline>
        Sample Contents....
    </fo:inline>
</fo:block>

なお、XSL Formatter V3 には keep-together="always" の継承の制限はありません。

行頭および行末の空白の扱いについては、V2/V3.0/V3.1R1 と V3.1MR1 とで扱いが異なります。

V2/V3.0/V3.1R1 における行頭および行末の空白の扱いについては、suppress-at-line-break プロパティで指定されます。

• http://www.w3.org/TR/xsl/slice7.html#suppress-at-line-break

suppress-at-line-break の初期値は "auto" です。このとき、U+0020 は "suppress" が指定されたものとして扱われます。 結果として、エリアは生成されません。

行頭/行末の空白を残すには、以下のように usage-context-of-suppress-at-line-break="ignore" を 指定してください。

<fo:block white-space-collapse="false" usage-context-of-suppress-at-line-break="ignore">
     &#x0020;
</fo:block>

usage-context-of-suppress-at-line-break (UCSLB) は、Errata in REC-xsl-20011015 で定義されました。

• http://www.w3.org/2001/10/REC-XSL-20011015-errata

現在の XSL 1.0 Errata は suppress-at-linebreak と white-space-treatment の仕様が変更され、usage-context-of-suppress-at-line-break は廃止されました。当時は以下の仕様が定義されていました。

7.16.4 "usage-context-of-suppress-at-line-break"
XSL Definition:

Value:  auto | observe | ignore | inherit
Initial:  auto
Applies to:  fo:block, fo:inline, fo:page-number, fo:page-number-citation
Inherited:  yes
Percentages:  N/A
Media:  visual

This property specifies the usage context of the character property
"suppress-at-line-break". It specifies if this character property
should apply or not.

Values for this property have the following meanings:

auto
If the value of the "wrap-option" trait on the current formatting
object to which the "usage-context-of-suppress-at-line-break"
applies is "no-wrap", the "auto" value specifies the same processing
of descendant fo:character formatting objects as if "ignore" had been
specified for the "usage-context-of-suppress-at-line-break" property.
Otherwise it specifies the same processing of descendant fo:character
formatting objects as if "observe" had been specified for the
"usage-context-of-suppress-at-line-break" property.

observe
Specifies that descendant fo:character formatting objects should be
treated using the computed value of the "suppress-at-line-break" property
of the fo:character formatting object.

ignore
Specifies that descendant fo:character formatting objects should be
treated as if the "suppress-at-line-break" property of the fo:character
formatting object had the value "retain".

これにより、suppress-at-line-break (SLB) プロパティは以下のように制御されます。

R: 空白は残ります

D: 空白は削除されます

XSL Formatter では suppress-at-line-break が未実装のため、初期値 "auto" の処理を行います。
しかし実装された場合でも、このプロパティの適用対象は fo:character であり、継承されないので、fo:block に指定することができません。 したがって、以下のように明示的に fo:character を使って指定する必要があります。

<fo:block>
    <fo:character character="' '" suppress-at-line-break="retain"/>
</fo:block>

XSL Formatter は usage-context-of-suppress-at-line-break を実装しています。 usage-context-of-suppress-at-line-break="ignore" とすると、 suppress-at-line-break="auto" による空白除去は起きなくなります。

XSL Formatter V3.1MR1 以降では、最新の XSL 1.0 Errata と XSL 1.1 WD の仕様に適合するように、 white-space-treatment および suppress-at-line-break の処理を変更しました。行頭行末の空白を残すためには white-space-treatment="preserve" を指定すればよいようになりました。 usage-context-of-suppress-at-line-break は互換のために残していますが、その値が auto の場合の動作は observe と同じです。（以前は auto のとき wrap-option="no-wrap" ならば ignore として扱われました）もし、usage-context-of-suppress-at-line-break="ignore" が指定されていれば、以前と同様に行頭行末の空白を残します。

スペースの扱いには、XSL-FO仕様に以下のような記述があります。

7.16.7 "treat-as-word-space"
...
auto
The value of this property is determined by the Unicode code point for
the character.

As the default behavior:

The characters at code points U+0020 and U+00A0 are treated as if 'true'
had been specified. All other characters are treated as if 'false' had
been specified.

This property does not automatically apply word spacing to the fixed
spaces (U+2000 through U+200A) or the ideographic-space (U+3000).

XSL Formatter は均等割り付けの場合のスペースの扱いもこれに従っていますので、全角空白は半角空白と異なり、全角１文字として処理されるため均等割り付けの対象にはなりません。
また、行頭／行末に全角空白が来た場合も半角空白とは異なり削除されません。 行頭および行末の半角空白の扱いについては [No.2003101601] を参照してください。

ハイフネーション処理はハイフネーション辞書によって処理されます。
ハイフネーション辞書はFOPとコンバーチブルなXML形式です。既存のTeXハイフネーション辞書から、このXMLファイルに変換して、XSL Formatterのhyphenationフォルダに保存することで機能します。
著作権の関係でXSL Formatterは英語辞書しか付属していません。よって英語以外の辞書はユーザーが用意する必要があります。
例えば、スペイン語の場合は以下のようにします。

1. 既存のスペイン語用TeXのハイフネーション辞書をFOPのXML形式に変換する。 （これは手作業になります。XMLファイルの解説がオンラインマニュアルにありますので、hyphenation.dtdと併せて参照してください）
2. このXMLファイルを es.xml として、XSL Formatter の hyphenationフォルダに保存する。（encodingはUTF-8かUTF-16にしてください）
3. ハイフネーションを行わせるには明示的にFOに言語とハイフネーションを指定する。

   <fo:block xml:lang="es" hyphenate="true">
   ...
   </fo:block>
   

4. 組版を実行する。

なお、アンテナハウス株式会社は「XSL Formatter V2」に組み込むことにより、40言語以上のハイフネーションを行なうためのオプション「XSL Formatter ハイフネーションオプション」を用意しています。
XSL Formatter ハイフネーションオプション は、XSL Formatter V2.5(改訂２版) 以降で、40言語以上のハイフネーション処理を可能にする拡張オプションです。綴りの変化するハイフネーションにも対応しています。
詳しくは弊社Web「XSL Formatter ハイフネーションオプション」をご覧ください。

Soft Hyphen という特殊文字で、"&#xAD;"を挿入することで可能です。

func­tio­nality

"&#xAD;" は通常は表示されませんが、そこで分割されるとハイフンに変化してハイフネーションされます。

例を挙げて説明します。 次のFOではこのような問題が起きます。

<fo:block font-size="8pt">
<fo:float float="start">
<fo:block>
<fo:inline font-size="30pt">H</fo:inline>
</fo:block>
</fo:float>ere, we have a crop cap that should be 3-lines high.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
</fo:block>

上記のFOを修正してみました。

<fo:block font-size="8pt">
<fo:float float="start">
<fo:block space-after="-8pt" space-after.conditionality="retain">
<fo:inline font-size="30pt">H</fo:inline>
</fo:block>
</fo:float>ere, we have a crop cap that should be 3-lines high.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
Now is the time for all good men.
</fo:block>

ポイントは'space-after="-8pt"'で、これはfloatの中のBlockオプジェクトの空白の後ろを削除するものです。 そして、'space-after.conditionality="retain"'はspace-afterに指定して、referenceエリアのafter-edgeに有効なのです。
なお、space-before/after というのはreferenceエリアのstart/after-edgeで無視されます。なぜならばspace-before/after-conditionalityのデフォルト値は"discard"（無視）だからです。

fo:floatの幅は、その内容により決まります。XSL-FO 仕様に次のようにありま す。

6.10.2 fo:float
...
Side-floats derive their length in the inline-progression-dimension
intrinsically from their child areas; the length is not determined by an
explicit property value.

しかし、XSL-FO 仕様ではside-floatの内容が幅をもたない場合のことが規定されていません。

Side-floats derive their length in the inline-progression-dimension
intrinsically from their child areas

という文章からはfo:float の内容は、行の折り返しのある段落であるということは想定されていないかのようです。

fo:float に直接 inline-progression-dimension (width) を指定できない仕様ですので、このような場合の対処方法としては、fo:float 内に fo:block-container を入れて、inline-progression-dimension を指定してください。

例を挙げてみます。次のようなFOを記述した場合、本文エリアのテキストとfloat内のテキストが、隣同士になってしまいます。

<fo:float float="start"><fo:block-container>
<fo:block border-style="solid" border-color="black" border-width="1pt">
<fo:block  start-indent="1em" text-align="justify">
    フロートその１です。フロートその１です。フロートその１です。
</fo:block>
</fo:block>
</fo:block-container>
</fo:float>

そこで、下記のようにfloatの子要素のblockにインデントを指定することで、間をあけることができます。

例では「fo:float float="start"」ですので、子要素のblock-containerに「end-indent」を指定します。

<fo:float float="start">
<fo:block-container end-indent="1em">
<fo:block border-style="solid" border-color="black" border-width="1pt">
<fo:block  start-indent="1em" text-align="justify">
    フロートその１です。フロートその１です。フロートその１です。
</fo:block>
</fo:block>
</fo:block-container>
</fo:float>

下記は「fo:float float="end"」に、「start-indent」を指定しています。注意する点ですが、block-containerにstart-indentを指定していますが、その子要素のblockで再度start-indentによって文字揃えを行っています。このままですと、block-containerで指定したstart-indentの継承が切れてしまいますので、inheritを使用して以前のインデント値を加えています。

<fo:float float="end">
<fo:block-container start-indent="1em">
<fo:block border-style="solid" border-color="black" border-width="1pt">
<fo:block start-indent="1em+inherit" text-align="justify">
    フロートその２です。フロートその２です。フロートその２です。
</fo:block>
</fo:block>
</fo:block-container>
</fo:float>

fo:float の後にテキストがあり、block に intrusion-displace="block" が指定されている場合、intrusion-displace="block" が適用されないことがあります。
例:

<fo:block intrusion-displace="block">
    <fo:float float="end">
        <fo:block>float text</fo:block>
    </fo:float>
Sample Text Sample Text
</fo:block>

以下のようにテキストの部分を fo:block で囲むことで回避が可能です。

<fo:block intrusion-displace="block">
    <fo:float float="end">
        <fo:block>float text</fo:block>
    </fo:float>
<fo:block>Sample Text Sample Text</fo:block>
</fo:block>

この問題は XSL Formatter V2 の制限事項です。

XSL Formatter V3.1 にはこの制限はありません。

プロパテイの継承関係を指定するのに便利です。 例えば fo:block-container の中のたくさんの子のブロックに同じインデントを設定したいというときに

<fo:block-container>
  <fo:wrapper start-indent="..." end-indent="...">
    <xsl:apply-templates/>
  </fo:wrapper>
</fo:block-container>

のようにします。インデントを fo:block-container に指定してしまうと、block-container 自体がインデントして、子のブロックもさらにインデントしてしまいますので注意してください。
fo:wrapperにnon-inheritableプロパティを指定して、子から from-parent() ("inherit" も同じ) で参照させるという使い方もあります。
fo:wrapper にそのプロパティの指定がない場合は、初期値が指定されているのと同じことになるので、結果として「遮断」しているように見えるかもしれません。

<fo:flow border-before-style="solid">
  <fo:wrapper>
    <fo:block border-before-style="inherit">
The "inherit" value is none.

<fo:flow border-before-style="solid">
  <fo:wrapper border-before-style="inherit">
    <fo:block border-before-style="inherit">
The "inherit" value is solid.

これはインデントに限ったことではありません。意図しない書式になってしまう原因の大半は「継承」による問題です。まずは「継承」を疑ってみてください。
まずは、W3C Recommendationにて親要素のプロパティが「継承されるものか」「されないものか」を確認してください。
親要素に指定されたプロパティには継承されるモノとされないモノがあります。継承されるプロパティは子要素にも反映されます。大抵は、この反映された結果が「意図しない書式」として表示されています。
そして、継承させたくない場合は、そのプロパティをリセット（０値を指定する等）して、継承を終わらせる必要があります。

W3C Recommendation
http://www.w3.org/TR/2001/REC-xsl-20011015/

V2.2までは、axf:suppress-duplicate-page-number の仕様による制限で fo:page-number-citation どうしは「兄弟関係」にあることが条件でした。basic-link で囲むと「兄弟関係」ではなくなるためです。しかし、V2.3からはこの制限をなくしました。よってこの場合でも問題なく重複ページ除去が行えます。

XSL Formatter は全てのデータをPDFに埋め込んでいます。しかし、PDFの仕様書には、Acrobat が ダイアログの表示を 255バイトに制限している、との記載があります。
PDFの文書情報は、 PDFDocEncoding(ASCII相当) か Unicode で格納する必要があります。 XSL Formatter は全て Unicode で格納しているため、Acrobat で文書情報を見た場合に途中までしか表示されない場合がありました。

XSL Formatter V2.5 PDF出力オプション改訂２版で、PDFDocEncoding だけで表現可能な文字のみの場合、PDFDocEncodingで出力するように変更しました。この場合も、Acrobatの制限を越える場合は、途中までの表示となります。

XSL Formatter V3 の拡張仕様には、axf:background-image があります。この拡張プロパティを使って、背景画像を指定することにより透かしを入れることが可能です。

組版サンプルページのグラフィックスの見本にSVGを使ったサンプルがあります。

XSLTで変換する際、本XML文書で、目次に出力したい項目を取り出すことで目次を出力できます。目次のページ番号の出力方法は、サンプルを参照してください。

残念ながら、XSL Formatterでは不可能です。将来のバージョンにて対応できるか検討中です。

スタイルシート内の自動番号生成で、 <xsl:number format="&#x30A4;" /> とするとイロハ順に番号生成ができます。

XSLTの仕様書7.7.1 Number to String Conversion Attributes
format="ア" specifies Katakana numbering
format="イ" specifies Katakana numbering in the "iroha" order

と、書かれていますのでご参考にしていただければと思います。 ただしXSLTプロセッサがサポートしている必要があります。 弊社では MSXML4 にて可能であることを確認しています。

XSL-FOには次のようになっていました。

<fo:table-cell margin-top="10pt" margin-bottom="10pt" font-weight="bold">
  <fo:block text-align="justify" keep-together="always">
    アーク放電
  </fo:block>
  <fo:block text-align="justify" keep-together="always">
    <fo:inline font-weight="bold">
      気体放電の一つ。電流が両極間の気体中を大きな密度で流れ、強い発熱と発光を伴う。
    </fo:inline>
  </fo:block>
</fo:table-cell>

fo:block に keep-together="always" が指定されています。keep-together は 'within-page'、'within-column'、'within-line' のコンポーネントを持っていますので、keep-together="always" とすると、この３つに "always" を指定したことになり、keep-together.within-line="always"となります。
そして、この指定は fo:inlineに継承されます。
したがって、fo:inline の文字を１行で表そうとしますので、結果、テーブルセル幅が広がり、ページ幅によってはテーブルセルがはみ出してしまうのです。
このような場合は次のように、keep-together.within-page="always" と指定すればページ幅内に収まるでしょう。

<fo:table-cell margin-top="10pt" margin-bottom="10pt" font-weight="bold">
  <fo:block text-align="justify" keep-together.within-page="always">
    アーク放電
  </fo:block>
  <fo:block text-align="justify" keep-together.within-page="always">
    <fo:inline font-weight="bold">
      気体放電の一つ。電流が両極間の気体中を大きな密度で流れ、強い発熱と発光を伴う。
    </fo:inline>
  </fo:block>
</fo:table-cell>

XSLスタイルシートにスクリプトを使用すれば可能です。（ただしこれはXSLTの拡張機能ですので、XSLTプロセッサに依存します。ご注意ください）
XSLT プロセッサに MSXML を使用する場合、下記のようなXSLスタイルシートを作成することで、XSL-FOに日付を埋め込むことができます。

<xsl:stylesheet version="1.0"
    xmlns:fo="http://www.w3.org/1999/XSL/Format"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:msxsl="urn:schemas-microsoft-com:xslt">
    <!-- msxsl:script 年月日の取得 -->
    <msxsl:script language="JScript" implements-prefix="user">
        function date(nodelist) {
            var DateObj = new Date()
            return DateObj.getFullYear() + "年" +
                    (DateObj.getMonth() +1 )+ "月" +
                        DateObj.getDate() + "日";
        }
    </msxsl:script>

-----中略----

        <!-- 作成日の出力 -->
    <fo:block text-align="right">
        作成日：<xsl:value-of select="user:date()"/>
    </fo:block>

FOは次のようになっていました。

<fo:page-sequence-master master-name="PageMaster">
    ...
    <fo:conditional-page-master-reference master-reference="last-page-left"
        odd-or-even="even" blank-or-not-blank="not-blank" page-position="last"/>

    <fo:conditional-page-master-reference master-reference="blank-page"
        odd-or-even="even" blank-or-not-blank="blank" page-position="last"/>
</fo:page-sequence-master>
    ...
<fo:page-sequence master-reference="PageMaster" force-page-count="end-on-even">
    ...
    <fo:static-content flow-name="first-and-rest-footer">
        <fo:block>
            Total number of pages = <fo:page-number-citation ref-id="LastPage" />
        </fo:block>
    </fo:static-content>
    <fo:static-content flow-name="last-page-left-footer">
        <fo:block id="LastPage" />
    </fo:static-content>
    <fo:static-content flow-name="blank-page-footer">
        <fo:block id="LastPage-blank" />
    </fo:static-content>
    ....

page-position="last" が指定されたページが２つあります。 そして、総ページ数、つまり最終ページのページ番号を参照するIDは、片方のみのページにあるblockのIDを示しています。
このページマスタが使用された場合、最終ページはmaster-reference="last-page-left"またはmaster-reference="last-page-left"のいずれかになります。 どちらが使用されるかは、fo:page-sequenceのforce-page-countの値に影響されます。
force-page-count="end-on-even"の指定があってfo:flowのcontensが偶数ページで終了した場合、最終ページのレイアウトはmaster-reference="last-page-left"が使用され、<fo:page-number-citation ref-id="LastPage" />はページ番号が出力されます。 しかし、fo:flowのcontensが奇数ページで終了した場合は偶数ページが追加され、最終ページのページレイアウトはmaster-reference="blank-page"が使用されます。
このため、fo:page-number-citationの参照先は存在しないことになり、ページ番号は出力されません。
XSL Formatterはページ番号が得られない時、"***"を出力します。

xsl:scriptはXSLT1.1で追加された仕様です。 お使いのXSLTプロセッサがサポートしているかどうかを確認してください。 XSL FormatterはデフォルトでMSXMLを使用します。
MSXMLはxsl:scriptをサポートしていませんが、拡張要素としてmsxsl:scriptがあります。
詳しい使い方はMSXML SDKをご覧ください。

text-transformプロパティを使用すれば、文字を変換させることができます。
XSL-FO仕様の7.16.6 "text-transform"を参照してください。

XSL-FO仕様には次のように書かれています

6.6.11 fo:page-number-citation
The fo:page-number-citation is used to reference the page-number for
the page containing the first normal area returned by the cited
formatting object.

fo:wrapper はエリアを生成しないので、fo:page-number-citation の参照先にすることはできません。

この問題はV2.4改訂１版までの不具合でした。 この問題はV2.5で修正されました。

"scale-to-fit" は指定された width/height に従って画像のサイズを拡縮します。width/height が指定されていない場合は画像のオリジナルサイズにて表示されます。width/height を指定してください。

これは、XSL Formatter V2.5 の不具合でした。XSL Formatter V2.5 改訂２版にて修正されましたので、ご利用の XSL Formatter のバージョンを確認していただき、最新の XSL Formatter にアップデートしてください。

これはXSL仕様に準拠しているかどうかという大きな問題です。アンテナハウスはXSL仕様を実装していますが、一方RenderXはこれを実装していないことがwebに記載されています。詳細は次をご覧ください。

> 私はアンテナハウスのFormatterは脚注が置かれるブロックからstart-indent= propertyを継承し
> ていることに気が付きました。
> 一方RenderXは継承しておりません。

RenderXの"未実装"の事項です。 http://www.renderx.com/Tests/doc/html/spec.html#N4831

| XEP 2.7 には XSL1.0 Recommendation を実装していない事項が掲載されています。（以下引用文）
...
| Inherited properties on <fo:footnote-body> and <fo:float> elements
|     In the XSL 1.0 Recommendation, <fo:footnote-body> and <fo:float>
|     obey to common inheritance rules. It implies that they get
|     inherited properties from the anchor point -- despite being
|     formatted into a separate area. This scheme turned out to be
|     extremely unpractical: footnotes/floats would inherit font
|     attributes from inline elements, keep-together constraints from
|     headings, indents from lists etc. To ensure that footnotes and
|     floats look uniformly in the XSL Recommendation model, a
|     stylesheet writer would have to care to specify an explicit
|     value for virtually every inhertable property on each
|     <fo:footnote-body>/<fo:float>.
|
|     In this situation, we could not help sacrifying conformance to
|     usability. In XEP 2.7 as in previous versions of XEP, out-of-line
|     elements inherit properties from their ancestor <fo:flow>, thus
|     introducing a kind of "region-to-region" inheritance -- from
|     body-region to its conditional subregions.

XSL仕様書によると

| 5.1.4 Inheritance
| ... The inheritable properties are propagated down the formatting
|object tree from a parent to each child. ...

予期しない継承を防ぐためには、すべてのfo:footnote-bodyに、継承プロパテイ(start-indent="0pt" text-align="start" etc.)を指定しなければなりません。

> しかし text-decoration= inheritable property のところで、
> 子孫である<footnote-body> からは継承されないことに
> 注意してください。

text-decoration は継承先プロパテイではないので、継承されません(仕様書 7.16.4 "text-decoration"を参照)

質問のFOは下記のようになっています。

<fo:flow flow-name="xsl-region-body">
    <fo:block>
        block
    </fo:block>
    <fo:block-container reference-orientation="90" >
        <fo:block-container reference-orientation="-90" >
            <fo:block>
                nest block-container
            </fo:block>
        </fo:block-container>
    </fo:block-container>
</fo:flow>

つまり、reference-orientationを指定したfo:block-containerを置き、この中に再度reference-orientationを指定したfo:block-containerがあります。reference-orientationが親側のfo:block-containerにだけある場合は、１ページに'block'と'nest block-container'が収まりますが、上記のFOではそれぞれ分かれてしまい、計２ページになってしまいます。
まず、fo:block-container が reference-orientation="90" などで回転していて、block-progression-dimension, inline-progression-dimension が auto (=指定なし)の場合、どのようにして reference-area の大きさを決めるべきかというのが、XSL-FO 仕様では明確でありません。（このため、その解釈の違いが XEP との組版結果の違いなどになる場合があります）

アンテナハウスの XSL Formatter は次のように処理しています。

<fo:block-container reference-orientation="90">

この block-containerにはblock-progression-dimension も inline-progression-dimension も指定がありません。XSL Formatter ではこの場合、９０度回転しているので、reference-area のblock-progression-dimension のサイズは、外側（つまりregion-body）のreference-area の inline-progression-dimension のサイズと同じになります。
そして、inline-progression-dimension のサイズは外側（つまりregion-body）のblock-pregression-dimensionを'仮'として設定して、block-container の内容を組版した後、その結果にて inline-progression-dimension を調整しています。
しかし次のようにfo:block-containerがネストされています。

<fo:block-container reference-orientation="-90">

ネストした fo:block-container が中にあるとき、このblock-containerの幅は先ほどの'仮の inline-progression-dimension' を使用してblock-containerの大きさが決まってしまいます。
したがって、fo:block-container がつくる reference-area の大きさは、それだけで region-body のエリアがいっぱいになってしまうものになり、改ページして、次のページに表示します。

解決方法は、このようにネストして回転してるような fo:block-container を使うときは必ずfo:block-container にblock-progression-dimension,inline-progression-dimension を指定してください。

XSL Formatter V2.3改訂１版までは、block-progression-dimension を比率（パーセント）で指定すると、最も近い先祖の対応寸法から計算します。このとき 参照エリアを回転させていても、block-progression-dimension, inline-progression-dimension は最も近い先祖のblock-progression-dimension, inline-progression-dimension の比率をサイズとします。
しかし、このように回転した場合にパーセント値の基準をどこから取得するべきかは、XSL仕様では明確ではありません。将来のバージョンでは、パーセント値の基準のとり方を変更するかもしれません。参照エリアを回転している場合、その大きさに比率（パーセント）で指定することは避けてください。

XSL Formatter は仕様に準拠しています。
W3C XSL-FO 仕様 7.27.7 "writing-mode" には次のように書かれています。

When "writing-mode" is applied to the simple-page-master, it is used to
determine the placement of the five regions on the master.

ですから、ご指摘のように writing-mode が fo:simple-page-master に指定された場合、５つのリージョン（fo:region-body,fo:region-before,fo:region-after,fo:region-start,fo:region-end）の位置に影響します。
次に、writing-mode は、inheritable なプロパティとなっています。したがって、fo:simple-page-master に writing-mode の指定があれば、その子供であるfo:region-* に継承されます。つまり region-* にも writing-mode を指定したことになります。
region-*にwriting-modeを指定した場合のXSL-FO仕様には、次のように書かれています。

When "writing-mode" is applied to the fo:region-*, it defines the
column-progression within each region. The inline-progression-direction
is used to determine the stacking direction for columns (and the default
flow order of text from column-to-column).

XEP では fo:region-body に writing-mode を指定した場合、region-body の column-progression-direction だけが変更され、region-body の block-progression-direction / inline-progression-direction には影響しません。
しかし、XSL Formatter は fo:region-body に writing-mode を指定した場合、region-body の column-progression-direction を変更し、 block-progression-direction と inline-progression-direction も変更しています。
XSL-FO仕様の説明文で「it defines the column-progression within each region.」となっていますので誤解されたと思いますが、only column とはなっていません。説明文の前提となる、writing-mode の定義の本文には、block-progression-direction / inline-progression-direction / shift-direction が変化すると書いてあります。
XSL-FO仕様では fo:flow にも fo:page-sequence にも writing-mode プロパティは指定できません。fo:block なども同じです。
writing-mode は reference-area に対して設定されますので、reference-area を定義する FO (fo:region-body, fo:block-container など)に適用されるようになっています。reference-area 内の area は基本的に reference-area の writing-mode を受け継ぎます。
region-reference-area や normal-flow-reference-area の writing-mode を定義するのは fo:region-body です。その内容の block-area などの writing-mode も同じになります。
これは XSL-FO 仕様の FO ツリーでの継承モデルと矛盾するようですが（FOツリー上で、fo:region-body は flow の内容の fo:block などの ancestor ではないのに、その writing-mode が影響する）、writing-mode は reference-area の性格を定義するものなので特別なのだろうと弊社では解釈しています。
もし、そうでなければ normal-flow-reference-area の writing-mode を fo:flow にも指定できるようになっていなければなりません。しかしこれを行った場合、縦書き用の段組の中のフローがすべて横書きになってしまうなど、問題が発生します。したがって、このような仕様にはなっていないと思われます。
また、XSL-FO仕様のwriting-modeには次のような説明があります。

To change the "writing-mode" within an fo:flow or fo:static-content,
either the fo:block-container or the fo:inline-container, as appropriate,
should be used.

この説明文は、fo:flow または、fo:static-content の途中で、writing-mode を fo:region-* の指定とは別のものに変更する場合のことを言っています。writing-mode のセットする方法を限定しているのではないのです。
これらの理由から、XSL Formatter はXSL-FO 仕様に準拠していると考えます。 ページマスターの内容も fo:simple-page-master / fo:region-* に指定された writing-mode に従って文字が置かれます。

次のようなFOをXSL FormatterとFOPにて、それぞれ組版させたときに、行間幅がXSL FormatterとFOPの結果が異なってきます。

<fo:block line-height="1.5" font-size="12pt" font-family="serif">
This is a text string. This is a text string. This is a text string.
</fo:block>

XSL Formatterは、W3C Recommendation の

7.15.4 "line-height" XSL modifications to the
 CSS definition:
In XSL the "line-height" property is used in
 determining the half-leading trait.

に従い、正確な組版を行っています。これは実際に組版結果を印刷して、定規などで計れば一目瞭然です。
FOP は弊社にて調査した限り、指定した値よりも行間幅が狭くなる傾向があります。この原因については不明です。

これは、border width のデフォルト値の違いだと思われます。
border width プロパティのデフォルトは "medium" になります。 XSL-FO仕様では、この値はユーザエージェントに依存するとあります。 XSL Formatter では、初期値として以下の値を定義しています。

"thin" = 1pt
"medium" = 3pt
"thick" = 5pt

これらは、組版オプションで変更することが可能です。

FOP では border width が指定されていないときに 1pt が使用されています。 同じ結果を得るためには、widthを指定するのが良いでしょう。