.. _spkg_dot2tex:

dot2tex: Create PGF/TikZ commands from Graphviz output
======================================================

Description
-----------

dot2tex is a Python module, whose purpose 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 PSTricks or PGF/TikZ
commands.

See https://github.com/kjellmf/dot2tex/

License
-------

-  MIT


Upstream Contact
----------------

-  Kjell Magne Fauske, km@fauskes.net

Dependencies
------------

graphviz (www.graphviz.org) should be installed and in the path (for
example via the graphviz spkg).

preview, a LaTeX package for extracting parts of a document.

Self-tests dependencies:

-  graphviz
-  texlive-latex-base
-  texlive-pictures
-  texlive-pstricks

Patches
-------

-  remove_test_semicolon.patch:

   Remove the failing semicolon test for the open dot2tex
   issue #5 - https://github.com/kjellmf/dot2tex/issues/5


Special Update/Build Instructions
---------------------------------

Make sure corresponding optional doctests still pass:

   sage -t --long --optional=dot2tex,graphviz,sage src/

Type
----

optional


Dependencies
------------

- $(PYTHON)
- $(PYTHON_TOOLCHAIN)
- :ref:`spkg_pyparsing`

Version Information
-------------------

package-version.txt::

    2.11.3.p0

install-requires.txt::

    dot2tex >=2.11.3


Equivalent System Packages
--------------------------

arch:

.. CODE-BLOCK:: bash

    $ sudo pacman -S  dot2tex


macports:
install the following packages: dot2tex

See https://repology.org/project/dot2tex/versions, https://repology.org/project/python:dot2tex/versions


However, these system packages will not be used for building Sage
because using Python site-packages is not supported by the Sage distribution;
see :trac:`29023`

