also it is the basis for Python documentation <http://docs.python.org/> - that is, Sphinx <http://sphinx.pocoo.org/contents.html> uses ReST as it's basis. By using ReST,. we provide an underlying markup that can be used to create a "book" (online or otherwise), and we build on existing Python Tools and knowledge.
While at one level ReST may not be the easiest, it is easy enough and provides a good path to using existing tools. On Sat, Dec 13, 2008 at 2:44 PM, DenesL <denes1...@yahoo.ca> wrote: > > It is possible to post code fragments, use a double colon :: > See the wiki for an example. > > I also find it hard at times to use ReST (or markdown) being new to > it, but the advantage I see in using ReST is that it can create > printable documentation, even in PDF. > > On Dec 13, 7:39 am, pedro <pedro...@gmail.com> wrote: > > I've registered and I started playing around and submitting some > > content. > > Should this take off we need to discuss some important things. > > The first and most important for the moment is the markup. I am not > > sure Rest or markdown are suited for this job. Personally I like > > markdown, but AFAIK there is no way to post chunks of code. > > I don't know which parsers are out there available in python but maybe > > yet another alternative should be considered or maybe an existent wiki > > engine could simply be used. > > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web2py Web Framework" 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 -~----------~----~----~----~------~----~------~--~---