Entfernen von Abschnittselementen

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

Ein häufiger Wunsch ist das Limitieren von Abschnittselementen, das heißt, dass Autoren beispielsweise nur bis zu einer Tiefe von sect4 verschachteln dürften.

DocBook 4 anpassen

Gehen Sie für DocBook 4 wie folgt vor:

Prozedur: Limitierung der Abschnittselemente auf sect4 für DocBook 4

  1. Deaktivieren von %sect4.module; und %sect5.module;
    Fügen Sie in Ihre Anpassungsdatei folgende Zeilen ein:
<!ENTITY % sect4.element "IGNORE"> 
<!ENTITY % sect5.module "IGNORE">

Diese beiden Zeilen benötigen Sie, um einerseits das gewünschte sect5 "auszuschalten" und andererseits sect4 ohne ein sect5 neu zu definieren.

  1. Laden der DocBook-DTD
    Fügen Sie folgende Zeilen in Ihre Anpassungsdatei, um die DocBook-DTD zu laden:
<!ENTITY % DocBookDTD PUBLIC 
   "-//OASIS//DTD DocBook XML V4.5//EN" 
   "http://www.docbook.org/xml/4.5/docbookx.dtd"> 
%DocBookDTD;
  1. Umdefinieren von sect4
    Fügen Sie die folgende Zeile aus dbhierx.mod ein, lassen jedoch sect5 aus:
<!ELEMENT sect4 %ho; (sect4info?, 
     (%sect.title.content;), (%nav.class;)*, 
     (((%divcomponent.mix;)+, 
     ((%refentry.class;)* | simplesect*)) 
     | (%refentry.class;)+ | simplesect+), (%nav.class;)*)>
  1. Verwenden der Anpassungsdatei
    Verwenden Sie die Anpassungsdatei an Stelle der Originaldatei von DocBook (vgl. Validieren mit einer DocBook 4-Anpassungsdatei).

DocBook 5 anpassen

Für DocBook 5 ist das Verfahren genauso einfach wie in vorigen Abschnitten. Sie fügen ein notAllowed zu Ihrem entsprechenden Definitionsmuster wie db.sect4 und db.sect5 ein. Falls Sie weitere Anpassungen für Abschnitte benötigen, finden Sie in DocBook 5: The Definitive Guide im Abschnitt 5.4. Removing Sectioning Elements weitere Anregungen.

  

<< zurück vor >>
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