On Mon, Jul 20, 2009 at 3:27 PM, JohnMc <maruadventu...@gmail.com> wrote:
>
> "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.
While I understand your sentiment, I think you would need to apply this
(then) to most every wiki markup also - some have simpler syntax, some are
different, but none that I know of (save html itself) have a WYSIWYG editor.
But when it comes to creating both a searchable web doc, OR a printed,
book-layout product, Sphinx + reST is what Pycon chose for some reasons.
Those (and many other docs) are full, and people manage to produce rich,
useful content.
Because of that, I question these sorts of "reasons" for not contributing to
docs ("Its too hard to learn!" is a tad easier than Python, a bigger chunck
easier than javascript, and people are still stumbling w/ html...)
I think this is a non-issue; if I'm right, then other attempts (as has been
the case for past year) will not make much of a difference, and something
else is at issue... going on...
If I am wrong, then we should see a veritable proliferation of docs written
in Scribus, OpenOffice, etc.... or even on blogger.com.
Regards,
- Yarko
>
> 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/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
-~----------~----~----~----~------~----~------~--~---
