Skip to content

fix: accessibility for MathJax SVG equations - #77

Merged
a-b-lowcarb merged 2 commits into
devfrom
fix/mathjax-svg-accessibility
Sep 11, 2026
Merged

a-b-lowcarb merged 2 commits into
devfrom
fix/mathjax-svg-accessibility

Conversation

@harrison-lccc

Copy link
Copy Markdown
Collaborator

Summary

Adds a rehype post-processor for MathJax SVG output to resolve missing accessible-name violations identified by the documentation accessibility audit.

Changes

  • Adds role="math" to MathJax containers and generated SVGs.
  • Adds accessible SVG labels with metadata-based and fallback values.
  • Sets generated SVGs to focusable="false".
  • Hides decorative SVG drawing primitives from assistive technology.
  • Runs the accessibility plugin after rehypeMathjax.

Verification

  • npm run build passes in docs/web.
  • Verified the local dev server and affected Logistic Power Curve page in a browser.
  • Confirmed generated MathJax output includes math roles, accessible labels, and hidden decorative nodes.

Closes #76.

@harrison-lccc
harrison-lccc requested a review from a team September 8, 2026 13:02
@harrison-lccc harrison-lccc changed the title Fix accessibility for MathJax SVG equations fix: accessibility for MathJax SVG equations Sep 8, 2026

@fcubuk-lccc fcubuk-lccc left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 👍

@a-b-lowcarb
a-b-lowcarb merged commit 2e91f9c into dev Sep 11, 2026
2 checks passed
@harrison-lccc
harrison-lccc deleted the fix/mathjax-svg-accessibility branch September 22, 2026 08:49
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.

5 participants