# pgf-go — Go (Weiqi, Baduk, Igo) diagrams in LaTeX

Release 0.2026.10.30 2026/10/30

## Description

pgf-go draws and comments on Go games with PGF/TikZ: boards, stones, moves,
marks, arrows and territory. With LuaLaTeX it also reads SGF files (a game on a
board, diagrams as in books, animations and problems), removes captured stones
and finds the territory. It also reads the ASCII diagrams of Sensei's Library
and Life in 19x19.

## License

The code may be distributed and/or modified under the terms of the
[LaTeX Project Public License](https://www.latex-project.org/lppl/), version
1.3c or later. The manuals may be distributed and/or modified under the LaTeX
Project Public License, version 1.3c or later, and/or the GNU Free
Documentation License.

## Requirements

LuaLaTeX is recommended (the compute kernel in Lua); with pdfLaTeX the package
works, but it cannot read SGF files, remove captured stones or find the
territory by itself. It loads TikZ and xparse; `\sgfanimation` needs
[animate](https://ctan.org/pkg/animate).

## Installation

pgf-go comes with TeX Live and MiKTeX. Otherwise, copy the files of the folder
`latex/` to the folder of your document or to your TeX tree.

## Usage

```latex
\documentclass{article}
\usepackage{pgf-go}

\begin{document}
\begin{goban}
	\stones[b]{C3}
	\stones[w]{E5}
\end{goban}

\sgfdiagrams[step = 50]{game.sgf}  % LuaLaTeX
\end{document}
```

## Documentation

The manuals `pgf-go-es.pdf` (Spanish) and `pgf-go-en.pdf` (English), the
slides `doc/pgf-go-quick-start-es.pdf` and `doc/pgf-go-quick-start-en.pdf`, and
the examples in `doc/examples`. On GitHub, the compiled manuals are attached to
each release.

## Changes

See `CHANGELOG.md`.

## Author

Jonatán Perren, jonatan (dot) perren (at) gmail (dot) com