キー
異なる材料セットには類似した情報が含まれる場合があり、一部の場所でカスタマイズする必要があります。 キーを使用すると、DITA を操作するときに変数情報をに含めることができます。
このレッスンで使用するサンプル ファイルは、ファイル keys.zip にあります。
キーを有効にする
-
提供されたサンプルファイルのセットをアップロードします。
a. zip ファイルを読み込みます。
b. AEM環境を更新します。
c.抽出するファイルを選択します。
d.上部のツールバーの アーカイブを抽出 をクリックします。
e. ダイアログで、Keys というフォルダーなど、抽出するファイルの特定の場所を選択します。
f. 「次へ」をクリックします。
g.これまでにアップロードされたことのないコンテンツには競合が存在しないので、スキップします。
h.画面の右上にある「抽出」を選択します。
-
抽出が完了したら、「ターゲットフォルダーに移動」をクリックします。
キーを参照値に解決する
キーを正しく使用するには、ユーザーの環境設定で特定のマップをルートマップとして参照する必要があります。 このマップの内部には、トピック グループ内でグループ化されたキーのコレクションがあります。 マップとトピックを開くと、このマップが参照する値にキーが解決されます。
-
ルートマップを指定します。
a. キー画面から、マップを開きます。
b. ユーザーの環境設定を指定します。
c.上部のツールバーで ユーザー環境設定 アイコンをクリックします。
d. キーアイコンをクリックして、キーの解決に使用する ルートマップ を指定します。
e.目的のAssetsのチェックボックスをオンにします。
f. 「選択」をクリックします。
g. 保存 ユーザーの環境設定
-
マップビュー に移動します。
-
指定したマップを開きます。
キーが解決されます。
新しいキー定義を手動で追加する
-
指定したルートマップでマップを開きます。
-
キーを選択します。
-
新しいキー定義を挿入します。
a. マップ内の有効な場所をクリックします。
b.上部のツールバーにある Keydef アイコンを選択します。
c. [ キー定義を挿入 ] ダイアログで、作成している定義に適したキーの一意の値を入力します。
d. 「挿入」をクリックします。
-
keydef 内に topicmeta を追加します。
a.上部のツールバーの 要素を挿入 アイコンをクリックします。
b. 「要素の挿入」ダイアログで、「topicmeta」を検索して選択します。
-
topicmeta 内にキーワードを追加します。
a.上部のツールバーの 要素を挿入 アイコンをクリックします。
b. エレメントを挿入ダイアログで、「キーワード」を検索して選択します。
-
topicmeta 内にキーワードを追加します。
a.上部のツールバーの 要素を挿入 アイコンをクリックします。
b. 要素を挿入 ダイアログで、「keyword」を検索して選択します
-
キーワードに keydef の値を入力します。
マップでは、keydef は次のようになります。
keydef をスニペットとして設定する
スニペットは、ドキュメントプロジェクトの様々なトピックで再利用できる小さなコンテンツフラグメントです。 各 keydef を手動で生成する代わりに、単一の keydef をスニペットとして設定できます。
-
マップ内の keydef 要素を選択します。
-
コンテキストメニューで、「スニペットを作成」をクリックします。
-
新しいスニペットダイアログで、タイトルと説明を追加します。
また、既存のキーやキーワード定義をコンテンツから削除することもできます。 -
「作成」をクリックします。
-
左側のパネルで「スニペット」を選択します。
-
作成したスニペットをスニペットパネルからマップにドラッグ&ドロップします。
-
必要に応じて、コンテンツ プロパティを使用して keydef を更新します。
保存して更新すると、このキーセットは、同じルートマップを含むマップを定義したユーザーが使用できます。