Branch conrefs

After you have branched a topic, you can choose to branch the conrefs used by that topic.

Before you begin

  • The root map must be open in the DITA Map view.
  • All documents referring to the conref must be in a state that allows them to be branched.
  • One parent topic containing the conref must already have been branched.

About this task

When you branch a conref the system creates a new, editable version in the Authoring cycle and gives it the status Authoring:work (or its equivalent in your workflow).

Procedure

  1. In the DITA Map view, right-click the branched parent topic and select Branch > Branch Conrefs.
    You can select several topics by holding down CTRL or SHIFT and clicking the topics.
    If branching this conref requires that other documents also be branched, the Branch Documents dialog appears. It displays a list of the documents that will be affected by this change and asks if you want to continue.
  2. Click OK.

Results

A copy of the published conref(s) is created in the Authoring cycle and assigned Authoring:work status (or its equivalent in your workflow). All topics that contain that conref will be branched as well.

All branched conrefs automatically receive the same tag as the parent map.