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