1. Installation guide

1.1. Dependencies

The following software and modules are required to run dot2tex:

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

The easiest way to install dot2tex is to use pip (recommended) or easy_install:

$ pip install dot2tex

or easy_install:

$ easy_install dot2tex

If you are on Linux or Mac OS X you may have to call pip or easy_install using sudo:

$ 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.3. Binary packages

Binary packages are available for Debian and OpenSUSE.

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 setup.py file:

$ 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.

1.5. Development version

The development version of dot2tex is hosted on GitHub. To get the code you can use the following command:

git clone https://github.com/kjellmf/dot2tex.git