DocBook-Module

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

Die DocBook-DTD teilt sich in fünf Hauptmodule auf, die von der Datei docbookx.dtd nacheinander eingelesen werden (siehe folgende Darstellung).

docbookx.dtd
|
+-- dbnotnx.mod <-- ISO-Entities
|
+-- dbcentx.mod
|
+-- dbpoolx.mod <-- calstblx.dtd, soextblx.dtd, htmltblx.mod
|
+-- dbhierx.mod
|
+-- dbgenent.mod

Darstellung: Reihenfolge der DocBook-Module der Version 4.5

Die folgende Liste beschreibt die Bedeutung. Sie benötigen Sie nur, wenn Sie eines der Module in Ihrer Anpassungsdatei komplett ersetzen möchten. Dies ist jedoch selten der Fall.

docbookx.dtd -//OASIS//DTD DocBook XML V4.5//EN

Hauptdatei, auf die normalerweise verwiesen wird (in Systembezeichnern und Katalog-Dateien); sie referenziert die anderen Module der ersten Ebene.

Eine eigene Anpassungsdatei muss diese Datei einbinden.

dbnotx.mod -//OASIS//ENTITIES DocBook Notations V4.5//EN

enthält Notations-Entities; dieses Modul deklariert Notationen, welche in DocBook verwendet werden.

dbcentx.mod -//OASIS//ENTITIES DocBook Character Entities V4.5//EN

deklariert und referenziert die ISO-Entities.

dbpoolx.mod -//OASIS//ELEMENTS DocBook XML Information Pool V4.5//EN

enthält alle Definitionen für Inline-Elemente, die den Hauptinhalt von DocBook ausmachen; zusätzlich wird ein Tabellenmodell ausgewählt.

dbhierx.mod-//OASIS//ELEMENTS DocBook Document Hierarchy V4.5//EN

deklariert Elemente, welche die hierarchische Struktur von DocBook bestimmen, wie Bücher, Kapitel, Referenzseiten usw.

dbgenent.mod-//OASIS//ENTITIES DocBook Additional General Entities V4.5//EN

für allgemeine Entities, allgemeingültige Texte, Verweise auf Bilder oder zusätzliche Notationen; standardmäßig ist diese Datei leer.

Jedes der obigen Module (außer docbookx.dtd) wird wie folgt geladen:

<!ENTITY % NAME.module "INCLUDE">
<![ %NAME.module; [
  <!ENTITY % NAME PUBLIC
     "PUBLIC"
     "MOD"> 
  %NAME;
]]>

Zeile 1: Der Name des Moduls, abgeleitet aus dem Dateinamen ohne die Endung .mod.
Zeile 4: Der Platzhalter PUBLIC beschreibt einen öffentlichen Bezeichner aus der obigen Liste.
Zeile 5: Der Dateiname des entsprechenden Moduls.

Soll eines der Module ersetzt werden, definieren Sie in Ihrer Anpassungsdatei das Parameter-Entity %NAME.module; mit IGNORE. Im folgenden Beispiel wird das Modul dbgenent durch eine andere Datei ersetzt:

<!ENTITY % dbgenent.module "IGNORE"> 
<!ENTITY % dbgenent SYSTEM "my-dbgenent.mod"> 
<!-- DocBook-DTD hier laden, siehe "Schreiben einer Anpassungsdatei für DocBook 4" -->

Legen Sie die Datei my-dbgenent.mod in dasselbe Verzeichnis wie Ihre Anpassungsdatei.

Tabellenmodelle von DocBook

In der Datei dbpoolx.mod werden die Tabellenmodelle hinzugeladen. Folgende Module sind in DocBook verfügbar:

calstblx.dtd-//USA-DOD//DTD Table Model 951010//EN

enthält die Definitionen für das CALS-Tabellenmodell in XML; weitere Einzelheiten können Sie in Tabellen erfahren. Standardmäßig ist das CALS-Tabellenmodell gewählt.

soextblx.dtd-//OASIS//DTD XML Exchange Table Model 19990315//EN

