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