DocBook 5-Anpassungen benennen

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

DocBook 4 braucht eine DOCTYPE-Deklaration, um die verschiedenen DocBook-Versionen auseinanderzuhalten. Ein Dokument in DocBook 5 verwendet für diesen Zweck das Attribut version, eine DOCTYPE-Deklaration ist überflüssig. DocBook 5 erwartet in einem Wurzelelement immer dieses Attribut:

Wenn Sie das DocBook-Schema anpassen, müssen Sie das Attribut version in Ihrem Dokument so ändern, um es von der offiziellen, unveränderten Version zu unterscheiden. Hierfür empfiehlt DocBook V5.0 The Transition Guide die folgende Konvention:

Beispiel: Namenskonvention zur Version einer Anpassungsdatei

Folgende Platzhalter passen Sie an Ihre Eigenschaften an:

• DBVERSION: Die Basisversion von DocBook, die Sie für Ihre Anpassung gewählt haben.
• NAME: Der Name Ihrer Anpassung. Kann mehrmals angegeben werden, wenn Sie zusätzliche Module kenntlich machen möchten.
• VERSION: Optionale Version zum vorigen Namen.

Einige gültige Beispiele lauten:

• Elemente oder Attribute wurden entfernt:

  5.0-subset DocBookSimplified-1.0

• Neue Elemente wurden aufgenommen:

  5.0-extension TMSBook-1.0

• Wie voriges Beispiel, jedoch zusätzlich mitMathML und SVG:

  5.0-extension TMSBook-1.0 MathML-2.0 SVG-1.1

• Elemente gelöscht, neue hinzugefügt, inklusive SVG

  5.0-variant TMSBook-1.0 SVG-1.1