On Tue, Sep 8, 2009 at 7:34 PM, Jason Grout<jason-s...@creativetrax.com> wrote: > > 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?
Yes, definitely!! And for exactly the reasons you list above and Jason below. >> > > 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 > > > > > -- William Stein Associate Professor of Mathematics University of Washington http://wstein.org --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
