ホーム > DITA の公開

DITA の公開

FrameMaker で公開プロセスを使用し、DITA コンテンツの出力を生成する方法について説明します。

FrameMaker で次のプロセスを使用して、DITA コンテンツの出力を生成できます。

PDF 形式で保存

FrameMaker の PDF 形式で保存機能により、DITA トピックまたは DITA マップ(bookmap を含む)を PDF 形式で出力できます。

FrameMaker の「別名で保存」機能により、DITA トピックまたは DITA マップ(bookmap など)を PDF 形式で出力することができます。 作成される PDF 形式の出力は、WYSIWYG 形式の表示が使用されます。 つまり、トピックまたはマップに適用される構造化アプリケーション形式規則が PDF へ出力されます。

DITA トピックの PDF 出力を作成するには、ファイル > PDF 形式で保存を選択します。

PDF 形式で保存機能を使用してマップの PDF 出力を作成する場合、文書を保存ダイアログで、「DitaVal ファイルを確認」オプションを選択します。

DITAVAL 機能を使用して、マップ内のトピックのコンテンツを条件付きで出力できます。 詳しくは、DITAVALを参照してください。

マルチチャネル公開

FrameMaker のマルチチャネル公開機能は、DITA トピックやマップを多数の出力形式に出力できます。

FrameMaker のマルチチャネル公開機能では、DITA トピックや DITA マップを次の形式で出力できます。

DITA Open Toolkit

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 コンテンツを次の形式で公開できます。

  1. PDF2

  2. XHTML

  3. CHM (HTML Help ワークショップをインストールして CHM を生成)

  4. カスタム

Docbook、Jave Help、RTF などの出力形式で生成することもできます。 その他の出力形式を有効化するには、出力タイプリストの変更.

DITA OT を使用した出力の生成

  1. 適切な DITA ファイルを選択し、構造 > DITA > DITA-OT 出力を生成を選択します。

    DITA-OT 出力を生成ダイアログが表示されます。

    DITA-OT 出力を生成ダイアログ
    FrameMaker の DITA-OT 出力を生成ダイアログ

  2. 出力タイプを選択します。

  3. 公開完了後にログファイルを起動する場合は、「ログファイルを表示」オプションを選択します。

    デフォルトでは、FrameMaker インストール時に DITA-OT がインストールされています。 ただし、Toolkit を個別にインストールした場合、DITA-OT ディレクトリフィールドでインストールする場所を指定できます。 このフィールドへの変更は、現在の出力に対してのみ適用できます。 次に DITA-OT 出力を生成ダイアログを開くとき、このディレクトリは FrameMaker のデフォルトにリセットされます。 デフォルトのディレクトリを変更するには、「 異なる DITA-OT パッケージの使用.

  4. Windows エクスプローラーで出力フォルダーを開くには、「出力フォルダーを開く」オプションを選択します。出力フォルダーは、公開完了後に Windows エクスプローラーに表示されます。

  5. 公開完了後もダイアログを開いておく場合は、「作成後にダイアログを開いたままにする」オプションを選択します。

  6. DITAVAL ファイルを選択し、DITAVAL ファイルで定義されている属性/値ペアを使用してコンテンツのコンディショナルフィルタリングを指定します。ファイルの使用方法の詳細については、「DITAVALDITAVAL」を参照してください。

    複数の文書を生成する際に同じ DITAVAL ファイルを使用する場合に、ditafm.ini で使用するファイル名と場所を指定できます。この場合、出力を生成するたびに DITAVAL ファイルを選択する必要はありません。

    注: 両方の場所(ditafm.ini および DITA-OT 生成ダイアログ)で DITAVAL ファイルを指定すると、DITA-OT 出力を生成ダイアログで選択したファイルが優先されます。
  7. 作成」をクリックします。

FrameMaker は DITA-OT を起動し、ソーストピックやマップと同じフォルダーに出力を生成します。

出力タイプリストの変更

FrameMaker では、デフォルトで DITA-OT を使用して PDF2、XHTML、HTML Help の出力を生成できます。 ただし、Toolkit を使用するとその他多くの形式で出力を生成できます。 その他の形式で出力を生成するには、ditafm.ini ファイルを更新する必要があります。

