說明 > DITA 編寫概述 > DITA 支援使用者介面 > 鍵與鍵參照 > 鍵與鍵參照對話方塊
  
鍵與鍵參照對話方塊
此對話方塊可讓您檢視 DITA 圖中金鑰定義與金鑰參照,以及對應所參照的主題與圖的相關資訊。如果已將目前圖的金鑰前後關聯設定為其他 DITA 圖,對話方塊中的資訊適用於做為金鑰前後關聯的圖,而不是目前的圖。您也可以從 DITA 主題中開啟此對話方塊,但在此情況下,它只包含該主題所含金鑰參照以及這些參照的關聯定義 (在做為目前金鑰前後關聯的對應中定義) 的相關資訊。如果對話方塊收集並顯示鍵資訊時花費了幾秒鐘以上的時間,即會顯示進度列。
請注意,若要讓金鑰參照包含有關其金鑰定義的資訊,它必須有使用中的金鑰前後關聯,且關聯的金鑰必須在該前後關聯中定義。金鑰前後關聯是包含金鑰定義的 DITA 圖。指派給 ditakeycontext 設定選項的值可決定文件的鍵前後關聯。您可以明確設定此選項,否則 Arbortext Editor會在某些情況下自動設定它。例如,如果您從包含鍵定義的對應中開啟參照主題,此對應會變為鍵前後關聯。
您可以從工具 > 鍵與鍵參照選單選項中叫用此對話方塊。您也可以只針對在包含游標之標籤中定義的鍵,使用工具選單及捷徑選單上的尋找鍵參照選單選項,來在 DITA 圖中開啟此對話方塊。
鍵與鍵參照對話方塊包含下列選項:
金鑰與金鑰參照資訊 - 提供目前文件中金鑰定義與關聯金鑰參照的相關資訊。
對話方塊的此區域列出在對應中定義的金鑰定義以及從對應參照之文件中使用這些金鑰的位置。它也會顯示在從目前對應參照之文件中定義的其他任何金鑰參照,且這些參照在目前金鑰前後關聯中沒有關聯的金鑰定義。針對具有定義的金鑰與金鑰參照,您可以在樹中按一下定義或參照來選取它,然後使用跳到按鈕來開啟包含該金鑰定義或參照的文件。
針對具有定義的金鑰,會在定義中依次顯示金鑰圖示 、金鑰名稱與 href 屬性的值。如果對應中或從對應參照之文件中有此金鑰的參照,這些參照會嵌套於金鑰定義下。您可以縮疊及展開金鑰下方的參照清單。包含所列金鑰參照的元素由以下圖示表示:
- 表示主題參照 (topicref)。
針對此金鑰參照與其他金鑰參照 (在 keyref 屬性中),圖示之後依次為:包含金鑰參照之元素的名稱與包含參照之文件的檔案名稱。如果包含參照的文件位於內容管理系統 (CMS) 而不是檔案系統中,則名稱為 CMS 物件名稱或「邏輯 ID」。
- 表示交叉參照 (xref) 或 link
- 表示 image
- 表示內容金鑰參照。
針對內容金鑰參照 (在 conkeyref 屬性中),圖示之後依次為:做為內容參照目標之文件中元素的名稱、包含參照之文件的檔案名稱以及 (conkeyref)
針對沒有關聯定義的金鑰參照,會依次顯示帶有紅色 x 的金鑰圖示 、金鑰參照中金鑰的名稱以及 (無定義)。其下方是未定義金鑰的參照,且這些參照位於從目前對應參照的文件中。
全部展開 - 展開所列金鑰下方的所有金鑰參照。
全部摺疊 - 縮疊所列金鑰下方的所有金鑰參照。
跳到 - 開啟包含所選金鑰定義或參照的文件,並在文件中反白該金鑰定義。
重新整理 - 將金鑰定義的清單更新為其最新狀態。