Yes rst/sphinx is nice for tutorials. I just used it to transform my Hands-on Python Tutorial in the last week:
http://anh.cs.luc.edu/python/hands-on/3.1/ Jurgis, Google does a fair approximation I think, when automatically translating you tutorial to English. At least it is smart enough not to mess with the code itself. Andy On Sat, Jan 8, 2011 at 12:15 PM, Jurgis Pralgauskis < jurgis.pralgaus...@gmail.com> wrote: > Hello, > > during the hollydays I put up some nice system > to quite straitforward build tutorials... > > the tutorial is written in kind of markdown (this could be changed easily) > http://ftp.akl.lt/users/jurgis/python/knygute/_sources/intro.1.txt > > and then it is converted to rst/sphinx like > http://ftp.akl.lt/users/jurgis/python/knygute/intro.1.html > > Features: > * automatically computes outputs/results of examples (I havent' found > such feature otherwise) > * adds interactions (via sphinx template js injections) > at the bottom of each code block there are 3 buttons appearing on hover > > - 1st I'd call "syntax trainer by repeating" (for beginners it > should be very good) > - 2nd -- toggle off/on prompts and output -- for copying example to > editor > which I didn't found around sphinx (3 lines of jquery actually) > - 3rd -- integration with http://people.csail.mit.edu/pgbovine/python/ > > - I also used turtle graphics to introduce function -- and I like this > idea > > http://ftp.akl.lt/users/jurgis/python/knygute/intro.3.functions.html#funkcijos > > any comments? > > > Tutorial is in Lithuanian, but you can understand most by examples... > I was writing it with absolute beginners in mind -- > somehow I didn't find easy enough english tutorials. > thinkscipy is a bit steep in my opinion... > maybe you could indicate some, or maybe I'ts worth translating mine > into english? > > > Best regards > -- > Jurgis Pralgauskis > Don't worry, be happy and make things better ;) > http://kompiuterija.pasimokom.lt > _______________________________________________ > Edu-sig mailing list > Edu-sig@python.org > http://mail.python.org/mailman/listinfo/edu-sig > -- Dr. Andrew N. Harrington Computer Science Department Loyola University Chicago 512B Lewis Towers (office) Snail mail to Lewis Towers 416 820 North Michigan Avenue Chicago, Illinois 60611 http://www.cs.luc.edu/~anh Phone: 312-915-7982 Fax: 312-915-7998 ahar...@luc.edu
_______________________________________________ Edu-sig mailing list Edu-sig@python.org http://mail.python.org/mailman/listinfo/edu-sig
