XML-Technologien / DocBook / (X)HTML erzeugen / Verlinkte Teildateien erzeugen / Ausgabeverzeichnis festlegen

Ausgabeverzeichnis festlegen

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

Standardmäßig wird von den Stylesheets das aktuelle Verzeichnis für die Ausgabe verwendet. Sollen die Dateien an anderer Stelle ausgegeben werden, gibt es folgende Möglichkeiten:

den Parameter base.dir,
die Verarbeitungsanweisungen <?dbhtml filename="..."?> und <?dbhtml dir="..."?> direkt im DocBook-Dokument,
eine Kombination aus den beiden vorigen.

Den Parameter base.dir setzen Sie entsprechend auf das Ausgabeverzeichnis:

xsltproc --stringparam base.dir /irgendwo/hin/ ...

Achten Sie darauf, dass für Linux bzw. MacOS das Verzeichnis immer mit einem Schrägstrich und für Windows mit einem Backslash endet. Ist dies nicht der Fall, enthalten die Dateinamen den übergebenen Wert als Präfix.

Die zweite Möglichkeit verwendet die Verarbeitungsanweisung <?dbhtml?>, um eine bessere Gliederung in Verzeichnissen zu ermöglichen:

<book>
  <?dbhtml dir="docbook"?>
  <title>DocBook</title>
...
  <chapter id="xml-intro">
     <?dbhtml dir="xml"?>
     <?dbhtml filename="index.html"?>
  ...
  <chapter id="xslt-intro">
     <?dbhtml dir="xsl"?>
  ...     
</book>

Der obige Code generiert die folgende Dateistruktur:

Alle Kindelemente des ersten chapter-Elements landen im Verzeichnis docbook/xml. Wird zusätzlich der Parameter use.id.as.filename verwendet, werden die Dateinamen entsprechend Ihrem ID-Attribut benannt.

Die dritte Möglichkeit ist lediglich eine Kombination aus den beiden vorgestellten, sodass an dieser Stelle auf ein Beispiel verzichtet wird.

<< zurück

vor >>

Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

DITA
XSLT

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