Aufbau der Stile

Das Verzeichnis /opt/zpub/demo/style enthält ein Verzeichnis pro verfügbarem Stil (hier Beispielshaft /opt/zpub/demo/style/plain, welches die XSLT-Dateien und zugehörigen Mediendateien enhalten. Folgende Dateien im Verzeichnis plain haben besondere Bedeutung:

Stil-Dateien

pdf/fo.xsl
XSLT-Stylesheet für die PDF-Ausgabe
pdf/fop.xconf
fop-Konfigurationsdatei (optional)
html/html.xsl
XSLT-Stylesheet für die HTML-Ausgabe
html/static/
Zusätzliche Dateien für die HTML-Ausgabe
htmlhelp/htmlhelp.xsl
XSLT-Stylesheet für die Windows-Hilfe-Ausgabe
htmlhelp/static/
Zusätzliche Dateien für die Windows-Hilfe-Ausgabe
epub/epub.xsl
XSLT-Stylesheet für die epub-Ausgabe
epub/static/
Zusätzliche Dateien für die epub-Ausgabe

Ein Bild tip.png, das im Wurzelverzeichnis des Style-Verzeichnisses liegt, muss wie folgt in den Stylesheets referenziert werden:

Beim erstellen der Zip-Archive für HTML, epub und Windows-Hilfe werden nur jene Bilder mit aufgenommen, die in den Dokumenten auch referenziert werden. Die Bilddateien oder die Unterverzeichnisse, in denen sie liegen, dürfen dabei auch symbolische Links sein. So könnte etwa xsl-images ein symbolischer Link auf /usr/share/xml/docbook/stylesheet/docbook-xsl/images/ sein.

Zusätzliche Dateien wie CSS-Stile und JavaScript-Dateien werden nicht automatisch kopiert; auch nicht darin referenzierte Dateien. Diese müssen daher in dem jeweiligen static/-Unterverzeichnis bereitgestellt werden. Eine Datei, die etwa im HTML-Stylesheet über einen Pfad css/screen.css. referenziert wird, muss dazu in html/static/css/screen.css liegen. Auch müssen Bilder, die via CSS oder JavaScript geladen werden, im Verzeichnis static/ liegen.