Ein erstes Beispiel

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

Im Beispiel "Aufbau eines XML-Katalogs" haben Sie bereits die Struktur eines XML-Kataloges gesehen. Zwischen <catalog> und </catalog> sind verschiedene XML-Elemente erlaubt, die in folgender Tabelle aufgelistet werden. Fettgedruckte Attribute sind anzugeben, normalgeschriebene sind optional. Jedes der gezeigten Elemente erlaubt zusätzlich die optionalen Attribute id und xml:base. Ersteres dient zum Identifizieren des Elements, letzterer verändert den Basis-URI (ähnlich dem BASE-Element von HTML).

Tabelle: Erlaubte Einträge in XML-Katalogen (Version 1.0)

Element Beschreibung/Syntax
delegatePublic

identifiziert einen Teil eines öffentlichen Bezeichners und delegiert den Ersetzungsprozess an einen anderen XML-Katalog

<delegatePublic publicIdStartString ="PUBLIC_IDENTIFIER_PRÄFIXcatalog="URI"/>

delegateSystem

identifiziert einen Teil eines Systembezeichners und delegiert den Ersetzungsprozess an einen anderen XML-Katalog

<delegateSystem systemIdStartString="STRINGcatalog="URI"/>

delegateURI

identifiziert einen Teil eines URIs und delegiert den Ersetzungsprozess an einen anderen XML-Katalog

<delegateURI uriIdStartString="STRINGcatalog="URI"/>

group

gruppiert Einträge und spezifiziert einen Basis-URI

<group prefer="public|system" > ... </group>

nextCatalog

lädt einen weiteren Katalog

<nextCatalog catalog="URI"/>

public

identifiziert einen kompletten öffentlichen Bezeichner

<public publicId="PUBLIC_IDENTIFIERuri="URI"/>

rewriteSystem

identifiziert einen Teil eines Systembezeichners und ersetzt ihn durch eine URI-Referenz

<rewriteSystem systemIdStartString="STRINGrewritePrefix="URI"/>

rewriteURI

identifiziert einen Teil eines URIs und ersetzt ihn durch eine URI-Referenz

<rewriteURI uriIdStartString="STRINGrewritePrefix="URI"/>

system

identifiziert einen kompletten Systembezeichner

<system systemId="STRINGuri="URI"/>

uri

verknüpft einen URI mit einem alternativen URI

<uri name="STRINGuri="URI"/>

Anmerkung: Unterschied zwischen Version 1.0 und 1.1
Die Version 1.1 der XML-Katalogspezifikation hat zwei neue Elemente, systemSuffix und uriSuffix. Bevor Sie diese in Ihrem Katalog verwenden, überprüfen Sie, welche Version der Spezifikation Ihr XML-Parser unterstützt.

Das folgende Beispiel zeigt zwei der gebräuchlichsten, <public/> und <system/>:

Beispiel: testCatalog.xml

<?xml version="1.0"?>
<!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
  <public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="file:///usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd" />
  <system systemId="http://www.beispiel.de/dtd/v2.3.4/bsp.dtd" uri="file:///usr/share/firms/beispiel/dtd/v2.3.4/bsp.dtd" /> 
  <nextCatalog catalog="file:///usr/local/doc/xsldbg/catalog.xml"/>
</catalog> 

Der obige Katalog hat folgende Eigenschaften:

  1. Das public-Element bildet den öffentlichen Bezeichner -//OASIS//DTD DocBook XML V4.5//EN auf den Pfad file:///usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd ab. Sobald dieser öffentliche Bezeichner angefordert wird, liefert der Katalog-Resolver den URI aus dem Attribut uri zurück.
  2. Das system-Element bildet die URL "http://www.beispiel.de/dtd/v2.3.4/bsp.dtd" auf den Pfad file:///usr/share/firms/beispiel/dtd/v2.3.4/bsp.dtd ab.
  3. Weitere Einträge werden über nextCatalog eingelesen. Dieses Element erlaubt Ihre Einträge thematisch zu gliedern.

Anmerkung: Notation unter Windows
Schreiben Sie die Pfade unter Windows mit einem Schrägstrich (/) anstatt einem umgekehrten Schrägstrich (\). Das bedeutet, aus dem Pfad C:\Programme\DocBook wird C:/Programme/DocBook in der Katalogdatei.

  

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