创建和管理DITA映射的分支

在Experience Manager Guides中,您可以创建DITA映射的多个分支来管理不同版本、功能或修复的文档。 您可以在分支之间切换以处理关联的内容,存档不再需要的分支,并在需要时恢复它们。

您也可以从同一DITA映射的任何现有分支创建分支。

创建分支

您可以创建DITA映射的分支以处理文档更改,而不影响其他分支中的相应内容。

执行以下步骤可创建分支:

  1. 打开要为其创建分支的DITA映射。

    note
    NOTE
    如果已在编辑器中打开另一个映射,则会显示确认对话框。 选择​ 打开 ​以打开当前分支中的选定映射。 有关详细信息,请查看打开当前映射上下文之外的内容。
  2. 选择​ main ​分支下拉列表,并验证是否已选择所需的DITA映射。

  3. 选择​ 新建分支 ​以创建选定映射的分支。

  4. 在​ 新建分支 ​对话框中,输入新分支的名称,然后选择要从中创建分支的父分支。

  5. 选择​创建。

将为所选DITA映射创建新分支。 您现在可以切换到新分支并开始处理其关联内容。

在分支之间切换

执行以下步骤以切换分支:

  1. 选择编辑器顶部的​分支下拉列表(默认显示main)。 此时将显示选定DITA映射的可用分支列表。

  2. 选择要使用的分支。

    选定分支随即打开,其名称将显示在编辑器顶部的分支下拉列表中,取代​main。

您现在可以在选定分支内处理映射及其关联内容。

NOTE
如果切换分支时某个主题具有未保存的更改,则会出现一个对话框,提示您先保存更改,然后再切换到所选分支。

您现在可以在选定分支内处理映射及其关联内容。

分支中的独立编辑

当您在DITA映射的分支中工作时,对其内容所做的更改将保留在选定分支中,并且不会影响其他分支中的相应内容。 这允许多位作者跨地图的不同分支独立处理相同的主题。

默认情况下,未更改的主题从源分支或main中读取。 在选定分支中编辑主题时,该主题将变成该分支的一部分。 随后对该主题所做的任何更改都会保留在所选分支中。

可以在同一DITA映射的分支之间切换以查看和编辑其各自的内容。

编辑分支中的主题

您可以编辑所选分支中与DITA映射关联的主题,而不会影响它们在其他分支中的内容。

执行以下步骤来编辑主题:

  1. 在编辑器中打开DITA映射。

  2. 从分支下拉列表中,选择要编辑主题的分支。

  3. 从映射中打开要修改的主题。

  4. 对主题进行所需的更改。

  5. 保存更改。

    已修改主题的副本将保存在所选分支中。 其他分支中的相应主题保持不变。

您可以继续编辑所选分支中的主题,或切换到另一个分支以处理其内容。

在当前映射上下文之外打开映射

在Experience Manager Guides中,映射上下文​引用编辑器中当前打开的DITA映射。

如果尝试打开不属于当前映射上下文的映射、主题或资源,将出现一个包含以下选项的确认对话框:

  • 打开:​将当前映射上下文替换为选定内容。
  • 在编辑器中打开:​在不更改当前映射上下文的情况下在新选项卡中打开内容。
  • 取消:​取消操作并保留当前映射上下文。

例如,假定当前在​ 主 ​分支中选择了master_map.ditamap。

如果尝试打开另一个DITA映射,将出现以下确认对话框:

选择​ 打开 ​以切换到所选映射。

main分支的映射上下文已更新为新选择的映射,允许您使用其关联内容。

打开或编辑当前映射上下文以外的主题

映射未引用的主题不会在分支中自动可用。

选择​ 在当前分支 ​中编辑,使此类主题可在所选分支中编辑。

您现在可以编辑主题,而不影响其在main中的内容。 但是,该主题不会自动添加到关联的DITA映射中,并且不会包含在已发布的输出中。 要在输出中包括主题,请将其添加到DITA映射。

管理分支

您可以从“映射”控制台的​ 分支 ​面板中管理DITA映射的分支。 您可以查看可用的分支、创建新分支、合并或重命名现有分支以及存档不再主动使用的分支。

分支​面板列出了选定DITA映射的所有可用分支。

要管理分支,请将鼠标悬停在所需分支上,然后选择​ 选项 ​菜单。 以下操作可用:

  • 新分支:​从所选分支创建新分支。

  • 合并到主分支: 将选定分支中的更改合并到main分支中。

  • 重命名分支:​更改所选分支的名称。

  • 合并历史记录:​显示合并活动的历史记录。 此选项仅在创建合并请求后可用。

  • 存档分支:​存档不再使用的分支。

    note
    NOTE
    Experience Manager Guides不支持删除分支。 您可以存档不再主动使用的分支。

您还可以使用​ 分支 ​面板顶部的选项来搜索分支、刷新分支列表或创建新分支。

存档分支

您可以存档不再主动使用的DITA映射的分支,并在需要时恢复它们。

NOTE
无法存档默认分支(main)。

要存档分支,请执行以下步骤:

  1. 在​ 分支 ​面板中,选择​ 管理 ​图标。

    显示​ 管理分支 ​对话框。

    该对话框包含以下选项卡:

    • 活动:​列出选定DITA映射的所有活动分支。
    • 已存档:​列出选定DITA映射的所有已存档分支。
  2. 在​ 活动 ​选项卡中,将鼠标悬停在要存档的分支上,然后选择​存档。

    所选分支已存档并移至​ 已存档 ​选项卡。

恢复已存档的分支

当您需要继续处理DITA映射的内容时,可以恢复其存档的分支。

要恢复已存档的分支,请执行以下步骤:

  1. 在​ 分支 ​面板中,选择​ 管理 ​图标。

  2. 在​ 管理分支 ​对话框中,选择​ 已存档 ​选项卡。

  3. 找到要还原的分支,然后选择​还原。

    分支已恢复并出现在​ 活动 ​选项卡中。

recommendation-more-help
experience-manager-guides-help-product-guide