重要: 次の手順には ditafm.ini ファイルへの変更が必要になります。 いかなる変更を行う前にも、このファイルのバックアップを作成することをお勧めします。
  1. 現在のユーザー AppData フォルダで ditafm.ini ファイルを開きます(%appdata%\Adobe\FrameMaker\xx\ditafm.ini

  2. 次のテキストをファイルに配置します。

    Count=3
    1=xhtml
    2=htmlhelp
    3=pdf
    注: 上の番号付きリストは、DITA-OT 出力を生成ダイアログにある出力形式のリストと同じものです。
  3. DITA-OT 出力を生成ダイアログで出力タイプの追加または削除を行うには、リストに表示するタイプの数としての「カウント」を指定する必要があります。

  4. 以下のリストは、含めることのできる使用可能な全出力タイプです。 次の出力タイプを 1 つ以上含める場合、それらを番号付きのリストに追加し、番号のシーケンスが保持されていることを確認する必要があります。

    • docbook

    • eclipsecontent

    • eclipsehelp

    • htmlhelp

    • javahelp

    • net.sourceforge

    • html

    • odt

    • pdf

    • tocjs

    • troff

    • wordrtf

    • xhtml

    注: ditafm.ini ファイルの出力タイプ入力では大文字と小文字が区別されます。上でリストされたようにエントリを作成する必要があります。

    以下の例は、Eclipse ヘルプおよび Word RTF 形式を既存のリストに追加します。

    Count=5
    1=xhtml
    2=htmlhelp
    3=pdf2
    4=eclipsehelp
    5=wordrtf
    注: リストを完全に変更してすべての出力タイプを含めることができます。
  5. FrameMaker を再起動して設定の変更を有効にします。

異なる DITA-OT パッケージの使用

FrameMaker には、DITA Open Toolkit 2.3 が統合されています。別のバージョンの DITA Open Toolkit をすでにインストールしている場合、dita 初期化ファイルの編集、または「DITA-OT をカスタマイズ」ダイアログから DITA Open Toolkit パスをカスタマイズできます。

1 回だけ変更するときには、ディレクトリパスを変更できます。その場合、出力を生成するときに、DITA Open Toolkitを使用して出力を生成できます。

FrameMaker のデフォルト DITA- OT ディレクトリを dita 初期化ファイルを使用して変更するには:

  1. 現在のユーザー AppData フォルダで ditafm.ini ファイルを開きます

    %appdata%\Adobe\FrameMaker\xx\ditafm.ini						
  2. 次のテキストをファイルに配置します。

    DitaDir=%FMHOME%\fminit\ditafm\DITA-OT
  3. DITA-OT の代替フォルダーを指定するように、DitaDir の値を変更します。

    例えば、C:\DITA-OT_3.1.2

  4. FrameMaker を再起動します。

    新しい DITA OT パスがDITA 出力の生成ダイアログに入力されました。

FrameMaker のデフォルトの DITA-OT ディレクトリを DITA-OT をカスタマイズダイアログから変更するには、次の操作を行います。

  1. 構造 > DITA > DITA-OT 出力の生成を選択して、DITA-OT 出力の生成ダイアログを開きます。

  2. 「カスタマイズ」ボタンをクリックして「DITA-OT をカスタマイズ」ダイアログを開きます。

    DITA-OT をカスタマイズダイアログ
    FrameMaker の DITA-OT をカスタマイズダイアログ
  3. 以下の詳細をダイアログに提供します:

    DITA-OT ディレクトリ

    カスタム DITA-OT.zip ファイルの保存場所のパスを指定する。FrameMaker のインストール場所を示す %FMHOME% 変数を使用できます。このパスは、その他の関連フォルダーのパスの指定に使用できる DITA_DIR 変数に保存されています。

    Ant コマンド:

    Ant スクリプトのフォルダーのパスを指定します。このパスは、ファイルシステムの DITA-OT ディレクトリを基準とします。

    Ant ホーム:

    Ant インストールフォルダーのパスを指定します。

    クラスパス:

    Java ライブラリのパスを指定します。

    ビルドファイル

    Ant ビルドのスクリプトファイルのパスを指定します - build.xml。このパスは、ファイルシステムの DITA-OT ディレクトリを基準とします。

    追加パラメーター

    カスタム DITA-OT プラグインに必要な追加パラメーターを指定します。