建立和管理DITA map的分支
在Experience Manager Guides中,您可以建立DITA map的多個分支,以管理不同版本、功能或修正的檔案。 您可以在分支之間切換以處理關聯的內容、封存不再需要的分支,並在需要時還原它們。
您也可以從相同DITA map的任何現有分支建立分支。
建立分支
您可以建立DITA map的分支來處理檔案變更,而不會影響其他分支中的對應內容。
執行以下步驟來建立分支:
-
開啟要為其建立分支的DITA map。
note NOTE 如果編輯器中已開啟另一個對應,則會顯示確認對話方塊。 選取 開啟 以開啟目前分支中選取的地圖。 如需詳細資訊,請檢視開啟目前地圖內容之外的內容。 -
選取 主要 分支下拉式清單,並確認已選取必要的DITA map。
-
選取 新增分支 以建立所選地圖的分支。
-
在 新分支 對話方塊中,輸入新分支的名稱,並選取要從中建立分支的父分支。
-
選取「建立」。
系統會為選取的DITA map建立新分支。 您現在可以切換到新分支並開始處理其關聯內容。
在分支之間切換
執行以下步驟來切換分支:
-
選取編輯器頂端的分支下拉式清單 (預設會顯示
main)。 此時會顯示所選DITA map的可用分支清單。 -
選取您要使用的分支。
選取的分支隨即開啟,其名稱會出現在編輯器頂端的分支下拉式清單中,取代main。
您現在可以在選取的分支內處理地圖及其相關內容。
您現在可以在選取的分支內處理地圖及其相關內容。
分支中的獨立編輯
當您在DITA map的分支中工作時,對其內容所做的變更會保留在所選的分支中,而不會影響其他分支中的對應內容。 這可讓多位作者跨地圖的不同分支,獨立處理相同的主題。
預設會從來源分支或main讀取未變更的主題。 在所選分支中編輯主題時,該主題會成為該分支的一部分。 對主題所做的任何後續變更都會保留在所選分支內。
您可以在相同DITA map的分支之間切換,以檢視和編輯其各自的內容。
編輯分支中的主題
您可以在所選分支中編輯與DITA map相關的主題,而不會影響它們在其他分支中的內容。
執行以下步驟來編輯主題:
-
在編輯器中開啟DITA map。
-
從分支下拉式清單中,選取您要在其中編輯主題的分支。
-
從地圖開啟您要修改的主題。
-
對主題進行必要的變更。
-
儲存您的變更。
已修改主題的副本會儲存在所選分支中。 其他分支中的對應主題保持不變。
您可以繼續編輯所選分支中的主題,或切換到另一個分支以處理其內容。
開啟目前地圖內容外部的地圖
在Experience Manager Guides中,map內容參考編輯器中目前開啟的DITA map。
如果您嘗試開啟的地圖、主題或資產不屬於目前的地圖前後關聯,則會出現確認對話方塊,其中包含下列選項:
- 開啟:以選取的內容取代目前的地圖內容。
- 在編輯器中開啟:在新的索引標籤中開啟內容而不變更目前的對映內容。
- 取消:取消作業並保留目前的地圖內容。
例如,假設目前在 主要 分支中選取master_map.ditamap。
如果您嘗試開啟另一個DITA map,會出現下列確認對話方塊:
選取 開啟 以切換至選取的對應。
main分支的對應內容已更新為新選取的對應,可讓您處理其關聯內容。
開啟或編輯目前地圖內容以外的主題
結構圖未參考的主題不會自動在分支中使用。
選取在目前分支中編輯,讓這些主題可在選取的分支中編輯。
您現在可以編輯主題,而不影響其在main中的內容。 不過,此主題不會自動新增至相關聯的DITA map,也不會包含在已發佈的輸出中。 若要在輸出中包含主題,請將其新增至DITA map。
管理分支
您可以從Map主控台的 分支 面板管理DITA map的分支。 您可以檢視可用的分支、建立新分支、合併或重新命名現有分支,以及封存不再主動使用的分支。
分支面板會列出所選DITA map的所有可用分支。
若要管理分支,請將游標停留在所需分支上,然後選取 選項 功能表。 下列動作可供使用:
-
新分支:從選取的分支建立新分支。
-
合併至主要: 將所選分支的變更合併至
main分支。 -
重新命名分支:變更所選分支的名稱。
-
合併歷史記錄:顯示合併活動的歷史記錄。 此選項僅在建立合併請求後可用。
-
封存分支:封存不再使用的分支。
note NOTE Experience Manager Guides不支援刪除分支。 您可以封存不再主動使用的分支。
您也可以使用 分支 面板頂端的選項來搜尋分支、重新整理分支清單或建立新分支。
封存分支
您可以封存不再主動使用的DITA map分支,並在需要時還原它們。
main)。若要封存分支,請執行以下步驟:
-
在 分支 面板中,選取 管理 圖示。
顯示 管理分支 對話方塊。
此對話方塊包含以下標籤:
- 作用中:列出所選DITA map的所有作用中分支。
- 已封存:列出所選DITA map的所有已封存分支。
-
在 作用中 索引標籤中,將游標停留在您要封存的分支上,並選取封存。
選取的分支已封存並移動到 已封存 索引標籤。
還原已封存的分支
當您需要繼續處理DITA map的內容時,可以恢復其已封存的分支。
若要還原已封存的分支,請執行以下步驟:
-
在 分支 面板中,選取 管理 圖示。
-
在 管理分支 對話方塊中,選取 已封存 索引標籤。
-
找到您要還原的分支,並選取還原。
分支已還原並出現在 作用中 索引標籤中。