XML-Technologien / DocBook / (X)HTML erzeugen / Verlinkte Teildateien erzeugen / Manuelle Kontrolle über den Aufteilungsvorgang

Manuelle Kontrolle über den Aufteilungsvorgang

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

Sind einige Teildateien zu kurz oder zu lang, kann manuell eingegriffen werden. Gehen Sie wie folgt vor:

Anwenden des Stylesheets maketoc.xsl
Wenden Sie das Stylesheet maketoc.xsl auf Ihr DocBook-Dokument an. Dies erzeugt eine XML-Datei, die DocBook-Elemente enthält (hauptsächlich tocentry).

xsltproc --output toc.xml html/maketoc.xsl mydocument.xml

Bearbeiten der erzeugten Datei
Editieren Sie die erzeugte Datei toc.xml und entfernen Sie alle tocentry-Elemente, die in die gleiche Datei wie ihr Elternelement geschrieben werden sollen. Umgekehrt fügen Sie tocentry-Elemente hinzu, um eine separate Datei zu erzeugen. Ein Ausschnitt aus der Datei toc.xml sieht ungefähr so aus:

<?xml version="1.0" encoding="UTF-8"?> 
<toc role="chunk-toc"> 
  <tocentry linkend="docbook-xml"><?dbhtml filename="index.html"?> 
    <tocentry linkend="preface"><?dbhtml filename="pr01.html"?> 
      <tocentry linkend=""><?dbhtml filename="pr01s02.html"?></tocentry> 
  ... 
</toc>

Um die Dateinamen zu ändern, müssen Sie nur die Verarbeitungsanweisungen bearbeiten. Das Attribut linkend lassen Sie unverändert.

Bearbeiten Sie Ihr Dokument mit chunktoc.xsl
Bearbeiten Sie Ihr Dokument mit dem Stylesheet chunktoc.xsl und setzen Sie zusätzlich den Parameter chunk.toc auf den Dateinamen von Schritt 1 (oben):

xsltproc --stringparam chunk.toc toc.xml \ 
    html/chunktoc.xsl mydocument.xml

Mit diesem Aufruf wird das Dokument mydocument.xml nach Ihren Vorgaben von toc.xml aufgeteilt.

Beachten Sie, dass jedes Element einen Anker besitzen muss, wenn es in eine Teildatei geschrieben werden soll. Ist dies nicht der Fall, werden solche Elemente mit dem entsprechenden Elternelement zusammen in eine Datei geschrieben (siehe Schritt 2 (oben) im dritten tocentry-Element).

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