<xref> (Cross Reference) Description .email comment.
Description
This element contains linking text to a text object in the article. This could be a paragraph or title. One popular use of this element is to refer to a numbered sections:
See section 3.2 for more details.
See section <xref linkend="S3002">3.2</xref> for more details.
...
<section2 id="S3002">...</section2>
or:
See Explanation for more details.
See <b><i><xref linkend="S3002">Explanation</xref></i></b> for more details.
...
<section2 id="S3002">
  <title>Explanation</title>
  ...
</section2>
Note that there are more specific elements for some text-based objects, including links to:
-
lists
-
list items
-
tables
-
enunciations
-
end notes
-
footnotes
-
citation
There are also specialised links to non-text objects that this element must not be used for, including:
-
figure
-
math equation
-
chemical equation
-
chemical formula
-
chemical structure
Finally, there is a separate element for linking to external sources (see <textref>).
Parent Elements
The elements listed below may directly contain this element. They are "parent" elements. Elements in referenced groups are included, up to two levels of group nesting.
Model Diagram
The DTD model for this element:
--+(choice of TEXT with elements repeated) 
  |  
  |--+(repeatable choice) [Reference Content]
  |  |  
  |  |--+(choice) [Formatting in Text]
  |  |  |  
  |  |  |-- sub  -- (TEXT and elements)
  |  |  |  
  |  |  |-- sup  -- (TEXT and elements)
  |  |  |  
  |  |  |-- b  -- (TEXT and elements)
  |  |  |  
  |  |  |-- i  -- (TEXT and elements)
  |  |  |  
  |  |  |-- smallcaps  -- (TEXT and elements)
  |  |  |  
  |  |  |-- u  -- (TEXT and elements)
  |  |  |  
  |  |  |-- box  -- (TEXT and elements)
  |  |  |  
  |  |  |-- roman  -- (TEXT and elements)
  |  |  |  
  |  |  |-- script  -- (TEXT and elements)
  |  |  |  
  |  |  |-- tt  -- (TEXT and elements)
  |  |  |  
  |  |  |-- strikethrough  -- (TEXT and elements)
  |  |  |  
  |  |  |-- overline  -- (TEXT and elements)
  |  |  |  
  |  |  |-- newpage  
  |  |  |  
  |  |  |-- query  -- TEXT
DTD Definition
The DTD contains the following element and attribute definitions (note that embedded links are to definitions within the DTD page of this guide):
<!ELEMENT xref                           (#PCDATA | %ReferenceContent;)*>
<!ATTLIST xref
                linkend                  IDREF  #REQUIRED 
               %a-group-CommonIDAttrs;>
.
Defined in DTD section Inline-level Content : Linking
General Attributes (shared with other elements)
Common Optional ID Attributes (a-group-CommonIDAttrs)
Local Attributes (defined for this element alone)
Attribute: linkend
Description
This attribute holds a copy of a unique value in an attribute of another element. This is used to form the link to that element.
Specification
This attribute is required. It holds a reference to a unique identifier code on another element.
DTD Definition
                linkend                  IDREF  #REQUIRED 
.