Skip to main content

Quick an dirty tool to transform text in Trac Wiki formatting to Restructured Text

Project description


I use trac2rst to help me in the task to pass documentacion from trac to sphinx (reStructuredText). I usally copy the trac wiki page to a temporaly file, run the script, copy the output to the new rest file and do manual changes.


The idea is use this tool to do the more tedious work (I mean transforming lists, links and inliners). You must review and fix the result later.

It only processes:
  • Headers (sections at 4 levels)
  • Lists (bullets and numbered)
  • Trac links.
  • A subject of trac and rest inliners
It does NOT support (a lot):
  • Trac macros
  • Trac processors
  • Links between wiki pages
  • Rest definition lists, etc
  • Preformatting
  • Images
  • Tables
  • Footnotes
  • Anchors
  • Citations
  • Comments
  • A lot more …

Usage example

Type trac2rst –help

You can view a simple wiki transfomation (used for manual test):

$ bin/trac2rst -i src/trac2rst/tests/wikitext.txt -u  -o /tmp/test.rst && rst2html /tmp/test.rst /tmp/test.html && firefox /tmp/test.html


This is a quick and dirty tool. It does not use reST or wiki processor. The work is done using regular expressions.


trac2rst is offered under the MIT license.


trac2rst is made available by Yaco Sistemas


0.2.1 (2011-12-19)

  • fix error in project url

0.2 (2011-12-19)

  • pep8 compliant
  • Global variables removed
  • Set a TODO comment por preformated text

0.1 (2011-12-19)

  • First Release

Project details

Release history Release notifications

This version
History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
trac2rst-0.2.1.tar.gz (9.5 kB) Copy SHA256 hash SHA256 Source None Dec 19, 2011

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page