トピックへのキー参照 (keyref) の挿入

テキストを変数としてトピックに挿入できます。この変数は、一般にキー参照または<keyref>として知られています。

始める前に

キーを追加するには、トピックをチェックアウトし、トピックのコンテキスト マップを選択する必要があります。挿入するキーはコンテキスト マップまたはサブマップで定義されている必要があります。

このタスクについて

キーを活用する1つの方法は、トピックにキーへの参照を挿入することです。

トピックにキーを挿入するには、

手順

  1. Topic Editorで、キーを追加するトピックの場所を選択します。
  2. ツールバーで、Insert links and variables defined as keys をクリックします。
    Insert DITA keyダイアログが開きます。
  3. リストを絞り込むには、挿入したいキーの種類を選択します。
    • すべて
    • URLを参照するキー定義のためのWeb リンク
    • 単語やフレーズを参照するキー定義のためのキーワード
    • 他のDITAオブジェクトを参照するキー定義のためのオブジェクト
  4. キーフィールドで、挿入したいキーを選択します。

    キーネームが角括弧内に表示され、その後ろにキーの値が表示されます。

  5. 要素フィールドで、現在のカーソル位置で有効なエレメントのドロップダウンリストからエレメントを選択します。
  6. Insertをクリックします。

タスクの結果

選択した要素を使用して、選択した位置にキーが挿入されます。そのキーは、陰影の付いた背景と選択可能なリンクアイコンでマークされます。