http://base-art.net/Articles/74/ <p>At work i daily use <a class="reference" href="http://trac.edgewall.org/">Trac</a>, 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?</p> <p>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 <a class="reference" href="http://docutils.sf.net">docutils</a> to convert ReST files to HTML fragments, cache them to filesystem and render them via the macro. Here is a simple use-case:</p> <pre class="literal-block"> [[ReST(/trunk/docs/design.txt)]] </pre> <p>And no more copy/paste between svn and wiki. Using it is adopting it, go check it out in the <a class="reference" href="http://svn.pythonfr.org/public/pythonfr/utils/trac/ReST.py">PythonFR</a> svn repository.</p> <p><strong>update 2006/08/01</strong> the macro is now embedded in a Trac plugin, which eases deployement and updates. It also directly uses the ReST publisher used in Trac, this allows to use <a class="reference" href="http://trac.edgewall.org/wiki/WikiRestructuredText">trac dedicated formatting</a>. The plugin has a new location: <a class="reference" href="http://svn.pythonfr.org/public/pythonfr/utils/trac/rest_macro/">http://svn.pythonfr.org/public/pythonfr/utils/trac/rest_macro/</a></p> en The contents of this blog are available for non-commercial use only. Alinea http://pythonfr.org/alinea/ http://base-art.net/Comments/202/ http://base-art.net/Comments/202/ winjer 2006-07-28T12:35:51Z