Die Transformation

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

Um Ihr DocBook-Dokument nach XHTML umzuwandeln, benötigen Sie einen XSLT-Prozessor (xsltproc, Saxon oder Xalan) und die DocBook-Stylesheets. Hierzu haben Sie folgende Möglichkeiten (vgl. DocBook XSL Stylesheets anpassen):

  1. Sie verwenden die Originalstylesheets. Ersetzen Sie den Platzhalter DB durch Ihr Installationsverzeichnis der DocBook-Stylesheets und rufen Sie auf:
xsltproc --output pinguin.html DB/xhtml/docbook.xsl pinguin.xml
  1. Sie verwenden Parameter. Durch Parameter lassen sich eine Vielzahl von Einstellungen schnell korrigieren, ohne eine Anpassungsdatei schreiben zu müssen. Beispielsweise verknüpft der folgende Parameter html.stylesheet jede XHTML-Datei mit einer CSS-Datei (alles in einer Zeile):
xsltproc --stringparam html.stylesheet "book.css" DB/xhtml/docbook.xsl pinguin.xml
  1. Sie schreiben eine Anpassungsdatei. Dies ist die flexibelste Lösung, wenn auch etwas umständlicher. Dadurch vereinfacht sich der Aufruf von xsltproc, da Sie keine Parameter mehr angeben müssen. Des Weiteren lassen sich Templates überschreiben, um eigene Vorstellungen einzubringen.
  1. Schreiben Sie Ihre Anpassungsdatei, beispielsweise:
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> 
    <xsl:import href="DBBASISURI/xhtml/docbook.xsl"/> 
    <xsl:param name="html.stylesheet">book.css<xsl:param> 
</xsl:stylesheet>

Ersetzen Sie den Platzhalter DBBASISURI durch den entsprechenden offiziellen URI, vgl. Tabelle Basis-URIs für DocBook 4 und DocBook 5.

  1. Speichern Sie das Stylesheet ab, beispielsweise unter mydb2xhtml.xsl.
  2. Rufen Sie den XSLT-Prozessor mit Ihrem Stylesheet auf:
xsltproc --output pinguin.html mydb2xhtml.xsl pinguin.xml 

Die oben vorgestellten Umwandlungen lassen sich ebenso mit dem Stylesheet xhtml/chunk.xsl vornehmen. Dadurch wird Ihr Dokument in einzelne XHTML-Dateien aufgeteilt und automatisch miteinander verlinkt. Dies bietet sich für größere Dokumente an, die zu umfangreich sind, um als Ganzes im Browser geladen zu werden.

  

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