Alec Thomas | 14 May 14:29

[Trac-dev] Re: Sphinx?


2008/5/14 Noah Kantrowitz <kantrn <at> rpi.edu>:
> What would people think about basing our new docs around the Sphinx system
> (http://sphinx.pocoo.org/)? It seems to provide a number of nice support
> functions beyond simply putting each doc in a file and running rst2html or
> something. The pickle builder would be a good starting place  for the
> integration with osimmion's newhelp interface (I think). This would mean
> Sphinx and Pygments would be required for building the documentation (and
> therefore for building release media), but neither would be runtime
> dependencies. Thoughts?

I've been converting the documentation for my own applications to
Sphinx, and it's been a very pleasant experience. As a bonus, I think
it would also save us a lot of work.

Alec

--

-- 
Evolution: Taking care of those too stupid to take care of themselves.

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Trac Development" group.
To post to this group, send email to trac-dev <at> googlegroups.com
To unsubscribe from this group, send email to trac-dev-unsubscribe <at> googlegroups.com
For more options, visit this group at http://groups.google.com/group/trac-dev?hl=en
-~----------~----~----~----~------~----~------~--~---


Gmane