Directory graphics/pgf/contrib/pgf-go
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, 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.
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
\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
Download the contents of this package in one zip archive (8.4M).
PGF-go – Diagramming and commenting on Go games
A LaTeX package for creating Go (Weiqi, Baduk, Igo) diagrams with ease. It can read SGF files, resolve captures, and count territory. It features an efficient coordinate-loading syntax to streamline workflows and offers flexible profile manipulation, allowing users to customize board layouts, stones, and annotations effortlessly. It also provides macros for easily arranging diagrams and problems.
| Package | PGF-go |
| Version | 0.2026.10.30 2026-10-30 |
| Licenses | Free Documentation License The LaTeX Project Public License 1.3c |
| Copyright | 2025–2026 Jonatán Perren |
| Maintainer | Jonatán Perren |
| Contained in | TeX Live as pgf-go MiKTeX as pgf-go |
| Topics | Use LuaTeX Games Go PGF TikZ |