FrameMaker で公開プロセスを使用し、DITA コンテンツの出力を生成する方法について説明します。
FrameMaker で次のプロセスを使用して、DITA コンテンツの出力を生成できます。
FrameMaker の PDF 形式で保存機能により、DITA トピックまたは DITA マップ(bookmap を含む)を PDF 形式で出力できます。
FrameMaker の「別名で保存」機能により、DITA トピックまたは DITA マップ(bookmap など)を PDF 形式で出力することができます。 作成される PDF 形式の出力は、WYSIWYG 形式の表示が使用されます。 つまり、トピックまたはマップに適用される構造化アプリケーション形式規則が PDF へ出力されます。
DITA トピックの PDF 出力を作成するには、
を選択します。PDF 形式で保存機能を使用してマップの PDF 出力を作成する場合、文書を保存ダイアログで、「DitaVal ファイルを確認」オプションを選択します。
DITAVAL 機能を使用して、マップ内のトピックのコンテンツを条件付きで出力できます。 詳しくは、DITAVALを参照してください。
FrameMaker のマルチチャネル公開機能は、DITA トピックやマップを多数の出力形式に出力できます。
FrameMaker のマルチチャネル公開機能では、DITA トピックや DITA マップを次の形式で出力できます。
Responsive HTML5
モバイルアプリケーション
EPUB
Kindle
Microsoft HTML Help
Adobe Experience Manager Mobile
基本的な HTML
DITA Open Toolkit について、および FrameMaker で DITA Open Toolkit を使用して出力を生成する方法について説明します。
DITA Open Tool kit(DITA-OT)は DITA マップおよびトピックコンテンツに処理を提供する一連の Java ベースのオープンソースツールです。FrameMaker では、DITA コンテンツ(マップおよびトピック)を成果物として使用可能な書式に変換する DITA Open Toolkit 3.0 および 2.3. DITA-OT がただちに使用できます。
FrameMaker では、デフォルトで DITA コンテンツを次の形式で公開できます。
PDF2
XHTML
CHM (HTML Help ワークショップをインストールして CHM を生成)
カスタム
Docbook、Jave Help、RTF などの出力形式で生成することもできます。 その他の出力形式を有効化するには、出力タイプリストの変更.
適切な DITA ファイルを選択し、
を生成を選択します。DITA-OT 出力を生成ダイアログが表示されます。
出力タイプを選択します。
公開完了後にログファイルを起動する場合は、「ログファイルを表示」オプションを選択します。
デフォルトでは、FrameMaker インストール時に DITA-OT がインストールされています。 ただし、Toolkit を個別にインストールした場合、DITA-OT ディレクトリフィールドでインストールする場所を指定できます。 このフィールドへの変更は、現在の出力に対してのみ適用できます。 次に DITA-OT 出力を生成ダイアログを開くとき、このディレクトリは FrameMaker のデフォルトにリセットされます。 デフォルトのディレクトリを変更するには、「 異なる DITA-OT パッケージの使用.
Windows エクスプローラーで出力フォルダーを開くには、「出力フォルダーを開く」オプションを選択します。出力フォルダーは、公開完了後に Windows エクスプローラーに表示されます。
公開完了後もダイアログを開いておく場合は、「作成後にダイアログを開いたままにする」オプションを選択します。
DITAVAL ファイルを選択し、DITAVAL ファイルで定義されている属性/値ペアを使用してコンテンツのコンディショナルフィルタリングを指定します。ファイルの使用方法の詳細については、「DITAVALDITAVAL」を参照してください。
複数の文書を生成する際に同じ DITAVAL ファイルを使用する場合に、ditafm.ini で使用するファイル名と場所を指定できます。この場合、出力を生成するたびに DITAVAL ファイルを選択する必要はありません。
「作成」をクリックします。
FrameMaker は DITA-OT を起動し、ソーストピックやマップと同じフォルダーに出力を生成します。
FrameMaker では、デフォルトで DITA-OT を使用して PDF2、XHTML、HTML Help の出力を生成できます。 ただし、Toolkit を使用するとその他多くの形式で出力を生成できます。 その他の形式で出力を生成するには、ditafm.ini ファイルを更新する必要があります。
現在のユーザー AppData フォルダで ditafm.ini ファイルを開きます(%appdata%\Adobe\FrameMaker\xx\ditafm.ini)
次のテキストをファイルに配置します。
Count=3
1=xhtml
2=htmlhelp
3=pdf
DITA-OT 出力を生成ダイアログで出力タイプの追加または削除を行うには、リストに表示するタイプの数としての「カウント」
を指定する必要があります。
以下のリストは、含めることのできる使用可能な全出力タイプです。 次の出力タイプを 1 つ以上含める場合、それらを番号付きのリストに追加し、番号のシーケンスが保持されていることを確認する必要があります。
docbook
eclipsecontent
eclipsehelp
htmlhelp
javahelp
net.sourceforge
html
odt
tocjs
troff
wordrtf
xhtml
以下の例は、Eclipse ヘルプおよび Word RTF 形式を既存のリストに追加します。
Count=5
1=xhtml
2=htmlhelp
3=pdf2
4=eclipsehelp
5=wordrtf
FrameMaker を再起動して設定の変更を有効にします。
FrameMaker には、DITA Open Toolkit 2.3 が統合されています。別のバージョンの DITA Open Toolkit をすでにインストールしている場合、dita 初期化ファイルの編集、または「DITA-OT をカスタマイズ」ダイアログから DITA Open Toolkit パスをカスタマイズできます。
1 回だけ変更するときには、ディレクトリパスを変更できます。その場合、出力を生成するときに、DITA Open Toolkitを使用して出力を生成できます。
FrameMaker のデフォルト DITA- OT ディレクトリを dita 初期化ファイルを使用して変更するには:
現在のユーザー AppData フォルダで ditafm.ini ファイルを開きます
%appdata%\Adobe\FrameMaker\xx\ditafm.ini
次のテキストをファイルに配置します。
DitaDir=%FMHOME%\fminit\ditafm\DITA-OT
DITA-OT の代替フォルダーを指定するように、DitaDir
の値を変更します。
例えば、C:\DITA-OT_3.1.2。
FrameMaker を再起動します。
新しい DITA OT パスがDITA 出力の生成ダイアログに入力されました。
FrameMaker のデフォルトの DITA-OT ディレクトリを DITA-OT をカスタマイズダイアログから変更するには、次の操作を行います。
DITA-OT 出力の生成ダイアログを開きます。
を選択して、「カスタマイズ」ボタンをクリックして「DITA-OT をカスタマイズ」ダイアログを開きます。
以下の詳細をダイアログに提供します:
カスタム DITA-OT.zip ファイルの保存場所のパスを指定する。FrameMaker のインストール場所を示す %FMHOME%
変数を使用できます。このパスは、その他の関連フォルダーのパスの指定に使用できる DITA_DIR
変数に保存されています。
Ant スクリプトのフォルダーのパスを指定します。このパスは、ファイルシステムの DITA-OT ディレクトリを基準とします。
Ant インストールフォルダーのパスを指定します。
Java ライブラリのパスを指定します。
Ant ビルドのスクリプトファイルのパスを指定します - build.xml。このパスは、ファイルシステムの DITA-OT ディレクトリを基準とします。
カスタム DITA-OT プラグインに必要な追加パラメーターを指定します。