Diff for Working with content references (conref)

--- Fri, 2006-02-10 21:52 by Michael Priestley
+++ Fri, 2006-02-10 21:54 by Bruce Esrig
-<p>Content referencing (conref) is a convenient mechanism for reuse of content fragments. A fragment of content may be included from another location. To do so, the top element to be included is repeated at the location that will receive the inclusion. Instead of the usual attributes or content, the referencing element is given a conref attribute that specifies the location of the referenced element.</p>
+<p>Content referencing (conref) is a convenient DITA mechanism for reuse of content from other topics or maps. A fragment of content in one topic or map can be pulled&nbsp;by reference into&nbsp;any other topic or map where the content is allowed. To create the reference, start by creating an empty element of the same type you want to pull in, and then use the element's conref attribute to provide the target's location.</p>
-<p>The element containing the content reference acts as a placeholder for the referenced element. The identifier for the referenced element must be either absolute or resolvable in the context of the referencing element. (See <a href="http://docs.oasis-open.org/dita/v1.0/archspec/id.html">Identity attribute</a> for the details on identifiers.)</p>
 <p>The architectural specification describes content referencing at:</p>
 <ul>
-    <li><font face="Lucida Sans Unicode" size="2"><a href="http://docs.oasis-open.org/dita/v1.0/archspec/conref.html">http://docs.oasis-open.org/dita/v1.0/archspec/conref.html</a>.</font> </li>
+    <li><font face="Lucida Sans Unicode" size="2"><a href="http://docs.oasis-open.org/dita/v1.0/archspec/conref.html">http://docs.oasis-open.org/dita/v1.0/archspec/conref.html</a></font> </li>
+</ul>
+<p>The language specification describes the syntax of the conref attribute at:</p>
+<ul>
+    <li><a href="http://docs.oasis-open.org/dita/v1.0/langspec/id-atts.html">http://docs.oasis-open.org/dita/v1.0/langspec/id-atts.html</a></li>
 </ul>

Revision of Fri, 2006-02-10 21:54:

Content referencing (conref)

Content referencing (conref) is a convenient DITA mechanism for reuse of content from other topics or maps. A fragment of content in one topic or map can be pulled by reference into any other topic or map where the content is allowed. To create the reference, start by creating an empty element of the same type you want to pull in, and then use the element's conref attribute to provide the target's location.

The architectural specification describes content referencing at: