Beeinflussen der Inhaltsverzeichnisse

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

Um Inhaltsverzeichnisse für Strukturelemente anzuzeigen oder auszublenden, gibt es den Parameter generate.toc. Zu diesem Zweck enthält der Parameter generate.toc eine Auflistung von Werte-Paaren, wie sie im folgenden Beispiel gezeigt werden.

Beispiel: Der Parameter generate.toc (Standardwerte)

<xsl:param name="generate.toc">
appendix          toc,title
article/appendix  nop
article           toc,title
book              toc,title,figure,table,example,equation
chapter           toc,title
part              toc,title
preface           toc,title
qandadiv          toc
qandaset          toc
reference         toc,title
sect1             toc
sect2             toc
sect3             toc
sect4             toc
sect5             toc
section           toc
set               toc,title  
</xsl:param>

Linke Spalte (appendix bis set): Kennzeichnet das gewünschte Element, das im Inhaltsverzeichnis aufgenommen wird.
Rechte Spalte (toc usw.): Eine Liste, welche Arten von Inhaltsverzeichnissen gewünscht werden.
Zeile 3, nop: Deaktiviert alle Inhaltsverzeichnisse für dieses eine Element.
Zeile 5: Für das Element book werden Inhalts-, Abbildungs- und Tabellenverzeichnisse, sowie eine Liste aller Beispiele und Gleichungen erstellt.

Der Inhalt des Parameters generate.toc besteht aus zwei Wortteilen, die durch beliebig viele Leerzeichen voneinander getrennt sind. Der erste Teil eines jeden Paares enthält den Elementnamen, für das ein Inhaltsverzeichnis ein- oder ausgeblendet wird.

Der zweite Teil besteht aus einer durch Kommata getrennten Liste von Schlüsselwörtern. Meist reicht toc, um das Inhaltsverzeichnis für das angegebene Element einzublenden. Ein zusätzliches title erzeugt den entsprechenden Titel der Liste, für gewöhnlich "Inhaltsverzeichnis", "Abbildungsverzeichnis" usw. Um alle Verzeichnisse eines Elements zu unterdrücken, verwenden Sie den Wert nop.

Mit Hilfe des Parameters generate.toc kontrollieren Sie, für welche Elemente Verzeichnisse enthalten sein sollen. Für gewöhnlich wird der Parameter in einer Anpassungsdatei gesetzt, da die Eingabe über die Kommandozeile unhandlich und fehleranfällig ist.

Möchten Sie Verzeichnisse von den Elementen appendix, part und preface ausblenden sowie für book und chapter einfügen, schreiben Sie:

<xsl:param name="generate.toc">
appendix          nop
part              nop
preface           nop
book              toc,title,table,figure,example,equation
chapter           toc,title,table,figure   
</xsl:param>
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