FrameMaker の DITA トピックについて
DITA はオーサリングに対してトピックベースのアプローチを使用します。 DITA のトピックは情報の最も小さいエンティティです。 DITA 仕様に従い、トピックは読みやすくなるよう短くする必要がありますが、それ自体で意味がわかるようにする必要もあります。
概念、タスク、参照などの個別のコンテンツに対応するため、DITA 標準は異なる情報タイプを指定します。 各情報タイプは、関連コンテンツのオーサリングをサポートする構造化エレメントを定義します。 例えば、タスクタイプは、<context>
、<example>
、<steps>
、<result>
のように定義されます。
FrameMaker で DITA トピックを作成および管理する方法をご覧ください。
ファイルメニューで、
に移動します。DITA サブメニューが DITA トピックのタイプと、作成可能なマップタイプを表示します。
FrameMaker では、次の DITA トピックタイプをサポートしています。
特定のコンテンツの場合、task、concept、reference、glossentry、glossgroup の種類を使用します。
DITA topicsで仕様を参照してください。
ハウツーまたは手順などのタスク関連のコンテンツに使用します。
「Task topics」の仕様を参照してください。
「~とは何か」などのコンテンツに使用します。 特性や機能に関する概念情報を提供します。
「Concept topics」の仕様を参照してください。
参照コンテンツに使用します。 例えば、製品仕様、API 参照、装置リスト、パーツリストなどです。
「Reference topics」の仕様を参照してください。
単一の用語集の用語および定義に使用します。
「Glossary Entry topics」の仕様を参照してください。
glossentry エレメントのグループに使用します。
glossgroup グループには他の glossgroup エレメントを含めて階層的な用語集構造を作成することもできます。
「Glossary Group topics」の仕様を参照してください。
上記のトピックタイプを含めることのできる最上位レベルのコンテナエレメントです。
DITA containerで仕様を参照してください。
トピックタイプを選択します。
作成したトピックの階層構造を表示するには、
を選択します。DITA トピックは構造化文書です。 つまり、他の構造化アプリケーションに基づいて構造化文書を使用するのと同様に、FrameMaker で DITA トピック構造を使用することを意味します。
構造化トピックでコンテンツを作成する方法について詳しくは、「frm_structauth_sa.html#WS053b9687b4c35b124e2fd7a146eb68148c-8000
FrameMaker の DITA リンクダイアログを使用して関連コンテンツへのリンクを追加する方法を参照してください。
DITA リンクダイアログを使用して、DITA コンテンツに直接リンクまたは間接リンクを挿入します。
使用するリンクエレメントを選択します。
デフォルトでは、エレメントは<リンク>
です。
「リンク」の仕様を参照してください。
直接参照を使用してリンクを作成するには、このオプションを選択します。
詳しくは、「DITA リンクを作成する」を参照してください。
間接参照を使用してリンクを作成し、キー設定ドロップダウンリストからキーを選択するには、このオプションを選択します。
詳しくは、「DITA リンクを作成する」を参照してください。
直接または間接参照を使用してリンクを作成するには、このオプションを選択します。
ターゲットがファイルに設定されている場合は、現在開いているトピックのリストから直接参照に使用する DITA トピックを選択します。また、現在開かれていないトピックを参照して選択することができます。
ターゲットがキーに設定されている場合、間接参照に使用するキーを選択します。DITA キースペースマネージャーダイアログを開くことも可能です。このダイアログで、キースペースを作成して現在のトピックのデフォルトのキースペースを設定します。
リンクを作成したい必要なトピックまたはキーを検索します。このスマート検索は、「フィルター」テキストボックスへの入力開始すると同時にエレメントをフィルターします。コンテンツはエレメントタグ、ID、またはテキスト(内容)に基づいてフィルターできます。
必要なトピックが見つかったら、リンクとして含めるエレメントを選択します。このリンクエレメントは別のトピックとの関係を定義します。
リンクのリテラルラベルまたはテキスト行を提供するエレメントを選択します。
デフォルトでは、エレメントは<リンクテキスト>
です。
リンクのリテラルラベルまたはテキスト行を提供するエレメントを選択します。
デフォルトでは、エレメントは<リンクテキスト>
です。
リテラルテキストとして表示するリンクテキストを指定します。
「書式」を選択し、ドロップダウンリストからリンク書式を選択します。
参照トピックのタイトルを表示します。
<page number> の <topic title> を参照
を表示します。
<page> の <topic title>
外部(非 DITA)リソースへのリンクを挿入します。 DITA 外部リンクダイアログで、外部リンクのソースを指定します - キーまたはリンクターゲット(href)のフィールドを参照してください。
オプションとして、リンクテキストを指定できます。 または、「リンクターゲット(href)」フィールドに入力したリンクをリンクテキストとして使用します。また、外部リンクを挿入するには、メインメニューの
またはコンテキストメニューを挿入します。関連リンクエレメントに最初のリンクを挿入する場合は、関連リンクエレメントの右側の挿入ポイントに配置します。
エレメントパネル(<リンク>
エレメントを挿入します。
DITA リンクダイアログ が表示されます。
使用する DITA リンクエレメントを選択します。
リンクのターゲットを選択します。
リンクはターゲットコンテンツの直接参照または間接参照として追加できます。 詳しくは、DITA 参照を参照してください。
直接リンクを追加するには、リンクを作成する DITA トピック(.xml ファイル)を選択します。
ターゲットの「ファイル」オプションを選択し、参照トピックを含むファイルを選択します。
現在のトピックまたは現在開いているトピックから選択します。または、「参照」ボタンを使用して現在開いていないトピックを選択します。
エレメントリストで、参照するトピックを選択します。
間接リンクを追加するには、DITA キー参照を使用する必要があります。 キー参照について詳しくは、「キースペースを使用した DITA キー参照の管理」を参照してください。
ターゲットの「キー」オプションを選択し、キースペースマネージャーをクリックします。
DITA キースペースマネージャー ダイアログで、定義済みのキーリストからキーを選択し、 OKをクリックします。
「次を使用して表示」ドロップダウンで、リンクテキストを表示するエレメントを選択します。
リンクに表示するテキストまたは書式を指定します。
「挿入」をクリックします。