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