JATS組版：３つ数えるくらい簡単

カスタマイズを支援するXSLTの機能

XSLT設計において特にカスタマイズに貢献する3つの特徴とは、モジュラースタイルシートのサポート、テンプレートとしての構成、そして名前付き属性セットである。

モジュラースタイルシートのサポートはxsl:include、xsl:importがXSLT1.0の最上位要素なので、XSLTの機能の一部である。仮に今までにそういったものに遭遇したことがなくても、その名前から、他のスタイルシートの一部として一つのスタイルシートを使うものだろうと想像できるであろう。xsl:includeは、確かに、概念的に1つのスタイルシートの内容を他のスタイルシートの内に含む。一方xsl:importは、インポートされる側のスタイルシートの内容をインポートする側のスタイルシートへ十分に定義された規則で利用可能にする。その規則とはインポートする側のスタイルシートの内容がインポートされる側のスタイルシートの内容より優先するというものである。

中核のJATSプレビュー用スタイルシートは図 3が示すように、xsl:includeのみを用いる。

図 3

JATSプレビュー用スタイルシートにインポート・インクルード

XSLTスタイルシートの構成は、ソースドキュメントの固有の文脈に一致させるxsl:template規則が優勢だが、それにより、固有の文脈に一致するテンプレートを含んだインポートする側のスタイルシートを書くのを容易にしている。例えば、次のテンプレートは td要素を処理するのに用いる。文字どおり、fo:table-cell は結果にコピーされる。xsl:call-templateは、XSLTネームスペースにあるすべての要素と同様に、XSLTプロセッサによって動作する。

<xsl:template match="td">
  <fo:table-cell xsl:use-attribute-sets="td">
    <xsl:call-template name="process-table-cell"/>
  </fo:table-cell>
</xsl:template>

インポートの優先度についての規則は、中核JATSプレビュー用スタイルシート中の対応するテンプレートを上書きしてカスタマイズするのを容易にする。だが、それは、テンプレートを上書きすることが理想的なメカニズムであることを意味しない。例えば、大きな複雑なテンプレートに小さな修正をしたい場合、普通は、単に元のテンプレートの小部分を上書きするのではなく、修正を含めた大きなテンプレートのコピーを維持しなければならない。しかし、一般的な場合、インポートされる側のテンプレートを上書きするのは、うまく作用する。

名前付き属性セットは、使用されるごとに新たに評価される属性定義のグループである。また、結果として生じる属性は、XSLT変換結果の要素に加えられる。複数の名前付き属性セットを同名で組み合わせる規則や、複数の異なった属性セットを組み合わせる規則はインポートする側のスタイルシートを引数にしたり、中核のJATSプレビュー用スタイルシートの属性セットを上書きすることを容易にしている。

カスタマイズを支援するJATSプレビュー用スタイルシートの機能

JATSプレビュー用スタイルシート設計において特にカスタマイズに貢献する3つの特徴とは、フォントファミリ用のグローバル変数、名前付き属性セット、名前付きテンプレートを使うことである。間違いなく、これらはすべて、JATSプレビュー用スタイルシートに存在し、スタイルシートがカスタマイズをサポートするよう意図されているかどうかに関わらず、その特徴は "Every piece of knowledge must have a single, unambiguous, authoritative representation within a system (知識のすべてはシステム内で、単一で明確で信頼できる表現でなければならない)" の中にある"Don’t Repeat Yourself (DRY, 繰り返さない)" 主義[21] を具現化している。例えば、次の様な事項である：

スタイルシートを構築する方法としては、カスタマイズするスタイルシートの中の信頼性のある表現を上書きし、または再使用することができるので、メンテナンスが容易で、カスタマイズも容易にできる。

例えば、次のセクションで書かれているXSLT 1.0スタイルシートは次の2つの名前付き属性セットの定義およびテンプレートを含んでいる。

<xsl:attribute-set name="td">
  <xsl:attribute name="line-stacking-strategy">max-height</xsl:attribute>
</xsl:attribute-set>

