Verwenden von XInclude

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

Um einzelne Dateien eines DocBook-Dokuments mit Hilfe von XIncludes einzufügen, fügen Sie an der entsprechenden Stelle das Element xi:include ein. Das folgende Beispiel zeigt den Aufbau einer Verbunddatei und die Referenzierung auf ein Kapitel.

Beispiel: Einzufügendes Kapitel: Datei docbook-intro.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Die einzufügende Datei darf eine DOCTYPE-Deklaration besitzen: -->
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.docbook.org/xml/4.5/docbookx.dtd">
<chapter id="docbook-intro">
  <title>Einführung in DocBook</title>
  ...
</chapter>

Beispiel: Verbunddatei als Buch: Datei book.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.docbook.org/xml/4.5/docbookx.dtd">
<book>
 <title>DocBook-XML</title>
 <para>...</para>
 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="docbook-intro.xml" />
  ... 
</book>

Zeile 6: Namensraumdeklaration (mit Namensraumpräfix xi) für XInclude. Der URI "http://www.w3.org/2001/XInclude" muss genau diese Schreibweise besitzen, damit der Ersetzungsmechanismus funktioniert (achten Sie auf Groß- und Kleinschreibung!). Das xi:include-Element benötigt das Attribut href, das einen URI enthält, der auf die Datei docbook-intro.xml zeigt.

In diesem Beispiel versucht der XML-Parser, die Datei docbook-intro.xml einzulesen. Ist dies erfolgreich, wird das include-Element durch den Inhalt von docbook-intro.xml ersetzt. Schlägt dies fehl, gibt der Parser eine Meldung aus.

  

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