DocBook 5.1: The Definitive Guide  (Version 1.5.3 for DocBook 5.1)

Preface to the DocBook V5.1 Edition

DocBook 5: The Definitive Guide as you see it on this site tracks the most current development release of DocBook, at the moment, that's DocBook V5.1b3.

The current O'Reilly edition covers DocBook V5.0, the OASIS Standard.

If you're using DocBook V5.0, you will find some things in this online text which are new or different from the OASIS Standard release.

1. Summary of Changes in DocBook V5.1

This section summarizes the changes made since DocBook V5.0.

FIXME: This needs to be updated

The largest change is the introduction of support for topic-based authoring through the addition of the topic element and the assembly structure. For more information about assemblies, see Chapter 6, DocBook Assemblies.

DocBook V5.1 also addresses the following requests for enhancement:

The following issues are also addressed:

  • Added accessibility attributes to CALS tables.

  • Added outputformat as a common effectivity attribute.

  • Fixed bug in Schematron assertions (several conditions were reversed).

  • Improve support for multimedia. Added autoplay and classid attributes to audiodata and videodata. Added multimediaparam, allowed in audioobject and videoobject.

  • Allow link in extendedlink. See backwards incompatible changes planned for DocBook V6.0; arc and locator will be removed.

  • Changed Schematron namespace to official ISO Schematron URI.

1.1. Backwards incompatible changes planned for DocBook V6.0

The following backwards incompatible changes are planned for DocBook V6.0:

  1. The linking elements will be removed from the content model of biblioid.

  2. The common linking attributes will be removed from indexterm.

  3. The xml:id attribute will be made required on startofrange indexterms.

  4. A Schematron constraint will be added to assert that for every startofrange indexterm there is exactly one endofrange indexterm that points to it.

  5. The language attribute will be removed from address; use xml:lang instead.

  6. The arc and locator elements will be dropped; instead link will be allowed in extendedlink.

2. About the formatting…

Starting with this edition of the guide, publication is being performed by the XSLT 2.0 stylesheets. Please report any formatting errors you notice.