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.
- Skip to Main Content
Repeatedly pressing the
Tabkey 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
Tabwill present a link labeled
Skip to Main Contentwhich 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
<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
@altattribute 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
mbxscript 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.10.4.
Section 6.5 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 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