From: Nicolas G. <nic...@ne...> - 2005-05-06 11:18:29
|
Hi all, is there a way of doing such things using the docutils API ? - create a new docutils document d - add a new section to d, with title "First section" and with contents "Simple text" - specify '=' is for sections, '-' is for subsections, and so on - write d into a file called 'test.txt' Many thanks in advance, cheers, nicolas |
From: David G. <go...@py...> - 2005-05-07 20:42:42
Attachments:
signature.asc
|
[Nicolas Girard] > is there a way of doing such things using the docutils API ? Not currently, no. It would require a "reStructuredText Writer", which does not yet exist. -- David Goodger <http://python.net/~goodger> |
From: Nicolas G. <nic...@ne...> - 2005-05-07 21:03:26
|
On Saturday 07 May 2005 22:42, David Goodger wrote: > [Nicolas Girard] > > > is there a way of doing such things using the docutils API ? > > Not currently, no. It would require a "reStructuredText Writer", > which does not yet exist. > (sigh...) Thanks for your answer ! Do you have any thoughts on how to make such reST writer ? (structure ; tools/patterns/existing code to use, ...) Nicolas |
From: Felix W. <Fel...@gm...> - 2005-05-14 03:08:38
|
David Goodger wrote: > Nicolas Girard wrote: > >> Do you have any thoughts on how to make such reST writer ? >> (structure ; tools/patterns/existing code to use, ...) > > The existing writers are based on the Visitor pattern, with support > from the docutils.nodes module. I wouldn't write a reST writer using a Visitor, since reST does not give a serial representation of a document, like HTML, LaTeX or DocBook does. You have to be able to deal with blocks of text. The implementation will probably have some recursivity, and the functions for block-level elements will need to return text blocks. So before starting to implement a reST writer, check if your design will (at least theoretically) be able to write grid tables. If it can't do that, you'd probably end up hacking around a lot of problems. -- For private mail please ensure that the header contains 'Felix Wiemann'. http://www.ososo.de/ |
From: David G. <go...@py...> - 2005-05-07 22:21:45
Attachments:
signature.asc
|
[Nicolas Girard] > Do you have any thoughts on how to make such reST writer ? > (structure ; tools/patterns/existing code to use, ...) The existing writers are based on the Visitor pattern, with support from the docutils.nodes module. Take a look at the docutils.writers.html4css1 module for an example. -- David Goodger <http://python.net/~goodger> |
From: Felix W. <Fel...@gm...> - 2005-05-14 03:01:43
|
Nicolas Girard wrote: > - create a new docutils document d > - add a new section to d, with title "First section" and with contents > "Simple text" I noticed that the current nodes interface isn't particularly helpful in this regard (probably since it has been written with parsers in mind, rather than custom node tree creators): * The document.__init__ needs a settings and reporter parameter -- what is that, and where do I get it, one might ask; it isn't even described in the docstring. For convenience these parameters shouldn't be required, i.e. the document node should be able to create settings and reporter objects itself. * Most nodes want a rawsource argument as first parameter, which is useless if you're generating your own node tree from Python source. (I don't see any easy way to change that, though.) Comments? -- For private mail please ensure that the header contains 'Felix Wiemann'. http://www.ososo.de/ |
From: Felix W. <Fel...@gm...> - 2005-05-21 00:41:55
|
Felix Wiemann wrote: > * The document.__init__ needs a settings and reporter parameter [...]. > For convenience these parameters shouldn't be required, i.e. the > document node should be able to create settings and reporter objects > itself. OK, found utils.new_document(). We really need an introductory document about Docutils development... -- For private mail please ensure that the header contains 'Felix Wiemann'. http://www.ososo.de/ |