DocBook versions in the 5.x series use a different schema than the 4.x series.
See Section 20.1, “Differences between 4.x and 5.x” for a discussion of the differences.
See Section 20.2, “Semi-automated conversion from 4.x to 5.x” for some tools that can streamline the conversion of existing documents.
If you are familiar with the conventions of DocBook 4.3, here are the parts you will have to change.
DOCTYPE declaration is much simplified
and does not include public or system identifiers. See
Section 5, “Overall section structure” for the new format.
Add these four attributes to your root
<article xmlns='http://docbook.org/ns/docbook' version='5.0' xmlns:xl='http://www.w3.org/1999/xlink' xml:lang='en'>
Also, if you use relative path names to specify images
(as discussed in Section 11.1, “Formal and informal figures”), you will
want to add an attribute of this form, where
is the base URL
of your document:
articleinfo element has
Inside the first
element, in 5.x, the
surname elements must
be wrapped in a
element, like this:
<author> <personname> <firstname>Amelia</firstname> <surname>Earhart</surname> </personname> </author>
id attribute, used
everywhere to attach unique identifiers to locations in
the text, is gone. Replace all such attributes with
xml:id attributes. This
attribute is now universal throughout the XML world.
Formerly, the first child element inside each
section element was a
title. In 5.x, the
title element must be wrapped in
info element, like this:
<section xml:id='mucking'> <info> <title>How to use a shovel</title> </info> ... </section>
ulink element is gone in
5.x. For the new ways of forming internal and external
links, see Section 8, “Links: connecting your document to itself and