From 9c7cf581f1ee774e0ceb5424f1ac963288c08ec1 Mon Sep 17 00:00:00 2001 From: Chris Sewell Date: Sun, 12 Jul 2026 14:03:15 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=94=A7=20Disable=20"colorrows"=20latex=20?= =?UTF-8?q?table=20style=20to=20fix=20PDF=20docs=20build?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit TeX Live 2026 updated colortbl/array such that Sphinx's colorrows implementation becomes self-referential (\CT@everycr{\the\everycr}), crashing the PDF build with "TeX capacity exceeded" at the first table (https://github.com/sphinx-doc/sphinx/issues/14465). The upstream fix is milestoned for Sphinx 9.1.1, which is not yet released, and the CI job uses an unpinned texlive image, so the build broke without any change on our side. Restricting latex_table_style to booktabs stops the writer emitting the colorrows package option, so the affected macros are never activated. This can be reverted once CI runs a Sphinx release containing the fix. --- docs/conf.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/conf.py b/docs/conf.py index 46080f9e..eb1d97b7 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -208,6 +208,10 @@ # -- LaTeX output ------------------------------------------------- latex_engine = "xelatex" +# drop the default "colorrows" style: colortbl in TeX Live 2026 breaks it +# (https://github.com/sphinx-doc/sphinx/issues/14465); +# it can be restored once CI runs a Sphinx release (>=9.1.1) containing the fix +latex_table_style = ["booktabs"] # -- Local Sphinx extensions -------------------------------------------------