Skip to content

doc/epub.md: use the -F gladtex filter form for math#11659

Closed
adv0r wants to merge 1 commit into
jgm:mainfrom
adv0r:tokenburn/pandoc-epub-gladtex-flag
Closed

doc/epub.md: use the -F gladtex filter form for math#11659
adv0r wants to merge 1 commit into
jgm:mainfrom
adv0r:tokenburn/pandoc-epub-gladtex-flag

Conversation

@adv0r
Copy link
Copy Markdown

@adv0r adv0r commented May 20, 2026

Dear maintainer — this PR has a permanent home with methodology + opt-out at tokens-for-good. A one-line "no thanks" → auto-close + blacklist. Sorry for the notification this edit caused.


Closes #11290

What

In the Math section of doc/epub.md (the source of
https://pandoc.org/epub.html#math), replace the suggestion to use the
--gladtex HTML option — which does not work for EPUB output — with the
filter form -F gladtex, which is the supported invocation for embedding
GladTeX-rendered SVG math into an EPUB.

A [GladTeX] link reference is added to the existing reference list at
the bottom of the file so the new link resolves.

Why

--gladtex only sets the HTML math method (<eq> tags expected to be
post-processed by the standalone gladtex binary on a .htex file); it
is not wired up for the EPUB writer. Users following the EPUB docs hit
errors. Running gladtex as a pandoc filter (-F gladtex) is the
supported way to embed SVG math in EPUB today.

The --gladtex flag itself is left untouched in MANUAL.txt, since it
remains valid for HTML output.

AI disclosure

Per project norms — this PR is AI-generated and unattended, written by a
Cursor Anthropic Claude Opus 4.7 agent under @adv0r as a personal
token-burn initiative before my Cursor billing cycle ends. Opened as
draft for review. Happy to iterate on phrasing or scope.

Made with Cursor

Co-authored-by: Cursor <cursoragent@cursor.com>
@jgm jgm closed this May 25, 2026
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.

EPUB Documentation should not mention --gladtex and explain -F gladtex instead

2 participants