Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added assets/pg/Student_Orientation/discriminant.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions assets/pg/Student_Orientation/enteringMath.pg
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,9 @@ expression automatically is converted to look like [::pi/sqrt(x+1)::]. [_]{Conte

Occasionally you will want to answer with raw text that should not be converted into a math expression. For example, if
the answer is a word. For this kind of answer, you should enter "text mode". There is a "Tt" button on the palette that
enters and exits text mode. You can also use the [|"|]* character to enter text mode, and then exit with the [|tab|]*
key or right arrow. Try answering the following with and without using text mode. The answer is [|pirate|]*:
[_]{Context("Numeric")->strings->add(pirate => {}), 'pirate'}{16}.
enters and exits text mode. You can also use the double quote character ([|"|]*) to enter text mode, and then exit with
the [|tab|]* key or right arrow. Try answering the following with and without using text mode. The answer is [|web|]*:
[_]{Context("Numeric")->strings->add(web => {}), 'web'}{16}.

The palette tool might be a distraction, especially to keyboard-only users. You can disable it by right-clicking (or
control-clicking) in an answer blank. To "right click" without a mouse:
Expand Down
Binary file modified assets/pg/Student_Orientation/explorerfull.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/pg/Student_Orientation/explorerpiece.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
51 changes: 34 additions & 17 deletions assets/pg/Student_Orientation/mathInteraction.pg
Original file line number Diff line number Diff line change
Expand Up @@ -30,31 +30,48 @@ It should look like the following.

There are many features that help you to engage with math content. Explore the menu options to survey what is available.

We will now point out a few important features. In the main menu, there is a "Math Settings" submenu. The "Zoom Trigger"
and "Zoom Factor" items allow you to control if/how math content is magnified. Magnification may help users with some
vision disabilities see the content better. And it may help all users to see some details of math notation better. Take
a moment to explore these settings and select options that you would be comfortable with. (Of course you can change
these settings at any time.)
### Enlarging Math

In the main menu, there is a "Math Settings" submenu. The "Zoom Trigger" and "Zoom Factor" items allow you to control
if/how math content is magnified. Magnification may help users with some vision disabilities see the content better.
And it may help all users to see some details of math notation better. Take a moment to explore these settings and
select options that you would be comfortable with. (Of course you can change these settings at any time.)

### Navigating Math

When focus is on a piece of math content, there is a small help icon in the upper right. Click this icon to see a guide
for how to navigate inside the math content. This can help you understand the meaning of the math content. For example,
here we have navigated to the piece of math content inside the radical:

[!Highlighting the discriminant in the quadratic formula!]{'discriminant.png'}{600}

### Subtitles for Math

Also in the main menu, there is an "Accessibility" submenu. Accessibility is enabled by default, but you can also select
"Show Subtitles" in the "Speech" submenu. This allows you to see math content verbalized. To do this, place focus onto
a math expression and hit [|enter|]*.
* At first, the entire expression is highlighted and there will be a verbal rendering of the expression.
[!Speech string for the quadratic formula!]{'explorerfull.png'}{600}
* Use the down arrow to navigate "down" into a smaller piece of the math expression.
* Use the left/right arrows to navigate to similar pieces of the math expression.
* At any time you can navigate back "up" to a larger part of the expression, or "down" into smaller pieces. For example,
you can see a verbalization for just this part of the expression above:
[!Speech string for the radicand of the quadratic formula!]{'explorerpiece.png'}{600}
* Return to the MathJax menu, Accessibility submenu, to explore options for how this explorer tool works.
* Under "Speech" you will find options for MathSpeak and ClearSpeak rules. The default is to use "MathSpeak verbose"
a math expression and hit [|enter|]*. At first, the entire expression is highlighted and there will be a verbal
rendering of the expression.
[!Speech string for the quadratic formula!]{'explorerfull.png'}{735}

As you navigate within the math using arrows, you can see verbalizations of the corresponding pieces:

[!Speech string for the radicand of the quadratic formula!]{'explorerpiece.png'}{735}

Under "Speech" you will find options for MathSpeak and ClearSpeak rules. The default is to use "MathSpeak verbose"
rules, which try try to read math "literally" without context. For example, it reads [`(1,3)`] as "left parenthesis 1
comma 3 right parenthesis". Other speech rules can produce more meaningful verbal renderings. For example with the right
ClearSpeak settings, the same math expression produces "the point with coordinates 1 comma 3" or "the interval from 1 to
3 not including 1 or 3".
3 not including 1 or 3".

### Voicing Math Out Loud

When focus is on math content, use the [|s|]* character to hear the math spoken. If you would like math to always be
spoken whenever focus lands on math, check Auto Voicing in the Speech menu.

### Disabling Tab Indexing

Some keyboard-navigating users might find it undesirable for each piece of math content to be tab-indexed. If this is
the case, then in the "Options" sub menu of the "Accessibility" submenu you can uncheck "Include in Tab Order" and
the case, then in the "Options" submenu of the "Accessibility" submenu you can uncheck "Include in Tab Order" and
"Semantic Enrichment". Just note that in order to undo this and make math content tabbable again, you will need to
access the menu, and so you will need some way other than tabbing to bring focus back to a piece of math content.
END_BODY
Expand Down
Loading