キー リファレンスとその使用法

マップ内の変数をキーとして定義し、そのキーをマップ内の任意の数のトピックに挿入できます。これはキー リファレンスまたは<keyref>とも呼ばれます。

キーは、定期的に再利用するフレーズや単語を一貫して効率的に管理することができる。

  • 名前またはフレーズ:キーを使用して、プロダクトまたはプロダクト機能名などのアイテムを定義できます。そうすれば、プロダクトまたは機能名が時間の経過とともに変化する場合は、それらのプロダクトや機能を含むすべてのトピックを編集する必要はありません。代わりに、関連するトピックを含むマップのキーを編集します。
  • ハイパーリンク:直接のハイパーリンク(<href>)の代わりにキーを使用して、マップ、トピック、画像など、他のオブジェクトへのコンテキストを意識した参照を作成することもできます。
  • コンテンツ参照:キーの機能とコンテンツ参照(<conref>)の柔軟性を組み合わせて<conkeyref>を作成することで、より大きな情報の一部を指すコンテキストを意識した参照を管理することができます。

キーは強力ですが、それを効果的に使うには、オブジェクトの関係を理解する必要があります。