Zenn
組版・ドキュメンテーション勉強会Publicationへの投稿
🐜

AntのXSLTタスクで実行するSaxonにconfigファイルを食わせる

hidaruma
2024/09/04に公開
XML
XSLT
ant
dita
tech

DITA-OTでXSLT処理系を使う場合、通常はSaxonをAntのXSLTタスクから使用することになります。ここで、configファイルを弄ったものを使用する必要があるときの読み込ませ方を紹介します。Saxonのドキュメントに書いてあったのに長らく見つけられなかったので。

追記。先人のブログにもありました。 https://toshi-xt500.hatenablog.com/entry/2020/03/24/072313

この記事内容については今後同人誌にもほぼそのまま同様の情報を載っける可能性があります。

DITA-OTでのAntとXSLTタスクの立ち位置

現代の有名ツールでApache Antを使っているものはそう多くないでしょう。その数少ない内の1つがDITA Open Toolkitです。DITA-OTは入力について、JavaのアプリケーションとXSLTスクリプトの処理のパイプをAntで記述していきます。ユーザによるカスタムプラグインも例外ではなく、Antで処理を書いていきます。ですので、XSLT処理については、<xslt>として用意されたXSLTタスクを使うのが通常の流れ[1]です。DITA-OTにはSaxon-HEがバンドルされているため、XSLTタスクを使うプラグインは大抵Saxon前提で組まれます[2]。

Configファイルの調整が必要になるのはどんなときか

典型的な例は次です：

  • Javaライブラリなどとして独自関数を定義してスタイルシートで利用しているとき
  • xsl:packageを使うとき

筆者の必要は後者によるもので、xsl:packageの参照解決は処理系側で行うことになっており、XMLCatalogでは行えない[3]からです。

一応、configを適宜指定していくこともできるのですが、まあファイルを読み込めた方が早いことも多いです。

該当箇所の記述例

<!-- build.xmlのtarget内など -->
 <xslt in="input.xml"
        style="stylesheet.xsl"
        out="output.xml">
        <factory name="net.sf.saxon.TransformerFactoryImpl">
            <attribute name="http://saxon.sf.net/feature/configuration-file"
 value="custom-config.xml"/>
        </factory>
  </xslt>

<factory>の@nameはSaxonのエディションによって変わります。上の例はHE用。
2024-09-06 追記。net.sf.saxon.BasicTransformerFactoryはHE用なんですが、ここはnet.sf.saxon.TransformerFactoryImplで大丈夫みたいなので修正。

というか、「XSLT transformations from Ant」の情報が答えなんですが「Configuration when running Ant」と離れた配置になっていて今迄見つけられなかったという……。

参考資料

脚注

  1. バンドルのSaxon-HEを使わない場合も大抵Saxon-PEやSaxon-EEなどSaxonを使う。新生Apache Xalanの3.0対応は未だ半ばだし、Altovaは単体エンジンの利用例全然聞かないんだよな ↩︎

  2. Saxon9の途中からHE版のAPIがJAXP廃止になったので、HEではSaxonとべったりなs9apiを使わなければならないというのも地味にあるのではないかと疑っている。まあXDM 3.0に対応するの大変そうだしJAXP用の負債サポートをPE・EEとして支払う構造はそれなりに正当性がある、気がする ↩︎

  3. パッケージのバージョン、パッケージ用パラメータの注入などの機能が必要になるためだろう ↩︎

組版・ドキュメンテーション勉強会
組版・ドキュメンテーション勉強会Publication

組版・ドキュメントに関連する記事を投稿するコミュニティ、を予定しています。 文章表現よりはマークアップ・文章構造・自動組版に焦点を絞れると他コミュニティと差別化できると思っていますが如何。

Discussion