I am trying to resolve an issue when attempting to read math content served by MathJax with a synthetic speech application called Read & Write Gold by TextHelp. Information about this assistive technology can be found at http://www.texthelp.com/North-America/our-products/readwrite
I have not found an example of a MathJax page which will work correctly with Read & Write. To document the problem, I used the page
http://www.mathjax.org/demos/tex-samples/ and created a video showing what happens. The video is loaded at http://screencast.com/t/VR7tlrYUud
The problem is that the visual highlighting goes away when a math equation is encountered, and the math is not read correctly by the synthetic speech.
I am using IE 8 and MathPlayer 3 on a Vista computer, along with RWG 9.
After consulting with Neil Soiffer at Design Science he stated:
"I thought Davide worked on this. I remember both Robert and I came up with web pages where MathJax hid the math. Perhaps there is some MathJax setting that needs to be done."
Let me know what further information is needed, or if I should try something on my end.
Thanks much,
--Steve Noble
------------------------------------
-- Steve Noble
Chair, National Technology Task Force
Learning Disabilities Association of America
--------------
Disclaimer: The opinions and comments made in email are those of the author, and do not necessarily represent the official position of any organization unless explicitly stated.
RWG has supported MathPlayer for many years now, and works just fine with web pages containing math (e.g., XHTML+MathML). RWG works fine with either MP 2.2 or MP 3. I have been working closely with Neil Soiffer and the developers of RWG on testing and feedback for several years. The developers of RWG (TextHelp) have also tested MathJax pages with the standard shipping version of MathPlayer (2.2) and have confirmed the same "broken" behavior.
I went through my email and found this from Robert Miner. Perhaps this will give you more of a lead?
---
When I last tried to figure this out, it looked to me like it was something about the mathjax.org page template that was screwing things up. The way I remember it was that if I had a plain black on white HTML test page it worked fine. Thus, I don't think it was anything to do with MathJax configuration per se. But Neil remembers it differently.
A slightly more technical answer is that when there is an invisible layer in the HTML over a MathJax equation, clicks and AT software go to that layer (since it is on top) and don't see the math. MathJax's own menu is such a layer, and so the configuration setting in question is to disable that so that clicks and AT software see right through to the MathPlayer equation.
But no one has ever really gotten to the bottom of whether it is some interaction between MJ and the mathjax.org template that causes a layer to obscure the math, a MJ bug, or just something pathological about the mathjax.org template. I suppose it is on me to either debug it or find someone who can, and empower them to do so by lining up access to all the bits and pieces.
---
Does this help?
Can you point me to a site using the "accessible configuration" you mention. Why wouldn't the mathjax.org website be created with an accessible configuration? How can I persuade vendors to use MathJax for accessibility if the MathJax website itself in not accessible??
--Steve Noble
RWG has supported MathPlayer for many years now, and works just fine with web pages containing math (e.g., XHTML+MathML). RWG works fine with either MP 2.2 or MP 3. I have been working closely with Neil Soiffer and the developers of RWG on testing and feedback for several years. The developers of RWG (TextHelp) have also tested MathJax pages with the standard shipping version of MathPlayer (2.2) and have confirmed the same "broken" behavior.
I went through my email and found this from Robert Miner. Perhaps this will give you more of a lead?
---
When I last tried to figure this out, it looked to me like it was something about the mathjax.org page template that was screwing things up. The way I remember it was that if I had a plain black on white HTML test page it worked fine. Thus, I don't think it was anything to do with MathJax configuration per se. But Neil remembers it differently.
A slightly more technical answer is that when there is an invisible layer in the HTML over a MathJax equation, clicks and AT software go to that layer (since it is on top) and don't see the math. MathJax's own menu is such a layer, and so the configuration setting in question is to disable that so that clicks and AT software see right through to the MathPlayer equation.
But no one has ever really gotten to the bottom of whether it is some interaction between MJ and the mathjax.org template that causes a layer to obscure the math, a MJ bug, or just something pathological about the mathjax.org template. I suppose it is on me to either debug it or find someone who can, and empower them to do so by lining up access to all the bits and pieces.
---
Does this help?
Can you point me to a site using the "accessible configuration" you mention.
Why wouldn't the mathjax.org website be created with an accessible configuration? How can I persuade vendors to use MathJax for accessibility if the MathJax website itself in not accessible??
Hi Davide,
Thanks for taking the time to look into this. A few follow-up questions:
1) It sounds like no one knows of a single web site which uses the "accessible configuration" for MathJax which you mention. Since the MathJax.Org website makes a selling point about the accessibility of MathJax, why don't we have at least one example of such an "accessible configuration"? I strongly urge that one such example page is added to the "Demos" menu.
When you say…"So for these reasons, www.mathjax.org does not disable the contextual menu overlay in IE. This does have a negative impact on screen readers, but I don't really see a viable alternative at the moment"...it almost sounds like you are saying that it is impossible for *any* site to use an accessible configuration (without encountering major instability and performance issues) because of the problems you cite. If that is true, then the ramifications of this problem are much bigger than I had initially thought.
2) You suggested that I…" Use "config=Accessible" on the script that loads MathJax.js. For example:
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=Accessible"></script>
I am not sure that I understand what you are telling me to do. Are you saying I should make a local copy of one of the MathJax demo pages on my PC, and then substitute the line in your example and try viewing the revised page locally?
--Steve
From: Davide P.Cervone [mailto:dp...@union.edu]
Sent: Thursday, November 24, 2011 1:13 PM
To: mathja...@googlegroups.com; Noble,Stephen L.
Subject: Re: Problem/bug report: Using MathJax plus MathPlayer with Read & Write Gold
On Nov 18, 2011, at 9:33 AM, Noble,Stephen L. wrote:
1) It sounds like no one knows of a single web site which uses the "accessible configuration" for MathJax which you mention. Since the MathJax.Org website makes a selling point about the accessibility of MathJax, why don't we have at least one example of such an "accessible configuration"? I strongly urge that one such example page is added to the "Demos" menu.
When you say…"So for these reasons, www.mathjax.org does not disable the contextual menu overlay in IE. This does have a negative impact on screen readers, but I don't really see a viable alternative at the moment"...it almost sounds like you are saying that it is impossible for *any* site to use an accessible configuration (without encountering major instability and performance issues) because of the problems you cite. If that is true, then the ramifications of this problem are much bigger than I had initially thought.
2) You suggested that I…" Use "config=Accessible" on the script that loads MathJax.js. For example:<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=Accessible"></script>I am not sure that I understand what you are telling me to do. Are you saying I should make a local copy of one of the MathJax demo pages on my PC, and then substitute the line in your example and try viewing the revised page locally?
My observations are that we are "almost there."
I was able to get a degree of usability by using the MathJax context menu to serve the content as MathML (using IE8 plus MathPlayer),
and then selecting the setting to let MathPlayer handle mouse events (or whatever the exact wording is).
The problem I notice, though, is that Read & Write Gold will speak all the TeX code first before reading the MathPlayer text string, unless one moves the mouse directly onto the math equation. That is especially problematic with inline equations, since the literary text is interrupted with a string of TeX code before one hears the math.
Is there something I am missing...or maybe the changes you recently made are not yet reflected in the version of MathJax now running at http://devel.mathjax.org/mathjax/dpvc/v2.0-candidate/test/sample.html?
First off...THANK YOU!!!
The test page now seems to be completely accessible with RWG. Getting rid of the TeX preview took care of the problem of the invisible TeX code being read.
RWG will only read math correctly using the "web highlighting" setting. Highlighting the text and pressing a button would probably only work with simple expressions containing common qwerty characters without superscripts, fractions, roots, etc.
If you found it to work with RWG 10 without using the web highlighting setting, that would be interesting to know, because I wasn't aware that TextHelp actually addressed that issue.
When I tried out the page you had up first (before you took out the TeX preview)--without setting the MathJax context menu to let MathPlayer handle mouse and menu events--it would not read the expressions correctly.
But I went back and turned the mouse and menu events setting off just now with the new page, it now reads correctly that way as well.
Actually, the only problem I can mention now is that the for some reason after RWG reads the inline equation example, the space between the previous word and the equation begins to grow at a regular rate and will over time expand to an extreme length. Here's a video example of what I am seeing on my end: http://screencast.com/t/gqw8JqReM9
I suspect that may be a quirk due to how RWG redraws the page to get highlighting. I wonder if you get the same results on your end?
Anyway...this is nothing short of fantastic.
I would be happy to garner further input on the accessibility improvements of the beta by asking the assistive technology community to try out this test page, if you think this is a useful juncture for that.
Thanks, Davide.
I'll bring up the issues directly with TextHelp and see what they think. There are quite a number of AT applications now that can handle MathML content via IE+MathPlayer, so it would be good for me to have them take a look as well.
My primary concern is accessibility for publishers of educational content, not my own content, per se. If the tendency to read the hidden preview code is more widespread than just RWG, then it would be good to mention this problem on the MathJax pages which mention accessibility...but let me work on confirming if this is only a RWG problem (which they could fix on their end) or if it is something systemic about the way AT interacts with MathJax pages.
--Steve
From: mathja...@googlegroups.com [mathja...@googlegroups.com] on behalf of Davide P.Cervone [dp...@union.edu]
Sent: Saturday, February 11, 2012 12:20 PM
To: mathja...@googlegroups.com
Subject: Re: [mathjax-users] Re: Problem/bug report: Using MathJax plus MathPlayer with Read & Write Gold
First off...THANK YOU!!!You're welcome. I'm glad this is working better for you.
The test page now seems to be completely accessible with RWG. Getting rid of the TeX preview took care of the problem of the invisible TeX code being read.This is an author-level change (so you can set up your owen pages to prevent previews), but it is not something that can be controlled by the user, and most pages on the web that use MathJax will have them. I personally consider this a bug in R&WG, since they should NOT be reading elements that have display:none or visibility:hidden (and certainly not both).RWG will only read math correctly using the "web highlighting" setting. Highlighting the text and pressing a button would probably only work with simple expressions containing common qwerty characters without superscripts, fractions, roots, etc.It is not the version that it based on a screen image analysis, but I think the same thing you are talking about (the words are highlighted as it reads, even in the mathematics). That seems to work fine for me in R&WG10 without having to change the MathPlayer settings in MathJax. But I just tested it again, and even version 10 reads the preview (despite being display:none and visibility:hidden). I could have sworn that adding visibility:hidden had made that work, but I must had the previews off during my tests, though I didn't think I had. I have not been able to find a way to prevent R&WG from reading hidden text, so it appears that the only way to get R&WG to work with MathJax would be to remove (or not create) the previews, rather than just hide them as is the case now.If you found it to work with RWG 10 without using the web highlighting setting, that would be interesting to know, because I wasn't aware that TextHelp actually addressed that issue.Well, here is the setting that I used:
<R&WG.png>
so web highlighting is not checked (but it appears to be working that way anyway, as I do see a yellow highlighting by sentence, and blue highlighting on the word being read).What I do i highlight where I want the reading to begin, then press the green button, and it reads from there. This seems to work (other than reading the previews).When I tried out the page you had up first (before you took out the TeX preview)--without setting the MathJax context menu to let MathPlayer handle mouse and menu events--it would not read the expressions correctly.It does for me in R&WG10.But I went back and turned the mouse and menu events setting off just now with the new page, it now reads correctly that way as well.OK great.Actually, the only problem I can mention now is that the for some reason after RWG reads the inline equation example, the space between the previous word and the equation begins to grow at a regular rate and will over time expand to an extreme length. Here's a video example of what I am seeing on my end: http://screencast.com/t/gqw8JqReM9
I suspect that may be a quirk due to how RWG redraws the page to get highlighting. I wonder if you get the same results on your end?I tried the same example as you and do not see any extra spaces appearing, so it seems that this must be a R&WG9 issue that is fixed in version 10.