By Norman Walsh & Leonard Muellner
1st Edition October 1999
1-56592-580-7, Order Number: 5807
652 pages, $36.95 , Includes CD-ROM
|DocBook: The Definitive Guide|
XRef ::= EMPTY
The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.
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.
If the Endterm attribute is specified, the content of the element pointed to by Endterm must be used as the text of the cross-reference, otherwise it is up to the application to generate appropriate cross reference text from the element pointed to by Linkend.
If the object pointed to has a specified XRefLabel, that should be used as the cross-reference text.
These elements contain XRef: Application, Attribution, BiblioMisc, BridgeHead, Citation, CiteTitle, Comment, Emphasis, entry, ForeignPhrase, GlossSee, GlossSeeAlso, GlossTerm, LineAnnotation, Link, LiteralLayout, LoTentry, Member, MsgAud, OLink, Para, Phrase, Primary, PrimaryIE, ProductName, ProgramListing, Quote, RefEntryTitle, RefPurpose, Screen, ScreenInfo, Secondary, SecondaryIE, See, SeeAlso, SeeAlsoIE, SeeIE, Seg, SegTitle, SimPara, Subtitle, Synopsis, Term, Tertiary, TertiaryIE, Title, TitleAbbrev, ToCback, ToCentry, ToCfront, ULink.
In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.
Endterm points to the element whose content is to be used as the text of the link.
Linkend points to the target of the cross reference.
Anchor, Link, OLink, ULink
Consider the following example:
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <book><title>An Example Book</title> <chapter ><title>XRef Samples</title> <para> This paragraph demonstrates several features of <sgmltag>XRef</>. </para> <itemizedlist> <listitem><para>A straight link generates the cross-reference text: <xref linkend="ch02">. </para></listitem> <listitem><para>A link to an element with an <sgmltag >XRefLabel</sgmltag>: <xref linkend="ch03">. </para></listitem> <listitem><para>A link with an <sgmltag >EndTerm</sgmltag>: <xref linkend="ch04" endterm="ch04short">. </para></listitem> </itemizedlist> </chapter> <chapter > <title>The Second Chapter</title> <para>Some content here</para> </chapter> <chapter xreflabel="Chapter the Third"> <title>The Third Chapter</title> <para>Some content here</para> </chapter> <chapter > <title>The Fourth Chapter</title> <titleabbrev >Chapter 4</titleabbrev> <para>Some content here</para> </chapter> </book>
One reasonable rendering for the content of the first chapter of this book is the following:
This paragraph demonstrates several features of XRef.
A straight link generates the cross-reference text: Chapter 2, "The Second Chapter"
A link to an element with an XRefLabel: Chapter the Third.
A link with an EndTerm: Chapter 4.
Of course, in an online system, these references would also be links to the appropriate chapters.
For additional examples, see also Part.
Back to: DocBook: The Definitive Guide
© 1999, O'Reilly & Associates, Inc.