diff --git a/assets/pg/Student_Orientation/discriminant.png b/assets/pg/Student_Orientation/discriminant.png new file mode 100644 index 0000000000..636d7719af Binary files /dev/null and b/assets/pg/Student_Orientation/discriminant.png differ diff --git a/assets/pg/Student_Orientation/enteringMath.pg b/assets/pg/Student_Orientation/enteringMath.pg index 8db6992a59..0e20c0d9fc 100644 --- a/assets/pg/Student_Orientation/enteringMath.pg +++ b/assets/pg/Student_Orientation/enteringMath.pg @@ -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: diff --git a/assets/pg/Student_Orientation/explorerfull.png b/assets/pg/Student_Orientation/explorerfull.png index c791cefdaf..a563a3b4e7 100644 Binary files a/assets/pg/Student_Orientation/explorerfull.png and b/assets/pg/Student_Orientation/explorerfull.png differ diff --git a/assets/pg/Student_Orientation/explorerpiece.png b/assets/pg/Student_Orientation/explorerpiece.png index c47d879cb7..36c4b884d5 100644 Binary files a/assets/pg/Student_Orientation/explorerpiece.png and b/assets/pg/Student_Orientation/explorerpiece.png differ diff --git a/assets/pg/Student_Orientation/mathInteraction.pg b/assets/pg/Student_Orientation/mathInteraction.pg index f8f0c11fc5..162750be9e 100644 --- a/assets/pg/Student_Orientation/mathInteraction.pg +++ b/assets/pg/Student_Orientation/mathInteraction.pg @@ -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