相互参照の概要と、FrameMaker で相互参照パネルを使用する方法について説明します。
ある文書から別の文書へ、または文書の中の特定の箇所へ、相互参照のリンクを貼ることができます。 FrameMaker では、相互参照を使用してリンクを作成できます。 FrameMaker の相互参照はマーカーに基づいている為、文書の中の相互参照箇所が変更されても、マーカーがそのままである限りはリンクはそのまま残ります。 例えば、文書の特定の見出しに相互参照を作成し、その後見出しの前のコンテンツを見出しに含めるか、削除するとします。 この場合リンク先の見出しの位置は変わりますが、相互参照は破損せずそのままです。
相互参照パネルを開くには、次の操作を実行します。
表示メニューから、パネル/相互参照を選択します。
相互参照パネルは現在の文書の相互参照をリスト表示します。
リストをソートするには、リスト内の列見出しをクリックします。 クリックした見出しに則してリストがソートされます。
列サイズを変更するには:
列と列の間にマウスオーバーして両方向矢印を表示させます。
マウスの左ボタンを押したままドラッグし、列を必要なサイズにしたところでボタンを放します。
相互参照パネルを使用すると以下の操作ができます。
リスト内の相互参照を検索します。 リストのすべての列に SAYT(入力中に候補を検索)機能が備わっています。
文書に相互参照を挿入します。詳しくは、「相互参照を挿入する」を参照してください。
相互参照ダイアログを開いて、相互参照を編集します。 詳しくは、「文書の相互参照を編集する」を参照してください。
選択した相互参照を削除します。詳しくは、「文書中の相互参照を削除する」を参照してください。
現在の文書の選択した相互参照に移行します。
選択した相互参照を編集可能なテキストに変換します。
文書または参照の種類に基づいて相互参照をフィルターします。文書のリストから、次のオプションを選択します。
現在の文書
開いているすべての文書
リストから文書を選択する
参照の種類に応じて次のオプションを選択します。
すべての相互参照
外部相互参照。詳しくは、「文書中の相互参照を削除する」を参照してください。
非決定の相互参照。詳しくは、「非決定の相互参照を管理する
使用可能な相互参照のリストを更新します。
FrameMaker 文書に相互参照を挿入する方法について説明します。
文書に相互参照を挿入すると、現在の文書の別の節や異なる文書の特定の節を参照できるようになります。 文書に相互参照を挿入するまたは構造化文書のエレメントに相互参照を挿入するできます。
相互参照ダイアログを使用すると、文書に相互参照を挿入できます。
相互参照ダイアログ内:
相互参照の参照先の文書を選択します。
相互参照の元に移動します。 参照先が別の文書である場合、その文書を開き、選択した相互参照の段落のタグまで移動します。
次の中から参照先のコンテンツのタイプを選択します。
構造化文書のエレメントに相互参照を挿入します。文書の段落に相互参照を挿入する
構造化文書のエレメントに相互参照を挿入します。文書の相互参照マーカーに相互参照を挿入する
文書中のエレメントの登場順に従って、エレメントをリスト表示できます。 または、各エレメントに適用された固有 ID にしたがって、エレメントをリスト表示できます。
上記で選択したソースの種類に応じて、左下のリストに、選択された文書中の段落タグ、相互参照、エレメントタイプが表示されます。
右のリストボックスにはその特定の段落、相互参照、またはエレメントが表示されます。
相互参照に使用するエレメントタグ(例えば XRef など)を選択します。 詳しくは、構造化文書のエレメントに相互参照を挿入するを参照してください。
書式を選択して、現在の文書で相互参照を表示します。 詳しくは、相互参照書式を管理するを参照してください。
初期設定では、FrameMaker は相互参照書式のリストを提供します。 このオプションを選択して、リストへ追加、編集、削除します。 詳しくは、相互参照書式を管理するを参照してください。
相互参照をテキストに変換ダイアログを表示します。
このダイアログで、次の相互参照を編集可能なテキストに変換できます。
選択した相互参照
特定のフォーマットを持つ相互参照
特定のエレメントタグを持つ相互参照
現在の文書のすべての相互参照
特定の位置に相互参照を挿入します。詳しくは、「文書に相互参照を挿入する」を参照してください。既存の相互参照を選択した場合は、「置換」のオプションを使用して相互参照を更新することができます。 詳しくは、「文書の相互参照を更新する」を参照してください。
通常の文書において、文書中の段落へ相互参照(例えば見出し)を挿入できます。もしくはテキストインセットへも可能です。
単語や語句に相互参照を挿入することもできます。 構造化文書において、階層構造のエレメントへ相互参照を挿入することもできます。
現在の文書で相互参照を挿入する位置に挿入ポイントを配置します。
相互参照パネルで「挿入」をクリックします。
または、挿入メニューから相互参照を選択することもできます。
相互参照ダイアログが表示されます。
「文書」ドロップダウンリストで、参照先段落が含まれる文書を選択します。
段落のタイプと参照する段落を選択します。
「書式」リストから、相互参照を表示する書式を選択します。
例えば、見出しとページを参照する書式は次のように表示されます。
See “Creating cross-references” on page 1
「挿入」をクリックします。
文書から別の文書に段落を移動させる場合、FrameMaker では「文書内の非決定の相互参照を決定する
別の文書への参照をテキストインセット形式で行う場合、テキストインセット中の段落に対してひとつの相互参照を挿入できます。 メインの文書の相互参照リンクを辿ると、ユーザーはその文書内のテキストインセットにリダイレクトされます。
現在の文書で相互参照を挿入する位置に挿入ポイントを配置します。
相互参照パネルで「挿入」をクリックします。
または、挿入メニューから相互参照を選択することもできます。
相互参照ダイアログが表示されます。
文書ドロップダウンリストで、参照先段落を含むテキストインセットで参照される文書を選択します。
段落のタイプと参照する段落を選択します。
「書式」リストから、相互参照を表示する書式を選択します。
例えば、見出しとページを参照する書式は、次のように表示されます。
See “Creating cross-references” on page 1
「挿入」をクリックします。
テキストインセットに段落相互参照を挿入すると、テキストインセットの更新時に相互参照マーカーが失われる場合があります。 マーカーが失われないようにするには、はじめにテキストインセットのソース文書の段落に相互参照を挿入しておきます。
インセットをダブルクリックしてインセットのソースを開き、テキストインセットの属性パネルから 「ソース文書を開く」をクリックします。
ソース文書内の任意の段落に相互参照を挿入します。
相互参照テキストを削除します。 マーカーは残ります。
ソース文書を保存します。そしてテキストインセットを含む文書で、編集/相互参照の更新を選択して、テキストインセットを更新します。
段落にスポット相互参照を挿入しますが、今度はインセットを含む文書内に挿入します。 相互参照は、更新したインセットのマーカーを使用します。
相互参照種類マーカーを使用すると、相互参照を文書の任意の位置に挿入することができます。 また相互参照マーカーを使用して、段落内の単語や語句、またはアンカー枠へリンクすることもできます。 表の中の特定のセルにリンクすることも可能です。 相互参照マーカーを挿入できる箇所であればどこへでもリンクすることが可能です。
参照先に挿入ポイントを配置し、マーカーダイアログを開きます(挿入/マーカー)。
マーカーダイアログで、相互参照マーカーの種類を選択します。
マーカーのテキストを指定し、「新規マーカー」をクリックします。
マーカーに対して任意の名称を指定することができます。 相互参照ダイアログで相互参照を挿入する際に、ここで指定した名称を選択します。
参照先に新しいマーカーが挿入されます。
相互参照を作成する位置に挿入ポイントを配置します。
ソースの種類ドロップダウンリストで、相互参照マーカーを選択します。
マーカーの種類リストで、相互参照を選択します。
相互参照マーカーのリストで、手順 1 から 3 で作成したマーカーを(名前から)選択します。
相互参照を挿入するには、「文書の段落に相互参照を挿入する」の手順に従って残りの手順を実行します。
構造化文書においては、複数段落への相互参照や相互参照マーカーの他に、現在の文書や別の構造化文書のエレメントにも相互参照を挿入することができます。
現在の文書で相互参照を挿入する位置に挿入ポイントを配置します。
相互参照パネルで「挿入」をクリックします。
または、挿入メニューから相互参照を選択することもできます。
相互参照を挿入ダイアログが表示されます。
相互参照の挿入に使用する DITA エレメントを選択します。
「ターゲット」領域で、参照先エレメントを含めるファイル、キースペース、またはその両方を選択します。
リストからターゲットエレメントを選択します。
リストには、エレメントの種類、ID、およびエレメントを使用するコンテンツの情報が表示されます。
「表示」セクションで、相互参照のテキストを指定するか、ドロップダウンリストから書式を選択します。
例えば、参照_タイトル_および_ページ書式では次のように表示されます。
See “Creating cross-references” on page 1
「挿入」をクリックします。
構造化文書でエレメントに相互参照を挿入する場合、FrameMaker では参照先およびソースのエレメントの ID 属性ならびに IDRef 属性が各々使用されます。
ID 属性に値が設定されていないエレメントに相互参照を挿入する場合は、FrameMaker はその属性に対して固有の値を割り当てます。 ただし、ID 属性が読み取り専用ではない場合は、ユーザーが属性値を設定することができます。
参照先のエレメントが定義済みの ID 属性を持っていることを確認する必要があります。 持っていない場合は、他のエレメントを使用するか構造化アプリケーションの定義を変更する必要があります。
FrameMaker で相互参照を管理、編集、削除、更新する方法、相互参照書式を操作する方法、および未解決の相互参照を識別および管理する方法について説明します。
文書中の既存の相互参照は編集または削除できます。編集については「文書の相互参照を編集する」、削除については「文書中の相互参照を削除する」を参照してください。また、相互参照の書式を編集することで、文書出力の際の相互参照の表示方法を変更できます。 例えば、見出しのテキストのみ表示させ、相互参照にはページ番号を含まないよう選択できます。 詳しくは、「 相互参照書式を管理する」を参照してください。 また文書の相互参照は更新できます。 例えば、参照先のコンテンツが変更された場合、更新します。 詳しくは、「文書の相互参照を更新する」を参照してください。また、参照先コンテンツに変更が加えられると、現在の文書の相互参照が破損する恐れがあります。 非決定の相互参照を特定して対処するには、「 非決定の相互参照を管理する.
相互参照ダイアログを使用することで、相互参照の参照先を含めた既存の相互参照に関連付けられているどの様な属性も変更することができます。
既存の相互参照では、文書の中のその相互参照をダブルクリックします。
または、相互参照パネルを開き(
)、パネル内の「相互参照」を選択してから「編集」をクリックします。「相互参照ダイアログ」が表示されます。
相互参照ダイアログで次の事項を更新することができます。
参照先の文書、段落、相互参照、またはエレメント
エレメントタグ - 相互参照が構造化文書のエレメントの場合
相互参照の書式
「書式の編集」をクリックして「相互参照の書式を編集ダイアログこのダイアログを使用して相互参照の書式を追加、編集、または削除します。 詳しくは、相互参照書式を管理するを参照してください。
文書中の相互参照をテキストに変換します。
「置換」をクリックして相互参照を更新します。
文書中の相互参照を削除すると、その相互参照と共に関連付けられたテキストも削除されます。 例えば、次のような相互参照が文書に挿入されているとします。
See “Creating cross-references” on page 1
これを削除すると、当該の相互参照が文書カタログから削除されるとともに、文書から「1 ページ目の「相互参照を作成する」を参照すること」というテキストが削除されます。
相互参照パネルを開きます(
)。パネルで相互参照を選択して、「削除」をクリックします。
または、文書内の相互参照を選択してキーボードの「Delete」キーを押すことでも削除できます。 ただしこの場合、それに続くテキストも常に削除されることになります。
文書に相互参照を挿入する場合は、書式を選択してその文書に関連させる必要があります。
例えば、見出しとページを参照する書式は、次のように表示されます。
See “Creating cross-references” on page 1
「書式」ドロップダウンリストに使用可能な書式が表示されます。 文書に相互参照を挿入する際にはいずれの書式も選択することができます。 または、書式の編集や新規作成も可能です。 相互参照書式は各 FrameMaker 文書ごとに固有のものとなります。 ただし、「 相互参照書式を取り込む.
相互参照の書式を編集ダイアログを使用して現在の文書の相互参照書式を作成、編集、または削除できます。
相互参照の書式を編集ダイアログで次の事項を編集できます。
既存の書式の名前を更新、または新しい書式の名前を指定します。
相互参照書式を定義します。
書式を定義するには、任意の固定テキストを入力します。例えば、定義で指定されたテキストを表示する文字列などが挙げられます。 コンテキスト情報を表示するには、構成要素リストの定義を使用することでも可能です。
例えば、デフォルトの見出しとページ書式は次のように定義されています。
“<$paratext>” on page\ <$pagenum>
山形かっこ(<>)中に含まれる($)記号以降が定義の構成要素部分です。 相互参照書式の中のこのような記述にぶつかると FrameMaker は記述をその構成要素の定義に従い解釈します。 上記の例を FrameMaker は次のように解釈します。
相互参照の段落の段落テキスト
相互参照した段落のページ番号
相互参照の結果は次のように表示されます:
“Inserting cross-references” on page 25
詳しくは、相互参照書式の構成要素を参照してください。
定義に構成要素の命名方式に従っていない文字が含まれる場合、これらの文字は定義で記載されたとおりに表示されます。 上の例を使用すると、見出しとページの書式は以下のように定義されています。
“<$paratext>” on page\ <$PageNum>
相互参照の結果は次のように表示されます:
“Inserting cross-references” on page <$PageNum>
書式を作成します。 詳しくは、「相互参照書式の作成」を参照してください。
既存の書式を編集します。 詳しくは、「相互参照書式の編集」を参照してください。
既存の書式を削除します。 詳しくは、「相互参照書式の削除」を参照してください。
相互参照書式を作成して現在の文書に使用できます。 別の文書で新しい書式を使用するには、「相互参照書式を取り込む
「相互参照の書式を編集ダイアログ」で、名前フィールドに相互参照名を入力します。
「定義」フィールドで、相互参照書式を定義します。
書式を定義するには、相互参照でそのまま表示される任意のテキスト(文字や番号など)を入力できます。
構成要素を使用して相互参照にコンテキスト情報を表示します。
構成要素を定義に追加するには、適切な場所に挿入ポイントを配置し、構成要素リストの「定義」をクリックします。
山形かっこ(<>)に定義を含め、定義の前に($)記号を含めることで、構成要素の定義を入力できます。
詳しくは、相互参照書式の構成要素を参照してください。
相互参照書式を作成するには、「追加」をクリックします。
既存の相互参照書式を変更して現在の文書に使用できます。 別の文書で更新された書式を使用するには、「相互参照書式を取り込む
「相互参照の書式を編集ダイアログ」で、書式リストから既存の書式を選択します。
「定義」フィールドで、相互参照書式の定義を編集します。
相互参照でそのまま表示される任意のテキスト(文字や番号など)を入力できます。
構成要素を使用して相互参照にコンテキスト情報を表示します。
構成要素を定義に追加するには、適切な場所に挿入ポイントを配置し、構成要素リストの「定義」をクリックします。
山形かっこ(<>)に定義を含め、定義の前に($)記号を含めることで、構成要素の定義を入力できます。
詳しくは、相互参照書式の構成要素を参照してください。
「変更」をクリックして、選択した相互参照書式を更新し、「完了」をクリックします。
相互参照を更新ダイアログが表示されます。
書式の定義を更新する場合、以下の場所における参照の更新を選択する必要があります。
現在の文書
現在の文書で相互参照によって参照されているすべての開いている文書
現在の文書で相互参照によって参照されているすべての文書
または、どの相互参照でも書式変更を反映しないようにするには、「キャンセル」をクリックします。
文書内で使用されていない相互参照書式を削除できます。 現在使用中の相互参照書式も削除できます。 現在の文書で使用されている相互参照書式を削除すると、その書式を使用するすべての相互参照が編集可能なテキストに変換されるというメッセージが表示されます。
「相互参照の書式を編集ダイアログ」で、書式リストから既存の書式を選択します。
「削除」をクリックし、文書カタログから選択した相互参照書式を削除するには「完了」をクリックします。
削除済みの書式を使用するすべての相互参照を編集可能なテキストに変更するようメッセージが表示されます。
追加または編集する相互参照書式は現在の文書で使用することができます。 これらの書式を他の文書で使用できるようにするには、書式を取り込む必要があります。
他の文書に取り込まれる相互参照書式を含む文書を開きます。
書式の取り込み先となる文書を開きます。
書式の取り込み先となる文書が現在選択されていることを確認します。
から、書式を取り込むダイアログを開きます。
文書から取り込むドロップダウンリストで、ソース文書を選択し、「相互参照書式」チェックボックスのみがチェックされていることを確認します。
すべてを選択解除ボタンを使用すると、まずすべてのチェックを外し、続いて「相互参照書式」チェックボックスをチェックできます。
相互参照書式を取り込むには、「取り込み」をクリックします。
相互参照書式を追加したり編集したりする場合、構成要素を使用して相互参照内のコンテキスト情報を表示することができます。次の節は、相互参照書式の作成に使用できる構成要素について詳しく説明します。
次の構成要素は、相互参照を含む文書のソースファイルについての情報を提供します。
構成要素 |
説明 |
---|---|
<$filename> |
ソース文書の名前 |
<$fullfilename> |
ソース文書の完全なパス |
<$volnum> |
ソース段落を含む文書の巻番号 |
<$chapnum> |
ソース段落を含む文書の章番号 |
次の構成要素は、相互参照によって参照されるソース段落についての情報を提供します。
構成要素 |
説明 |
---|---|
<$pagenum> |
ソース段落のページ番号 |
<$paratext> |
ソース段落の自動番号以外のテキスト(文字カタログ書式を適用してソース段落内のテキストの文字書式を変更すると、フォント名、上付き文字および下付き文字の各属性は相互参照のテキストに保存されます) |
<$paratag> |
ソース段落のタグ |
<$paranum> |
ソース段落全体の自動番号(自動番号書式のテキストも含む) |
<$paranumonly> |
ソース段落の自動番号のカウンター(カウンター間のどの文字も含む) |
通常、サブセクションの相互参照では、そのサブセクションを含む上位レベルのセクションを示します。 例えば、この下位見出しへの相互参照は、次の例のようにそのサブ見出しを含む上位の見出しを指定します。 「Plate tectonics」の「Types of plate boundaries」を参照してください。 この例の場合、「Types of plate boundaries」がソース段落であり、「Plate tectonics」は、このソース段落の上位の見出しです。
各構成要素では、参照する段落のタグで角かっこ([ ])内の tag を置き換えますが、角かっこは削除しません。 例えば、「見出し 1」というタグが付いている前の段落のテキストを参照する場合は、<$paratext[見出し 1]> を指定します。
構成要素 |
説明 |
---|---|
<$pagenum[tag]> |
指定のタグを持つ先行段落のページ番号 |
<$paratext[tag]> |
指定のタグを持つ先行段落の自動番号以外のテキスト(文字カタログ書式を適用してソース段落内のテキストの文字書式を変更すると、フォント名、上付き文字および下付き文字の各属性は相互参照のテキストに保存されます) |
<$paratag[tag]> |
指定のタグを持つ先行段落のタグ |
<$paranum[tag]> |
指定のタグを持つ先行段落の全体の自動番号(自動番号書式のテキストも含む) |
<$paranumonly[tag]> |
指定のタグを持つ先行段落の自動番号のカウンター(カウンター間の文字も含む) |
次の構成要素を使用して、構造化文書のエレメントを参照する相互参照書式を作成します。
構成要素 |
説明 |
---|---|
<$elempagenum> |
ソースエレメントのページ番号 |
<$elemtext> |
ソースエレメントのテキスト(最初の段落区切りまで)。自動番号は含まれませんが、エレメント定義で指定されている接頭辞と接尾辞は含まれます。 |
<$elemtextonly> |
ソースエレメントのテキスト(最初の段落区切りまで)。自動番号およびエレメント定義で指定されている接頭辞と接尾辞は含まれません。 |
<$elemtag> |
ソースエレメントのタグ。 |
<$elemparanum> |
ソースエレメントの最初の段落(またはソースエレメントを含む段落)の全体の自動番号。自動番号書式のすべてのテキストが含まれます。 |
<$elemparanumonly> |
ソースエレメントの最初の段落(またはソースエレメントを含む段落)の自動番号のカウンター。カウンター間の文字も含まれます。 |
<$attribute[name]> |
指定した名前が割り当てられている属性の値(値が指定されていない場合は、初期設定値)。 |
相互参照のソースコンテンツが更新された場合、現在の文書の相互参照を更新する必要があります。 例えば、見出しへの段落相互参照を作成して見出しのテキストを変更する場合、その相互参照を含む文書で相互参照を更新する必要があります。
文書を開くたびに文書内の相互参照は更新されます。 または、すでに開いている文書の相互参照を手動で更新することもできます。 さらに、FrameMaker を開くたびに文書内の相互参照が更新されるのを回避することができます。
編集メニューから、「参照を更新」を選択します。
参照を更新ダイアログで、「すべての相互参照」をチェックして「更新」をクリックします。
FrameMaker が相互参照を決定できない場合は、非決定の相互参照を更新ダイアログボックスが表示されます。非決定の相互参照について詳しくは、非決定の相互参照を管理する.
デフォルトでは、FrameMaker は、文書を開くたびに文書内の相互参照を更新します。 ただし、文書に大量の相互参照が含まれる場合、文書内の相互参照に対する検証が原因で文書の読み込みに時間がかかる場合があります。
文書を開いたときに FrameMaker が相互参照を更新しないようにするには、以下の手順に従います。
を更新を選択します。
参照を更新ダイアログで、右上隅にあるコマンドドロップダウンリストを開き、「自動更新しない」を選択します。
参照を自動更新しないダイアログで、「すべての相互参照を自動更新しない」にチェックを入れ、「設定」をクリックします。
相互参照のソースが変更されて FrameMaker が参照先の参照を更新できない場合、FrameMaker はその相互参照を非決定としてレポートします。これは、ソース文書またはソースコンテンツが削除された場合などに起こる可能性があります。
FrameMaker は、以下の場合に相互参照を非決定としてレポートします。
相互参照のマーカーまたはソースが異なるファイルに移動されたか、ファイルが移動またはその名前が変更された場合。
ソースが削除された場合、またはソースが段落または相互参照マーカーであり、ソースが削除されたとマーカーが示している場合。
マーカーを含むファイルを他のユーザーが開いている場合。
ソースエレメントの ID 属性の値や相互参照の ID 参照属性(@IDRef
)の値を変更または削除した場合。
以下の方法で、文書内の非決定の相互参照のリストを表示できます。
相互参照パネルを開きます( )。
参照ドロップダウンリストで、「非決定の相互参照」を選択します。
このリストには非決定の相互参照が表示されます。 相互参照を更新ダイアログを使用して、文書内の非決定の相互参照を決定する。
文書内にある非決定の相互参照のリストを生成することもできます。
を選択します。
スタンドアロンの参照索引としてリストを作成するように選択するか、または索引を新しいブックに含めます。
「非決定の相互参照」を「含める参照」リストに移動し、「設定」をクリックします。
生成されたリストには、非決定の相互参照ごとにページ番号が含まれ、存在しないソースが内部(現在の文書)または外部(他の文書)のどちらであるかが示されます。 リストには、ソース段落のタグとテキスト(非構造化文書)または ID、エレメントタグおよびソースエレメントのテキスト(構造化文書)などの追加情報も含まれます。相互参照マーカーの相互参照の場合は、リストにマーカーテキストが含まれます。
文書内の非決定の外部相互参照を決定するには:
参照を更新ダイアログを開きます。
を更新で、コマンドドロップダウンリストをクリックし、「非決定の相互参照を更新」を選択します。
非決定の相互参照を更新ダイアログが表示されます。
xx 個の非決定の相互参照のソースファイルスクロールリストで、非決定の相互参照のソースを含んでいたファイルを選択します。スクロールリストの下にあるテキストに、選択したファイルを参照する非決定の相互参照の数が表示されます。
相互参照を含む代替文書に移動して選択します。
xx 個の非決定の相互参照のソースファイルスクロールリストに表示されている他のファイルへの相互参照を決定するには、手順 3 と 4 を繰り返して、「OK」をクリックします。
相互参照マーカーへの相互参照を決定するには、相互参照マーカーおよび相互参照を再度作成する必要があります。詳しくは、文書の相互参照マーカーに相互参照を挿入するを参照してください。
同様に、構造化文書のエレメントへの相互参照を決定するには、相互参照を再度作成する必要があります。詳しくは、構造化文書のエレメントに相互参照を挿入するを参照してください。