Accessibility Statement
One of the reasons I blog is because I love to share weird niche things I learned, and to hopefully find other people with similar interests. It would be dissapointing if accessibility issues got in the way of that.
This site is committed to providing an experience that functions for the widest possible audience, regardless of technology or ability. I strive to meet the WCAG 2.2 level AA guidelines by default. If, for some reason, you actually care about my content (thank you!) and need certain level AAA accommodations, please email me and we can figure something out.
Of course, I'm human and I make mistakes. I use pa11y-ci
and aXe scans to help add some level of
automation, and I try to test this website on Chromium, Firefox, and Safari. If you find any
issues I missed, please email me or write a Github issue so we can get it resolved.
Math Accessibility Instructions
I unfortunately was not able to find a definitive answer for what the best way to render accessible math on the web was. For example, while many mailing lists seem to suggest MathJax is the golden standard for accessible math rendering, I had trouble using explorer mode on Orca (though this might just be my unfamiliarity with the tool).
To solve this, I added the ability to change whether Math is rendered into regular MathML or as enhanced MathJax as a site-level setting. You should pick the option that is most convenient for you. All math is rendered as MathML if JavaScript is disabled.
If you decide to stick with MathJax, you should know that it has a very customizable experience through a context menu exposed on any math expression. I encourage you to explore and pick settings that work for you.
Known Issues
-
Issue: The MathJax context menu does not show up while using the "Comment Preview" functionality in the comment form. This is because the context menu implementation does not seem to account for HTML dialog elements.
Workaround: You can still use the MathJax context menu on math present in the blog post itself, or on other users' comments. Any accessibility settings set there should carry over to math displayed in the "Comment Preview" dialog.