說明 > DITA 編寫概述 > DITA 支援使用者介面 > 資源管理員 > 鍵定義標籤
  
鍵定義標籤
鍵定義標籤可讓您將金鑰定義插入到 DITA 圖中。如果您選取插入 > 鍵定義選單選項,而資源管理員尚未開啟,則資源管理員會開啟,並且金鑰定義標籤處於使用中狀態。當您在編輯對應或專門化對應時,資源管理員 中的此標籤才為可用。ditakeyrefui 進階偏好設定的設定也可決定此選項是否可在資源管理員中使用。
鍵定義標籤擁有兩種不同的狀態。第一種狀態適用於針對本機文件插入金鑰定義。第二種狀態適用於插入網際網路上文件的金鑰定義。同時,您正在編輯的 DITA 圖 的類型決定了標籤上可供使用的選項。如果您正在編輯 DITA 金鑰定義圖,則會有更多選項可供使用。
用來將鍵定義插入至本機文件的選項
對於將金鑰定義插入至本機文件而言,鍵定義標籤中包含以下選項:
尋找範圍 - 決定 資源管理員 瀏覽器中所顯示內容的位置。
從下拉式清單中選取位置。這個欄位始終會包含瀏覽器中目前可用的位置。按兩下瀏覽器中的資料夾可在尋找範圍欄位中顯示該資料夾。若您選取此清單中的 Web鍵定義標籤會變為可將金鑰定義插入至網際網路文件的狀態。
清單中包含最愛位置 選擇。選取此選項可將顯示在瀏覽器中的位置移至最愛位置節點,這裡有您已儲存的最愛位置清單。
此清單也包含記錄 選項。 選取此選項可將顯示在瀏覽器中的位置移至記錄節點,該節點包含您已在目前工作階段中造訪之所有位置的清單。
選單按鈕 () - 顯示包含以下選項的選單:
開啟 (後綴為 Document) - 如果您在瀏覽器中已選取文件,則會以新視窗開啟該文件。
所選的 XML、DITA、SGML 和 HTML 文件會以新 Arbortext Editor 視窗開啟。其他類型的文件或圖形則會以關聯的應用程式開啟。例如,圖形會以預設的圖形應用程式開啟。
清除記錄 - 清除瀏覽器中記錄節點中已造訪位置的清單。
只有在選取記錄節點的情況下,此選擇才會適用。
新增至我的最愛 - 將所選位置新增至最愛位置清單。
只有當在瀏覽器中選取檔案系統資料夾、內容管理系統 (CMS) 資料夾或類似位置時,才能使用此選項。
從我的最愛移除 - 從最愛位置清單中移除所選位置。
只有當選取最愛位置清單中的項目時,才能使用此選項。
上移 - 將最愛位置清單中的項目在清單中上移一級。
只有當選取最愛位置清單中的項目時,才能使用此選項。
下移 - 將最愛位置清單中的項目在清單中下移一級。
只有當選取最愛位置清單中的項目時,才能使用此選項。
匯出我的最愛 - 開啟另存新檔對話方塊,您可以在此將您目前的最愛位置清單儲存到 XML 檔案中。
只有當在瀏覽器中選取最愛位置節點時,才能使用此選項。此選項可將您的最愛儲存到 XML 檔案中,稍後可使用匯入我的最愛選單選項將該檔案匯入為我的最愛的清單。請勿修改此 XML 檔案,因為它只用來儲存我的最愛清單。
匯入我的最愛 - 開啟開啟對話方塊,您可以在此選取包含匯出的 資源管理員 最愛清單的 XML 檔案。
只有當在瀏覽器中選取最愛位置節點時,才能使用此選項。此選項可以讓您匯入為之前使用匯出我的最愛選單選項匯出的最愛清單。
開啟對話方塊中選取檔案,並按一下開啟之後,會開啟另一個對話方塊,詢問您是否要與目前最愛清單合併還是將其取代? 按一下合併可將匯入清單中尚不在您目前清單中的位置新增至您的最愛清單。按一下取代可使您目前的最愛清單完全由匯入的清單取代。
出庫並編輯 - 在 Arbortext Editor 中開啟所選 CMS 物件,以進行編輯。
如果物件未出庫,資源管理員會為您出庫 (鎖定) 物件。您可以選擇以相同的操作方式出庫任何相關物件。此選單選項僅適用於 PTC 伺服器連線 物件。
出庫 - 出庫 (鎖定) 所選的取消鎖定的 CMS 物件。
您可以選擇以相同的操作方式出庫任何相關物件。此選單選項僅適用於 PTC 伺服器連線 物件。
復原出庫 - 取消出庫 CMS 物件並丟棄對出庫版本所做的任何變更。
取消物件出庫之後,如果在 Arbortext Editor 中開啟文件物件,其狀況將會變更為唯讀。此選單選項僅適用於 PTC 伺服器連線 物件。
內容 — 顯示包含所選物件的內容的物件內容對話方塊。
此選單選項僅適用於 PTC 伺服器連線 物件。
搜尋 CMS - 顯示搜尋對話方塊。
此選單選項僅適用於 PTC 伺服器連線 物件。搜尋對話方塊可讓您輸入查詢來尋找所有與某些搜尋條件相配的 CMS 物件。搜尋結果會顯示在資源管理員瀏覽器的 CMS 搜尋結果節點中。
清除 CMS 搜尋結果 - 清除已新增至資源管理員瀏覽器之 CMS 搜尋結果部份的所有 CMS 物件。
此選單選項僅適用於支援的 CMS 轉接器。 此選項不會將這些物件從 CMS 移除,只是從 資源管理員 瀏覽器中移除。
同步化標籤中的位置 - 決定當您切換至不同標籤或開啟其他 資源管理員 對話方塊時,是否維持您在 資源管理員 瀏覽器中瀏覽至的第一個位置。
ditasynctabs 進階偏好設定的設定可決定此功能預設為開啟還是關閉。
上一個資料夾按鈕 - 將瀏覽器中顯示的位置移至最後一次在瀏覽器中顯示的資料夾。
資源管理員 會維護您已在目前工作階段中檢視的所有資料夾記錄,所以您可以透過該記錄,使用這個按鈕將瀏覽器檢視移回先前的檢視。若您在目前工作階段中僅檢視過一個資料夾,則會禁用此按鈕。
上移一級按鈕 - 在目前階層中,將瀏覽器內顯示的位置往上移一級。
若您位於最上面一層,會禁用此按鈕。
目前文件資料夾按鈕 - 將顯示在瀏覽器中的位置移至包含目前文件的資料夾。
重新整理按鈕 () - 更新瀏覽器檢視以反映對瀏覽器中所顯示物件所做的任何變更。
瀏覽 Web 按鈕 - 將金鑰定義標籤變更為從網際網路插入參照的狀態。
使用 CMS 物件瀏覽器按鈕 () - 為 PTC 伺服器連線或存放庫轉接器叫用瀏覽器
只有在您透過 PTC 伺服器連線或存放庫轉接器連接到內容管理系統 (CMS) 時,這個按鈕才會可用。
搜尋 CMS 按鈕 - 叫用搜尋對話方塊。
此按鈕僅適用於 PTC 伺服器連線物件。您可以在搜尋對話方塊中輸入查詢來尋找與某些搜尋條件相符的所有 CMS 物件。搜尋結果會顯示在資源管理員瀏覽器的 CMS 搜尋結果部份中。
篩選器 - 可讓您篩選在瀏覽器中顯示的檔案與文件元素清單。
當您在此選項中輸入文字時,會對顯示在瀏覽器中的檔案與文件元素清單進行篩選,以只顯示標籤中包含您已輸入之文字的檔案或元素。在此情況下,篩選器選項與瀏覽器會顯示淡黃色背景顏色,指示正在對瀏覽器的內容進行篩選。
例如,如果您輸入 "test",則只有標籤中內含 "Test"、"testing"、"test cases" 等內容的物件會顯示在瀏覽器中。如果您已展開文件以顯示文件內的元素,則也會對顯示的元素進行篩選。在此情況下,即使文件的標籤並不包含篩選文字,文件也會保持顯示在瀏覽器中。
篩選不會區分大小寫。不會對資料夾與類似物件進行篩選。如果您在篩選器選項中輸入多個辭彙,相配的標籤必須包含所有的這些辭彙。
資源管理員 瀏覽器 — 提供檔案系統、內容管理系統 (CMS) 或文件階層。
資源管理員 瀏覽器可讓您在檔案系統或 CMS 中尋找要插入您的文件的內容。該瀏覽器提供檔案系統或 CMS 的內容的階層檢視。除了可以顯示資料夾和檔案外,該瀏覽器還可讓您檢視 DITA 文件的內容。舉例來說,當您使用鍵定義標籤時,瀏覽器會根據文件中目前的前後關聯,顯示 DITA 文件中可用作金鑰定義目標的元素。若有元素標題,標題會顯示在瀏覽器中的元素旁。元素的 ID (根據 ditahideids 進階偏好設定的設定) 及任何 href 屬性值也會顯示出來。
如果瀏覽器中所顯示的元素在 keyref 屬性中已有金鑰參照值,則會由一個特殊圖示 表示。在瀏覽器中選取元素會自動在對話方塊的鍵內容部份中填入某些選項。例如,如果所選元素具有 title 元素,則會將該元素的內容放入標題選項中。會填入哪些選項,由所選元素決定。
瀏覽器包含最愛位置 節點,該節點包含您已儲存之最愛位置的清單。連按兩下其中一個我的最愛可在瀏覽器中開啟該位置。如果目前無法使用最愛位置,例如如果位置已遭刪除,或者是 CMS 資料夾,而您並未登入 CMS,則資料夾會有特殊的圖示 來指示該狀況。
瀏覽器也包含記錄 節點,該節點中包含您已在目前工作階段中造訪之所有位置的清單。 連按兩下其中一個位置可在瀏覽器中開啟該位置。
按一下階層中的加號 ( + ) 可開啟階層中的一個層級或文件內容。按一下減號 ( – ) 可關閉一個層級或文件。按一下階層中的物件即可選取該物件。按兩下資料夾可讓瀏覽器焦點移動到該資料夾。
若您連按兩下瀏覽器中的 Web 節點,標籤會變為可插入網際網路文件參照的狀態。
類型 — 決定 資源管理員 瀏覽器中顯示的文件類型。
使用此下拉式清單可按照文件類型篩選瀏覽器中顯示的文件。您可以選擇下列文件類型:
主題、圖或圖像 - 顯示 DITA 圖與主題文件及圖形檔案。
主題 — 僅顯示 DITA 主題文件。
主題或圖 — 顯示 DITA 圖 或主題文件。
對應 — 僅顯示 DITA 圖 文件。
圖像 — 僅顯示圖形檔案。
PDF — 僅顯示 PDF 文件。
HTML — 僅顯示 HTML 文件。
任何 — 顯示所有文件類型。
顯示 — 決定 資源管理員 瀏覽器中針對 DITA 文件顯示的元素類型。
使用此下拉式清單可按照元素類型篩選顯示器中顯示的文件的元素。您可以選擇下列元素類型:
全部元素
全部有 ID 的元素
鍵定義
鍵參照
鍵內容 - 可讓您指定金鑰定義的屬性。
使用 資源管理員 部份中的選項可設定您正在定義的金鑰內容。可用選項數目取決於您正在編輯的 DITA 圖 類型。如果您正在編輯 DITA 金鑰定義圖,則會有更多選項可供使用。這些其他的選項在插入鍵參照對話方塊中提供有關金鑰的更多詳細資訊。
以下金鑰內容可供使用:
清除按鈕 - 將已輸入到金鑰屬性選項中的任何內容移除。
當您將內容輸入到其中一個金鑰屬性選項中時,該選項的標籤會變藍。當您修改了屬性內容後,即使在瀏覽器中變更了選取項,它也不會再更新。按一下此按鈕可清除任何修改過的選項中的內容、使標籤恢復成黑色,並還原任何預設值。
名稱 - 提供金鑰的名稱。
您可以輸入一或多個用空格分隔的金鑰名稱。如果您在瀏覽器中選取了一個已定義金鑰參照的元素,依預設會將 keyref 屬性的值插入到此選項中。如果您輸入無效的金鑰名稱,此選項的標籤會變紅,並在狀態列中顯示錯誤。當金鑰名稱與相同金鑰前後關聯中的另一個金鑰定義重複時,也會在狀態列中顯示訊息。
標題 - 提供金鑰的標題。
此處的值會放在金鑰定義的 navtitle 屬性中。
描述 - 提供金鑰的描述。
此選項只有在您編輯 DITA 金鑰定義圖時才可用。此處的值會放在金鑰定義的 keydescription 元素中。
元素 ID - 提供在瀏覽器中選取之元素的 ID。
如果所選元素已有 ID,依預設會將該 ID 的值插入到此選項中。如果所選元素沒有 ID,您可以使用產生 ID 按鈕來為它產生一個 ID。
此選項只有在您編輯 DITA 金鑰定義圖時才可用。此處的值會放在金鑰定義的 keysubelementid 元素之 value 屬性中。
產生 ID 按鈕 - 為在瀏覽器中選取的元素產生 ID,並更新包含元素的文件。
此選項只有在您編輯 DITA 金鑰定義圖時才可用。
參照標籤 - 提供參照鍵之元素的清單。
您可以輸入一或多個用空格分隔的元素名稱。根據您在瀏覽器中選取的元素,依預設會插入某些元素標籤。請注意,為了查看標籤名稱是否有效,此欄位不會被核取。
此選項只有在您編輯 DITA 金鑰定義圖時才可用。此處的值會放在金鑰定義的 keyreftags 元素之 value 屬性中。
插入 - 決定要插入至圖的元素類型。
使用此下拉式清單可選取要插入您的文件的元素類型。
插入按鈕 - 將金鑰定義插入至您正在編輯的圖中。
若您文件中目前的前後關聯不是有效的插入點,則會禁用此按鈕。
用來將鍵定義插入至網際網路上之文件的選項
對於將金鑰定義插入至網際網路上的文件而言,鍵定義標籤包含以下選項:
尋找範圍 - 決定鍵定義標籤的狀態。
當您要將金鑰定義插入至網際網路上的文件時,此選項始終設定為 Web。從下拉式清單中選取不同位置會變更將定義插入至本機文件的標籤狀態。
選單按鈕 () - 顯示包含以下選項的選單:
開啟 (後綴為 Document) - 此選擇已禁用。
搜尋 CMS - 顯示搜尋對話方塊。
此選單選項僅適用於 PTC 伺服器連線 物件。
清除 CMS 搜尋結果 - 清除已新增至資源管理員瀏覽器之 CMS 搜尋結果部份的所有 CMS 物件。
同步化標籤中的位置 - 決定當您切換至不同標籤或開啟其他 資源管理員 對話方塊時,是否維持您在 資源管理員 瀏覽器中瀏覽至的第一個位置。
ditasynctabs 進階偏好設定的設定可決定此功能預設為開啟還是關閉。
上一個資料夾按鈕 - 將瀏覽器中顯示的位置移至最後一次在瀏覽器中顯示的資料夾。
若您在瀏覽器中檢視的最後位置不是 Web,標籤狀態會變更為可插入本機文件參照的狀態。
上移一級按鈕 - 此按鈕已禁用。
目前文件資料夾按鈕 - 將顯示在瀏覽器中的位置移至包含目前文件的資料夾。
標籤狀態會變更為可修改本機文件參照的狀態。
重新整理按鈕 - 此按鈕已禁用。
瀏覽 Web 按鈕 - 此按鈕已禁用。
使用 CMS 物件瀏覽器按鈕 () - 為 PTC 伺服器連線或存放庫轉接器叫用瀏覽器
只有在您透過 PTC 伺服器連線或存放庫轉接器連接到內容管理系統 (CMS) 時,這個按鈕才會可用。
搜尋 CMS 按鈕 - 叫用搜尋對話方塊。
此按鈕僅適用於 PTC 伺服器連線物件。您可以在搜尋對話方塊中輸入查詢來尋找與某些搜尋條件相符的所有 CMS 物件。搜尋結果會顯示在資源管理員瀏覽器的 CMS 搜尋結果部份中。
URL - 顯示要針對金鑰定義插入的 URL。
您可以編輯此欄位來新增所需 URL,或選取取得瀏覽器 URL 按鈕來將顯示在使用中 Web 瀏覽器中之網頁的 URL 插入選項中。
開啟瀏覽器 - 開啟您的預設 Web 瀏覽器。
如果 URL 選項中有 URL,則 Web 瀏覽器會在開啟時顯示該網頁。請注意,您必須在作業系統或偏好設定對話方塊的檔案位置偏好設定中設定預設 Web 瀏覽器,才能使用此選項。
取得瀏覽器 URL - 將顯示在使用中 Web 瀏覽器中之網頁的 URL 插入 URL 選項中。
請注意,您必須在作業系統或偏好設定對話方塊的檔案位置偏好設定中設定預設 Web 瀏覽器,才能使用此選項。
鍵內容 - 可讓您指定金鑰定義的屬性。
使用 資源管理員 部份中的選項可設定您正在定義的金鑰內容。可用選項數目取決於您正在編輯的 DITA 圖 類型。如果您正在編輯 DITA 金鑰定義圖,則會有更多選項可供使用。這些其他的選項在插入鍵參照對話方塊中提供有關金鑰的更多詳細資訊。
以下金鑰內容可供使用:
清除按鈕 - 將已輸入到金鑰屬性選項中的任何內容移除。
當您將內容輸入到其中一個金鑰屬性選項中時,該選項的標籤會變藍。當您修改了屬性內容後,即使在瀏覽器中變更了選取項,它也不會再更新。按一下此按鈕可清除任何修改過的選項中的內容、使標籤恢復成黑色,並還原任何預設值。
名稱 - 提供金鑰的名稱。
您可以輸入一或多個用空格分隔的金鑰名稱。如果您輸入無效的金鑰名稱,此選項的標籤會變紅,並在狀態列中顯示錯誤。當金鑰名稱與相同金鑰前後關聯中的另一個金鑰定義重複時,也會在狀態列中顯示訊息。
標題 - 提供金鑰的標題。
此處的值會放在金鑰定義的 navtitle 屬性中。
描述 - 提供金鑰的描述。
此選項只有在您編輯 DITA 金鑰定義圖時才可用。此處的值會放在金鑰定義的 keydescription 元素中。
元素 ID - 此選項被禁用。
產生 ID 按鈕 - 此選項被禁用。
參照標籤 - 提供參照鍵之元素的清單。
您可以輸入一或多個用空格分隔的元素名稱。依預設會插入某些元素標籤。請注意,為了查看標籤名稱是否有效,此欄位不會被核取。
此選項只有在您編輯 DITA 金鑰定義圖時才可用。此處的值會放在金鑰定義的 keyreftags 元素之 value 屬性中。
插入 - 決定要插入至圖的元素類型。
使用此下拉式清單可選取要插入您的文件的元素類型。
插入按鈕 - 將指定 URL 的金鑰定義插入至您正在編輯的圖。
若您文件中目前的前後關聯不是有效的插入點,則會禁用此按鈕。