vereinfachtes Tabellenmodell. Es lässt sich mit folgenden Deklarationen einschalten:

<!ENTITY % exchange.table.module "INCLUDE">
<!ENTITY % cals.table.module "IGNORE">
htmltblx.mod -//OASIS//ELEMENTS DocBook XML HTML Tables V4.5//EN

enthält das Tabellenmodell von HTML. Dieses Modell ist erst ab Version 4.3 in DocBook standardmäßig verfügbar. Benötigen Sie keine HTML-Tabellen, schalten Sie diese wie folgt aus:

<!ENTITY % allow.html.tables "IGNORE">

ISO-Entities

Der Codepunkt eines Unicode-Zeichens lässt sich schwer merken. Darum erhalten Unicode-Zeichen Namen, die sich besser handhaben lassen.

Die so genannten ISO-Entities sind Dateien (iso*.ent), die vom ISO-Komitee zusammengestellt und vom DocBook-Komitee an XML angepasst wurden. Sie werden in der Datei dbcentx.mod referenziert. Eine Auflistung der Zeichen finden Sie unter DocBook Character Entity Reference.

Die Namen sind in verschiedene Kategorien eingeordnet. Jede Kategorie befindet sich in einer eigenen Datei, wie iso-cyr1.ent, iso-grk1.ent oder iso-lat1.ent. So sind Zeichen einfacher zu finden, die für Dokumente in kyrillischer, griechischer oder lateinischer Schrift gebraucht werden.

Standardmäßig werden von DocBook 4 alle Entities geladen. Sollten Sie bestimmte Symbole nie benötigen, verkürzen Sie die Ladezeit, indem Sie dem Parameter-Entity ISOKategorie.module den Wert IGNORE zuweisen. (vgl. sie den Platzhalter Kategorie mit der folgenden Tabelle). Beispielsweise deaktiviert die folgende Zeile alle kyrillischen Zeichen:

<!ENTITY % ISOcyr1.module "IGNORE">

Tabelle: Kategorien von ISO-Entities

Kategorie Beschreibung
amsa Mathematische Symbole: Pfeilrelationen
ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN//XML
amsb Mathematische Symbole: Binäre Operatoren
ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN//XML
amsc Mathematische Symbole: Begrenzungszeichen
ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN//XML
amsn Mathematische Symbole: Symbole für negierte Relationen
ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN//XML
amso Mathematische Symbole: gewöhnliche Symbole
ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN//XML
amsr Mathematische Symbole: Relationen
ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN//XML
box Zeichen für Rechtecke und Linien
ISO 8879:1986//ENTITIES Box and Line Drawing//EN//XML
cyr1 Russisch kyrillische Zeichen
ISO 8879:1986//ENTITIES Russian Cyrillic//EN//XML
cyr2 Nicht-russisch kyrillische Zeichen
ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN//XML
dia Diakritische Zeichen
ISO 8879:1986//ENTITIES Diacritical Marks//EN//XML
grk1 Griechische Zeichen
ISO 8879:1986//ENTITIES Greek Letters//EN//XML
grk2 Monotonisch-griechische Zeichen
ISO 8879:1986//ENTITIES Monotoniko Greek//EN//XML
grk3 Griechische Symbolzeichen
ISO 8879:1986//ENTITIES Greek Symbols//EN//XML
grk4 Alternative griechische Symbole
ISO 8879:1986//ENTITIES Alternative Greek Symbols//EN//XML
lat1 ISO Latin 1
ISO 8879:1986//ENTITIES Added Latin 1//EN//XML
lat2 ISO Latin 2
ISO 8879:1986//ENTITIES Added Latin 2//EN//XML
isonum Nummerische und spezielle Zeichen (wie Brüche, typografische Anführungszeichen usw.)
ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML
pub Typografische Zeichen (wie verschieden weite Leerzeichen und Bindestriche, Ligaturen usw.)
ISO 8879:1986//ENTITIES Publishing//EN//XML
tech Allgemeine technische Zeichen
ISO 8879:1986//ENTITIES General Technical//EN//XML

  

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