Skip to content

Commit 6a54678

Browse files
authored
Merge pull request #261 from mathjax/v3.1-a11y
Inludes descriptions of the new accessibility options.
2 parents 0c1de39 + 983f4eb commit 6a54678

File tree

1 file changed

+15
-12
lines changed

1 file changed

+15
-12
lines changed

basic/a11y-extensions.rst

+15-12
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,8 @@ on the other hand has a large number of preferences that allow very fine-tuned
9898
control over how different types of expressions are spoken. The MathJax menu
9999
allows a smart choice of preferences by only displaying the preferences that
100100
are currently relevant for the sub-expression that is currently explored.
101+
The `Select Preferences` option opens a selection box for all possible
102+
ClearSpeak preference choices.
101103

102104
Some rule-set and preference settings can also be controlled by keyboard
103105
commands. This allows the user to have the same expression read in different
@@ -108,11 +110,10 @@ active rule set. For ClearSpeak rules, preference cycling depends on the type
108110
of the currently explored sub-expression, similar to smart selection of menu
109111
entries.
110112

111-
.. note::
112-
113-
MathJax currently only supports speech in English, French, and Spanish. The
114-
only available Braille output is Nemeth. We are hoping to add more in the
115-
future.
113+
The speech language can be adjusted in the `Language` sub-menu in the
114+
`Speech` options. MathJax currently only supports speech in English,
115+
French, German, and Spanish. The only available Braille output is
116+
Nemeth. We are hoping to add more in the future.
116117

117118
In addition to voicing expressions, the explorer allows for queries on
118119
sub-expression, such as getting positional information with respect to the
@@ -143,13 +144,15 @@ During interactive exploration, the sub-expression that is explorered is
143144
automatically highlighted, by default with a blue background color. The
144145
highlighting can be customized by changing `Background` or `Foreground`
145146
colors in in the `Highlight` sub-menu of the MathJax contextual menu.
146-
147-
In addition, there is choice of highlighters for marking collapsible
148-
sub-expressions: The `Flame` highligher permanently colors collapsible
149-
sub-expressions while successively darkening the background for nested
150-
collapsible expressions. The `Hover` highlighter colors each
151-
collapsible sub-expression only when hovering over it with the mouse
152-
pointer.
147+
In addition, the opacity of both `Background` and `Foreground` can be
148+
adjusted by two slider bars underneath the respective sub-menus.
149+
150+
The `Highlight` sub-menu also provides a choice of highlighters for
151+
marking collapsible sub-expressions: The `Flame` highligher permanently
152+
colors collapsible sub-expressions while successively darkening the
153+
background for nested collapsible expressions. The `Hover` highlighter
154+
colors each collapsible sub-expression only when hovering over it with
155+
the mouse pointer.
153156

154157
A final highlighting feature is `Tree Coloring`, in which expressions are
155158
visually distinguished by giving neighbouring symbols different, ideally

0 commit comments

Comments
 (0)