Skip to main content

Getting Started with PreTeXt

Section Accessibility FAQ

Is PreTeXt WCAG-compliant?
The HTML output is designed to meet WCAG 2.1 Level AA, and the community takes this seriously. But compliance is ultimately a property of a specific document, not of a tool. If an author skips alt text, no toolchain can compensate.
Isnโ€™t a PDF from accessible enough?
Accessible PDFs are possible but genuinely difficult to produce well from , and the result is often imperfect. HTML is fundamentally a more accessible format: it reflows, works natively with screen readers, and adapts to user preferences for font size and contrast. Generating HTML from the same PreTeXt source costs you nothing extra.
Does PreTeXt really produce Braille?
Yes, from the same source file. Formulas are rendered in Nemeth Code, and tactile diagrams can be generated automatically from structured figures. If you write mathematical images with PreFigure, that same source can produce the visual figure, a tactile diagram, and accessibility annotations for the image. The PreTeXt section on PreFigure shows how this fits into a PreTeXt project. The approach has been validated on full-length textbooks in abstract algebra and calculus, with quality checked by a certified transcriber and readability confirmed by a blind mathematician.
If screen readers can read math aloud, why does Braille still matter?
Because mathematicians read math by looking back and forth, comparing pieces, holding sub-expressions in view. Braille gives a blind reader the same tactile access.
Do I need to learn accessibility standards to use this well?
No. The authoring practices in What You, the Author, Must Do are your primary responsibilities. You donโ€™t need to study WCAG to produce accessible output.
Who decides what โ€œaccessible enoughโ€ means for my course?
Ultimately your institution and your students. PreTeXt gives you a document that is accessible by default and easy to improve where it matters most. For specific student accommodations, work with your campus disability services. The HTML, EPUB, and Braille outputs will cover most common needs out of the box.
Whatโ€™s my actual responsibility as an author?
Write alt text for images, and design images so they work without color. That is essentially the whole list.
How do I write alt text in PreTeXt?
Every non-decorative image needs a <shortdescription>: plain text, no markup, no quotation marks, under about 125 characters. Complex images can also include a <description> with paragraphs and even math, which screen readers read as a longer alternative.
Why canโ€™t PreTeXt generate alt text automatically?
Because image descriptions depend on author intent and context. The same graph might be described one way in a section about asymptotes and another way in a section about symmetry. No tool can reliably make that call.
What about using color in figures?
Donโ€™t rely on color alone. If you ask students to compare the red and green curves, add a second distinguishing feature. For example, dashing, thickness, or labels. A quick test: view your image in black and white and check that it still conveys the intended information.
Can I produce Braille with PreTeXt.Plus?
No. Producing Braille involves additional tools beyond the setup weโ€™re using. The capability exists and the HTML you build today is already screen-reader accessible. Braille is a next step for instructors who need it.
Does PreTeXt align with the recent accessibility requirements?
Yes. Many US institutions are now required to ensure accessibility of all online materials, including content posted in an LMS like Canvas or Blackboard. PreTeXt is well-positioned for this: you can deploy the HTML publicly, or export a single portable HTML file that uploads directly to an LMS.
What about EPUB for students who want to read on a tablet or e-reader?
Produced from the same source. EPUB reflows, supports screen readers, and works across the major e-reader apps.
Are interactive elements accessible?
Native PreTeXt exercise types (multiple choice, true/false, fill-in) are generally accessible. Embedded third-party interactives (GeoGebra, Desmos, DoenetML) inherit the accessibility of those platforms, which varies. For critical content, consider including an image or text description as a fallback.