Erweiterte Querverweise

(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)

Falls Sie den Text weiter beeinflussen möchten, lässt sich dies, wie eingangs erwähnt, mit den Attributen endterm und xrefstyle in <xref/> vornehmen.

Beispiel: Ein DocBook-Dokument mit Querverweisen (xref02.xml)

<chapter ANKER="chap.xmldtd">
  <title>XML, DTDs und Schemata</title>
  <para>XML finden Sie in <xref linkend="sec.xml"/></para>
  <para>Mehr zu Document Type Definitions finden Sie in <xref linkend="sec.dtd"/></para>
  <para>Etwas zu Schemata finden Sie in <xref linkend="sec.xsd" endterm="sec.xsd.abbrev"/></para>
  <section ANKER="sec.xml">
    <title>Was ist XML</title>
    <para>... </para>
  </section>
  <section ANKER="sec.dtd" xreflabel="DTDs">
    <title>Was ist eine DTD?</title>
    <para>...</para>
  </section>
  <section ANKER="sec.xsd">
    <title>Was sind W3C-Schemata?</title>
    <titleabbrev ANKER="sec.xsd.abbrev">W3C-Schemata</titleabbrev>
    <para>...</para>
  </section>
</chapter>

Ersetzen Sie den Platzhalter ANKER durch id in DocBook 4 und xml:id in DocBook 5.

Zeile 3: Dieser Querverweis zeigt auf den ersten Abschnitt (sec.xml).
Zeile 4: Dieser Querverweis zeigt auf den zweiten Abschnitt (sec.dtd). Jedoch enthält der zweite Abschnitt zusätzlich ein Attribut xreflabel, das als Querverweistext verwendet wird.
Zeile 5: Ein Querverweis mit dem zusätzlichen Attribut endterm. In diesem Fall zeigt der Attributwert von endterm auf ein Element, bei dem der Inhalt als Querverweistext verwendet wird.
Zeile 6: Ein Abschnitt mit einem Anker.
Zeile 10: Ein Abschnitt mit einem zusätzlichen xreflabel. Wird darauf verwiesen, wird der Inhalt dieses Attributs verwendet im Gegensatz zum Titel.
Zeile 16: Dieser Abschnitt enthält ein Element titleabbrev. Wird darauf mittels endterm verwiesen, ist dies eine weitere Möglichkeit für den Quellverweistext.

Das xref-Element wird durch Ihr Publishing-System aufgelöst. Die DocBook-Stylesheet erzeugen daraus folgende Texte:

XML finden Sie in Abschnitt 1.1, "Was ist XML"
Mehr zu Document Type Definitions finden Sie in DTDs
Etwas zu Schemata finden Sie in W3C-Schemata

Der hervorgehobene Text ist derjenige, der durch xref ersetzt wurde. Das zusätzliche Wort Abschnitt ist ein lokalisiertes Wort, das standardmäßig von den DocBook-Stylesheets erstellt wird. Die Nummerierung wird automatisch hinzugefügt.

In der Regel werden Sie das Attribut endterm eher weniger benötigen. Sie brauchen es dann, wenn sich aus bestimmten Gründen der Titel vom Querverweistext unterscheiden muss.

  

<< zurück vor >>
Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © 2009 Millin Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

Millin Verlag, Siebengebirgsring 36, 53797 Lohmar, info(at)millin.de