ホーム > DITA トピック

DITA トピック

FrameMaker の DITA トピックについて

DITA はオーサリングに対してトピックベースのアプローチを使用します。 DITA のトピックは情報の最も小さいエンティティです。 DITA 仕様に従い、トピックは読みやすくなるよう短くする必要がありますが、それ自体で意味がわかるようにする必要もあります。

概念、タスク、参照などの個別のコンテンツに対応するため、DITA 標準は異なる情報タイプを指定します。 各情報タイプは、関連コンテンツのオーサリングをサポートする構造化エレメントを定義します。 例えば、タスクタイプは、<context><example><steps><result> のように定義されます。

DITA トピックの作成

FrameMaker で DITA トピックを作成および管理する方法をご覧ください。

  1. ファイルメニューで、新規 > DITA に移動します。

    DITA サブメニューが DITA トピックのタイプと、作成可能なマップタイプを表示します。

    FrameMaker では、次の DITA トピックタイプをサポートしています。

    topic

    特定のコンテンツの場合、task、concept、reference、glossentry、glossgroup の種類を使用します。

    DITA topicsで仕様を参照してください。

    task

    ハウツーまたは手順などのタスク関連のコンテンツに使用します。

    Task topics」の仕様を参照してください。

    concept

    「~とは何か」などのコンテンツに使用します。 特性や機能に関する概念情報を提供します。

    Concept topics」の仕様を参照してください。

    referene

    参照コンテンツに使用します。 例えば、製品仕様、API 参照、装置リスト、パーツリストなどです。

    Reference topics」の仕様を参照してください。

    用語集

    単一の用語集の用語および定義に使用します。

    Glossary Entry topics」の仕様を参照してください。

    glossgroup

    glossentry エレメントのグループに使用します。

    glossgroup グループには他の glossgroup エレメントを含めて階層的な用語集構造を作成することもできます。

    Glossary Group topics」の仕様を参照してください。

    ditabase

    上記のトピックタイプを含めることのできる最上位レベルのコンテナエレメントです。

    DITA containerで仕様を参照してください。

  2. トピックタイプを選択します。

  3. 作成したトピックの階層構造を表示するには、構造 > 構造図を選択します。

  4. DITA トピックは構造化文書です。 つまり、他の構造化アプリケーションに基づいて構造化文書を使用するのと同様に、FrameMaker で DITA トピック構造を使用することを意味します。

    構造化トピックでコンテンツを作成する方法について詳しくは、「frm_structauth_sa.html#WS053b9687b4c35b124e2fd7a146eb68148c-8000

関連コンテンツへのリンクを追加

FrameMaker の DITA リンクダイアログを使用して関連コンテンツへのリンクを追加する方法を参照してください。

DITA リンクダイアログ

DITA リンクダイアログを使用して、DITA コンテンツに直接リンクまたは間接リンクを挿入します。

DITA リンクダイアログ
DITA リンクダイアログを使用し、DITA コンテンツへの直接リンクまたは間接リンクを挿入します。

DITA リンクダイアログを使用するには:

A(DITA エレメント):

使用するリンクエレメントを選択します。

デフォルトでは、エレメントは<リンク>です。

リンク」の仕様を参照してください。

B(ターゲット/ファイル):

直接参照を使用してリンクを作成するには、このオプションを選択します。

詳しくは、「DITA リンクを作成する」を参照してください。

C(ターゲット/キー):

間接参照を使用してリンクを作成し、キー設定ドロップダウンリストからキーを選択するには、このオプションを選択します。

詳しくは、「DITA リンクを作成する」を参照してください。

D(ターゲット/両方):

直接または間接参照を使用してリンクを作成するには、このオプションを選択します。

Ε(ファイル/キー設定):

ターゲットがファイルに設定されている場合は、現在開いているトピックのリストから直接参照に使用する DITA トピックを選択します。また、現在開かれていないトピックを参照して選択することができます。

ターゲットがキーに設定されている場合、間接参照に使用するキーを選択します。DITA キースペースマネージャーダイアログを開くことも可能です。このダイアログで、キースペースを作成して現在のトピックのデフォルトのキースペースを設定します。

F(フィルターテキスト):

リンクを作成したい必要なトピックまたはキーを検索します。このスマート検索は、「フィルター」テキストボックスへの入力開始すると同時にエレメントをフィルターします。コンテンツはエレメントタグ、ID、またはテキスト(内容)に基づいてフィルターできます。

必要なトピックが見つかったら、リンクとして含めるエレメントを選択します。このリンクエレメントは別のトピックとの関係を定義します。

G(次を使用して表示):

リンクのリテラルラベルまたはテキスト行を提供するエレメントを選択します。

デフォルトでは、エレメントは<リンクテキスト>です。

linktext」の仕様を参照してください

H(次を使用して表示):

リンクのリテラルラベルまたはテキスト行を提供するエレメントを選択します。

デフォルトでは、エレメントは<リンクテキスト>です。

linktext」の仕様を参照してください

H(テキスト)

リテラルテキストとして表示するリンクテキストを指定します。

I(書式)

書式」を選択し、ドロップダウンリストからリンク書式を選択します。

DITA デフォルトフォーマット

参照トピックのタイトルを表示します。

See_Title_and_Page

<page number> の <topic title> を参照を表示します。

Title_and_Page

<page> の <topic title>

を表示します。
J(外部リンク)

外部(非 DITA)リソースへのリンクを挿入します。 DITA 外部リンクダイアログで、外部リンクのソースを指定します - キーまたはリンクターゲット(href)のフィールドを参照してください。

オプションとして、リンクテキストを指定できます。 または、「リンクターゲット(href)」フィールドに入力したリンクをリンクテキストとして使用します。また、外部リンクを挿入するには、メインメニューの > 外部参照またはコンテキストメニューを挿入します。

DITA リンクを作成する

  1. 関連リンクエレメントに最初のリンクを挿入する場合は、関連リンクエレメントの右側の挿入ポイントに配置します。

    関連リンクエレメントの右側に挿入ポイントを配置する
    関連リンクエレメントの右側に挿入ポイントを配置

  2. エレメントパネル(表示 > パネル > エレメントカタログ)から、<リンク>エレメントを挿入します。

    DITA リンクダイアログ が表示されます。

  3. 使用する DITA リンクエレメントを選択します。

  4. リンクのターゲットを選択します。

    リンクはターゲットコンテンツの直接参照または間接参照として追加できます。 詳しくは、DITA 参照を参照してください。

    直接リンクを追加するには、リンクを作成する DITA トピック(.xml ファイル)を選択します。

    1. ターゲットの「ファイル」オプションを選択し、参照トピックを含むファイルを選択します。

      現在のトピックまたは現在開いているトピックから選択します。または、「参照」ボタンを使用して現在開いていないトピックを選択します。

    2. エレメントリストで、参照するトピックを選択します。

    間接リンクを追加するには、DITA キー参照を使用する必要があります。 キー参照について詳しくは、「キースペースを使用した DITA キー参照の管理」を参照してください。

    1. ターゲットの「キー」オプションを選択し、キースペースマネージャーをクリックします。

    2. DITA キースペースマネージャー ダイアログで、定義済みのキーリストからキーを選択し、 OKをクリックします。

  5. 次を使用して表示」ドロップダウンで、リンクテキストを表示するエレメントを選択します。

  6. リンクに表示するテキストまたは書式を指定します。

  7. 「挿入」をクリックします。