Skip to main content
\( \newcommand{\lt}{<} \newcommand{\gt}{>} \newcommand{\amp}{&} \)


Continuing our discussion from Section 3.24 we begin by listing features of our conversion to HTML which happen automatically.


Wherever possible we supply HTML elements and class names that will be interpreted sensibly by a screen reader in the absence of styling provided by CSS.


MathJax ( is the JavaScript library we use to render mathematics. It provides extensive capabilities for screen readers to render the mathematics audibly, and by default your document is configured to take advantage of these features. We refer the reader to the MathJax documentation of Accessibility Features at

Skip to Main Content

Repeatedly pressing the Tab key will move a reader from one location to the next in a web document. Since your Table of Contents in the left sidebar is a series of many links, a reader will need to tab through all of these to eventually reach the interesting content on a page.

However, we support a common device. The first link on every page is hidden from all readers, but an initial Tab will present a link labeled Skip to Main Content which when executed will take the reader past the Table of Contents and to the start of the content at the top of the page.


We are sensitive to the fact that some readers have difficulty distinguishing between certain colors. So we do our best to distinguish text, or other elements, without relying exclusively on color. For example, the <delete> and <insert> elements may render text with strike-through and underlining (respectively) to show the distinction.

Here are features which are provided, but require your participation as the author.

Image Description

Images you author or supply will be invisible to some readers. Within every <image> element you can use a <description> element. The content here will migrate to places like the HTML @alt attribute to be picked up by screen readers.

Make the content very expressive and detailed, but also do not use any markup whatsoever, just simple characters, and avoid quotation marks.

Image Formats

University offices that provide services for students with disabilities are often interested in the images themselves from a text, as standalone files. You could use the mbx script to produce a variety of different formats and bundle these up in a single archive file for distribution at your book's website. Or you can make each image available through adjacent links placed automatically. We call these “image archives.” See Subsection 6.9.4.


Section 6.4 describes a variety of ways to customize the look and content of a cross-reference. You can create a larger target for clickable items by making the text as long as possible. So for example an <xref> authored as

<xref ref="theorem-FTC" text="type-global" />

would cause the clickable portion to be something like “Theorem 5.16”, whereas

<xref ref="theorem-FTC" text="global" />

would then cause the clickable portion to be simply the much shorter “5.16”. Of course, you can set a default style for your entire document, so it is not necessary to continually provide the @text attribute.