リンク/Xref タブ
「リンク/Xref」タブでは、リンクまたは相互参照を DITA トピックに挿入できます。リソースマネージャを開いていない状態で、 > メニュー項目を選択するか、「リンク」ツールバーボタンをクリックすると、リソースマネージャが開き、「リンク/Xref」タブが表示されます。このタブがリソースマネージャで使用できるのは、トピックまたは特殊化されたトピックを編集しているときです。
「リンク/Xref」タブには 2 つの状態があります。1 つは、ローカル文書へのリンクまたは相互参照を挿入する場合。もう 1 つは、インターネット上の文書へのリンクまたは相互参照を挿入する場合です。
ローカル文書へのリンクまたは相互参照を挿入する場合のオプション
ローカル文書へのリンクまたは相互参照を挿入する場合、「リンク/Xref」タブには以下のオプションが表示されます。
• 「検索先」 - リソースマネージャブラウザに表示するコンテンツの場所を指定します。
ドロップダウンリストから場所を選択します。このフィールドにはブラウザで現在使用可能な場所が常に表示されます。ブラウザでフォルダをダブルクリックすると、そのフォルダが「検索先」フィールドに表示されます。このリストで「Web」を選択した場合は、「リンク/Xref」タブの状態が変わり、インターネット上の文書への参照を挿入できるようになります。
このリストには
「お気に入りの場所」
の選択が含まれます。このオプションを選択すると、ブラウザに表示される場所が
「お気に入りの場所」ノードに変わり、ここに保存済みのお気に入りの場所のリストが一覧表示されます。
リストには
「履歴」
オプションも含まれます。このオプションを選択すると、ブラウザに表示される場所が
「履歴」ノードに変わり、ここに現在のセッションで訪れたすべての場所のリストが一覧表示されます。
• 「メニュー」ボタン
- 以下のオプションを選択できるメニューが表示されます。
◦ 「開く」 (後ろに文書名) - ブラウザ内で文書を選択している場合は、新しいウィンドウが開いてその文書が表示されます。
選択している文書のタイプが XML、DITA、SGML、または HTML である場合、その文書は Arbortext Editor の新規ウィンドウで開かれます。その他のタイプの文書やグラフィックは、それぞれに関連付けられているアプリケーションで開かれます。たとえば、グラフィックはお手元のグラフィック用デフォルトアプリケーションで開かれます。
◦ 「履歴をクリア」 - ブラウザの「履歴」ノードから訪問した場所のリストが消去されます。
このオプションは、「履歴」ノードが選択されている場合のみ表示されます。
◦ 「お気に入りに追加」 - 選択した場所を「お気に入りの場所」に追加します。
このオプションは、ファイルシステムフォルダ、コンテンツ管理システム (CMS) フォルダ、または同様の場所がブラウザで選択されている場合のみ表示されます。
◦ 「お気に入りから除去」 - 選択した場所を「お気に入りの場所」から除去します。
このオプションは、「お気に入りの場所」リストでアイテムが選択されている場合のみ表示されます。
◦ 「上へ移動」 - 「お気に入りの場所」リストのアイテムを、リスト内で 1 レベル上へ移動します。
このオプションは、「お気に入りの場所」リストでアイテムが選択されている場合のみ表示されます。
◦ 「下へ移動」 - 「お気に入りの場所」リストのアイテムを、リスト内で 1 レベル下へ移動します。
このオプションは、「お気に入りの場所」リストでアイテムが選択されている場合のみ表示されます。
◦ 「お気に入りをエクスポート」 - 「名前を付けて保存」ダイアログボックスが開き、現在のお気に入りの場所のリストを XML ファイルに保存できます。
このオプションは、ブラウザで「お気に入りの場所」ノードが選択されている場合のみ表示されます。このオプションではお気に入りが XML ファイルに保存されます。「お気に入りをインポート」メニュー項目を使用して、このファイルをお気に入りのリストとしてインポートすることができます。この XML ファイルは、お気に入りのリストの保存目的のみのものなので、修正しないでください。
◦ 「お気に入りをインポート」 - 「開く」ダイアログボックスが開き、エクスポートされた「リソースマネージャ」のお気に入りリストを含む XML ファイルを選択できます。
このオプションは、ブラウザで「お気に入りの場所」ノードが選択されている場合のみ表示されます。このオプションでは、「お気に入りをエクスポート」メニュー項目を使用してエクスポートしたお気に入りのリストとしてインポートできます。
「開く」ダイアログボックスでファイルを選択して「開く」をクリックすると、別のダイアログボックスが開き、現在のお気に入りのリストとマージするか置換するかを尋ねられます。インポートしたリストにあり、現在のリストにはまだ存在していない場所を、お気に入りのリストに追加するには、「マージ」をクリックします。現在のお気に入りのリストをインポートしたリストによって完全に置き換えるには、「置換」をクリックします。
◦ 「チェックアウトして編集」 - 選択した CMS オブジェクトを開いて Arbortext Editor で編集します。
オブジェクトをまだチェックアウトしていない場合、リソースマネージャがオブジェクトを自動的にチェックアウト (ロック) します。一度の操作で依存するオブジェクトをチェックアウトすることもできます。このメニューは PTC サーバー接続オブジェクトのみに使用します。
◦ 「チェックアウト」 - 選択したロックされていない CMS オブジェクトをチェックアウト (ロック) します。
一度の操作で依存するオブジェクトをチェックアウトすることもできます。このメニューは PTC サーバー接続オブジェクトのみに使用します。
◦ 「チェックアウトを解除」 - CMS オブジェクトのチェックアウトをキャンセルして、チェックアウトしたバージョンに加えた変更をすべて破棄します。
チェックアウトをキャンセルした後にその文書オブジェクトを Arbortext Editor で開くと、読み取り専用に変わります。このメニューは PTC サーバー接続オブジェクトのみに使用します。
このメニューは PTC サーバー接続オブジェクトのみに使用します。
◦ 「CMS のサーチ」 -
「サーチ」ダイアログボックスを表示します。
このメニューは PTC サーバー接続オブジェクトのみに使用します。「サーチ」ダイアログボックスでは、クエリを入力してサーチ条件に一致する CMS オブジェクトすべてを検索できます。サーチ結果は「リソースマネージャ」ブラウザの「CMS のサーチ結果」パートに表示されます。
◦ 「CMS のサーチ結果をクリア」 - リソースマネージャブラウザの「CMS のサーチ結果」パートに追加された CMS オブジェクトを消去します。
このメニュー項目は、サポートされる CMS アダプタに対してのみ使用できます。このオプションは、オブジェクトを CMS から除去するわけではありません。リソースマネージャブラウザから除去するだけです。
高度なグラフィックにリンクしている場合のみ、「リンク/Xref」タブでこのメニューを使用できます。リンクを修正するための「リンク/Xref」タブでこのメニューを使用する場合、このメニュー項目の名前は「ハイライトリンクを修正」になります。「リンクを追加」ダイアログボックスでこのメニューを使用する場合、このメニュー項目の名前は「ハイライトリンクを追加」になります。
高度なグラフィックにリンクしている場合のみ、「リンク/Xref」タブでこのメニューを使用できます。リンクを修正するための「リンク/Xref」タブでこのメニューを使用する場合、このメニュー項目の名前は「アニメーションリンクを修正」になります。「リンクを追加」ダイアログボックスでこのメニューを使用する場合、このメニュー項目の名前は「アニメーションリンクを追加」になります。
高度なグラフィックにリンクしている場合のみ、「リンク/Xref」タブでこのメニューを使用できます。リンクを修正するための「リンク/Xref」タブでこのメニューを使用する場合、このメニュー項目の名前は「ビューリンクを修正」になります。「リンクを追加」ダイアログボックスでこのメニューを使用する場合、このメニュー項目の名前は「ビューリンクを追加」になります。
◦ 「タブ間で場所を同期」 - 別のタブに切り替えるとき、または別の「リソースマネージャ」ダイアログボックスを開くときに、リソースマネージャのブラウザで最初にブラウズする場所を保持するかどうかを指定します。
ditasynctabs アドバンス環境設定により、デフォルトでこの機能をオンにするかオフにするかを指定します。
• 「前のフォルダ」ボタン (
) - ブラウザの表示を、1 つ前に表示したフォルダに戻します。
リソースマネージャは現在のセッションで表示したフォルダの履歴を保持しており、このボタンを使用してブラウザのフォルダ表示を戻すことができます。現在のセッションで 1 つしかフォルダを表示していない場合、このボタンは無効です。
• 「1 レベル上に移動」ボタン
- ブラウザに表示する場所を、現在の階層の 1 レベル上に移動します。
階層の最上位になっている場合、このボタンは無効です。
• 「再表示」ボタン
- ブラウザの表示を更新して、ブラウザに表示されているオブジェクトに加えられた変更を反映します。
• 「Web をブラウズ」ボタン
-
「リンク/Xref」タブの状態を、インターネットから参照を挿入する状態に変更します。
• 「現在の文書」ボタン -
- 現在の文書をブラウザビューで開きます。
• 「CMS オブジェクトブラウザを使用」ボタン
-
PTC サーバー接続またはリポジトリアダプタ用の
ブラウザを開きます。
このボタンはコンテンツ管理システム (CMS) に PTC サーバー接続またはリポジトリアダプタ経由で接続しているときにだけ使用可能です。
• 「CMS のサーチ」ボタン
-
「サーチ」ダイアログボックスを開きます。
このボタンは PTC サーバー接続 オブジェクトに対してのみ使用できます。「サーチ」ダイアログボックスでは、サーチ基準に一致する CMS オブジェクトすべてを検索するクエリを入力できます。サーチ結果は「リソースマネージャ」ブラウザの「CMS のサーチ結果」パートに表示されます。
• 「フィルタ」 - ブラウザに表示されるファイルおよび文書のエレメントのリストをフィルタできます。
このオプションにテキストを入力すると、ブラウザに表示されるファイルおよび文書のエレメントのリストがフィルタされ、入力したテキストがラベルに含まれるファイルまたはエレメントのみが表示されるようになります。この場合、「フィルタ」オプションでは、ブラウザの背景色が薄い黄色になり、ブラウザのコンテンツがフィルタ中であることを示します。
たとえば、"test" と入力すると、ラベルに "Test"、"testing"、"test cases" などを含むオブジェクトのみがブラウザに表示されます。文書を展開して文書内のエレメントを表示している場合は、表示されるエレメントもフィルタされます。この場合、ラベルにフィルタのテキストが含まれていない場合でも、文書はブラウザに表示されたままになります。
フィルタリングでは大文字と小文字は区別されません。フォルダ (およびフォルダ的なオブジェクト) はフィルタされません。「フィルタ」オプションに複数の用語を入力した場合、一致するラベルにはこれらすべての用語が含まれる必要があります。
• リソースマネージャブラウザ - ファイルシステム、コンテンツ管理システム (CMS)、文書階層を表示します。
リソースマネージャブラウザでは、ファイルシステムまたは CMS にあるコンテンツを見つけて文書に挿入できます。ブラウザはファイルシステムまたは CMS のコンテンツを階層表示します。フォルダとファイルの表示に加えて、DITA 文書のコンテンツを表示することもできます。たとえば「リンク/Xref」タブを使用しているときは、ブラウザには文書の現在のコンテンツに基づいてリンクまたは相互参照として使用できる DITA 文書のエレメントが表示されます。エレメントにタイトルが付いている場合は、ブラウザのエレメントの横にタイトルが表示されます。ditahideids アドバンス環境設定によっては、エレメントの ID も表示されます。
文書に高度なグラフィックが含まれている場合、それらのグラフィックには特殊なアイコン
が表示されます。このアイコンはブラウザのグラフィックの下に表示され、そのグラフィックに挿入することができる高度なグラフィックリンクのタイプを示します (例:
「ハイライトリンクを挿入」)。高度なグラフィックを使用すれば、選択されたときにそのグラフィックが修正されるリンクを作成できます。高度なグラフィックを使用すると、そのグラフィックの異なるビューを開いたり、アニメーションを開始したり、グラフィックの一部をハイライト表示するためのリンクが有効になります。高度なグラフィックにこのようなリンクを作成する場合は、使用するグラフィックを選択し、ブラウザの
を選択するか、
「メニュー」ボタンまたは
リソースマネージャのショートカットメニューを使用して、作成するリンクのタイプを指定します。グラフィックへの通常のリンクを挿入するだけの場合は、通常どおり
「挿入」ボタンをクリックします。
キー定義を含む DITA マップのコンテンツをブラウズしている場合は、そのマップを拡張することができ、キー定義はキーアイコン
によって示されます。キー定義を選択すると、キー名が
Keyref オプションに挿入されます。キー定義が選択された状態で参照を挿入する場合、キー定義の
href、
scope、
type、および
format 属性の値が挿入されたリンクまたは相互参照に使用されます。
navtitle 属性の値がリンクテキストに使用されます。
ditakeyrefui アドバンス環境設定によって、
リソースマネージャブラウザで該当するオプションが使用できるかどうかが決まります。
ブラウザには、保存したお気に入りの場所のリストを含む
「お気に入りの場所」 (
) ノードが含まれます。お気に入りの 1 つをダブルクリックすると、その場所がブラウザに表示されます。場所が削除された、または CMS フォルダなのに CMS にログオンしていないなど、お気に入りの場所が現在使用できない場合、フォルダにはそのステータスを示す特別なアイコン
が表示されます。
ブラウザには現在のセッションで訪れたすべての場所を含む
「履歴」 ノードも表示されます。場所をダブルクリックすると、その場所がブラウザに表示されます。
階層のプラス記号 (+) をクリックすると、階層の下位レベルまたは文書のコンテンツが表示されます。マイナス記号 ( - ) をクリックすると、階層のレベルまたは文書が閉じられます。階層内のオブジェクトを選択するには、そのオブジェクトをクリックします。フォルダにブラウザのフォーカスを移動するには、そのフォルダをダブルクリックします。文書エレメントをダブルクリックすると、そのエレメントへのリンクまたは相互参照が文書に挿入されます。
以下の方法で、ブラウザに表示されているコンテンツへの参照を文書に挿入することができます。
◦ エレメントをハイライトして「挿入」ボタンを選択する
◦ エレメントをダブルクリックする
◦ ドラッグアンドドロップを使用する
このリストで「Web」ノードをダブルクリックした場合は、「リンク/Xref」タブの状態が変わり、インターネット上の文書への参照を挿入できるようになります。
• 「タイプ」 - リソースマネージャブラウザに表示する文書のタイプを指定します。
このドロップダウンリストを使用して、ブラウザに表示する文書を文書のタイプによって絞り込みます。以下の文書のタイプを選択できます。
◦ 「トピック」 - DITA トピック文書だけを表示します。
◦ 「トピックまたはマップ」 - DITA マップ文書またはトピック文書を表示します。
◦ 「マップ」 - DITA マップ文書だけを表示します。
◦ 「イメージ」 - グラフィックファイルだけを表示します。
◦ 「PDF」 - PDF 文書だけを表示します。
◦ 「HTML」 - HTML 文書だけを表示します。
◦ 「任意」 - すべてのタイプの文書を表示します。
• 「表示」 - リソースマネージャのブラウザに表示する DITA 文書のエレメントタイプを指定します。
このドロップダウンリストを使用して、ブラウザに表示するエレメントをエレメントのタイプによって絞り込みます。
• 「挿入」 - 文書に挿入するエレメントのタイプを指定します。
このドロップダウンリストを使用して、文書に挿入するエレメントのタイプを選択します。特殊化されていない DITA トピックの場合、xref エレメントまたは link エレメントのみ使用できます。
• 「Keyref」 - オプションで、参照のために Keyref 属性に挿入するキー名を入力することができます。
挿入している参照にキー参照を追加する場合は、このオプションを使用します。ditakeyrefui アドバンス環境設定によって、リソースマネージャで該当するオプションが使用できるかどうかが決まります。ブラウザで選択されたオブジェクトについて、ditakeycontext または ditakeybaselist アドバンス環境設定のキー定義マップのいずれか一方でキーが定義されている場合、デフォルトでそれらのキーがドロップダウンリストに表示されます。
• 「挿入」ボタン - 選択した文書エレメントへのリンクまたは相互参照を、編集中の文書に挿入します。
文書の現在のコンテキストが有効な挿入ポイントでない場合、このボタンは無効です。
インターネット上の文書へのリンクまたは相互参照を挿入する場合のオプション
インターネット上の文書へのリンクまたは相互参照を挿入する場合、「リンク/Xref」タブには以下のオプションが表示されます。
• 「検索先」 - 「リンク/Xref」タブの状態を決定します。
インターネット上の文書へのリンクまたは相互参照を挿入する場合、このオプションは常に「Web」に設定されます。ドロップダウンリストから別の場所を選択すると、ローカル文書に参照を挿入する状態にタブの状態が変わります。
「メニュー」ボタン (
) - 以下のオプションを選択できるメニューが表示されます。
◦ 「開く」 (後ろに文書名) - 選択は無効になります。
◦ 「CMS のサーチ」 -
「サーチ」ダイアログボックスを表示します。
このメニューは PTC サーバー接続オブジェクトのみに使用します。
◦ 「CMS のサーチ結果をクリア」 - リソースマネージャブラウザの「CMS のサーチ結果」パートに追加された CMS オブジェクトを消去します。
◦ 「タブ間で場所を同期」 - 別のタブに切り替えるとき、または別の「リソースマネージャ」ダイアログボックスを開くときに、リソースマネージャのブラウザで最初にブラウズする場所を保持するかどうかを指定します。
ditasynctabs アドバンス環境設定により、デフォルトでこの機能をオンにするかオフにするかを指定します。
• 「前のフォルダ」ボタン (
) - ブラウザの表示を、1 つ前に表示したフォルダに戻します。
ブラウザで最後に表示した場所が「Web」でない場合、ローカル文書に参照を挿入する状態にタブの状態が変わります。
• 「1 レベル上に移動」ボタン
- 無効になります。
• 「再表示」ボタン
- 無効になります。
• 「Web をブラウズ」ボタン
- 無効になります。
• 「現在の文書」ボタン
- 現在の文書をブラウザビューで開きます。
タブは、ローカル文書の参照を挿入する状態に変わります。
• 「CMS オブジェクトブラウザを使用」ボタン
-
PTC サーバー接続またはリポジトリアダプタ用の
ブラウザを開きます。
このボタンはコンテンツ管理システム (CMS) に PTC サーバー接続またはリポジトリアダプタ経由で接続しているときにだけ使用可能です。
• 「CMS のサーチ」ボタン
-
「サーチ」ダイアログボックスを開きます。
このボタンは PTC サーバー接続 オブジェクトに対してのみ使用できます。「サーチ」ダイアログボックスでは、サーチ基準に一致する CMS オブジェクトすべてを検索するクエリを入力できます。サーチ結果は「リソースマネージャ」ブラウザの「CMS のサーチ結果」パートに表示されます。
• 「URL」 - リンクまたは相互参照に挿入する URL が表示されます。
このフィールドを編集して必要な URL を追加することも、「ブラウザの URL を取得」ボタンを選択して現在アクティブな Web ブラウザに表示されている Web ページの URL をオプションに挿入することもできます。
• 「ブラウザを開く」 - デフォルトの Web ブラウザを開きます。
「URL」オプションに URL が含まれている場合、Web ブラウザが開いてその Web ページが表示されます。このオプションを使用するには、お使いのオペレーティングシステム、または
「環境設定」ダイアログボックスの
「ファイルの場所」環境設定で、デフォルトの Web ブラウザを設定しておく必要があります。
• 「ブラウザの URL を取得」 - 現在アクティブな Web ブラウザに表示されている Web ページの URL を「URL」オプションに挿入します。
このオプションを使用するには、お使いのオペレーティングシステム、または
「環境設定」ダイアログボックスの
「ファイルの場所」環境設定で、デフォルトの Web ブラウザを設定しておく必要があります。
• 「挿入」 - 文書に挿入するエレメントのタイプを指定します。
このドロップダウンリストを使用して、文書に挿入するエレメントのタイプを選択します。特殊化されていない DITA トピックの場合、xref エレメントまたは link エレメントのみ使用できます。
• 「Keyref」 - オプションで、参照のために Keyref 属性に挿入するキー名を入力することができます。
挿入している参照にキー参照を追加する場合は、このオプションを使用します。ditakeyrefui アドバンス環境設定によって、リソースマネージャで該当するオプションが使用できるかどうかが決まります。ブラウザで表示された URL について、ditakeycontext または ditakeybaselist アドバンス環境設定のキー定義マップのいずれか一方でキーが定義されている場合、デフォルトでそれらのキーがドロップダウンリストに表示されます。
• 「挿入」ボタン - 指定した URL へのリンクまたは相互参照を、編集中の文書に挿入します。
文書の現在のコンテキストが有効な挿入ポイントでない場合、このボタンは無効です。