Re: [sphinx-dev] Using Sphinx in education
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 22:12, schrieb Tim Bower: This is not exactly a new project using Sphinx, but I wanted to mention that I have been using Sphinx for course material delivery in college classes. I think Sphinx has a great deal of value to education as instructional technology. I just wrote and presented a conference paper about it. The title of the paper is Dumping PowerPoint in Favor of Web Sites. You may download the paper at: http://www.sal.ksu.edu/faculty/tim/scholarship/study_guides.pdf The notes that I used in the presentation may be viewed at: http://www.sal.ksu.edu/faculty/tim/prof-day/index.html Hi Tim, this is very nice to see! cheers, Georg -BEGIN PGP SIGNATURE- Version: GnuPG v2.0.16 (GNU/Linux) iEYEARECAAYFAk0yq50ACgkQN9GcIYhpnLAm8QCfZPD6WysepUwsQB7pf61nxd49 oYIAn3d8rQvhb9P1FOakyxnXKheRuWja =SgAh -END PGP SIGNATURE- -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
[sphinx-dev] slideshow mode (was: Using Sphinx in education)
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.11 22:12, schrieb Tim Bower: This is not exactly a new project using Sphinx, but I wanted to mention that I have been using Sphinx for course material delivery in college classes. Interesting that you cited Death by Powerpoint. I used Sphinx to deliver a handout for my Art of Presentation-seminar. But concerning presentations: There is a presentation mode in the Python CMS Plone. You can have a look here: http://www.hasecke.com/plone-benutzerhandbuch/4.0/artikeltypen/seite.html?highlight=präsentation#prasentationsmodus The feature is based on S5 (http://s5project.org/) I don't know the status of the s5 project. And I use it only from time to time because I prefer Keynote but perhaps this is something some people would like to see in Sphinx. You could write your documentation and simply mark something to appear on a slide. You could switch your documentation to a slide show with a mouse click. In Plone we use a special CSS for the slideshow. It hides all paragraphs and only displays headlines and lists (bullet lists, enumerated lists and description lists). So the normal representation as a html-page and the s5-slideshow use the same html-source. In Sphinx there could be a more sophisticated solution with a special S5 builder, where you can design your slide with a '.. only::' statement. The alternative to a s5 builder is a builder for the beamer class in LaTeX. Cheers! juh - -- Die deutschsprachigen Benutzerhandbücher Plone 3 http://www.hasecke.com/plone-benutzerhandbuch/3.3.5/ Plone 4 http://www.hasecke.com/plone-benutzerhandbuch/4.0/ -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.10 (Darwin) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iEYEARECAAYFAk0yuywACgkQPUzUEFbILMR20wCfbPEYMX9f8oV09EeT1TQmQSV2 iLkAoKG+FLWwefTmpKp5Iu3XeglsWN9u =LjRA -END PGP SIGNATURE- -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
Re: [sphinx-dev] Intersphinx problem with Generator
On Sat, Jan 15, 2011 at 11:54 AM, Georg Brandl ge...@python.org wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 13:30, schrieb cool-RR: On Wed, Jan 12, 2011 at 2:24 PM, cool-RR ram.rac...@gmail.com mailto:ram.rac...@gmail.com wrote: Hello, I write :term:`generator` in my docs, and do `make html`, but it doesn't make a link to Python's documentation. I also tried prefixing it with :py, doesn't help. Does Intersphinx not support terms? Thanks, Ram. I also tried :py:keyword:`yield` now, and it doesn't link either. You'll have to link to the development Python docs ( http://docs.python.org/dev), since the 2.7 docs are still using Sphinx 0.6 which only can reference to Python objects, not terms or keywords. cheers, Georg I see. Do you think there's a good reason for them to stay at 0.6? Should I file an issue for them to upgrade? Ram. -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
Re: [sphinx-dev] Intersphinx problem with Generator
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 16.01.2011 12:47, schrieb cool-RR: Hello, I write :term:`generator` in my docs, and do `make html`, but it doesn't make a link to Python's documentation. I also tried prefixing it with :py, doesn't help. Does Intersphinx not support terms? Thanks, Ram. I also tried :py:keyword:`yield` now, and it doesn't link either. You'll have to link to the development Python docs (http://docs.python.org/dev), since the 2.7 docs are still using Sphinx 0.6 which only can reference to Python objects, not terms or keywords. cheers, Georg I see. Do you think there's a good reason for them to stay at 0.6? Should I file an issue for them to upgrade? Since these branches are in bugfix-only mode, I thought it best not to update the toolchain either. However I'll discuss with the other developers for the next release. Georg -BEGIN PGP SIGNATURE- Version: GnuPG v2.0.16 (GNU/Linux) iEYEARECAAYFAk0y6x0ACgkQN9GcIYhpnLBMfgCfYuMP0BbHqXjKTKfj2oruxME6 sLcAn2DMAL6+z1W1L9TZouin6sy+CBqj =8UHe -END PGP SIGNATURE- -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
[sphinx-dev] matplotlib plot directive
Hello, I just learnt how to add matplotlib extension for sphinx to the sphinx project so that I can embed matplotlib code that is coverted to figures on the fly. I tried two figures and matplotlib gives these figures the name of hires.png. I have not specified the name hires anywhere in my document, so I suppose it is somewhere in the extension code. Can someone please tell me how can I get rid of this name hires? Thanks -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.