Transform ReST files from repository to HTML


The ReST Wiki macro translates ReST files hosted on the Subversion repository to HTML snippets. reStructuredText (sometimes abbreviated as RST, ReST, or reST) is a file format for textual data used primarily in the Python programming language community for technical documentation.

It requires one argument, namely the full path of the ReST file to convert:


For example the following could be used to display the file 'design.txt':


The generated HTML will always be kept in sync with the corresponding ReST file in SVN.

The macro uses internal Trac ReST publisher and there's an optional cache system to make it more reliable. To activate it you only have to create a directory named 'rst_cache' in the Trac environment. This directory should be writable by the user running Trac.

Bugs/Feature Requests

Existing bugs and feature requests for ReSTMacro are here.

If you have any issues, create a new ticket.


Download the zipped source from here.


You can check out ReSTMacro from here using Subversion, or browse the source with Trac.


General instructions on installing Trac plugins can be found on the TracPlugins page.

Recent Changes

15910 by rjollos on 2016-10-11 04:14:43
0.3.4: Change license to 3-Clause BSD

Done with permission of original author.

15909 by rjollos on 2016-10-10 21:14:20
0.3.3: Initial import
15908 by rjollos on 2016-10-10 21:04:12
Create directory for ReSTMacro source


Author: Philippe Normand
Maintainer: none (needsadoption)

Last modified 3 weeks ago Last modified on Oct 10, 2016, 9:31:49 PM