Michael Eager wrote:
> I downloaded the add-on for Docbook 5.  When I create a document
> with the article template for Docbook 5, I get the following:
> 
> <?xml version="1.0" encoding="UTF-8"?>
> <!DOCTYPE article [
> <!ENTITY % sgml.features "IGNORE">
> <!ENTITY % xml.features "INCLUDE">
> <!ENTITY euro "&#8364;">
> <!ENTITY % dbcent PUBLIC "-//OASIS//ENTITIES DocBook Character Entities
> V4.4//EN" "http://www.oasis-ope
> n.org/docbook/xml/4.4/dbcentx.mod">
> %dbcent;
> ]>
> <article xmlns="http://docbook.org/ns/docbook";
>          xmlns:xlink="http://www.w3.org/1999/xlink";
>          xmlns:xi="http://www.w3.org/2001/XInclude";
>          xmlns:svg="http://www.w3.org/2000/svg";
>          xmlns:mml="http://www.w3.org/1998/Math/MathML";
>          xmlns:html="http://www.w3.org/1999/xhtml";
>          xmlns:db="http://docbook.org/ns/docbook";>
>   <title></title>
> 
>   <section>
>     <title></title>
> 
>     <para></para>
>   </section>
> </article>
> 
> 
> This looks like it references the Docbook 4.4 DTD, not 5.0.
> 
> It is quite different from the headers with the Docbook 4
> template.
> 
> Am I misunderstanding something?

The above template is a Docbook 5[*] template. It does *not* reference
the Docbook 4.4 *DTD* (i.e. the grammar). It references Character
Entities specified in "4.4/dbcentx.mod".

If you are not interested by having references to Character Entities
(e.g. &nbsp;) in the saved DocBook 5 file, you can safely remove what
follows from the above article template:

---
<!DOCTYPE article [
<!ENTITY % sgml.features "IGNORE">
<!ENTITY % xml.features "INCLUDE">
<!ENTITY euro "&#8364;">
<!ENTITY % dbcent PUBLIC "-//OASIS//ENTITIES DocBook Character Entities
V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/dbcentx.mod";>
%dbcent;
]>
---



> 
> How can I create Docbook 5 documents?

File|New then choose a template in the "DocBook 5" section. Please be
careful not choose a template in the "DocBook" section. If you do this,
you have our word that you'll create a Docbook 5 document.




---
[*] DocBook 5 is based on a RELAX NG schema. There is no standard way to
associate a RELAX NG schema to a document, that's why you'll not find in
the above template a reference to "docbook.rng". However the presence of
a namespace xmlns="http://docbook.org/ns/docbook"; clearly shows that
this is not a DocBook 4 document, but a DocBook 5 one.

Reply via email to