Index of /sandbox/rst2graph

[ICO]NameLast modifiedSizeDescription

[DIR]Parent Directory  -  
[   ]MANIFEST.in12-Jul-2013 08:40 37  
[   ]global.log12-Jul-2013 08:40 61K 
[TXT]rst2graph.rst12-Jul-2013 08:40 1.2K 
[TXT]rst2gxl.py12-Jul-2013 08:40 22K 
[   ]setup.py12-Jul-2013 08:40 519  
[   ]sortDot.pl12-Jul-2013 08:40 1.1K 
[   ]tag.log12-Jul-2013 08:40 15  
[DIR]tests/12-Jul-2013 08:40 -  
[   ]version.py12-Jul-2013 08:40 18  

README for rst2graph

README for rst2graph


rst2graph is a program to create a graph from the links contained in a reStructuredText file. This is useful if you use linking in your text and want to visualize the link structure in a graphical form.

rst2graph supports various output formats describing the resulting graph in a certain formal syntax. So far Graphviz seems to be the best tool to render the output to a graphical form.

rst2graph offers a number of options to select only certain portions from the reStructuredText file. Using these options you can create the subgraph you are interested in.


After you obtained and unpacked the package run something like

python install

After installation you have the following commands to render graphs from reStructuredText:
The generic renderer. You must give an explicit output format to this command.,
Two commands rendering to dot format.
A command to render GXL format.


Beyond the docutils package you may want to install the pygraphviz to render into dot output.

This runs on Python 2.7. Python 3 has not been tested.


See or use --help for options.


There are test suites in tests.tgz. Use filterunit to run tests.


rst2graph is available from

and the Docutils sandbox


rst2graph stems from rst2gxl which only supported the GXL format. Because the gxl2gv converter malfunctioned too often and since pygraphviz is available rst2gxl became the foundation for rst2graph supporting the dot format directly.