diff --git a/README.md b/README.md index 72f3f88..e79c861 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,7 @@ The examples below show how to use and configure MathJax components in your web * [tex-mml.html](tex-mml.html.md) ([View Demo](https://mathjax.github.io/MathJax-demos-web/tex-mml.html)) * [mml-attribute.html](mml-attribute.html.md) ([View Demo](https://mathjax.github.io/MathJax-demos-web/mml-attribute.html)) * [speech-tex-chtml.html](speech-tex-chtml.html.md) ([View Demo](https://mathjax.github.io/MathJax-demos-web/speech-tex-chtml.html)) +* [speech-explorer-tex.html](speech-explorer-tex.html.md) ([View Demo](https://mathjax.github.io/MathJax-demos-web/speech-explorer-tex.html)) ### Customization @@ -55,6 +56,11 @@ The examples below show how to use and configure MathJax components in your web * [custom-component](custom-component/custom-component.html.md) ([View Demo](https://mathjax.github.io/MathJax-demos-web/custom-component/custom-component.html)) * [custom-build](custom-build/custom-mathjax.html.md) ([View Demo](https://mathjax.github.io/MathJax-demos-web/custom-build/custom-mathjax.html)) +### Speech Output Demo + +* [convert-with-speech](speech-generator/convert-with-speech.html) A lab to explore all possible speech options in MathJax. + + ## MathJax Component Files MathJax version 3 has the ability to create MathJax "components" that can be dynamically loaded by MathJax as needed (much as could be done in version 2). This allows portions of MathJax to be bundled together into components that include most or all of what you need to run MathJax, but still allows less-used pieces to be loaded on demand later when needed. This is similar to v2's combined configuration files and TeX extensions. diff --git a/speech-explorer-tex.html b/speech-explorer-tex.html new file mode 100644 index 0000000..92e352c --- /dev/null +++ b/speech-explorer-tex.html @@ -0,0 +1,52 @@ + + + + + + + + MathJax v3 with TeX input and HTML output with speech + + + + + + +

+ These expressions will have auto-generated speech attached for screen readers. Focus on a formula and press Enter to start exploration with the arrow keys. +

+ +

+ When $a \ne 0$, there are two solutions to \(ax^2 + bx + c = 0\) and they are + $$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$ +

+ + + diff --git a/speech-explorer-tex.html.md b/speech-explorer-tex.html.md new file mode 100644 index 0000000..514dc72 --- /dev/null +++ b/speech-explorer-tex.html.md @@ -0,0 +1,27 @@ +# [speech-expolrer-tex.html](https://mathjax.github.io/MathJax-demos-web/speech-explorer-tex.html) + +This example shows how to enable MathJax's accessibility extension to attach speech to typeset math and enable interactive exploration of expressions. + +The key lines are + +``` html + + +``` + +which causes the `a11y/sre` extension to be loaded, and modifies the menu settings to initialise the interactive explorer on page load. In addition we can switch off the assistive mml extension as it is no longer needed. + +[Run the example](https://mathjax.github.io/MathJax-demos-web/speech-explorer-tex.html) diff --git a/speech-generator/convert-with-speech.html b/speech-generator/convert-with-speech.html index 37307e6..f0d46a8 100644 --- a/speech-generator/convert-with-speech.html +++ b/speech-generator/convert-with-speech.html @@ -8,7 +8,7 @@ ``` -which causes the `a11y/semantic-enrich` extension to be loaded, and modifies the enrich action to force the enrichment regardless of the settings in the contextual menu. The output jax will pick on on the speech text that is generated by the extension and create the proper tags and attributes for it to be picked up by screen readers. +which causes the `a11y/semantic-enrich` extension to be loaded, and modifies the enrich action to force the enrichment regardless of the settings in the contextual menu. The output jax will pick up on the speech text that is generated by the extension and create the proper tags and attributes for it to be picked up by screen readers. [Run the example](https://mathjax.github.io/MathJax-demos-web/speech-tex-chtml.html) diff --git a/tex-mml.html.md b/tex-mml.html.md index 1413dba..5470e00 100644 --- a/tex-mml.html.md +++ b/tex-mml.html.md @@ -47,11 +47,6 @@ The key lines are (doc) => {for (math of doc.math) {MathJax.config.renderMathML(math, doc)}}, (math, doc) => MathJax.config.renderMathML(math, doc) ] - }, - menuOptions: { - settings: { - assistiveMml: false - } } }, //