CTAN Comprehensive TeX Archive Network

Directory graphics/pgf/contrib/pgf-go

README.md

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

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 Lua 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 Project Public License, version 1.3c or later. The manuals may be distributed and/or modified under the Project Public License, version 1.3c or later, and/or the GNU Free Documentation License.

Requirements

Lua is recommended (the compute kernel in Lua); with pdf 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 Live and MiK. Otherwise, copy the files of the folder latex/ to the folder of your document or to your 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 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.

PackagePGF-go
Version0.2026.10.30 2026-10-30
LicensesFree Documentation License
The Project Public License 1.3c
Copyright2025–2026 Jonatán Perren
MaintainerJonatán Perren
Contained inTeX Live as pgf-go
MiKTeX as pgf-go
TopicsUse Lua
Games
Go
PGF
...
Guest Book Sitemap Contact Contact Author