Fernando Perez wrote: > On Tue, Sep 8, 2009 at 6:45 PM, William Stein<wst...@gmail.com> wrote: >> Hi, >> >> Mike Hansen and I just spent a while carefully going through: >> >> http://wiki.sagemath.org/SageUsability >> >> and updated it with more ideas... > > I wonder if it would be totally crazy to consider using reST as the > native notebook format, or at least have it be optionally so. > > I know that one can already execute 'live' sphinx docs in html, which > is super cool. But given that reST has support for input and output > code blocks (which it can even doctest), I'd really like to basically > edit in the notebook itself reST sources, with text cells being plain > reST, input cells being code blocks and output being 'text' code > blocks, as suggested here: > > http://groups.google.com/group/sphinx-dev/browse_thread/thread/ecbcea0ab4d1ca78/86e3da68e1576f7a > > I don't know enough about all the sphinx machinery yet to see if there > are any fatal flaws in this idea, and given the amount of existing > worksheets out there obviously such a change couldn't be done lightly. > But I'm so happy with using sphinx more and more, that being able to > simultaneously edit reST and execute code seems really appealing to > me. > > Does this sound possible/reasonable/useful? >
Along these lines, I just started to write/adapt a short tutorial on Calculus in Sage. In hopes that eventually would make it into some sort of documentation or primer or something, I tried to write it somewhat in ReST. You can see the result here: http://sagenb.org/home/pub/791/ My hope is that it will be easy to convert from a worksheet into a document. I found it a wonderful way to write documentation, and kept wishing I had a better way to structure the document (i.e., collapsible headings, etc.) Jason -- Jason Grout --~--~---------~--~----~------------~-------~--~----~ To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URLs: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---
