XIncludes in DocBook 4.x aufnehmen

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

Diesen Abschnitt benötigen Sie nur, wenn Sie beabsichtigen, ein DocBook 4-Dokument mit XIncludes zu validieren, jedoch ohne die XInclude-Elemente durch Ihre referenzierte Ressource aufzulösen.

Version 4.x der DocBook-DTD kennt keine XIncludes. Daher kann Ihr XML-Editor diese Elemente auch nicht anbieten, wenn Sie ein DocBook-Dokument schreiben. Glücklicherweise kann mit relativ wenig Aufwand diese an bestimmten Stellen erlaubt werden. Gehen Sie wie folgt vor:

  1. Erstellen Sie zunächst die Datei xinclude.mod mit folgendem Inhalt:
<!ENTITY % xmlnsxi 'xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude"'> 
<!ELEMENT xi:include (xi:fallback?) > 
<!ATTLIST xi:include 
     %xmlnsxi; 
     href CDATA #IMPLIED 
     parse (text|xml) "xml" 
     xpointer CDATA #IMPLIED 
     encoding CDATA #IMPLIED 
     accept CDATA #IMPLIED 
     accept-charset CDATA #IMPLIED 
     accept-language CDATA #IMPLIED 
     > 
<!ELEMENT xi:fallback ANY > 
<!ATTLIST xi:fallback %xmlnsxi; >
  1. Ergänzen Sie Ihre Datei, für die Sie XInclude-Elemente erlauben wollen, um folgenden Code:
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.docbook.org/xml/4.5/docbookx.dtd" 
[ 
 <!ENTITY % xinclude SYSTEM "xinclude.mod"> 
 %xinclude; 

 <!ENTITY % local.chapter.class "| xi:include"> 
 <!ENTITY % local.section.class "| xi:include"> 
 <!ENTITY % local.info.class "| xi:include"> 
 <!-- Folgende Zeile nur für DocBook 4.2 und früher auskommentieren --> 
 <!-- <!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED"> --> 
]> 
<book>...</book>
  1. Entfernen Sie den Kommentar in der Entity-Deklaration %local.common.attrib; im vorigen Schritt, wenn Sie DocBook 4.2 oder früher verwenden.
  2. Fügen Sie die Änderung aus Schritt 2 in jede Ihrer Dateien ein, in der Sie XInclude-Elemente verwenden wollen.

Der Vorteil dieser Änderungen besteht darin, dass Sie eine XML-Datei validieren können, ohne dass Sie XInclude-Elemente auflösen müssen.

  

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