Use RelaxNG instead of DTDs for DocBook validation

[Matthew Burgess]

Details on how to do this are in the thread referenced above. This is simply here as a reminder to actually do this, although it's dependent on the release of DocBook-5.0.

[Jeremy Huntwork]

Testing Trac configuration. Also, are we still looking into using RelaxNG?

[Matthew Burgess]

Yes, DocBook-5.0, i.e. the RNG version, just hit beta 3.

[Matthew Burgess]

Although Docbook-5.0 hasn't been officially released yet, Candidate Release 1 (CR1) is out, and a version of the Docbook Stylesheets has also been released - announcement at ​http://sourceforge.net/forum/forum.php?forum_id=657704

[Matthew Burgess]

In configuring a build environment for a DocBook-5.0 version of the book, we need to have a local copy of the files that define entities such as – and Æ (​http://www.docbook.org/docs/howto/#faq-authoring-general-entities has details). These entity files are currently installed under /usr/share/xml/docbook/xml-dtd-4.5. Maybe we should install the Docbook-RNG schema and the required entity files under /usr/share/xml/docbook/xml-rng-5.0? (at the moment, I've been using a copy of docbook.rng in my local working copy). The following appears to work fine for the entity files.

xmlcatalog --noout --add "delegatePublic" \
  "ISO 8879:1986//ENTITIES Publishing//EN//XML" \
  "file:///etc/xml/docbook" \
  /etc/xml/catalog;

xmlcatalog --noout --add "delegateSystem" \
  "http://www.w3.org/2003/entities/iso8879/isopub.ent" \
  "file:///etc/xml/docbook" \
  /etc/xml/catalog;

xmlcatalog --noout --add "delegateURI" \
  "http://www.w3.org/2003/entities/iso8879/isopub.ent" \
  "file:///etc/xml/docbook" \
  /etc/xml/catalog;

xmlcatalog --noout --add "delegatePublic" \
  "ISO 8879:1986//ENTITIES Added Latin 1//EN//XML" \
  "file:///etc/xml/docbook" \
  /etc/xml/catalog;

xmlcatalog --noout --add "delegateSystem" \
  "http://www.w3.org/2003/entities/iso8879/isolat1.ent" \
  "file:///etc/xml/docbook" \
  /etc/xml/catalog;

xmlcatalog --noout --add "delegateURI" \
  "http://www.w3.org/2003/entities/iso8879/isolat1.ent" \
  "file:///etc/xml/docbook" \
  /etc/xml/catalog;

xmlcatalog --noout --add "public" \
    "ISO 8879:1986//ENTITIES Publishing//EN//XML" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/ent/isopub.ent" \
    /etc/xml/docbook;

xmlcatalog --noout --add "rewriteSystem" \
    "http://www.w3.org/2003/entities/iso8879/isopub.ent" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/ent/isopub.ent" \
    /etc/xml/docbook;

xmlcatalog --noout --add "rewriteURI" \
    "http://www.w3.org/2003/entities/iso8879/isopub.ent" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/ent/isopub.ent" \
    /etc/xml/docbook;

xmlcatalog --noout --add "public" \
    "ISO 8879:1986//ENTITIES Added Latin 1//EN//XML" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/ent/isolat1.ent" \
    /etc/xml/docbook;

xmlcatalog --noout --add "rewriteSystem" \
    "http://www.w3.org/2003/entities/iso8879/isolat1.ent" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/ent/isolat1.ent" \
    /etc/xml/docbook;

xmlcatalog --noout --add "rewriteURI" \
    "http://www.w3.org/2003/entities/iso8879/isolat1.ent" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/ent/isolat1.ent" \
    /etc/xml/docbook;

[Matthew Burgess]

Docbook-5.0 has now been released - ​http://www.docbook.org/xml/5.0/. Still targetting at a future milestone as it'll probably take a while to get the XML processing toolchain to play nicely together.

[matthew.2.burgess@…]

Just checking a normal user can add comments to open tickets (apologies all, for the noise).

[gerard@…]

Closing this ticket. Sounds like the benefits aren't going to outweigh the effort in implementing it.