Branch resources

After you have branched a topic, you can go on to branch the resources it references.

Before you begin

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

About this task

When you branch a resource 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 parent topic and select Branch > Branch Referenced Resources.
    You can select several topics by holding down CTRL or SHIFT and clicking the documents.
    The Branch Resources dialog displays a list of the selected topic(s) and the resources they contain.
  2. Select any or all of the resources.
  3. Click OK.
    If branching this resource 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.
  4. Click OK.

Results

A copy of the published resource (or resources) is created in the Authoring cycle and assigned Authoring:work status (or its equivalent in your workflow). All topics that contain that resource will be branched as well. All branched resources automatically receive the same tag as the parent map.