<xref>

Cross-Reference

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

Remarks

This element is the preferred method for inserting any kind of cross-reference including cross-references to bibliographic citations (<bibliomixed> elements).

Elements for which cross-referencing text can be generated without a @xreflabel include <appendix>, <equation>, <figure>, <footnote>, <note>, <section>, <table>, or any type of list (<itemizedlist>, <orderedlist>, <variablelist>) that has a <title>.

If <bibliomixed> has no @xreflabel, a <xref> to it will be provided with its @xml:id as contents.

Linking to other elements that have @xml:id will also work, but since they have no automatic labeling logic, a @xreflabel must be given on the target element, or a warning text will result.

A <footnote> can be referenced more than once using <xref> for second or subsequent references.

Attribute

linkend Linkend

Expanded Content Model

EMPTY

Description

This is an EMPTY element

This element may be contained in:

<attribution>, <emphasis>, <para>, <quote>, <subtitle>, <td>, <term>, <th>, <title>

Example

...
    <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="mul83"/>.) 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>
    ...

Module

balisage-1-3.dtd