pgf – A Portable Graphic Format for TeX

PGF is a TeX macro package for generating graphics. It is platform-and format-independent and works together with the most important TeXbackend drivers, including pdftex and dvips. It comes with auser-friendly syntax layer called TikZ.

See the directory doc/generic/pgf for more information. See the filedoc/generic/pgf/pgfmanual.pdf (also available fromhttps://pgf-tikz.github.io/pgf/pgfmanual.pdf) for a manual. Thisdocumentation also explains the installation. See the filedoc/generic/pgf/license/LICENSE for license details.

Please go to the official repository at https://github.com/pgf-tikz/pgf or theofficial mailing list at https://tug.org/mailman/listinfo/pgf-tikz to submitbug reports, request new features, etc.

We also have a chat on the Matrix network at#pgf-tikz:matrix.org.

Installation

In general you should just use the version of PGF that is shipped byyour TeX distribution. See their documentation on how to installpackages.

If you are feeling adventurous you can install the latest developmentversion in TeX Live from our tlcontrib repository.

$ tlmgr repository add http://pgf-tikz.github.io/pgf/tlnet pgf-development
$ tlmgr pinning add pgf-development "*"
$ tlmgr update --self --all
$ tlmgr install pgf --reinstall

Development

Currently PGF does not have a comprehensive test suite to check forregressions, so for now we check for bugs by building the manual foreach commit. To build the manual locally you can either copy the PGFrepository into your texmf tree (not recommended) or use the usertreeoption of TeX Live. For the usertree option on GNU/Linux, followthese steps:

$ git clone https://github.com/pgf-tikz/pgf
$ tlmgr init-usertree --usertree pgf
$ export TEXMFHOME=$(readlink -f pgf)
$ cd pgf
$ texlua build.lua manual luatex

We recommend building at least the version for LuaTeX, as shown in theexample above because this has the broadest coverage of PGF features.To test the animations feature you have to build the version fordvisvgm.