<xsl:attribute-set name="td-small" use-attribute-sets="td">
  <xsl:attribute name="line-height">10pt</xsl:attribute>
  <xsl:attribute name="border">none</xsl:attribute>
  <xsl:attribute name="padding-top">0pt</xsl:attribute>
  <xsl:attribute name="padding-bottom">0pt</xsl:attribute>
</xsl:attribute-set>

<xsl:template match="td[ancestor::table[@style = 'small']]">
  <fo:table-cell xsl:use-attribute-sets="td-small">
    <xsl:call-template name="process-table-cell"/>
  </fo:table-cell>
</xsl:template>

「td」名前付き属性セットはメインのJATSプレビュー用スタイルシートで定義されている。従って、この定義はその定義に加えられる。また、結合された属性セットは「td」属性セットが使われるところではどこでも評価される。例えば、通常より狭いスペースに組版する表で使用する、「td-small」名前付き属性セットの内などである。このような表内のtdのテンプレートはその名前付き属性セットを使用する。そしてその名前付き属性セットは「td-small」属性セットのすべての属性と、「td」属性セットの定義から来るすべての属性を変換結果のfo:table-cellに追加する。表のセルを組版する共通の解釈を扱うコアなJATSプレビュー用スタイルシートから「process-table-cell」テンプレートを使うことが可能なので、このテンプレートは他のことをあまり行わない。

画像処理

画像は少なくとも固有のサイズを持っており、TIFFのような形式では、同様に固有解像度を持っている。

画像を段幅にするか、ページ幅にするかを判断する過程は以下の通りである。

PLOS ONEオーサリングガイドラインは、画像サイズはページ本体の高さまで許容している。だが、図表は300文字以内のキャプションが付与されるだろうし、組版結果にはさらにラベル、タイトル、DOI (Web上の電子文献と一対一に対応しているコード)も出現する。XSLはフロートさせたFOがページを跨ぐことを許容していない。下記の表について述べていることと似ているが、処理システムは両方の幅で図表キャプションを「あらかじめフォーマットし」、スタイルシートによって画像の許容範囲の最大高を縮小するように、メインのスタイルシートが入力として使用するエリアツリーを書き上げる。これで、画像がキャプションをフッタエリアに押し出さないようにする。

表の処理

表は上記で述べたが、表の内容がどれにべストフィットするかによって、カラム幅、ページ幅あるいはページの高さのどれかで配置される。どれに決めるかは全面的に処理システムが行う。XMLは他のソースから変換されたそのままの状態で、DTDで定義された見栄え志向の属性さえも含んでいないからである。

NLM/JATS DTD [26] は結合された表とキャプションの位置方向の指定に対応しているが、表の幅を示す方法を提供していない。一方NISO JATSの表モデルはtableとcaptionには「style」属性を許容しており、その両方を含むtable-wrapにではない。

プロジェクトスタート時に提供されたサンプルファイルには、画像用のTIFFファイルと同様にサンプル中にある表の各々のTIFF画像が含まれていた。表のイメージは既存のページレイアウトシステムが生成した人工物であり、それらが入手可能になる見込みはないのみならず、FOベースの新システムでも同様なものの生成が期待されていることが明らかになったのはプロジェクトが始まってからであった。

実装したアプローチでは、各表を各幅で含む組版済みの仮のサイズ調節文書（sizer）を作る。その文書をXMLでエリアツリーとして保存する。そして、最終組版用のFOを生成するスタイルシートへのパラメータとしてエリアツリーを提供している。

サイズ調節文書は各々違う固定の幅と大きな高さの３つのページシーケンスから成る（組版ソフトがfo:root media-usage="bounded-in-one-dimension">に対応していないため）。ソースXMLにある表はそれぞれIDを持っている。各ページの表には、表の独自のIDの前にページに特有の接頭辞を付け加えることによって、FO文書内でユニークなIDを与えられる。図 9はページ幅、カラム幅、ページ高さの幅で組版した表を示す。最初の二つの表はカラム内に収まっているが、三番目はカラムからはみだし、ページの幅にあっていない。

図 9

サイズ調節文書（sizer document）

