Einfache Querverweise

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

In den meisten Fällen reicht es aus, wenn Sie:

  1. Einen Anker an die Stelle setzen, auf die Sie verweisen möchten.
  2. Den internen Querverweis als <xref/> eingeben und den Inhalt des Attributs linkend auf den vorher definierten Anker zeigen lassen.

Wie dies aussieht, zeigt das folgende Beispiel.

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

<chapter ANKER="prod.description">
  <title>Produktbeschreibung</title>
  <para> ... </para>
</chapter>
  ...
<para>Weitere Informationen erhalten Sie in <xref linkend="prod.description"/>.</para>

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

Nach der Verarbeitung erhalten Sie beispielsweise:

Weitere Informationen erhalten Sie in Kapitel 2, "Produktbeschreibung".

Das xref-Element wird durch den hervorgehobenen Text ersetzt. Der Ersetzungstext wird von den DocBook-Stylesheets generiert, wie auch das Wort Kapitel, die Kapitelnummer und die Anführungszeichen. Je nach Zielformat wird der hervorgehobene Text als Link erzeugt.

  

<< 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