Erlaubte Wurzelelemente korrigieren

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

Es ist in der DocBook 4-DTD nicht möglich, die erlaubten Wurzelelemente einzuschränken. Jedoch unterstützt DocBook 5 durch RELAX NG diese Funktionalität. Es gibt in DocBook 5 verschiedene Elemente, die Sie als Wurzelelement benutzen dürfen. Falls Sie die Auswahlmöglichkeiten einschränken möchten, verwenden Sie folgende Anpassungsdatei:

Beispiel: Einschränken der verfügbaren Wurzelelemente

<?xml version="1.0" encoding="UTF-8"?>
<grammar xmlns="http://relaxng.org/ns/structure/1.0">
    <include href="docbook.rng">
        <start>
            <choice>
                <ref name="db.article"/>
                <ref name="db.book"/>
                <ref name="db.section"/>
                <ref name="db.refentry"/>
            </choice>
        </start>        
    </include>
</grammar>
include "docbook.rnc"
{
  start = (db.article | db.book | db.section | db.refentry )
}

Das vorige Beispiel erlaubt als Wurzelelement nur article, book, section oder refentry.

Möchten Sie dagegen nur die Auswahl erweitern, benötigen Sie eine geringfügig andere Schreibweise. Beispielsweise soll das Element exercise zusätzlich als ein Wurzelelement erlaubt sein:

Beispiel: Erweitern der erlaubten Wurzelelemente

<grammar xmlns="http://relaxng.org/ns/structure/1.0">
    <include href="docbook.rng">
        <start combine="choice">
            <ref name="db.exercise"/>
        </start>
    </include>
    <!-- Definition von db.exercise -->
</grammar>
include "docbook.rnc"
{
  start |= db.exercise
}
# Definition von db.exercise
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