Skip to main content

trac2rst

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.

Features

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 https://trac.yaco.es/project/  -o /tmp/test.rst && rst2html /tmp/test.rst /tmp/test.html && firefox /tmp/test.html

Disclaimer

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

License

trac2rst is offered under the MIT license.

Authors

trac2rst is made available by Yaco Sistemas

Credits

Changelog

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

Metadata

Release files for trac2rst 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for trac2rst 0.2.1
File Size Uploaded
trac2rst-0.2.1.tar.gz 9.5 kB Details

Release files / trac2rst-0.2.1.tar.gz

Download URL trac2rst-0.2.1.tar.gz
Size 9.5 kB
Tags Source
SHA-256 checksum
How to use checksums
f91e1368e16e43c1a3d882a04900544c4da1031803a0aec376298a44cda7cc6b
BLAKE2b-256 checksum
How to use checksums
3c8914a94293811ab3dfbcaa4edc9f34ce360dc869bf3b8fdc6694aab8edfbf8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.2.1 This release

1 release file

0.2

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page