On Sun, Jul 19, 2009 at 7:49 PM, Tim Michelsen <[email protected]>wrote:
> > > A directed question if I may. What tools do you use to create the rest > > doc that goes into Sphinx. > I tried to show some here: > > http://bazaar.launchpad.net/~timmie/web2py/web2py-appdocu/annotate/head%3A/doc/source/docs_contrib.rst<http://bazaar.launchpad.net/%7Etimmie/web2py/web2py-appdocu/annotate/head%3A/doc/source/docs_contrib.rst> This was Timmies patch for web2py documenting - and his proposal to follow numpy standards (a good starting point, I thought, and continue to think, but too detailed for web2py sources). I got partway thru parsing this down to what I thought would be useful essentials for web2py; I need to send this to Massimo. In the end, too many people working at once, and no coherent direction, so this confused the issue / task (too many / no chiefs; incongruent effort), and I just dropped it until this aspect cooled (anyway, other things in my life took priority at the time). I haven't tried prettytable (write python code to generate ascii table; but could be useful to dump existing data). The shell scripts for making web2py specific sphinx docs I don't think apply to your question of what tools do I use to create rest (that is, the structured format of the content). But bottom line is still - you can easily just use a normal text editor.... To get a feel for this - to convince yourself that as a edit / contributor this is "sane", just look at one of the "show source" links on any of the sphinx docs e.g. http://sphinx.pocoo.org/_sources/intro.txt of http://sphinx.pocoo.org/intro.html; other sphinx docs listed here: http://sphinx.pocoo.org/examples.html - Yarko > > you can use a simple editor that involves good syntax highlighting. Like > HTML... > > Or see the post on Lyx. > > > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web2py-users" 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/web2py?hl=en -~----------~----~----~----~------~----~------~--~---
