Re: [Docutils-develop] XML output

[Adam C. <ad...@ch...>]

On Mon, 23 Sep 2002 22:37:04 -0400 David Goodger
<go...@us...> wrote:

[...]
> > What's the best way to fix these issues? Perhaps a dedicated XML
> > writer is necessary (I hope not...)?
> 
> One already exists: docutils-xml.py.  Try it instead of quicktest.py.

For some weird reason I managed to miss that one. :-) Sorry about that...

> I just tried running it on tools/test.txt and had some trouble.  Fell
> victim to a bug in Python 2.2's StringIO.py.  Moral: upgrade to 2.2.1!
> With 2.2.1 in place, it worked without problem.

Good thing to know.
 
> I've added an encoding attribute to the XML declaration (``<?xml
> version="1.0" encoding="utf-8"?>``) and a ``<!DOCTYPE document ...``
> declaration.  

Thanks. 

> It would be easy enough to add an XSL stylesheet
> declaration as well; I'll wait for the need to arise.

AFAIK, we currently don't have any such need. We won't be serving the XML
files dynamically or such, but rather do the transformation at "build time".

[...]
> Patches are welcome, but I suspect that once you try docutils-xml.py
> you'll forget all about quicktest.py.

Yes, docutils-xml.py works much better. :-)

> > 2. The "xml:space" attribute is used incorrectly. In the output one
> >    can find "xml:space=1"; the only valid values from xml:space are
> >    "default" and "preserved".
> 
> An oversight, now fixed ("preserve", actually).  Thanks.  The snapshot
> has been updated: http://docutils.sf.net/docutils-snapshot.tgz

Great!

---
Adam Chodorowski <ad...@ch...>

BTW, I made the statistics up. I read somewhere that 60% of statistics are
made up on the spot :-)
    -- Phill Wooller