blob: 6a6dae21498379305a163ee3a06e945ab6fffa77 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
dot2tex - A Graphviz to LaTeX converter
=======================================
Copyright (C) 2007 Kjell Magne Fauske
License: MIT (See LICENSE for details.)
Version: 2.7.0
URL: http://www.fauskes.net/code/dot2tex/
Dot2tex is a tool for converting graphs rendered by Graphviz to formats
that can be used with LaTeX.
The purpose of dot2tex is to give graphs generated by Graphviz a more
LaTeX friendly look and feel. This is accomplished by converting xdot
output from Graphviz to a series of TikZ and PGF, or PSTricks commands.
This approach allows:
* Typesetting labels with LaTeX, allowing mathematical notation.
* Using native PSTricks and PGF/TikZ commands for drawing arrows.
* Using backend specific styles to customize the output
Installation
============
Before you install dot2tex you have to have a working Python environment
installed on your system. Dot2tex has been developed and tested with
Python 2.4, but it will probably run fine using Python 2.3. In addition
you'll need the following modules:
* pyparsing (http://pyparsing.wikispaces.com/). A recent version is required.
Older version like for instance 1.3.2 does not work with dot2tex.
* pydot (http://dkbza.org/pydot.html)
* preview (http://www.ctan.org/tex-archive/help/Catalogue/entries/preview.html)
A stand-alone part of the preview-latex/AUCTeX bundle.
Required for preprocessing graphs with LaTeX.
From source
-----------
Download a zip or a tarball from the download_ page. It is also available on
CTAN_. 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 module 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.
.. _download: http://www.fauskes.net/code/dot2tex/download/
.. _CTAN: http://www.ctan.org/tex-archive/help/Catalogue/entries/dot2tex.html
Using easy_install
------------------
The easiest way to install dot2tex is to use `easy_install`_::
$ easy_install dot2tex
The command will locate dot2tex and download it automatically. Note that
documentation and examples are not installed by default. `Easy_install`_
will also create a wrapper script or EXE file for you and install dependencies
if necessary.
.. _easy_install: http://peak.telecommunity.com/DevCenter/EasyInstall
Binary packages
---------------
Binary packages are available for Debian_ and OpenSUSE_.
.. _Debian: http://packages.qa.debian.org/d/dot2tex.html
.. _OpenSUSE: http://download.opensuse.org/repositories/home:/jimfunk/
What's new in version 2.7.0
===========================
- Added the --codeonly option. When this option is used, only draw commands
are generated. Intended for use with the dot2texi package.
- Minor improvements to the documentation.
For a full list of changes see changelog.txt
|
