basica11y

basic + accessibility

  • they/them

I have been working in accessible web design and software development since 2014 or so. I thought it would be a good idea to maybe share some of what I know here!

Avatar is by Dave Braunschweig and licensed under the Creative Commons Attribution-Share Alike 4.0 International license

posts from @basica11y tagged #text alternatives

also:

Image Description Guidelines from DIAGRAM

DIAGRAM (or Digital Image And Graphic Resources for Accessible Materials) is a research center that produced one of the most useful image description guidelines for both the fundamentals of image description and the more advanced, complex image description that you encounter in higher education. I used these for describing everything from classic art pieces to chemistry flowcharts.

In some ways, you are participating in some high level Design Thinking when you are writing image descriptions. You are not just thinking of the physical characteristics of what you are looking at - you are thinking about the authorial intent, the intended audience, the function, the semantic impact of the image, and more. It can be pretty intimidating! Which is why we have these sorts of handbooks. It takes skill and practice, though if you are the actual author, you can avoid having to reverse engineer the intent, which is often the hardest part of image description.

MathSpeak™ Core Specification Grammar Rules

SeeWriteHear stewards what I knew as gh's MathSpeak. This is a set of grammar rules for verbally describing math which is based on the Nemeth Code used for braille math. Interestingly, this is what taught me about how poorly constructed visual math is- translating it into a parseable set of linearly read grammar rules is a nightmare, due to the adhoc way symbols are incorporated or repurposed to mean entirely different things depending on the context of the math.

I had to learn MathSpeak so I could write the alt text (not literally held in alt attributes, but actually visually hidden text in HTML documents) for math equations that were rendered using SVGs - entirely a backwards way of making robust digital math in some ways, but necessary when students needed access to their homework and couldn't wait for browser vendors to support MathML or for screen reader software developers to do the browser vendor's work for them.

Learning MathSpeak is useful for double-checking the way you have written your MathML or how your MathML is being rendered, because what looks visually correct can often have semantically drastically different meanings, which is extremely dicey when it comes to math homework!



WCAG 2.1: Understanding Success Criterion (SC) 1.1.1 (Level A)

All non-text content that is presented to the user has a text alternative that serves the equivalent purpose...

Situation B: If a short description can not serve the same purpose and present the same information as the non-text content (e.g., a chart or diagram):...

WCAG 2.1: Sufficient Technique G74

G74: Providing a long description in text near the non-text content, with a reference to the location of the long description in the short description

Also consider:

WCAG 2.1: Understanding SC 1.3.1: Info and Relationships (Level A)

The intent of this Success Criterion is to ensure that information and relationships that are implied by visual or auditory formatting are preserved when the presentation format changes. For example, the presentation format changes when the content is read by a screen reader or when a user style sheet is substituted for the style sheet provided by the author.

Situation A: The technology provides semantic structure to make information and relationships conveyed through presentation programmatically determinable:

WCAG 2.1: Sufficient Technique G115: Using semantic elements to mark up structure

MathML, a markup language designed to maintain important distinctions between structure and presentation in mathematics, includes special "presentation" markup for the complex notations used to represent mathematical ideas as well as "content" (semantic) markup for the mathematical ideas themselves.

MathType full demo, with copyable text that pastes as full MathML

MathJax demo, where you can paste and render both LaTex and MathML to see how your MathML can render using a common online math polyfill