Updates

• 27. April 2014

Da ich immer wieder mal Dokumentationen mittels Docbook verfasse, jedoch nicht oft genug, damit ich mir merke, wies geht - habe ich mir ein Template geschaffen, das zum einen die korrekte Projektstruktur vorgibt und zum anderen Beispiele für verschiedene Konstrukte wie Tabellen, Querverweise, Abbildungen enthält.

Das Template enthält eine komplette Projektstruktur einschließlich eines Build-Skriptes. Das Projekt erzeugt sowohl HTML- wie auch PDF-Versionen. Das Projekt ist angelegt als Set - also als Menge mehrerer Bücher oder Buchreihe. Es enthält ein Buch.

Das Template zeigt exemplarisch

• Aufteilen eines Docbook-Projektes in verschiedene Dateien
• Abbildungen
• Tabellen
• Querverweise (nicht nur auf Abschnitte, sondern auch Tabellen, Abbildungen, Beispiele,...)
• Callouts und Programm-Listings

Voraussetzungen

Docbook Stylesheets

erlauben die Transformation von Docbook-XML-Dateien in andere Formate

XSLT-Prozessor Saxon

Führt die Transformation von Docbook-XML-Dateien in andere Formate durch

Formatting Objects Prozessor FOP

PDF-Erzeugung läuft über ein Zwischenformat: fo - FOP transformiert dieses Format in ein PDF

ANT

Dieses Werkzeug dient der Erstellung der Ausgabedokumente - es wird ohne weitere Parameter in dem Verzeichnis ausgeführt, das auch die Datei build.xml enthält

Konfiguration

docbook-xsl=<Pfad zu den Stylesheets>
saxon.dir=<Verzeichnis, das die Datei saxon9he.jar enthält>
fop.executable=<Name des ausführbaren FOP-Programms einschließlich absoluter Pfadangabe>

Aktualisierung vom 27. April 2014

docbook-xsl=<Pfad zu den Stylesheets>
saxon1.dir=<Verzeichnis, das die Datei saxon.jar enthält> (saxon bis maximal Version 6.5.5);
saxon2.dir=<Verzeichnis, das die Datei saxon9he.jar enthält>
fop.executable=<Name des ausführbaren FOP-Programms einschließlich absoluter Pfadangabe>

Lizenz

docbooktemplate