Antenna House FormatterDITA オープンツールキットとPDF5-MLプラグイン

DITA (Darwin Information Typing Architecture) は XML ベースの技術文書の生成および管理のために開発された仕様です。DITA は情報の分散化と再利用をテーマに開発され、大規模なマニュアル用のドキュメント管理に適しています。
DITA は 2004年から OASIS DITA 推進委員会（IBM、Idiom Technologies、フィンランド Nokia、など）にて仕様が策定され、2005年5月にバージョン 1.0 が OASIS 標準に認定されました。2015年12月にはバージョン 1.3 が承認されました。
DITA についての詳細は「OASIS DITA 技術委員会」の Web サイトをご覧ください。また、弊社サイト「アンテナハウス DITA サービス」もご参照ください。

DITA 文書は、オープンソースの「DITA-OT (DITA Open Toolkit)」を使用して、HTML、DocBook、PDF など様々な配布可能なフォーマットに変換することができます。DITA-OT は活発に開発が進んでおり、2016年9月現在のバージョンは 2.3 です。DITA-OT の標準のビルドファイルでは『Formatter（XSL Formatter）』がサポートされており、以下のコマンドラインで『Formatter』を起動して PDF を得ることができます。これには DITA-OT 付属の Idiom 製のスタイルシートが使用されます。

　ant -l [ログファイルのパス] -Dargs.input=[ditamap ファイルのパス] -Dpdf.formatter=ah -Dtranstype=pdf

PDF5-ML プラグインの紹介

DITA-OT の標準のプラグインに代わるものとして "PDF5-ML プラグイン" があり、DITA1.2 の多くの要素/属性をサポートするスタイルシートを搭載しています。アンテナハウスが開発し、オープンソースで公開しています。

主な特長は以下のとおりです。

徹底した多言語対応

たとえば、次のような DITA インスタンスを作ったとします。
<section> <title>Ph test</title> <p>We say "Hello" in English.</p> <p>We say "<ph xml:lang="ja-JP">こんにちは！</ph>" in Japanese.</p> <p>We say "<ph xml:lang="zh-CN">你好！</ph>" in Chinese.</p> <p>We say "<ph xml:lang="ko-KR">안녕하세요！</ph>" in Korean.</p> </section> このようにひとつのトピックファイルの中に多言語が混在したとしても、言語ごとに適切なフォントを割り当てることができます。

簡潔なスタイル定義

PDF5-ML は次のようにメンテナンスしやすいようにスタイルを定義できます。
 <attribute-set name="atsTocLevel1" use-attribute-sets="atsB"> <attribute name="font-family">$General_Text_Font</attribute> <attribute name="font-size">11.5pt</attribute> <attribute name="text-align">justify</attribute> <attribute name="text-align-last">justify</attribute> <attribute name="text-indent">-1 * $Toc_Indent_Size</attribute> <attribute name="start-indent">inherited-property-value(start-indent) + $Toc_Indent_Size</attribute> <attribute name="space-before">3mm</attribute> </attribute-set> このスタイル定義は "スタイル定義ファイル" と呼ばれるファイルに書き、ロジックが書かれたファイルとは完全に分離されます。

表紙の自由なレイアウト

次のように CSS 記法を使って表紙をレイアウトすることができます。
<conbodydiv fo:prop="position:absolute;top:40mm;right:10mm;width:40%;height:130mm;">  <section> <p fo:prop="font-family:Franklin Gothic Demi Cond;font-size:24pt;line-height:120%;">Antenna House</p> <p fo:prop="font-family:Arial;font-weight:bold;font-size:32pt;line-height:120%;">PDF5-<i fo:prop="color:deeppink;">ML</i> plugin</p> <p fo:prop="font-weight:bold;font-size:28pt;line-height:120%;">User's Guide</p> </section> </conbodydiv>

セミナー資料

実践！PDF5-ML プラグイン（PDF）
2015年12月22日に開催した「DITA-OTプラグイン "PDF5-ML" 解説セミナー」での発表資料です。PDF5-ML について開発者自身が語り尽くしています。是非ご覧ください。

ダウンロード

PDF5-ML プラグインのダウンロードは下記のリンクからお願いします。
その他の詳しい情報およびご使用方法については、リンク先にある pdf5-ml_manual.pdf（英語）をご覧ください。

Antenna House PDF5-ML DITA-OT Plug-in (GitHub)