Hi Leo, On 12/02/14 00:26, Dr. Leo wrote: > I would like to use Sphinx for non-documentation projects. the bare > Docutils works reasonabley well. But Sphinx' unique features such as > multiple files and TOC generation, directives for graphviz and > matplotlib and the Hieroglyph extension to create HGML5 slides > - https://github.com/nyergler/hieroglyph - > > are compelling reasons for me to use Sphinx rather than Docutils. > > So I guess what I want is an extension or theme that strips off all the > documentation related stuff leaving just those Sphinx features reusable > in non-documentation contexts. At least, I want to > configure/extend/modify Sphinx such that documentation-related elements > do not "pollute" the output. > > Unfortunately, I have no idea where to start.
I recommend the tutorial: http://sphinx-doc.org/tutorial.html > The main reason for this somewhat off-topic request is my need for a > tool chain to produce slides from simple plain text files. It looks as > though this might be the best way for the visually impaired to produce > high quality slides - ppt is virtually untractable with assistive > technology. Latex/Beamer might be an option, but it's just so clumpsy to > write. For the presentations themselves I'd recommend landslide: https://github.com/adamzap/landslide/blob/master/docs/index.rst > Any hint, in particular on whether it would be worthwhile to start from > Sphinx rather than Docutils would be very much appreciated. I maintain several non-code sites and can recommend Sphinx over plain docutils in this situation, mainly because it adds the notion of a global document tree. http://www.saffre-rumma.net http://www.vor-cycling.be/ Luc -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/groups/opt_out.
