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

[Jakub Wilk]

severity 611233 wishlist
retitle 611233 python-docutils: please provide reStructuredText -> DocBook XML converter
thanks

* 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.

I retitled the bug report and changed its severity accordingly, but to 
be honest, it's unlikely it will be fixed any time soon.

The question about rST->DocBook conversion has been asked on the 
Docutils mailing list at least once[0]. Also, at least according to its 
package description, pandoc[1] is able to do the necessary conversion.

[0] http://sourceforge.net/mailarchive/forum.php?thread_name=87bqd24osa.wl%25lele%40nautilus.homeip.net&forum_name=docutils-develop
[1] http://packages.debian.org/sid/pandoc

-- 
Jakub Wilk