Skip to content

Commit 5d94296

Browse files
committed
Update some wording in the accessibility pages
1 parent fb5b9c4 commit 5d94296

File tree

2 files changed

+24
-19
lines changed

2 files changed

+24
-19
lines changed

basic/a11y-extensions.rst

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ MathJax offers accessibility support via its own built-in extensions
99
that provide a choice of support options as well as a high degree of
1010
personalization. The extensions can be activated either via the
1111
context menu, which itself is fully accessible, or a page author can
12-
control the default settings using the Mathjax configuration object.
12+
control the default settings using the MathJax configuration object.
1313
When the menu component is available, configuration should be done
1414
using the :ref:`MathJax menu options <menu-options>`, otherwise use
1515
the :ref:`accessibility options <accessibility-options>`.
@@ -84,18 +84,18 @@ the |bkey| S |ekey| key.
8484
There are a number of different rule sets that can be chosen for
8585
translating math to text, where each can have a number of different
8686
preferences for how a particular expression is spoken. By default,
87-
MathJax uses `ClearSpeak`, however, the `Speech` sub-menu allows
88-
also provides the `MathSpeak` option.
89-
90-
Each rule set has several different preference settings; three in the
91-
case of MathSpeak, for example, which primarily influence the length
92-
of produced text. ClearSpeak,
93-
on the other hand, has a large number of preferences that allow very
94-
fine-tuned control over how different types of expressions are
95-
spoken. The MathJax menu allows a smart choice of preferences by only
96-
displaying the preferences that are relevant for the sub-expression
97-
that is currently selected. The `Select Preferences` option opens a
98-
selection box for all possible ClearSpeak preference choices.
87+
MathJax uses `ClearSpeak`, however, the `Speech` sub-menu also
88+
provides the `MathSpeak` option.
89+
90+
Each rule set has several different preference settings --- three in
91+
the case of MathSpeak, for example, which primarily influence the
92+
length of the speech text that it produces. ClearSpeak, on the other
93+
hand, has a large number of preferences that allow very fine-tuned
94+
control over how different types of expressions are spoken. The
95+
MathJax menu allows a smart choice of preferences by only displaying
96+
the preferences that are relevant for the sub-expression that is
97+
currently selected. The `Select Preferences` option opens a selection
98+
box for all possible ClearSpeak preference choices.
9999

100100
Some rule-set and preference settings can be controlled by keyboard
101101
commands. This allows the user to have the same expression read in
@@ -116,8 +116,8 @@ underlying LaTeX expressions, when available, as is currently being
116116
taught in gradeschools in a number of European countries.
117117

118118
In addition to voicing the sub-expressions during exploration, the
119-
explorer allows for queries on sub-expression, such as getting
120-
positional information with respect to the context, as well as
119+
explorer allows queries on sub-expressions, such as getting positional
120+
information with respect to the context, as well as obtaining
121121
summaries of the sub-expression currently being explored. See the
122122
:ref:`explorer-commands` section for details.
123123

@@ -130,7 +130,7 @@ Highlighting
130130
During interactive exploration, the sub-expression that is being
131131
explorered is automatically highlighted, by default with a blue
132132
background color. The highlighting can be customized by changing
133-
`Background` or `Foreground` colors in in the `Highlight` sub-menu of
133+
`Background` or `Foreground` colors in the `Highlight` sub-menu of
134134
the `Explorer` section of the MathJax contextual menu. In addition,
135135
the opacity of both `Background` and `Foreground` can be adjusted by
136136
two slider bars underneath the respective sub-menus.
@@ -185,7 +185,7 @@ hovering over it with the mouse pointer. The choices here are:
185185
is dependent on the context of a sub-expression in the overall expression.
186186
* `Prefix`
187187
is information pertaining to the position of a
188-
sub-expression. Examples are ``'exponent'``, ``'radicand'``, etc. These would
188+
sub-expression. Examples are ``exponent``, ``radicand``, etc. These would
189189
also be spoken during interactive exploration.
190190

191191
For more details on all of these concepts, see also the documentation of the
@@ -213,7 +213,7 @@ return the expression to its original form. Collapsible expressions
213213
can also be discovered using some of the highlighting features, as
214214
described above.
215215

216-
The ability to collapse sub-expressinos is controlled by the
216+
The ability to collapse sub-expressions is controlled by the
217217
`Collapsible Math` setting in the `Options` sub-menu of the MathJax
218218
contextual menu. This feature is off by default, but can be selected
219219
by the user, or the default can be changed by the page author using

basic/explorer-commands.rst

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Advanced Keys
9696
possible. The speech-text is regenerated to match.
9797

9898
|bkey| Home |ekey|
99-
Jump directly to the top-most level of expression.
99+
Jump directly to the top-most level of the expression.
100100

101101
-----
102102

@@ -174,4 +174,9 @@ In that case, you will have to enter focus mode manually in order to
174174
use the explorer. How this is done depends on the screen reader, so
175175
consult its documentation for details.
176176

177+
Once the focus mode is started, you may need to exit focus mode
178+
manually when you are done exploring the expression. How that is done
179+
depends on the screen reader, so consult the reader's documentation
180+
for details on how to accomplish that.
181+
177182
|-----|

0 commit comments

Comments
 (0)