サイズ調節文書を作るスタイルシートはとても簡単である。文書ノードにマッチするテンプレートがすべての作業を行う。そして、表が最終出力で期待通りになるように、そのスタイルシートがメインのスタイルシートをインポートする。ただ３つのページ種類があるだけなので、スタイルシートは頁並びのマスターさえも定義する必要はなく、fo:page-sequenceが直接fo:simple-page-masterを参照するだけである。

  <fo:root>
    <fo:layout-master-set>
      <xsl:call-template name="define-sizer-simple-page-masters"/>
    </fo:layout-master-set>
    <fo:page-sequence master-reference="page-wide">
      <fo:flow flow-name="body" xsl:use-attribute-sets="fo:flow">
        <xsl:apply-templates select="//table-wrap">
          <xsl:with-param name="prefix" select="'page-wide-'" as="xs:string" tunnel="yes" />
        </xsl:apply-templates>
      </fo:flow>
    </fo:page-sequence>
    <fo:page-sequence master-reference="column-wide">
      <fo:flow flow-name="body" xsl:use-attribute-sets="fo:flow">
        <xsl:apply-templates select="//table-wrap">
          <xsl:with-param name="prefix" select="'column-wide-'" as="xs:string" tunnel="yes" />
        </xsl:apply-templates>
      </fo:flow>
    </fo:page-sequence>
    <fo:page-sequence master-reference="page-high">
      <fo:flow flow-name="body" xsl:use-attribute-sets="fo:flow">
        <xsl:apply-templates select="//table-wrap">
          <xsl:with-param name="prefix" select="'page-high-'" as="xs:string" tunnel="yes" />
        </xsl:apply-templates>
      </fo:flow>
    </fo:page-sequence>
  </fo:root>
</xsl:template>

デフォルトの処理を書き換えるのに、テンプレートに唯一必要なことは、fo:basic-linkを生成する参考文献の相互参照や、付属資料への参照をなくすことである。これにより、XSL組版ソフトからの相互参照に関する警告メッセージがなくなる。

<xsl:template match="xref[@ref-type = ('bibr', 'supplementary-material')]">
  <xsl:apply-templates />
</xsl:template>

メインのスタイルシートは、ページ幅、マージンなど用の変数を宣言する。従って、同じ値が、画像がページ幅かカラム幅かを決める最終出力を行うメインのスタイルシートで使われ、またページ寸法を指定するサイズ調整のスタイルシートで使われる。

前にも述べたように、サイズ調節文書用のエリアツリーはXMLとして保存され、エリアツリーXMLのファイル名はメインのスタイルシートに渡され、単独で動かすときは、パラメタの値となる。スタイルシートがtable-wrap処理を行う時、サイズ調節のエリアツリーにある表の変形寸法を調べ、その寸法に従って、どの表の形式を使うかを決定する。図 10は最終組版でのサイズ調整の文書のうち２つの表を示す。

図 10

組版したページ

現在の機能では 表のサイズを自動的にカラム幅、ページ幅 あるいはページの高さの(カラム幅あるいはページ幅のいずれか)に調整することができ、また手動による上書きで、表をページ幅あるいはページの高さにすることもでき、また、ページの高さの表が長すぎたり、幅広すぎた場合、適切なスペースを取って、自動で表分割をすることもできる。表を複数の部分表に分割するとき、分割された表は、サイズ調節用の表から、自身のカラム幅を得て、同じ幅を使うようにし、表の自動アルゴリズが表の部分を最適化したり、ページの下部に空きを残すのを防ぐ。

最終的に、分割スタイルシート（‘splitter’ stylesheets）で前回のパスからのエリアツリーをチェックし、すべてのフロートさせた図表や表が、付属資料や、謝辞、参考文献の前に出現しているか確認する。もしフロートが後付けと重なったら、重なりを避けるため、スタイルシートで後付けを別のfo:page-sequenceに分割する。

表内のTIFF画像を作成する必要はなかったが、もし必要なら、メインのスタイルシートで、それぞれの表用に個々のページ寸法を指定した別のFO文書を出力する。その後、そのFO文書はPDFまたはPostScriptにフォーマットされ、次に、ImageMagickで、TIFFに変換される。