ホーム > DITA 関係テーブル

DITA 関係テーブル

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

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

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

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

DITA マップの使用

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

追加する DITA タイプ

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

  • トピック

  • タスク

  • 概念

  • リファレンス

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

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

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

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

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

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

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

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

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

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

  • URL を指定して

  • レビュー PDF 形式で保存

  • XML 形式で保存

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

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

関係テーブルの作成

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

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

  2. スマートカタログを表示するには、Ctrl + 1 を押して関連テーブルを選択します。

    挿入テーブルダイアログが表示されます。

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

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

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

    注: また、関連トピックの複数グループに対して複数の関係テーブルを作成できます。
  4. 「挿入」をクリックします。

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

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

    構造図から関係テーブルにトピックを追加できる一方、表形式の表示にはさらに使いやすいモードがあります。

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

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

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

    • トピック

    • タスク

    • 概念

    • リファレンス

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

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

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

    3. @type属性をDITAトピックタイプに設定します:

      トピックタイプ-属性値:topic

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

      コンセプトタイプ-属性値:concept

      参照タイプ -属性値:reference

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

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

      更新された type 属性

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

    テーブルのボディセルに関連トピックのトピック参照を追加するには、次の操作を行います。

    1. 行のセルに挿入ポイントを置き、エレメントカタログ(エレメント > エレメントカタログ)で、topicref エレメントをダブルクリックし、セルに追加します。

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

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

      Ctrl+1 を押してスマートカタログを表示します。 topicref エレメントを選択して追加します。

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

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

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

      ヒント: トピック参照をテーブルセルに追加できない場合、列ヘッダーに指定したトピックタイプを確認します。
    3. 1 つの(関連トピックへの)トピック参照をテーブル行の各セルに追加します。

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

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

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

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

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

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

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

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

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

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

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

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

  • PDF 形式で保存

  • レビュー PDF 形式で保存

  • XML 形式で保存

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