1. Installation guide¶
The following software and modules are required to run dot2tex:
- Python 2.7 or 3.x.
- 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.
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.