Skip to content

Fix counter needed in pandoc 3.8.2 and later#116

Open
zeehio wants to merge 2 commits into
Bioconductor:develfrom
zeehio:fix-pandoc-382-counter
Open

Fix counter needed in pandoc 3.8.2 and later#116
zeehio wants to merge 2 commits into
Bioconductor:develfrom
zeehio:fix-pandoc-382-counter

Conversation

@zeehio

@zeehio zeehio commented Jul 11, 2026

Copy link
Copy Markdown

BiocStyle::pdf_document fails on recent pandoc versions. Since pandoc 3.8.2, pandoc requires the latex template to include a counter definition that BiocStyle is missing.

I have tested this fix with pandoc 3.1.3 (worked before and after the fix), pandoc 3.8.1 (does not work, it is a botched release superseded one week after by 3.8.2) pandoc 3.8.2 (needs this fix) and pandoc 3.10 (needs this fix).

See jgm/pandoc#11201 for the underlying issue and rstudio/rticles#595 for how it has been patched elsewhere.

@zeehio zeehio changed the title Fix counter neded in pandoc 3.8.2 and later Fix counter needed in pandoc 3.8.2 and later Jul 11, 2026
@zeehio
zeehio force-pushed the fix-pandoc-382-counter branch from 1db6d0d to 5e905a4 Compare July 11, 2026 06:30
pandoc<3.8.1 works
pandoc==3.8.1 does not work
pandoc>=3.8.2 works

3.8.2 was released one week after 3.8.1

See jgm/pandoc#11201 and rstudio/rticles#595
@zeehio
zeehio force-pushed the fix-pandoc-382-counter branch from 5e905a4 to 8478c44 Compare July 11, 2026 06:31
zeehio pushed a commit to sipss/AlpsNMR that referenced this pull request Jul 11, 2026
…ignette failure

pandoc >=3.8.1 emits \LTcaptype{none} for uncaptioned longtables, and
stock BiocStyle's LaTeX template never predefines a counter named
"none", causing "LaTeX Error: No counter 'none' defined" when
building vignettes (this is what's been failing check-bioc.yml).
Confirmed via a minimal reprex against official BiocStyle 2.40.0 with
pandoc 3.1.3 (works) vs 3.8.2.1 (fails, same error).

Installs the fork right after dependency-installation pass 1 and
before pass 2 (the step that actually builds vignettes via
remotes::install_local(build_vignettes = TRUE)). The fork's
Version: 2.41.0 outranks the official release's 2.40.0, so pass 2's
own upgrade = TRUE won't revert it.

Temporary until Bioconductor/BiocStyle#116
lands upstream.
…onductor#116)

Renders the pipe-table reprex from Bioconductor#116 through
BiocStyle::pdf_document with lualatex. Without the fix in
inst/rmd/latex/default-2.8.tex, compilation fails with
"! LaTeX Error: No counter '' defined." on pandoc >=3.8.1 (jgm/pandoc#11201).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants