Zusätzliche Möglichkeiten für DocBook 5
(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)
Die vorhin gezeigten Verweise sind ebenfalls in DocBook 5 erlaubt. Sie müssen lediglich das Attribut id durch xml:id austauschen.
Um in DocBook 5 einen internen Querverweis zu erstellen, ist das Element xref nicht unbedingt erforderlich. Das Attribut linkend ist jetzt überall erlaubt und verwandelt jedes Element in einen Querverweis. Das folgende Beispiel zeigt Ihnen den Code.
Beispiel: Verweis mit dem Attribut linkend
<para>Des Weiteren gibt es <acronym linkend="chap.xml">XML</acronym>, die eXtensible Markup Language...</para>
...
<chapter xml:id="chap.xml">
<title>XML</title>
<para> ... </para>
</chapter>Der Vorteil dieser Methode ist, dass sich jedes Element in einen Querverweis verwandeln lässt. Wann sollten Sie das Attribut linkend verwenden und wann nicht? Hier ein paar Anmerkungen:
- Verwenden Sie bevorzugt xref, wenn Sie Ihren Verweistext anpassen möchten oder er automatisch generiert werden soll.
- Achten Sie darauf, dass ein Verweis in manchen Zielformaten nicht weiterverfolgt werden kann. In (X)HTML wird das Element, welches das linkend-Attribut trägt, zu einem anklickbaren "Hotlink". Erzeugen Sie PDF, sieht der Leser nur den Text ohne irgendeinen Bezug wie Seitenzahl, Abschnittsnummer usw.
- Setzen Sie linkend nur bei Inline-Elementen ein. Auch wenn dieses Attribut in Block-Elementen erlaubt ist, ist das Ergebnis undefiniert und im schlimmsten Fall unerwünscht. Zukünftige Versionen der DocBook-Stylesheets mögen diesen Fall unterstützen, zum Zeitpunkt der Bucherstellung wird dies nicht empfohlen.
| << zurück | vor >> |
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