◇◆

linkend Linkend

Points to an internal link target by identifying the value of its @xml:id.

Usage/Remarks

Available internal cross-referencing mechanisms, which use this attribute, are described more fully in the descriptions of the related elements, <xref>, <citation>, and <link>.
OPTIONAL on element: <citation>
Value Meaning
An identifier (IDREF) The pointing uses the ID/IDREF mechanism, using the @linkend attribute of the <citation> element to point to the @xml:id attribute of a <bibliomixed> element.
Restriction This attribute may be specified if the element is used.
OPTIONAL on element: <link>
Value Meaning
An identifier (IDREF) The pointing uses the ID/IDREF mechanism, using the @linkend attribute of the <link> element to point to the @xml:id attribute of an existing element (when the linking text is not to be generated or acquired from the target element of the reference, but instead from the <link> element’s contents).
Restriction This attribute may be specified if the element is used.
REQUIRED on element: <xref>
Value Meaning
An identifier (IDREF) The pointing uses the ID/IDREF mechanism, using the @linkend attribute of the <xref> element to point to the @xml:id attribute of an existing element (when the linking text is to be generated or acquired from the target element of the reference).
Restriction This attribute must be specified if the element is used.
Tagged Samples
Pointer to a bibliographic entry 
...
<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, of which there appear to have been a diverse group, including 
    Croatans, Mangoaks, Chaonists, and Sequotanes, as well as Roanoke from which the 
    region took its name. [<xref linkend="lane1586"/>, <xref linkend="dunbar1960"/>] 
    ...</para>
  </section>
...
<bibliography>
  <title>Bibliography</title>
  ...
  <bibliomixed xml:id="dunbar1960" xreflabel="Dunbar 1960">Dunbar, Gary S. ...</bibliomixed>
  <bibliomixed xml:id="lane1586" xreflabel="Lane">Lane, Ralph. ...</bibliomixed>
</bibliography>
...
Pointer to a figure 
...
<section xml:id="mul4-1">
  <title>Gourds</title>
  <para>The native people grew a variety of large broad-leafed, ground-covering vines 
    which produced what they called <quote>macocqwer</quote> or gourds. (<emphasis 
    role="ital">See</emphasis> <xref linkend="mul-fig1"/>.) ...</para>
  <figure xml:id="mul-fig1">
    <title>Gourds</title>
    <mediaobject>
      <imageobject>
        <imagedata format="jpg" fileref="19450212-2.jpg" width="50%"/>
      </imageobject>
    </mediaobject>
    ...
  </figure>
  ...
</section>
...
Pointer to a section 
...
<section xml:id="mul3">
  <title>Native Inhabitants of the New World</title>
  ...
</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 <xref linkend="mul3"/>. ...</para>
</section>
...
Pointer to an appendix 
...
<section>
  ...
  <para>The second expedition, organized by John White in 1587, fared better. It sailed with 
    seven ships filled with Devon families intent upon establishing a colony in that part of 
    Virginia called Roanoke, a word deriving from the speech of native peoples. (<emphasis 
    role="ital">See</emphasis> <xref linkend="mul-app2"/>.) ...</para>
</section>
...
<appendix xml:id="mul-app2" xreflabel="Appendix II">
  <title>The Roanoke Colony, 1587</title>
  ...
</appendix>
...