将分支合并到主分支
在Experience Manager Guides中,您可以将来自DITA映射分支的更改合并到main分支中。 通过合并,您可以将已完成的文档更新合并到main中,而无需将更改手动复制到main中。
例如,考虑一个名为install-the-lift.ditamap的DITA映射,其分支名为Release 2。 作者可以更新此分支中的安装说明,而现有文档在main中保持不变。
更新准备就绪后,作者可以将更改从Release 2合并到main中。
了解分支合并
合并将更改从DITA映射的选定分支引入main分支。
- Source分支:包含要合并的更改的分支。
- 目标分支:更改合并到的默认分支(
main)。
如果在两个分支中修改了主题/映射的相同部分,则可能会发生合并冲突,需要解决。
合并分支
您可以将DITA映射的选定分支中的更改合并到main中。
要合并分支,请执行以下步骤:
-
在“映射”控制台中打开所需的DITA映射。
-
导航到 分支 选项卡。
-
找到包含要合并的更改的分支。
-
打开分支的 选项 菜单,然后选择合并到主菜单。
将为所选分支创建合并请求。 它允许您在将更改合并到
main中之前查看更改并解决任何冲突。
-
选择合并请求。
合并请求在 合并分支 视图中打开。 查看更改并解决任何冲突(如果需要)。
-
完成合并。
查看更改并解决任何冲突(如果需要)。 有关详细信息,请查看解决合并冲突。
解决所有冲突后,选择 全部合并 以将更改合并到
main中。这些更改将合并到
main分支中。
解决合并冲突
在main和要合并的分支中修改了相同的内容时,会发生合并冲突。 在将更改合并到main中之前,必须解决所有冲突。
打开合并请求时,合并分支视图中会显示以下部分:
- 冲突:列出需要冲突解决的文件。
- 清理更新:列出可以合并而不解决冲突的文件。
对于有冲突的文件,将显示 合并分支 视图。
合并分支视图包含以下窗格:
- 左窗格(主):显示默认分支(
main)的内容。 - 中间窗格(已合并):显示合并的内容,您可以在其中接受分支的更改或直接编辑内容。
- 右侧窗格(选定的分支):显示合并到
main中的分支的内容。
根据 合并 窗格中的内容,左右窗格中会突出显示这些差异:
- 红色(-):表示 合并 窗格中存在的内容与相应的左窗格或右窗格中的内容不同。
- 绿色(+):表示左窗格或右窗格中存在的、未包含在 合并 窗格中的内容。
最初,合并的窗格包含与main相同的内容,因此右侧窗格中会突出显示差异。 接受选定分支的更改后,左窗格会显示与更新的 合并 窗格之间的差异。
执行以下步骤来解决合并冲突:
-
在 冲突 部分中,选择包含冲突的文件。
note NOTE 在 清理更新 下列出的文件仅包含所选分支中所做的更改,因此不需要解决冲突。 -
查看 合并分支 视图中突出显示的差异,并使用合并控件解决冲突。
右侧窗格中冲突旁边的复选框确定如何将所选分支内容添加到 合并 窗格:
- 已选定(默认):将 已合并 窗格中的匹配内容替换为所选分支内容。
- 已清除:将所选分支内容与 已合并 窗格中的现有内容一起添加,而不替换它。
您可以使用以下选项解决冲突:
-
如果要使用选定分支中的更改,请选中冲突的复选框,然后选择相应的左箭头控件(
<<<)。 选定的分支内容替换了 合并 窗格中的冲突内容。
-
如果要保留两个分支中的内容,请清除冲突的复选框,然后选择向左箭头控件(
<<<)。 这会将所选分支内容添加到 已合并 窗格,而不替换该窗格中已存在的内容。
-
如果您已接受所选分支的更改并希望从
main中恢复相应的内容,请在左窗格中选择右箭头控件(>>>)。 这会将 合并 窗格中的选定内容替换为main中的版本。
note tip TIP 将鼠标悬停在箭头控件上可查看接受所选更改将如何影响 合并 窗格。 -
查看合并内容后,您还可以使用以下选项之一来接受任一分支的整个内容:
- 接受主文件:将所选文件的 合并 窗格中的内容替换为来自
main的版本。 - 接受[分支名称]:将所选文件的 合并 窗格中的内容替换为所选分支中的版本。
note NOTE 选择任一选项都将替换选定文件的 合并窗格 中的全部内容,包括您在解决冲突时手动所做的任何更改。 或者,您可以直接在 合并 窗格中查看或编辑内容,然后选择 标记为已解决 以保留合并的内容。
- 接受主文件:将所选文件的 合并 窗格中的内容替换为来自
-
查看 合并 窗格中的最终内容,然后选择 标记为已解决 以将文件标记为已解决。
-
对 冲突 下列出的所有文件重复这些步骤。
解决所有冲突后,合并所有选项将变为可用。
-
选择 全部合并 以将已解析的文件和干净更新合并到
main中。note NOTE 在解决所有冲突之前,合并所有选项保持禁用状态。 已解决的更改将合并到
main中。 无法撤消已完成的合并。 但是,您可以创建新的合并请求以将后续更改合并到主请求中。
管理合并请求
您可以使用上下文菜单管理现有合并请求。
要管理合并请求,请打开其上下文菜单,然后选择以下选项之一:
- 预览:显示合并请求中的更改而不合并它们。
- 查看日志:查看与合并请求关联的日志。
- 删除:删除合并请求。 分支及其更改不受影响。
- 查看报告:在分支合并到
main中后查看合并报告。