Example: Single <ditavalref> on a branch

A single <ditavalref> element can be used to supply filtering conditions for a branch.

Consider the following DITA map and the DITAVAL file that is referenced from the <ditavalref> element:

Figure 1. input.ditamap:
  <topicref href="intro.dita"/>
  <topicref href="install.dita">
    <ditavalref href="novice.ditaval"/>
    <topicref href="do-stuff.dita"/>
    <topicref href="advanced-stuff.dita" audience="admin"/>
    <!-- more topics -->
  <!-- Several chapters worth of other material -->
Figure 2. Contents of novice.ditaval
  <prop att="audience" val="novice" action="include"/>
  <prop att="audience" val="admin" action="exclude"/>

When this content is published, the following processing occurs:

In this example, no resources are renamed based on the <ditavalref> processing.

Note: In cases where the original resource names map directly to names or anchors in a deliverable, the absence of renaming ensures that external links to those topics are stable regardless of whether a DITAVAL document is used.

Return to main page.