Einbinden über XIncludes

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

XML Inclusion, kurz XInclude, ist eine W3C-Spezifikation und definiert zwei Elemente (include und fallback) im Namensraum "http://www.w3.org/2001/XInclude" mit zugehörigen Attributen. Das include-Element dient als Verweis auf eine Datei und wird beim Auflösungsvorgang durch den Inhalt der Datei ersetzt. Der Inhalt darf XML oder Text sein. Misslingt der Einfügevorgang, wird ein optionales fallback-Kindelement verwendet.

Die Vorteile im Vergleich zu den externen Entities sind:

  • Alle über XInclude eingefügten Dateien können eine DOCTYPE-Deklaration besitzen und somit einzeln validiert werden. Dies muss präzisiert werden: Nur wenn Querverweis und zugehöriger ID-Wert (id bzw. xml:id) sich in derselben Datei befinden, wird eine Validierung erfolgreich sein. Befinden sich Querverweis und ID-Wert dagegen in unterschiedlichen Dateien, wird die Validierung misslingen.
  • Falls das Ersetzen des include-Elementes fehlschlägt, wird das Element fallback verarbeitet. Dieses kann weitere include- oder sogar andere Elemente enthalten. Dadurch können Sie Warnungen in Ihren Text integrieren, falls eine Datei nicht gefunden werden kann. Durch diese Methode werden Fehler leichter erkannt. Weitere Informationen inklusive Beispiel gibt es in Abfangen von Fehlern.
  • XIncludes sind Elemente, keine syntaktischen Konstrukte wie Entities. Durch XSLT oder einer beliebigen Programmiersprache lässt sich danach suchen, um beispielsweise eine Liste aller eingefügten Dateien zu erstellen. Externe Entities lassen sich mit Hilfe von XSLT nicht erkennen, da sie im Transformationsschritt bereits aufgelöst sind.
  • Brauchen Sie nur einen Teil des Dokuments, erlaubt XInclude im Attribut xpointer einen so genannten XPointer-Ausdruck anzugeben (siehe Teilweises Einfügen mit XPointer). Dadurch reduzieren Sie die einzufügende XML-Datei auf die gewünschten Objekte.
  • XInclude-Elemente lassen sich "verschachteln", das heißt, eine eingefügte Datei kann wieder XInclude-Elemente enthalten. Dies hilft Ihnen, Ihre Daten weiter zu modularisieren.

  

  

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