[Python-modules-team] Bug#611233: rst2xml can not create valid DocBook XML-code for Publican

[Juhapekka Tolvanen]

On Thu, 27 Jan 2011, +15:54:40 EET (UTC +0200),
Jakub Wilk <jwilk at debian.org> pressed some keys:

> * Juhapekka Tolvanen <juhtolv at iki.fi>, 2011-01-27, 04:13:
> >Please check out files in this WWW-directory:
> >
> >http://iki.fi/juhtolv/tmp/bugreports/python-docutils/01/harjoitukset/
> >
> >When I run that script called compileall.sh almost everything
> >works like a charm. Even Tidy thinks XML-code that rst2xml created
> >is valid.  But when Publican tries to validate (let alone convert)
> >that XML-code, it gives umpteen gazillion errors. They all can be
> >seen in that file publican_errors.txt .

> Thanks for your bug report. I'm afraid that errors you are seeing
> are expected: rst2xml doesn't produce DocBook XML documents (and it
> was never intended to do so!), which is the format Publican expects.

Why on earth they waste their time coding and maintaining some
utility, that outputs XML-code written in neverheard-DTD? And that
tool called rst2pseudoxml must be even more ridiculous waste of time.
What good is it?

Almost everybody who knows at least something about XML have heard
about a DTD called Docbook and therefore probably starts using it.
Docbook is probably the most used XML-DTD in the world. Are those
developers of python-docutils living inside a bottle or barrel?

Meanwhile I use pandoc, but it would be nice, if python-docutils
included some tool for converting RST to Docbook-XML.


-- 
Juhapekka "naula" Tolvanen * http colon slash slash iki dot fi slash juhtolv
"Quidquid Latine dictum sit altum videtur."