a11y-slides-math

HTML template to write accessibility-oriented slides with symbolic mathematical content rendered using MathJax.

usage/getting started

You can view the template at a11y-slides-math-template.html, and use the LEFT and RIGHT arrow keys to navigate through.

You can edit the template by downloading the file a11y-slides-math-template.html and edit it as you see fit. You'll find the necessary Javascript and CSS at the bottom of the file.

You can navigate through the slides using the LEFT and RIGHT arrow keys.

version

V0.4, 2024-11-19

testing with NVDA

To test a11y-slides-math-template.html with NVDA, use the following steps:

1. open a11y-slides-math-template.html in your web browser (I recommend Chrome or Firefox, but others should work also);
2. launch NVDA, note that the default NVDA key is the INSERT key, and that this can be changed;
3. navigate through the first slide using the UP and DOWN arrow keys; on each slide, you should hear the text from the <h1> announced;
4. press NVDA+SPACE to exit focus mode, and you can now navigate through the slides by using the RIGHT and LEFT arrows;
5. when you want to interrogate a slide, press NVDA+SPACE to enter focus mode, and then use the UP and DOWN arrows to interrogate the details of the slide;
6. on slide 3 of a11y-slides-math-template.html you will encounter some symbolic mathematical content:
   • when you reach the mathematical content, press ENTER;
   • now press SHIFT+SPACE which should allow you to interrogate this mathematical content at different levels using the arrow keys via the MathJax explorer extension; press SPACE to have NVDA announce your current level;
   • when you're done interrogating the mathematical content, press ESC, and then NVDA+CTRL+SPACE, which should return you to the next part of the slide;
7. if you want to exit/quit NVDA, press NVDA+Q.

For reference, see the NVDA keyboard shortcuts.

assumptions about users of this

I assume the following two assumptions about users of this template:

1. they wish to prioritise accessibility;
2. they only wish to do the work of creating their slides once.

anticipated questions, and responses

I'm happy with the way I produce my slides, why should I use this?

If you're happy with your method, keep using your method, and don't use this template.

why not LaTeX?

Before I answer, please understand that I am a supporter of LaTeX; see my tex stackexchange profile at cmhughes, and latexindent.pl which I have authored and maintained since 2012.

LaTeX produces pdf files by default. Such pdf files that contain mathematical content will, in general, not be accessible to assistive technology. Authors that choose to use LaTeX (with classes such as beamer) will have to do the work of creating their slides more than once if they wish to create an accessible version. If you have a method that you're happy with, stick with it.

why not PowerPoint?

I have been unable to create PowerPoint slides that I can navigate with assistive technology. If you have an example that works, please do link me to them.

why not reveal js?

I have been unable to create reveal.js slides that I can navigate with assistive technology. If you have an example that works, please do link me to them.

why not dzslides?

I have been unable to create dzslides slides that I can navigate with assistive technology. If you have an example that works, please do link me to them.

how can I get my LaTeX/PowerPoint/whatever into a11y-slides-math format?

I have no idea, and that's not what this project is about. I only want to do work once (see assumption 2 in the above), so I produce my slides in a11y-slides-math format.

what about fancy transitions and visual effects?

a11y-slides-math is not about fancy transitions and visual effects. If you want something more visually appealing, you can edit the CSS and Javascript as you see fit, or use something like reveal.js or dzslides.

a11y-slides-math is deliberately simple HTML with minimal Javascript and CSS, designed to be navigated with assistive technology. I intend to keep it that way, prioritising accessibility and screen reader navigability above everything else.

printing your slides

If you press SHIFT+P then all slides will be presented in your browser. From here, you should be able to print to pdf, and you should receive one slide per page in the pdf.

examples

You can find further examples in the following files:

• 1-example.html, automatically numbering slides
• 2-example.html, automatically numbering examples
• 3-example.html, automatically numbering examples and theorems

See the examples directory to download the files for the above.

acknowledgements

This project is based on the work of Utibe Udoma posted at How to build a slideshow using HTML, CSS, and JavaScript