Skip to content

Commit

Permalink
User guide: Update the section on reading math to recommend MathCAT, …
Browse files Browse the repository at this point in the history
…and also clarify some information about MathPlayer. (#16062)

Fixes #16036
Fixes #15352

Summary of the issue:
When reading the section of the User guide about Math support, and then the MathPlayer page from Wiris, it is unclear as to whether MathPlayer is actually needed for NvDA unless you are using an older browser such as Internet Explorer 8.
Also, Nthe User Guide does not recommend let alone mention, MathCAT, which is now the replacement for the older and unmaintained MathPlayer.

Description of user facing changes
Update the math section in the User guide to mention and recommend MathCAT, and clarify that MathPlayer is still relevant on newer browsers.
  • Loading branch information
michaelDCurran authored Jan 22, 2024
1 parent b27ee1e commit 8e6fa2d
Showing 1 changed file with 24 additions and 8 deletions.
32 changes: 24 additions & 8 deletions user_docs/en/userGuide.t2t
Original file line number Diff line number Diff line change
Expand Up @@ -915,12 +915,14 @@ Also, although the application will try its best to match the native selection t
However, for scenarios where you wish to copy an entire table or paragraph of rich content, this feature should prove useful.

+ Reading Mathematical Content +[ReadingMath]
Using MathPlayer 4 from Design Science, NVDA can read and interactively navigate supported mathematical content.
This requires that MathPlayer 4 is installed on the computer.
MathPlayer is available as a free download from the [MathPlayer information page https://info.wiris.com/mathplayer-info].
After installing MathPlayer, restart NVDA.

NVDA supports the following types of mathematical content:
NVDA can read and navigate mathematical content on the web and in other applications, providing access in both speech and braille.
However, in order for NVDA to read and interact with mathematical content, you will first need to install a Math component for NvDA.
There are several NVDA add-ons available in the NVDA Add-on Store that provide support for math, including the [MathCAT NVDA add-on https://nsoiffer.github.io/MathCAT/] and [Access8Math https://github.com/tsengwoody/Access8Math].
Please refer to the [Add-on Store section #AddonsManager] to learn how to browse and install available add-ons in NVDA.
NVDA also can make use of the older [MathPlayer https://info.wiris.com/mathplayer-info] software from Wiris if found on your system, though this software is no longer maintained.

++ Supported math content ++[SupportedMathContent]
With an appropriate math component installed, NVDA supports the following types of mathematical content:
- MathML in Mozilla Firefox, Microsoft Internet Explorer and Google Chrome.
- Microsoft Word 365 Modern Math Equations via UI automation:
NVDA is able to read and interact with math equations in Microsoft Word 365/2016 build 14326 and higher.
Expand Down Expand Up @@ -959,15 +961,29 @@ By default, the review cursor follows the system caret, so you can usually use t
| Interact with math content | NVDA+alt+m | Begins interaction with math content. |
%kc:endInclude

At this point, you can use MathPlayer commands such as the arrow keys to explore the expression.
At this point, NVDA will enter Math mode, where you can use commands such as the arrow keys to explore the expression.
For example, you can move through the expression with the left and right arrow keys and zoom into a portion of the expression such as a fraction using the down arrow key.
Please see the [MathPlayer documentation https://docs.wiris.com/mathplayer/en/mathplayer-user-manual.html] for further information.

When you wish to return to the document, simply press the escape key.

For more information on available commands and preferences for reading and navigating within math content, please refer to the documentation for your particular math component you have installed.
- [MathCAT documentation https://nsoiffer.github.io/MathCAT/users.html]
- [Access8Math documentation https://github.com/tsengwoody/Access8Math]
- [MathPlayer documentation https://docs.wiris.com/mathplayer/en/mathplayer-user-manual.html]
-

Sometimes mathematical content might be displayed as a button or other type of element which, when activated, can display a dialog or more information related to the formula.
To activate the button or the element containing the formula, press ctrl+enter.

++ Installing MathPlayer ++[InstallingMathPlayer]
Although it is generally recommended to use one of the newer NVDA add-ons to support math in NVDA, in certain limited scenarios MathPlayer may still be a more suitable choice.
E.g. MathPlayer may support a particular language or Braille code that is unsupported in newer add-ons.
MathPlayer is available for free from the Wiris website.
[Download MathPlayer https://downloads.wiris.com/mathplayer/MathPlayerSetup.exe].
After installing MathPlayer, you will need to restart NVDA.
Please note that information about MathPlayer may state that it is only for older browsers such as Internet Explorer 8.
This is only referring to using MathPlayer to display mathematical content visually, and can be ignored by those using it to read or navigate math with NVDA.

+ Braille +[Braille]
If you own a braille display, NVDA can display information in braille.
If your braille display has a Perkins-style keyboard, you can also enter contracted or uncontracted braille.
Expand Down

0 comments on commit 8e6fa2d

Please sign in to comment.