說明 > DITA 編寫概述 > DITA 支援使用者介面 > 鍵與鍵參照 > 插入鍵參照對話方塊
  
插入鍵參照對話方塊
此對話方塊可讓您將金鑰參照插入到 DITA 主題或圖中。您可從插入 > 鍵參照選單選項或相關聯的工具列按鈕中叫用此對話方塊。如有需要,您可以在 Arbortext Editor 視窗中停駐此對話方塊。
包括在此對話方塊中的鍵來自 ditakeybaselist 進階偏好設定中的 DITA 圖。您也可以透過新增/移除按鈕將圖新增到目前工作階段的清單中。此外,如果您從包含金鑰定義的圖的前後關聯中開啟某個主題,當您針對該主題開啟此對話方塊時,該圖會變成金鑰前後關聯的一部份。如果包含金鑰定義的圖是 DITA 金鑰定義圖,則其他資訊也適用於這些定義。
插入鍵參照對話方塊包含以下選項:
搜尋 - 可讓您篩選可用金鑰定義的清單。
當您鍵入此選項時,會自動對金鑰定義表的內容進行篩選,以符合您所鍵入的內容。搜尋時會包含表格中鍵名稱標題/描述參照欄的內容。它也包含資源欄中的任何文字 (包括標示)。
大小寫須相符 - 決定在搜尋選項中進行的搜尋是否區分大小寫。
開頭 - 決定在搜尋選項中進行的搜尋是否應僅與搜尋欄中內容的開頭相符。
對應 - 決定在金鑰定義表中用於金鑰定義的圖。
預設值全部代表在目前金鑰前後關聯中使用所有金鑰定義。如果您從下拉式清單中選取了一個特定 圖,則只有該圖中的金鑰定義會顯示在金鑰定義清單中。
新增/移除 - 開啟新增/移除對應對話方塊。
使用此對話方塊可從目前金鑰前後關聯中新增或移除對應。請注意,這只會變更目前工作階段中的金鑰前後關聯。若要永久變更金鑰前後關聯,必須修改 ditakeybaselist 進階偏好設定。
金鑰定義表 - 列出文件中可以插入做為參照的金鑰定義。
如果包含金鑰定義的圖是 DITA 金鑰定義圖,則其他資訊也適用於這些定義。如果多次定義一個金鑰,則每一個定義都會顯示在它自己的列中。如果針對一個金鑰定義來定義數個金鑰,則每一個金鑰都會分別列在它自己的列中。
表格中包含以下欄:
鍵名稱 - 提供金鑰的名稱。
一般金鑰沒有圖示。內容參照金鑰由 圖示指示。如果在 DITA 金鑰定義圖中定義了金鑰,並且指定了 keysubelementid 元素,則會將該 ID 值附加到金鑰名稱中的前導 / 之後。
類型 - 提供可用於參照此金鑰的元素清單。
如果在 DITA 金鑰定義圖中定義了金鑰,並且指定了 keyreftags 元素,則金鑰清單將來自於該元素。否則,值將為任何,表示具有 keyref 元素的任何元素皆可參照該金鑰。如果金鑰屬於內容金鑰參照 (conkeyref),則值將會是要用於內容參照的元素之名稱,後面加上 (conref)
標題/描述 - 提供金鑰的描述。
如果在 DITA 金鑰定義圖中定義了金鑰,並且指定了 keydescription 元素,則描述將來自於該元素。否則,描述將依序來自於 navtitle 元素、navtitle 屬性或 linktext 元素的內容。
資源 - 如果鍵定義中沒有提供 href 值,會從鍵定義提供 href 屬性的值或提供定義中的任何文字 (包括標示)。
當鍵定義中沒有提供 href 值時,會假設定義包含用於文字取代的內容。
對應名稱 - 提供包含金鑰定義的對應的名稱。
只有對應的基礎名稱會顯示在表格中。如果金鑰定義來自於從其他對應參照的對應,則顯示的內容將會是父對應的基礎名稱後跟放在括號內的所參照之對應的基礎名稱。
插入下拉清單 - 提供要在目前游標位置插入的有效鍵參照元素的清單。
針對非用於文字取代的鍵參照,此清單的內容由游標所在元素的類型決定。清單的內容也受到類型欄中是否有一組允許的標籤以及 smartinsert 進階偏好設定值的影響。
針對要用於文字取代的鍵參照,清單中顯示的元素由 ditatextkeyrefs 進階偏好設定的值決定。依預設,會將此偏好設定設為 off,表示只有允許鍵參照的連結元素會顯示在清單中。如果您將偏好設定設為 on,則允許鍵參照的非連結元素也會顯示在清單中。這可讓您針對這些類型的元素,插入要用於文字取代的鍵參照。
插入按鈕 - 使用所選元素將所選鍵參照插入到文件中。
hrefscopetypeformat 屬性的值,以及金鑰定義的連結文字,皆可用於插入的參照。