將分支合併至主要
在Experience Manager Guides中,您可以將DITA map分支的變更合併至main分支。 合併可讓您將已完成的檔案更新合併到main中,而不需手動將變更複製到main。
例如,假設名為install-the-lift.ditamap的DITA map具有名為Release 2的分支。 作者可以更新此分支中的安裝指示,而現有檔案在main中保持不變。
一旦更新準備就緒,作者就可以將來自Release 2的變更合併到main中。
瞭解分支合併
合併會將DITA map選定分支的變更匯入main分支。
- Source分支:包含您要合併之變更的分支。
- 目標分支:變更合併到的預設分支(
main)。
如果在兩個分支中修改了主題/對映的相同部分,則可能會發生合併衝突,需要解決。
合併分支
您可以將DITA map所選分支的變更合併至main。
若要合併分支,請執行下列步驟:
-
在Map主控台中開啟必要的DITA map。
-
導覽至 分支 標籤。
-
找到包含您要合併之變更的分支。
-
開啟分支的 選項 功能表,並選取合併至主要。
系統會為所選分支建立合併請求。 它可讓您在合併變更到
main之前,先檢閱變更並解決任何衝突。
-
選取合併請求。
合併要求會在 合併分支 檢視中開啟。 如有需要,請檢閱變更並解決任何衝突。
-
完成合併。
如有需要,請檢閱變更並解決任何衝突。 如需詳細資訊,請檢視解決合併衝突。
解決所有衝突後,請選取 全部合併 以將變更合併到
main中。變更會合併至
main分支。
解決合併衝突
在main和要合併的分支中修改相同的內容時,會發生合併衝突。 您必須先解決所有衝突,才能將變更合併至main。
開啟合併請求時,合併分支檢視中會顯示下列區段:
- 衝突:列出需要衝突解決的檔案。
- 清除更新:列出可以合併而不解決衝突的檔案。
對於有衝突的檔案,會顯示 合併分支 檢視。
合併分支檢視包含下列窗格:
- 左窗格(主要):顯示預設分支(
main)的內容。 - 中間窗格(已合併):顯示合併的內容,您可以在此接受分支的變更或直接編輯內容。
- 右側窗格(選取的分支):顯示合併至
main的分支內容。
會根據 已合併 窗格中的內容,在左窗格和右窗格中反白顯示差異:
- 紅色(-):表示 已合併 窗格中出現的內容,與對應的左窗格或右窗格中的內容不同。
- 綠色(+):表示左窗格或右窗格中存在的、未包含在 已合併 窗格中的內容。
最初,已合併窗格包含與main相同的內容,因此會在右側窗格中反白顯示差異。 接受所選分支的變更後,左窗格會顯示與更新的 已合併 窗格之間的差異。
執行以下步驟來解決合併衝突:
-
在 衝突 區段中,選取包含衝突的檔案。
note NOTE 列在 清除更新 下的檔案只包含所選分支中所做的變更,因此不需要衝突解決。 -
檢閱 合併分支 檢視中反白的差異,並使用合併控制項解決衝突。
右窗格中衝突旁的核取方塊會決定如何將選取的分支內容新增至 已合併 窗格:
- 已選取(預設):將 已合併 窗格中的相符內容取代為選取的分支內容。
- 已清除:將選取的分支內容與 已合併 窗格中的現有內容一起新增,而不取代它。
您可以使用下列選項解決衝突:
-
如果要使用所選分支中的變更,請保持選取衝突的核取方塊,然後選取對應的向左箭號控制項(
<<<)。 選取的分支內容會取代 已合併 窗格中的衝突內容。
-
如果要保留兩個分支的內容,請清除衝突的核取方塊,然後選取向左箭號控制項(
<<<)。 這會將選取的分支內容新增至 已合併 窗格,而不取代該窗格中已存在的內容。
-
如果您已接受所選分支的變更,且想要從
main還原對應的內容,請在左窗格中選取向右的箭頭控制項(>>>)。 這會將 已合併 窗格中選取的內容取代為來自main的版本。
note tip TIP 將滑鼠指標暫留在箭號控制項上,以檢視接受選取的變更將如何影響 已合併 窗格。 -
檢閱合併內容後,您也可以使用下列其中一個選項來接受任一分支的完整內容:
- 接受主要:將選取檔案的 合併 窗格中的內容取代為
main中的版本。 - 接受[分支名稱]:以所選分支的版本取代所選檔案 已合併 窗格中的內容。
note NOTE 選取任一選項會取代所選檔案之 合併窗格 中的全部內容,包括您在解決衝突時手動所做的任何變更。 或者,您可以直接在 已合併 窗格中檢閱或編輯內容,並選取 標示已解決 以保留合併的內容。
- 接受主要:將選取檔案的 合併 窗格中的內容取代為
-
檢閱 已合併 窗格中的最終內容,並選取 標示已解決 以將檔案標示為已解決。
-
對 衝突 下列出的所有檔案重複這些步驟。
解決所有衝突後,全部合併選項就會變為可用。
-
選取全部合併,將已解析的檔案和清除的更新合併到
main中。note NOTE 在解決所有衝突之前,全部合併選項會保持停用狀態。 已解析的變更會合併至
main。 無法復原已完成的合併。 不過,您可以建立新的合併請求,將後續變更合併至主要內容。
管理合併請求
您可以使用內容功能表管理現有的合併請求。
若要管理合併請求,請開啟其內容功能表,並選取下列其中一個選項:
- 預覽:顯示合併要求中的變更,但不合併它們。
- 檢視記錄:檢視與合併要求關聯的記錄。
- 刪除:刪除合併要求。 分支及其變更不受影響。
- 檢視報告:分支合併到
main後檢視合併報告。