Hi André! I've spent the last month converting python educational materials from lore to sphinx. For the results, see: http://openbookproject.net/thinkcs/python/english2e and http://www.openbookproject.net/pybiblio/gasp/course The only missing feature at this point (sphinx rocks!) is support for crunchy. Any thoughts on that? I didn't see any reference to reStructuredText or Sphinx on the crunchy site. Thanks! jeff elkenr
On Mon, Jun 22, 2009 at 3:53 PM, Jeff Elkner<jeff@elkner.net> wrote:
Hi André! I've spent the last month converting python educational materials from lore to sphinx.
For the results, see:
http://openbookproject.net/thinkcs/python/english2e
and
This looks great!
The only missing feature at this point (sphinx rocks!) is support for crunchy. Any thoughts on that? I didn't see any reference to reStructuredText or Sphinx on the crunchy site.
Crunchy can read either reStructuredText files (and transform them in html files) or html files directly. If you launch Crunchy, you can see it in action with the menu item: Advanced Topic -> reStructuredText Crunchy recognizes a few additional "rst directives". For example, some cut-and-paste text from taken directly from that file: """ We start by showing two simple Python code samples, with no special directives, one with a simulated interactive Python session, the other without, so that Crunchy will perform its magic based on your preferences. >>> print "Python is great!" Python is great! And for the other example without a Python prompt, that Crunchy will not know what to do with. print "Crunchy is pretty good too!" We now move on to using embedded directives. Interpreters ============ The following is an example of a borg interpreter. If you type the above text into the box, you will see that "answer" can be defined and then printed .. interpreter:: interpreter :linenumber:
answer = 42 print answer 42 """
If all you're using are interpreter prompts, then the Crunchy default should work just fine, with no additional directives. I just loaded the page http://www.openbookproject.net/pybiblio/gasp/course/1-intro.html, setting this site to "trusted" (from the security item on the Crunchy menu at the top), reloaded the page, and everything worked just fine! It looks better if you de-select the "popups" from the preferences. I've attached a "screen capture image" so that anyone interested can compare with the original. Note that the "style" (css) is the Crunchy default which is different from that on the original website. Cheers, André
Thanks!
jeff elkenr
I have high regard for Crunchy Frog, another Monty Python allusion (I make sure kids learn). I also met a music band recently by that name, includes didgeridoo playing. Perhaps we'll see some YouTube commercials for this free product soon? I encourage open source developers to create demand for their products just like car companies do (whiskey companies etc.), not so much to generate profit (the product is free after all) but to motivate geeks to participate and contribute, as field testers and power users at first, some graduating to become core committers if passionate and skilled enough. So more like the army maybe, in terms of what the commercials accomplish. Kirby 4D
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Jeff Elkner wrote:
Hi André! I've spent the last month converting python educational materials from lore to sphinx.
For the results, see:
http://openbookproject.net/thinkcs/python/english2e
and
http://www.openbookproject.net/pybiblio/gasp/course
The only missing feature at this point (sphinx rocks!) is support for crunchy. Any thoughts on that? I didn't see any reference to reStructuredText or Sphinx on the crunchy site.
Congratulations, the book looks impressive. Adding crunchy is a great idea. Btw, while Sphinx marks the HTML documents UTF-8 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> the webserver serves the pages as iso-8859-1. This results eg. in ugly permalink markers (¶). Regards Michael - -- http://blog.d2m.at http://planetzope.org -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFKQHDsl0uAvQJUKVYRAhEcAJ9akXMIvKrwA8AIxaV9Ev/LSaHOZACgrO0p tws9GfLlIji5YqLiAOo2Z9U= =kPcd -----END PGP SIGNATURE-----
participants (4)
-
Andre Roberge -
Jeff Elkner -
kirby urner -
Michael Haubenwallner