This post originated from an RSS feed registered with Python Buzz
by Philippe Normand.
Original Post: Doc publishing for the lazy Trac user
Feed Title: Base-Art / Python
Feed URL: http://base-art.net/Sections/5/rss.xml
Feed Description: Phil's blog
At work i daily use Trac, it's a great flexible wiki and issue
tracking system. These days we're editing some documentation
files hosted on the subversion repository. Using the Wiki to
display them for human eyes is the next step, but how to keep
rendered and source versions in sync?
Let's use Trac's WikiMacro dead simple yet powerful framework. We
currently use ReST as the documentation format, so it was quite
easy to use docutils to convert ReST files to HTML fragments,
cache them to filesystem and render them via the macro. Here is a
simple use-case:
[[ReST(/trunk/docs/design.txt)]]
And no more copy/paste between svn and wiki. Using it is adopting
it, go check it out in the PythonFR svn repository.
Previous Topic
