#### 9.6.2 Designating map sections as named branches

To specify that part of a bookmap or ditamap should be treated differentially, you can insert a special PI marker to give that map section a “branch” name:

    <?dtall branch="branchname" ?>

See §38. Working with processing instructions .

You do not need to specialize, or do anything else with the DITA code itself. When you place a branch PI marker in a map (not in topics), doing so marks everything in the map that comes after the PI marker, at the same level or below, as belonging to that branch.

You can override a branch PI with another branch PI marker, at the same level or below, following the same scoping rules (inheritance). DITA2Go manages branch PIs on a stack, so restore works as expected.

Previous Topic: 9.6.1 Understanding the advantages of filtering in maps

Next Topic: 9.6.3 Reusing the same topics with different conditions

Parent Topic: 9.6 Scoping and filtering within maps

Sibling Topics:

9.6.1 Understanding the advantages of filtering in maps

9.6.3 Reusing the same topics with different conditions

9.6.4 Directing a cross reference to the correct branch

9.6.5 Directing a content reference to the correct branch

9.6.6 Limiting the scope of keydefs by branch

9.6.7 Directing a key reference to the correct branch