構造化文書のコンテンツ参照について、およびそのコンテンツを使用して別の DITA トピックのコンテンツ参照を作成する方法について説明します。
コンテンツ参照(conref)は、DITA トピック内のコンテンツ(エレメント)または別の DITA トピックにある DITA マップへの参照を作成するために使用されます。 conref を使用すると、DITA トピック全体のコンテンツ(エレメント)を再利用できます。 conref は、エレメントに割り当てられたDITA ID 属性に基づいています。 これは、トピック内でエレメントの位置が変更されても、ID がそのままであれば参照はそのまま残ることを意味します。
直接参照を使用すると、ターゲットのトピックまたはエレメントを含む DITA トピック(.xml ファイル)を直接指すことができます。または、間接参照を使用して、キースペースで定義されたキーにポイントできます。 詳しくは、「 DITA 参照」を参照してください。
DITA エレメントカタログ内のほとんどすべてのエレメントに対して conref を作成できます。 DITAtopicの conref を作成してトピック
全体を再利用可能にできます。 <keyword>
または <pH>
エレメントを使用し、 <用語>
あるいは単語を再使用することもできます。conref を作成するための唯一の必要条件は、エレメントに DITA ID 属性.
FrameMaker で conref を使用するトピックを設定する方法について説明します。
DITA トピックで conref を作成するには、再利用するコンテンツ(エレメント)が含まれている DITA トピック(直接参照)または DITA マップ(間接参照)を最初に作成する必要があります。 例えば、表、番号リスト、画像を複数のトピック間で再利用するとします。 これらのエレメントはソーストピックに追加する必要があります。 間接参照を使用している場合、トピックは DITA マップに追加されます。 また、エレメントを再利用可能にするには、固有の ID をエレメントに割り当てる必要があります。DITA コンテンツを再利用可能にする方法についての詳細は、「 参照内容の設定」を参照してください。
トピックの設定方法を学び、FrameMaker で conref を使用するように、直接および間接 conref を FrameMaker の DITA コンテンツに追加するために、DITA conref ダイアログを使用する方法を学びます。
DITA Conref ダイアログを使用して、直接または間接 conref を DITA の内容に追加します。
を選択します。
DITA 参照を使用して conref を挿入する場合はこのオプションを選びます。詳しくは、「conref を作成する」を参照してください。
DITA 参照を使用して conref を挿入する場合はこのオプションを選びます。詳しくは、「DITA リンクを作成する」を参照してください。
直接または間接参照を使用してリンクを作成するには、このオプションを選択します。
ターゲットがファイルに設定されている場合は、現在開いているトピックのリストから直接参照に使用する DITA トピックを選択します。また、現在開かれていないトピックを参照して選択することができます。
ターゲットがキーに設定されている場合、間接参照に使用するキーを選択します。DITA キースペースマネージャーダイアログを開くことも可能です。このダイアログでは、キースペースを作成現在のトピック向けにデフォルトのキースペースを設定します。
リンクを作成したい必要なトピックまたはキーを検索します。このスマート検索は、「フィルター」テキストボックスへの入力開始すると同時にエレメントをフィルターします。コンテンツはエレメントタグ、ID、またはテキスト(内容)に基づいてフィルターできます。
必要なトピックが見つかったら、リンクとして含めるエレメントを選択します。このリンクエレメントは別のトピックとの関係を定義します。
conref の一連のエレメントの最終エレメントとしてエレメントを選択します。 詳しくは、「 範囲内のエレメントに対する conref の作成」を参照してください。
FrameMaker での conref の操作方法、conref の作成方法、および更新方法を参照してください。
DITA トピックまたはマップ内で DITA Conref ダイアログを使用して conref を作成できます。
この節は次のトピックを説明します。
現在のトピックまたはマップ内で DITA トピックまたはマップに対する conref を作成するには、ターゲットトピックまたはマップ内で参照内容の設定します。
次に、ターゲット DITA コンテンツへの直接参照または間接参照を作成します。
トピックまたはマップ上で conref を挿入する場所に挿入ポイントを配置します。
トピック内の場所に conref を挿入するには、conref エレメントに関連する挿入ポイントを配置する必要があります。
<li>
(リストアイテム)conref エレメントは、 <ol>
または <ul>
リストに配置する必要があります。
テーブル <row>
は、 <表>
または <simpletable>
に配置する必要があります。
テーブルの <entry>
の場合、挿入ポイントをテーブルの <行>
に配置することはできないので、置き換える既存の <entry>
を選択する必要があります。
を選択します。
DITA Conref ダイアログが表示されます。
リンクはターゲットコンテンツの直接参照または間接参照として追加できます。 詳しくは、 DITA 参照」を参照してください。
ターゲットコンテンツへの直接参照を作成するには、
ターゲットの「ファイル」オプションを選択し、参照トピックを含むファイルを選択します。
DITA トピックを選択すると、固有の ID が割り当てられるエレメントがエレメントリストに表示されます。
固有の ID が割り当てられている、選択したエレメントタグの DITA トピックにあるエレメントが、エレメントリストに表示されます。エレメントに固有の ID が割り当てられていない場合、固有の ID をエレメントに割り当てるできます。
現在のトピックに conref として挿入するエレメントを選択します。
このリストには、エレメントの ID とコンテンツ(テキストエレメントの場合)も表示されます。
ソーストピックの <conref>
エレメントに変更を行った場合、その更新を表示するには、ソーストピックを保存してコンテナのトピックを更新する必要があります。
ターゲットコンテンツへの間接参照を作成するには、
ターゲットの「キー」オプションを選択し、キースペースマネージャーをクリックします。
DITA キースペースマネージャー ダイアログで、定義されたキーリストでキーを選択し、「OK」をクリックします。
キー参照を追加する方法について詳しくは、「キースペースを使用した DITA キー参照の管理」を参照してください。 キースペースを使用した DITA キー参照の管理
キーを選択すると、キースペースに含められる DITA トピックタイプがエレメントタグリストに表示されます。 詳しくは、「キースペースの作成」を参照してください。 キースペースを作成
エレメントタグを選択します。
固有の ID が割り当てられている、選択したエレメントタグの DITA トピックにあるエレメントが、エレメントリストに表示されます。エレメントに固有の ID が割り当てられていない場合、固有の ID をエレメントに割り当てるできます。
conref として挿入するエレメントを選択し、「OK」をクリックします。
「挿入」をクリックします。
範囲内のエレメントに conref を作成することができます。 例えば、まとめて conref を作成したい多数のp(paragraph)エレメントがあるとします。 <p>
例えば、まとめて conref を作成したい多数のp(paragraph)エレメントがあるとします。 すべてのpエレメントに対し conref を 1 つ作成することができます。 <p>
エレメントに対し conref を 1 つ作成することができます。
範囲の最初のエレメントを選択するにはconref を作成するの手順を実行します。ただし、「 <挿入>
」はクリックしません。
Conref 最終エレメントドロップダウンリストで、範囲の最終エレメントを選択して conref に含めます。
「挿入」をクリックします。
再利用可能なエレメントを別のトピックで参照した後にこれを更新する場合、アップデートを表示するにはトピックの conref を更新する必要があります。
トピックの conref を更新するには
を選択します。
DITA 参照を更新 ダイアログが表示されます。
「ファイル内のすべてのトピック参照を更新」を選択します。
現在のトピックのすべての conref が更新されます。