Konventionen für DocBook-Definitionsmuster

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

Das RELAX NG-Schema von DocBook 5 verwendet Definitionsmuster für jedes Element und Attribut. Diese Definitionsmuster werden wiederrum zu größeren Einheiten zusammengefasst. Je nach Anforderung lassen sich mit Hilfe von Gruppierungen kleinere oder größere Einheiten anpassen.

Alle Muster besitzen zwei oder mehr Teile und werden mit einem Punkt (.) voneinander getrennt. Der erste Teil beginnt immer mit dem Präfix db., nachfolgende Teile sind kontextabhängig. Die folgenden Muster sind die Namenskonventionen, die DocBook 5 verwendet; kleinere Abweichungen sind möglich. Großgeschriebene Namen sind Platzhalter, die Sie ersetzen müssen, um den Namen des eigentlichen Musters zu erhalten:

Tabelle: Namenskonventionen für DocBook& 5

Muster Beschreibung
Attributlistenmuster db.ELEMENTNAME.attlist

Enthält eine Liste aller Attribute eines Elements. Enthält ein Element andere Eigenschaften in einem anderen Zusammenhang, kann noch ein optionaler Kontext angegeben werden.

Liste von Attributen für einen Titel:
db.title.attlist
Liste von Attributen für obligatorischen Titel in einem info:
db.titlereq.info.attlist

Attributmuster db.[KONTEXT.]ATTRIBUTNAME.attribute

Definiert ein einzelnes Attribut. Enthält ein Attribut andere Eigenschaften in einem anderen Zusammenhang, kann noch ein optionaler Kontext angegeben werden.

arch Attribut:
db.arch.attribute
Identifiziert ein xlink:href Attribut:
db.xlink.href.attribute

Attributmengenmuster db.NAME.attributes

Enthält eine Ansammlung von Attributen oder Attributlisten unter einem gemeinsamen Namen, wie db.common.attributes.

Enthält os, arch, ...:
db.effectivity.attributes
Enthält linkend oder href:
db.common.linking.attributes

Block-Elementmuster db.NAME.blocks

Enthält eine Liste verschiedener Muster von Block-Elementen, die zwischen Absätzen erscheinen dürfen (vergleiche Block-Elemente):

Enthält db.list.blocks, db.admonition.blocks usw.:
db.nopara.blocks

Komponentenmuster db.NAME.components

Enthält eine Gruppe verschiedener Muster für alle Komponenten einer höheren Ebene wie Kapitel, Anhang, Artikel (vergleiche Strukturelemente):

Enthält db.dedication, db.preface usw.:
db.components

Enthält db.navigation.components, db.components usw.:
db.part.components

Inhaltsmodellmuster db.NAME.contentmodel

Enthält ein Teil eines Inhaltsmodells, die von anderen Elemente gemeinsam genutzt werden.

Inhaltsmodell eines indexterm:
db.indexterm.contentmodel

Gemeinsames Inhaltsmodell von tip, warning, caution und note:
db.admonition.contentmodel

Aufzählungsmuster db.[KONTEXT.]ATTRIBUTNAME.enumeration

Enthält eine Auflistung, normalerweise nur für Attribute. Ein Attribut kann nur bestimmte Werte zulassen, die durch dieses Muster festgelegt werden. Enthält eine Attributliste andere Eigenschaften in einem anderen Zusammenhang, kann noch ein optionaler Kontext angegeben werden.

Aufzählungen für das halign Attribut:
db.halign.enumeration
Aufzählungen im Attribut renderas des Elements bridgehead:
db.bridgehead.renderas.enumeration

Inline-Elementmuster db.NAME.inlines

Enthält eine Auswahl verschiedener Muster von Inline-Elementen, die innerhalb eines Absatzes erscheinen dürfen (vergleiche Inline-Elemente):

Enthält db.technical.inlines, db.error.inlines, db.os.inlines usw.:
db.domain.inlines
Enthält db.guiicon, db.guibutton, db.guimenu usw.:
db.gui.inlines

Elementmuster db.[KONTEXT.]ELEMENTNAME

Enthält das Muster für ein bestimmtes Element. Besitzt ein Element andere Eigenschaften in einem anderen Zusammenhang, kann noch ein optionaler Kontext angegeben werden.

Inhaltsmodell eines Buches:
db.book
Inhaltsmodell von info im Kontext eines Buches:
db.book.info

  

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