Description of the TikZ Sphinx Extension

This extension to Sphinx enables the use of the PGF/TikZ LaTeX package to draw nice pictures. (See CTAN or sourceforge; the manual is, e.g., here. Also have a look at contributions such as pgfplots.)

Use the extension at your own risk. Anything might change in future versions without further notice.

Version: 0.4.1 Christoph Reller christoph.reller@gmail.com BSD License tikz.py https://bitbucket.org/philexander/tikz http://pypi.python.org/pypi/sphinxcontrib-tikz

Prerequisites and Configuration

Prerequisites

On your computer the following must be installed:

• latex with the tikz and the amsmath packages
• pdftoppm (part of the Poppler pdf library)
• either of the following:
• pnmcrop and pnmtopng (both part of the Netpbm package)
• convert (part of the ImageMagick package)

(We cannot use dvipng as the pngmath Sphinx extension does because there is an issue with cropping the image if postscript specials are used.)

For Ubuntu Linux you roughly have to have the following packages installed:

• texlive and texlive-pictures (and maybe more LaTeX packages)
• poppler-utils
• netpbm or imagemagick

For Mac OS X a possible way of getting this extension working is:

• Install homebrew in the terminal by: