Conref (conref)
The conref
step resolves conref attributes, processing only the DITA maps or topics that use the @conref attribute. This step is implemented in XSLT.
The values of the @id attribute on referenced content are changed as the elements are pulled into the new locations. This ensures that the values of the @id attribute within the referencing topic remain unique.
If an element is pulled into a new context along with a cross reference that references the target, both the values of the @id and @xref attributes are updated so that they remain valid in the new location. For example, a referenced topic might include a section as in the following example:
<topic id="referenced_topic">
<title>...</title>
<body>
<section id="sect"><title>Sample section</title>
<p>Figure <xref href="#referenced_topic/fig"/> contains an code sample that demonstrates ... .</p>
<fig id="fig"><title>Code sample</title>
<codeblock>....</codeblock>
</fig>
</section>
</body>
</topic>
When the section is referenced using a @conref attribute, the value of the @id attribute on the
<section id="sect"><title>Sample section</title>
<p>Figure <xref href="#new_topic/d1e25"/> contains an code sample that demonstrates ... .</p>
<fig id="d1e25"><title>Code sample</title>
<codeblock>....</codeblock>
</fig>
</section>
In this case, the value of the @id attribute on the