14 May 14:07
[Trac-dev] Sphinx?
From: Noah Kantrowitz <kantrn <at> rpi.edu>
Subject: [Trac-dev] Sphinx?
Newsgroups: gmane.comp.version-control.subversion.trac.devel
Date: 2008-05-14 12:10:31 GMT
Subject: [Trac-dev] Sphinx?
Newsgroups: gmane.comp.version-control.subversion.trac.devel
Date: 2008-05-14 12:10:31 GMT
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? --Noah
)
As a side note, the output is not XHMTL strict as we produce w/ Trac,
only XHTML transitional. It seems there a very few efforts to produce
XHTML strict though.
Cheers,
Manu
--~--~---------~--~----~------------~-------~--~----~
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
Basic structure
---------------
As more or less agreed above, we make 4 main guides:
- Install Guide
- Developer Guide/Reference
- Admin Guide
- User Guide
Install and Developer guides
RSS Feed