On 21 February 2010 12:01, Georg Brandl <[email protected]> wrote:
> BTW, since you wrote about literate programming with reST, there's a
> tool specifically written for that: http://pylit.berlios.de/
Thanks for the suggestion. In fact I had noticed PyLit before;
however, its author recognizes that
* "PyLit is not a complete LP system but a simple tool. It does not
support re-arranging of named code chunks."
* "[PyLit] does not provide code re-ordering or multiple expansion of
definitions. Some call this semi-literate programming."
I wanted to combine the power of noweb --that allows arbitrary
rearrangement of named code chunks-- with Sphinx's ability to generate
nicely formatted and easily navigable docs. And this is a sample of
what I've done:
http://inmabb.criba.edu.ar/varios/noweb-sphinx/wc.html
There's still some work to do, but the result looks promising. I'll
keep posting on this subject, and probably ask for some help too :-)
BTW, I've already solved the file splitting issue, in a way that is
satisfactory at least in the context of my project.
Regards,
Fernando
--
Fernando Gómez
Biblioteca "Antonio Monteiro"
INMABB (Conicet / Universidad Nacional del Sur)
Av. Alem 1253
B8000CPB Bahía Blanca, Argentina
Tel. +54 (291) 459 5116
http://inmabb.criba.edu.ar/
--
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en.
