DITA 関係テーブル

構造化文書での関連トピックの概念と、FrameMaker で関連トピックのリンクを作成するために関係テーブルを使用する方法について説明します。

DITA トピックのセットには、相互に関連するトピックが含まれることがよくあります。 この場合、各トピックの最後に関連する（参照する）リンクのセットを含めることもできます。 これにより、必要に応じてリーダーは詳細を参照することができます。

例えば、FrameMaker の「別名で保存」オプションを説明する場合は、次の個別のトピックを使用できます。

この場合、それぞれのトピックの最後に別の 3 つのトピックへの関連リンクを含めることができます。

DITA マップの使用

FrameMaker の関係テーブルを使用すると、DITA トピックで関連リンクを作成できます。 DITA マップで関係テーブルを使用します。 つまり、DITA マップを作成し、DITA マップの使用するトピックセットにトピックを含める必要があります。 その後で関係テーブルをマップに追加します。 関係テーブルで、DITA マップに含まれる関連トピックを定義します。

追加する DITA タイプ

次の DITA トピックタイプを関係テーブルに追加できます。

  • トピック

  • タスク

  • 概念

  • リファレンス

関連トピックを関係テーブル行に追加する

DITA マップの 2 つ以上のトピックが関連するように指定するには、これらのトピックを関係テーブルの単一行に追加する必要があります。 関係テーブルを作成するための手順は、「 関係テーブルを作成する」を参照してください。

例えば、トピック「別名で保存」、「PDF 形式で保存」、「レビュー PDF 形式で保存」、「XML 形式で保存」を関連トピックにするには、次のように指定します。

ドキュメント表示の関係テーブル

Note: FrameMaker の関係テーブルは、ドキュメント表示で表示した場合、コンテンツの一部として含まれる FrameMaker テーブルの外観と同じように表示されます。

任意の行数を関係テーブルに追加できます。 FrameMaker は、行にあるすべてのトピックを関連するものと見なします。

任意の関係テーブル数を DITA マップに追加できます。 これは、関連トピックのセットをまとめてグループ化できます。

関係テーブル行の関連トピックの順序を指定する

テーブル行の関連トピックの順序は、DITA マップ出力の「関連リンク」セクションに表示されるトピックのシーケンスを定義します。

次の例では、「PDF 形式で保存」トピックの「関連リンク」セクションは次のトピックで表示されます。

  • 別名で保存

  • レビュー PDF 形式で保存

  • XML 形式で保存

ドキュメント表示の関係テーブル
FrameMaker の文書ウィンドウの関係テーブル

つまり、テーブル内でトピックの順序を変更すると、「関連リンク」セクションのシーケンスは異なって表示されます。

関係テーブルを作成する

FrameMaker で関係テーブルを作成する方法については、サンプルの関係テーブルワークフローを参照してください。

  1. DITA マップの 構造図 で、トピックの最後および topicref エレメントと同じレベルに挿入ポイントを置きます。

  2. スマートカタログを表示するには、Ctrl + 1 キーを押して「reltable」を選択します。

    表を挿入 ダイアログが表示されます。

  3. 列と行の数を指定します。

    列の数は、まとめてグループ化する関連トピックの数により異なります。

    行の数は、作成する関連トピックのグループの数により異なります。

    Note: また、関連トピックの複数グループに対して複数の関係テーブルを作成できます。

  4. 「挿入」をクリックします。

    関係テーブルが DITA マップに追加されます。

  5. 表形式の表示で関係テーブルを表示するには、ドキュメント表示に移動します。

    構造図から関係テーブルにトピックを追加することはできますが、表形式の表示を使用すると、より便利なモードで作業できます。

    デフォルトの関係テーブル（4 列 x 1 ボディ行）
    FrameMaker のデフォルトの関係テーブル（4 列 x 1 ボディ行）

    関係テーブルヘッダーの各セルで、列の本文セルに含める関連トピックの DITA トピックタイプを指定します。

    FrameMaker は、次の DITA トピックタイプを関係テーブルに追加できます。

    • トピック

    • タスク

    • 概念

    • リファレンス

    Note: デフォルトでは、FrameMaker はトピックタイプをサポートします。 テーブルにトピックタイプのみ含める場合、タイプ属性を設定する必要はありません。

  6. 特定の DITA トピックタイプをテーブルの列に追加するには

    1. テーブルヘッダーのセルに挿入ポインタを配置します。

    2. 属性 ダイアログ（エレメント > 属性を編集）を開きます。

    3. @type 属性を DITA トピックの種類に設定します。

      トピックタイプ - 属性値：トピック

      タスクタイプ - 属性値：task

      概念タイプ - 属性値：concept

      参照タイプ - 属性値：reference

      Important: 属性値は大文字と小文字が区別されます。

      タイプ属性を上記のように設定すると、列タイトルが更新されます。

      更新されたタイプ属性

  7. 関係テーブルの行の各セルで、関連トピックのトピック参照を追加します。 つまり、関連トピックの 1 セットをテーブルの 1 行のセルに含める必要があります。

    テーブル本文セルに関連トピックのトピック参照を追加するには

    1. エレメント カタログ（エレメント > エレメントカタログ）で、挿入ポイントを行のセルに配置します。

      エレメントを挿入 ダイアログが表示されます。

      また、 スマートカタログ を使用して、topicref エレメントを挿入することもできます。

      Ctrl キーを押しながら 1 キーを押すと、 スマートカタログ を選択します。topicref エレメントを選択して追加します。

    2. 「HRef」フィールドで、トピックファイルにパスを入力し、「OK」をクリックします。

      または、「参照」ボタンを使用して、トピックに移動して選択します。

      トピック参照がテーブル行に追加されます。

      Tip: トピック参照をテーブルセルに追加できない場合、列ヘッダーに指定したトピックタイプを確認します。

    3. 1 つの（関連トピックへの）トピック参照をテーブル行の各セルに追加します。

テーブルに複数行がある場合、複数グループの関連トピック（参照）を各行に追加できます。

サンプルの関係テーブルワークフロー

DITA マップで関係テーブルを作成するを行った後に出力をテストするには、FrameMaker の「PDF 形式で保存」オプションを使用します。

  1. DITA マップが選択されていることを確認します。

  2. ファイル > PDF 形式で保存を選択します。

  3. PDF 設定 ダイアログで、「設定」をクリックします。

DITA マップの PDF 出力には、DITA マップの関係テーブルのセルに含めるトピックの 関連リンク 」セクションが表示されます。

Important: 「PDF 形式で保存」の機能は、例のようにこのセクションで使用されます。 FrameMaker の複数チャンネルの発行機能で使用できる出力形式に DITA マップを公開できます。

テーブル行のセルで指定した順序と同じ順序でトピックが表示されます。

また、表示する関連トピックは現在のトピックには含まれません。 同じサンプルの関係テーブルには次が含まれます。

文書ウィンドウの関係テーブル
FrameMaker の文書ウィンドウの関係テーブル

「別名で保存」トピックの「関連リンク」セクションには、次が表示されます。

  • PDF 形式で保存

  • レビュー PDF 形式で保存

  • XML 形式で保存

「別名で保存」（現在の）トピックは表示されません。