環境設定と実行PDFレイアウトのカスタマイズお問い合わせ関連情報DITAのドキュメント制作では、ドキュメントをトピックというコンポーネント単位で編集します。編集完了したドキュメントを出版物にする工程を“パブリッシング”と言います。パブリッシングは、HTML、PDFなどの媒体別に自動処理で行ないます。この方法は、予めプログラムした手続きで一気にPDFを作る、“バッチ処理”です。DITAで制作したドキュメントのパブリッシングは、DTPとは根本的に異なります。V1.1準拠の自動組版ソフト(XSL-FOプロセサ)を用いてXSL-FOをPDFにするという、大きく分けて2つの過程を経て行われます。この時、何が行われているのかを見てみましょう。Formatterはアンテナハウスが開発・販売する商用XSL-FOプロセサです。30日間評価版は無償配布。正式版は有償となります。説明DITA-OT作成された大量のDITAトピック(コンテンツ)を、トピック配置を決めるマップに従って組み合わせたり、間接参照を解決するなどの事前処理を行います。DITA-OTには後ほど紹介するPDFプラグイン、XSL-FOプロセサが搭載されています。PDFプラグインDITA-OTが事前処理をして生成された中間ファイルを、PDFとして出力できるようにするためにXSL-FOに変換します。DITA-OTには、PDFパブリッシング用にPDF2というプラグインが組み込まれていますが、プログラムの作りが良くないので利用を推奨しません。代わりにアンテナハウスではより優れたPDFプラグイン、PDF5-MLをオープンソースでご提供しております。弊社はPDF5-MLのご利用をお勧めします。XSL-FOプロセサPDFプラグインが生成したXSL-FOをPDFにレンダリングします。DITA-OTには予め、FOPというオープンソースのXSL-FOプロセサが組み込まれており、PDF2はデフォルトでFOP用のXSL-FOを生成します。Formatter、XEPという二つの商用XSL-FOプロセサ向けのXSL-FOも生成できます(商用XSL-FOプロセサは別途購入の必要があります)。FOPではXSL1.1仕様に基づいた索引の作成などができず、日本語組版の機能も不十分です。Formatter専用のAH拡張機能を付加し、索引の作成はもちろん優れた日本語組版にも対応したXSL-FOを生成します。△ページ上部へ環境設定と実行DITA-OTのインストールDITA-OTをダウンロードして解凍すると“doc”フォルダーに‘userguide.pdf’(「DITA-OTユーザーガイド」)があります。以下、DITA-OT付属の「DITA-OTユーザーガイド」によりポイントを紹介します。Windows版はZIP形式、Linux/Mac版はtar.gz形式で用意されています。7以降Oracleからダウンロードして実行環境を整えておく必要があります(必須)。1.7.1以降Javaプログラムのビルドツールです。XSLTプロセッサXSL変換を行なうツールです。Ver.9.1が同梱されています。JavaUnicodeベースの国際化ライブラリーです。メッセージの整形、テキスト境界、文字集合の変換を行ないます。Ver.54.1が同梱されています。WorkshopHTMLヘルプを生成するとき必要です。必要ならば自分でMSのサイトから入手します。XSL-FOプロセッサPDF2でPDFを生成するときに使います。1.1が同梱されています。△ページ上部へDITA-OTの実行DITA-OTを実行する方法は、OS環境によって異なります。Windowsの場合は次のとおりです。DITA-OTを解凍したフォルダの、‘startcmd.bat’をクリックします。‘startcmd.bat’が必要な環境変数をセットしてWindowsのDOS窓を開きます。Antのコマンドで実行する場合は、DOS窓から次のようなAntのコマンドを入力します。-Dparametername=valueinput-file:DITAマップまたはDITAファイルを指定します。transformation-type:PDFを指定します。parameter-name:パラメータを指定します。Formatter)を指定します。コマンドパラメータの詳細は「DITA-OTユーザーガイド」を参照してください。DITA-OTをインストールした状態では、DITAからXSL-FOへの変換はPDF2プラグインが動作します。Formatterで組版することになります。PDF5-MLとは?PDF5-MLは、DITAからXSL-FOへの変換処理をPDF2に代わって行ないます。次のような特長があります。Library」と一緒に使うことで多言語索引を作成することができます。PDF2と比べるとDITAの要素を生かしたXSL-FO変換を行なっており、カスタマイズがより容易にできます。解説セミナー」での発表資料です。ついて開発者自身が語り尽くしています。PDF5-MLのインストールPDF5-MLをDITA-OTのプラグインに追加する方法の概略は次のとおりです。詳しくは、PDF5-MLをダウンロードして解凍すると「pdf5-ml_manual.pdf」がありますので、詳細はそちらを参考にしてください。Formatterのプログラムとオプション設定ファイル(ahf_setting.xml)のパスをセットするコマンドを追加します。‘com.antennahouse.pdf5’フォルダーをDITA-OTの‘plugins’フォルダーにコピーします。‘startcmd’を実行してDOS窓を開きます。DOS窓で、Antの次のコマンドを実行し、PDF5-MLプラグインをDITA-OTに統合します。integrator.xmlあとはDITA-OTの通常の実行と同じです。PDF5-MLを動かすときは、-Dtranstype=pdf5mlを指定するのを忘れないでください。実際のDITAによる制作プロジェクトにあたっては、PDF作成について次のような質問が多く寄せられます。質問に一般的な回答はありません。DTPレイアウトとDITAのPDFパブリッシングは、実現方法がまったく異なるためです。PDFのレイアウトをご要望にあわせるには、PDF5-MLのXSL変換をカスタマイズすることになります。PDFのレイアウトをどこまで高度にできるかは、XSL変換スタイルシート開発者の技量とXSL-FOプロセサの機能に依存します。Formatterを組み合わせてご利用いただくことで、世界最高水準の自動組版レイアウトを実現できます。DITAのDTDまたはスキーマを拡張する(特殊化する)ことが必要な場合があります。特殊化した場合は、オーサリングも変更になります。DITAの特殊化を承っています。お気軽にお問い合わせください。お問い合わせ下記はお問い合わせの一例です。