Repository navigation
Add accessible alt text for Docs equations - #69
Conversation
|
Live Google Docs verification — all six cases passed Tested PR head
MathJax: six equations rendered with the option off and on. Native Docs Alt Text UI verified fallback/custom metadata, including each enabled-case description. Single de-render restored the authored custom suffix; De-render All restored the remaining five. Copied source matches the original six fixtures exactly, without duplicate suffixes. CodeCogs: six equations rendered; native Alt Text UI verified raw fallback and explicit custom text, and the image links confirm CodeCogs URLs. De-render All restored six, with exact source verified again. Release boundary: this PR remains open and its Docs code was pushed to project head for the explicitly requested test. Docs Marketplace remains v95. The separately approved Slides fix was published as v15 in #70. The earlier new sandbox failed at Google OAuth with “This app is blocked”; the existing main Docs add-on ran successfully here. |
The screenshots in this PR's 2026-09-15 comment were taken against the earlier
opt-in revision and show an alt-text checkbox that no longer exists. Recaptured
against this branch pushed to the Docs project head (Common v8, development mode
off, pulled back and verified byte-identical), in a new document tab so the
earlier QA content was left untouched.
Covers the whole _{description} rule in one pass: Advanced Settings with no
checkbox, six equations rendered, Google's own Alt text panel showing the raw
LaTeX fallback, an authored description and a description with nested braces,
and De-render All restoring all six lines character for character.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
New live Docs screenshots — alt text, always onThe screenshots in the 2026-09-15 comment above show an alt-text checkbox that no longer exists; they were taken against the earlier opt-in revision. These replace them. Captured today in Google Docs against this branch pushed to the Docs Apps Script project head (Common pinned to v8, FixturesThere is no setting any moreAdvanced Settings now holds only Delimiter Style and Preferred Renderer. Alt text is not something a user has to find and turn on. Rendered
What a screen reader actually getsRead out of Google's own Image options → Alt text panel, not from our code.
Round trip
Not covered by these shots: the CodeCogs server-renderer path (the 2026-09-15 comment covers it and nothing in this revision changed it), and case 4's empty-suffix fallback, which the test suite asserts but I did not photograph. 🤖 Generated with Claude Code |


























Human intent
Make Google Docs equations accessible by default, with no extra setting. Use raw LaTeX as fallback alt text, automatically recognize custom descriptions, and explain support in the Google Sites FAQ.
What changed
_{description}provides a custom description:$$x^2$$_{x squared}.Validation
npm test: 54 passing, including default-on scanning, raw fallback, custom metadata rollback, and single/all round trips.git diff --checkpassed.master, so it carries the Inline-fragmentation fix from Fix inline MathJax equations losing terms #71;npm testis 159 passing.Website FAQ
Published and verified the alt-text note at https://www.autolatex.com/faq. It labels automatic alt text as coming in the next Docs update until this PR is released. Existing FAQ text was preserved; Google Sites publish review listed only the FAQ page.
Release status
Docs Marketplace remains v95. This PR updates the upcoming Docs release; it does not change the already-published Slides v15.