xref
xref — A cross reference to another part of the document.
Synopsis
xref ::=
- empty
Attributes
Common attributes and common linking attributes.
Additional attributes:
- endterm (IDREF)
- xrefstyle
Required attributes are shown in bold.
Description
The xref
element forms a cross-reference from
the location of the xref
to the element to which it
points. Unlike link
and the other cross-referencing
elements, xref
is empty. The processing system has to
generate appropriate cross-reference text for the reader.
Processing expectations
Under ordinary circumstances, the xref
points
to some element with its linkend
attribute and the processing system generates appropriate
cross-reference text. There are three ways for the author to influence
the generated text:
If the
endterm
attribute is specified onxref
, the content of the element pointed to byendterm
will be used as the text of the cross-reference.Otherwise, if the object pointed to has a specified
xreflabel
, the content of that attribute will be used as the cross-reference text.Finally, the author may specify a keyword (or other information) in the
xrefstyle
attribute. Unlikeendterm
andxreflabel
which have rigid semantics, the content of thexrefstyle
attribute is simply additional information for the processing system. What effect it has, if any, is dependent on the processing system.
Attributes
Common attributes and common linking attributes.
- any attribute
Any attribute in any other explicit namespace
- endterm
Points to the element whose content is to be used as the text of the link
- xrefstyle
Specifies a keyword or keywords identifying additional style information
Parents
These elements contain xref
: abbrev
, acronym
, address
, artpagenums
, attribution
, authorinitials
, bibliocoverage
, biblioid
, bibliomisc
, bibliomixed
, bibliomset
, bibliorelation
, bibliosource
, bridgehead
, citation
, citebiblioid
, citetitle
, city
, confdates
, confnum
, confsponsor
, conftitle
, contractnum
, contractsponsor
, contrib
, country
, edition
, email
, emphasis
(db._emphasis), emphasis
(db.emphasis), entry
, fax
, firstname
, firstterm
(db._firstterm), firstterm
(db.firstterm), foreignphrase
(db._foreignphrase), foreignphrase
(db.foreignphrase), givenname
, glosssee
, glossseealso
, glossterm
(db._glossterm), glossterm
(db.glossterm), holder
, honorific
, inlinestagedir
, issuenum
, jobtitle
, label
, line
, lineage
, link
, literal
, literallayout
, mathphrase
, member
, meta
(db.meta.content), olink
, optional
, orgdiv
, orgname
, otheraddr
, othername
, pagenums
, para
, personname
, phone
, phrase
(db._phrase), phrase
(db.phrase), pob
, postcode
, primary
, productname
, productnumber
, publishername
, quote
(db._quote), quote
(db.quote), releaseinfo
, remark
, revnumber
, revremark
, secondary
, see
, seealso
, seriesvolnums
, shortaffil
, simpara
, state
, street
, subscript
, subtitle
, superscript
, surname
, templatename
, term
, termdef
, tertiary
, title
, titleabbrev
, trademark
, uri
, volumenum
, wordasword
, year
.
See Also
Examples
1 |<book xmlns='http://docbook.org/ns/docbook'>
|<title>An Example Book</title>
||
<chapter xml:id="ch01"><title>XRef Samples</title>
5 |<para>This paragraph demonstrates several features of <tag>XRef</tag>.
|</para>
||
<itemizedlist>
|<listitem><para>A straight link generates the cross-reference text:
10 |<xref linkend="ch02"/>.
|</para></listitem>
|<listitem><para>A link to an element with an
|<tag class="attribute">XRefLabel</tag>:
|<xref linkend="ch03"/>.
15 |</para></listitem>
|<listitem><para>A link with an <tag class="attribute">EndTerm</tag>:
|<xref linkend="ch04" endterm="ch04short"/>.
|</para></listitem>
|</itemizedlist>
20 |</chapter>
||
<chapter xml:id="ch02">
|<title>The Second Chapter</title>
|<para>Some content here</para>
25 |</chapter>
||
<chapter xml:id="ch03" xreflabel="Chapter the Third">
|<title>The Third Chapter</title>
|<para>Some content here</para>
30 |</chapter>
||
<chapter xml:id="ch04">
|<title>The Fourth Chapter</title>
|<titleabbrev xml:id="ch04short">Chapter 4</titleabbrev>
35 |<para>Some content here</para>
|</chapter>
|</book>