Ticket #855 (new enhancement)

Opened 4 years ago

Last modified 2 months ago

Use RelaxNG instead of DTDs for DocBook validation

Reported by: matthew@linuxfromscratch.org Assigned to: lfs-book@linuxfromscratch.org
Priority: lowest Milestone: Future
Component: Book Version: SVN
Severity: normal Keywords:
Cc:

Description (Last modified by jhuntwork@linuxfromscratch.org)

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.

Change History

08/26/04 15:12:10 changed by matthew@linuxfromscratch.org

  • version changed from CVS to SVN.

02/04/06 12:48:57 changed by jhuntwork@linuxfromscratch.org

  • description changed.

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

02/05/06 02:01:20 changed by matthew@linuxfromscratch.org

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

02/05/06 17:59:02 changed by jhuntwork@linuxfromscratch.org

  • milestone set to Future.

07/08/06 12:29:39 changed by matthew@linuxfromscratch.org

  • owner changed from matthew@linuxfromscratch.org to lfs-book@linuxfromscratch.org.

07/10/06 13:44:26 changed by manuel@linuxfromscratch.org

  • type changed from defect to enhancement.

01/26/07 14:02:16 changed by matthew@linuxfromscratch.org

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

03/18/07 13:57:07 changed by matthew@linuxfromscratch.org

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;

02/08/08 09:23:45 changed by matthew@linuxfromscratch.org

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.

10/05/08 13:21:22 changed by matthew.2.burgess@bt.com

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