◇◆

<xref> Cross-Reference

An internal cross-reference. This is an empty element, displayed as a link to the element identified with its @linkend attribute (its target element), with contents generated from the target (its @xreflabel or, on certain elements where @xreflabel is not available, an autogenerated label).

Usage/Remarks

Best Practice Note

This element is the preferred method for inserting any kind of cross-reference, including cross-references to bibliographic citations (<bibliomixed> elements).
A <footnote> can be referenced more than once using <xref> for second or subsequent references.
Display/Formatting Note
Elements for which cross-referencing text can be generated without an @xreflabel include <appendix>, <equation>, <figure>, <footnote>, <note>, <section>, and <table>. The generated text will not include any type of enclosing punctuation; brackets or other types of punctuation to enclose the cross-reference must be present in the narrative text, e.g., [<xref linkend="app1"/>].
Use of @xreflabel with <bibliomixed> is preferred, with its value providing the link text for any cross-reference, e.g. xreflabel="Smith and Thomas 1986". If <bibliomixed> has no @xreflabel, an <xref> to it will be provided with its @xml:id value as contents, e.g., xml:id="smith-thomas86". Any enclosing punctuation for the cross-reference must be present in the narrative text, e.g., [<xref linkend="jones1990"/>].
Attribute
linkend (REQUIRED)
Models and Context
May be contained in
<attribution>, <emphasis>, <para>, <phrase>, <quote>, <subtitle>, <td>, <term>, <th>, <title>
Description
This is an EMPTY element
Expanded Content Model

EMPTY

Tagged Samples
To bibliiographic entry 
<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
  version="5.0-subset Balisage-1.5" xml:id="HR-23632987-8973">
  ...
  <section xml:id="mul3">
    <title>Native Inhabitants of the New World</title>
    <para>... natives assisted the settlers&#8217; efforts to hunt game, fowl, 
      and fish, although such efforts apparently failed to provide sufficient 
      food stocks for the entire colony. [<xref linkend="lane1586"/>]</para>
  </section>
  ... 
  <bibliography>
    <title>Bibliography</title>
    ... 
    <bibliomixed xml:id="lane1586" xreflabel="Lane">Lane, Ralph. <emphasis role="ital">The 
      Colony at Roanoake &#8212; 1586</emphasis>. [online]. [cited 13 Apr 1998]. 
      <link>http://www.nationalcenter.inter.net/ColonyofRoanoke.html</link>.</bibliomixed>
    ... 
  </bibliography>
</article>
To section 
<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
  version="5.0-subset Balisage-1.5" xml:id="HR-23632987-8973">
  ...
  <section xml:id="mul3">
    <title>Native Inhabitants of the New World</title>
    <para>Upon establishing the Roanoke colony, the settlers encouraged 
      relations with the native inhabitants, ...</para>
  </section>
  ... 
  <section xml:id="mul6">
    <title>Roanoke &#8212; a Failure?</title>
    ...
    <para>... Raleigh&#8217;s efforts &#8212; along with those of 
      countless other explorers to the New World &#8212; introduced 
      New World plants such as potatoes and tomatoes to England, as 
      described in Section <xref linkend="mul3"/>. ...</para>
  </section>
  ...
</article>
To appendix 
...
<para>With land claimed in the New World, an expedition was mounted to establish a settlement.
  The first expedition failed. Led by Sir Richard Grenville in April 1585, it encompassed 600
  men of which 105 remained in the colony while Grenville returned to England for additional
  provisions. (<emphasis role="ital">See</emphasis>
  <xref linkend="mul-app1"/>.) However, when almost a year passed without Grenville’s return, 
  the remainder of the expeditionary force took advantage of Sir Francis Drake’s arrival to 
  seek return passage to England.<footnote xml:id="mul74">
    <para>It has been argued that the first expedition was not a failure. Richard Grenville did
      return to the colony with additional provisions not long after Drake’s departure, and he
      ordered 15 men, supposedly supplied for two years, to remain in the colony while he
      returned for new settlers. However, it is unknown whether these men were present to greet
      the subsequent expedition.</para>
  </footnote>
</para>
...