Abfangen von Fehlern
(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)
Wird beim Laden einer Ressource ein Fehler erzeugt, fängt fallback den Fehler ab. Sie dürfen innerhalb von fallback alles einfügen, was an der Stelle von include ebenso erlaubt wäre. Das sind entweder Elemente oder Text.
Wird das Beispiel "Verbunddatei als Buch: Datei book.xml" durch das Element fallback ergänzt, wird daraus:
Beispiel: Abfangen von Fehlern mit xi:fallback
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="docbook-intro.xml">
<xi:fallback>
<para>
<emphasis>Datei docbook-intro.xml nicht gefunden!</emphasis>
</para>
</xi:fallback>
</xi:include>Wird docbook-intro.xml nicht gefunden, wird an der Stelle ein Absatz eingefügt, und die Datei sieht dann nach der XInclude-Auflösung so aus:
<para>
<emphasis>Datei docbook-intro.xml nicht gefunden!</emphasis>
</para>Beachten Sie, dass Sie nach der Auflösung ein valides Dokument besitzen müssen. An der Stelle von xi:include ist ein para-Element erlaubt, jedoch kein emphasis-Element. Daher führt folgendes xi:include-Element zu einem ungültigen Dokument:
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="docbook-intro.xml">
<xi:fallback>
<emphasis>Datei docbook-intro.xml nicht gefunden!</emphasis>
</xi:fallback>
</xi:include>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