索引鍵

不同的材料集可能包含類似的資訊,需要在特定位置自訂。 鍵可讓您在使用DITA時包含變數資訊。

您可選擇用於本課程的範例檔案會提供在keys.zip檔案中。

啟用金鑰

  1. 上傳提供的範例檔案集。

    a.載入zip檔案。

    b.重新整理AEM環境。

    c.選取要擷取的檔案。

    選取Zip

    d.按一下頂端工具列中的​ 擷取封存

    工具列

    e.在對話方塊中,選擇要擷取檔案的特定位置,例如名為「金鑰」的資料夾。

    f.按一下​ 下一步

    g.略過任何衝突,因為之前從未上傳過的內容不存在衝突。

    h.選取畫面右上方的​ 擷取

  2. 擷取完成時,按一下​ 移至目標資料夾

    確認

將索引鍵解析為參考值

若要正確使用索引鍵,「使用者偏好設定」必須參照特定對應作為「根對應」。 此地圖內是索引鍵的集合,分組在主題群組內。 開啟對映和主題會將鍵解析為此對映參照的值。

  1. 指定根對應。

    a.在「按鍵」畫面中,開啟地圖。

    b.設定使用者偏好設定。

    c.按一下頂端工具列上的​ 使用者偏好設定 ​圖示。

    頂端工具列

    d.按一下金鑰圖示以指定將用於解析金鑰的​ 根對應

    e.選取任何所需Assets的核取方塊。

    Assets下拉式清單

    f.按一下​ 選取

    g. 儲存 ​使用者偏好設定。

  2. 瀏覽至​ 地圖檢視

  3. 開啟指定的對應。

鍵已解析。

手動新增索引鍵

  1. 開啟具有指定根對映的對映。

  2. 選取金鑰。

    索引鍵下拉式清單

  3. 插入新的索引鍵。

    a.按一下地圖中的有效位置。

    b.選取頂端工具列上的​ Keydef ​圖示。

    索引鍵工具列

    c.在「插入Keydef」對話方塊中,輸入唯一的「索引鍵」值,以符合您正在建立的定義。

    d.按一下​ 插入

  4. 在keydef中新增topicmeta。

    a.按一下頂端工具列上的​ 插入元素 ​圖示。

    索引鍵工具列

    b.在插入元素對話方塊中,搜尋並選取「topicmeta」。

  5. 在topicmeta中新增關鍵字。

    a.按一下頂端工具列上的​ 插入元素 ​圖示。

    索引鍵工具列

    b.在插入元素對話方塊中,搜尋並選取「關鍵字」。

  6. 在topicmeta中新增關鍵字。

    a.按一下頂端工具列上的​ 插入元素 ​圖示。

    索引鍵工具列

    b.在​ 插入元素 ​對話方塊中,搜尋並選取「關鍵字」

  7. 在關鍵字中輸入keydef的值。

在地圖中,您的keydef現在看起來應該像這樣:

Keydef已完成

將keydef設定為程式碼片段

程式碼片段是小型內容片段,可在說明檔案專案的各種主題中重複使用。 您可以將單一金鑰定義設定為程式碼片段,而不需手動產生每個金鑰定義。

  1. 在地圖中選取keydef元素。

  2. 在內容功能表中,按一下​ 建立程式碼片段

  3. 在新程式碼片段對話方塊中,新增標題和說明。
    您也可以從內容中移除現有的金鑰或關鍵字定義。

  4. 按一下​ 建立

  5. 在左側面板上,選取​ 代碼片段

  6. 從「代碼片段」面板將您剛建立的代碼片段拖放至地圖。

  7. 視需要使用「內容屬性」更新keydef。
    儲存並重新整理後,此組金鑰將可供已定義包含相同根對映之對映的任何使用者使用。

recommendation-more-help
5d77304e-09c3-49ad-9381-b66e7cbd5f86