"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.... " - Yarko Why of course I can create reST docs in VI if I wanted to, so long as I memorized the markup. But I think the last 6-7 comments on the thread prove my point -- reST utilization won't progress until such time as I can edit a document in an editor and not worry that it IS reST format. JohnMc On Jul 19, 10:13 pm, Yarko Tymciurak <yark...@gmail.com> wrote: > On Sun, Jul 19, 2009 at 7:49 PM, Tim Michelsen > <timmichel...@gmx-topmail.de>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/he...<http://bazaar.launchpad.net/%7Etimmie/web2py/web2py-appdocu/annotate/...> > > 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 ofhttp://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 web2py@googlegroups.com To unsubscribe from this group, send email to web2py+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/web2py?hl=en -~----------~----~----~----~------~----~------~--~---
