In den vorhergegangenen Abschnitten wurden vereinzelt bereits Beispiele für Referenzen gebracht, so bei den Fußnoten und beim Verbinden von Zellen über Spaltengrenzen. Alle diese Beispiele haben gezeigt, dass man für Referenzen zwei Dinge braucht:
eine eindeutige Bezeichnung des Sprungziels
die eigentliche Referenz
Referenzen erfordern eindeutige Bezeichnungen
Die eindeutige Bestimmung des Sprungziels erfolgt über die Vergabe das Univeralattributs id. Universalattribut bedeutet, dass es in jedem Element erscheinen kann. Eine id muss für jedes Dokument eindeutig sein, es darf also nicht vorkommen, dass zwei Elemente eines Dokuments den gleichen Wert für das Attribut id haben. Wenn das Ziel eines Sprungs nicht ein Bereich, sondern ein ganz bestimmter Punkt des Dokuments sein soll, kann man das Element anchor verwenden, um das Sprungziel zu bestimmen. Auch anchor braucht das id-Attribut.
Referenzen auf Ziele innerhalb des Dokuments werden mit dem Element xref bewerkstelligt. Der Verweis auf das eigentliche Ziel erfolgt dabei mit dem Attribut linkend. Dieses muss den gleichen Wert haben, wie die id des Sprungziels. Durch die Verwendung von endterm kann außerdem angegeben werden, welcher Text die Sprungstelle beschreiben soll. Auch dieses Attribut ist ein Zeiger auf die id eines anderen Elements. Das Element xref kann keine untergeordneten Elemente enthalten.
Beispiel 2.33. Referenz auf einen Abschnitt
Das title-Element dieses Abschnitts trägt das Attribut id mit dem Wert „referenzen“.
<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<para>
Dieser Absatz gehört zum Abschnitt
<xref linkend="referenzen" endterm="referenzen" />.
</para>
Dieser Absatz gehört zum Abschnitt Referenzen.
Externe Verweise erfolgen mit ulink
Für externe Verweise, insbesondere auf Internet-Adressen verwendet man das Element ulink, welches das Sprungziel durch eine URL beschreibt. Im Gegensatz zu xref kann ulink Text enthalten. Mit dem Attribut url wird die URL des Sprungziels angegeben und das optionale Attribut type kann benutzt werden, um den Mime-Typen des Ziels zu beschreiben.
Beispiel 2.34. Verweis auf eine URL
<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<para>
Wenn Sie weitere Informationen suchen, besuchen Sie doch
<ulink url="http://www.docbook.org" type="text/html">
www.docbook.org
</ulink>.
</para>
Wenn Sie weitere Informationen suchen, besuchen Sie doch www.docbook.org.