1. Installation guide¶
The following software and modules are required to run dot2tex:
- Python 2.6 or 2.7.
- pyparsing. Version 1.4.8 or later is recommended.
- Graphviz. A recent version is required.
- preview. A LaTeX package for extracting parts of a document. A free-standing part of the preview-latex/AUCTeX bundle.
- PGF/TikZ version 2.0 or later.
Users have reported problems using dot2tex with old versions of pyparsing and Graphviz.
A natural companion to dot2tex is the dot2texi LaTeX package for embedding graphs directly in your LaTeX source code.
Dot2tex 2.9.x works with Python 2.6, but support for 2.6 will be dropped in the next major version.
1.2. Using pip or easy_install¶
$ pip install dot2tex
$ easy_install dot2tex
$ sudo pip install dot2tex
The commands will locate dot2tex and download it automatically. Note that documentation and examples are not installed by default. Pip and easy_install will also create a wrapper script or EXE file for you and install dependencies if necessary.
1.4. From source¶
Download a zip or a tarball from the download page. Unpack the file to a directory and run
python on the
$ python setup.py install
This will create a dot2tex module in your Python modue directory and a wrapper script in your
SCRIPTS directory. Note that a few warnings will be displayed. You can safely ignore them. The warnings are shown because there is some extra information in the
setup.py file that distutils does not understand.