ar5iv icon indicating copy to clipboard operation
ar5iv copied to clipboard

Citation environments seem to be incompatible with mac voiceover

Open jstoobysmith opened this issue 2 years ago • 2 comments

Firstly, thank you for this great tool.

I've been trying to use the mac 'voiceover' screen reader to read the html articles.

It appears that some of the citation environments cause a glitch in the screen reader, causing it to stop.

For example, taking the second paragraph in the introduction to https://ar5iv.labs.arxiv.org/html/2201.07245. Voiceover passes the first citation '[1]' without issue, but breaks at the second citation '[2,3]'.

Indeed it seems like the issue only occurs when there is more than one citation in the cite environment.

Voiceover breaks:

 <cite class="ltx_cite ltx_citemacro_cite">[<a href="#bib.bib13" title="" class="ltx_ref">13</a>, <a href="#bib.bib14" title="" class="ltx_ref">14</a>]</cite>

Voiceover works:

 <cite class="ltx_cite ltx_citemacro_cite">[<a href="#bib.bib12" title="" class="ltx_ref">12</a>]</cite>

Voiceover works:

 [<a href="#bib.bib13" title="" class="ltx_ref">13</a>, <a href="#bib.bib14" title="" class="ltx_ref">14</a>]

Voiceover works: (I just removed the comma between citations)

<cite class="ltx_cite ltx_citemacro_cite">[<a href="#bib.bib13" title="" class="ltx_ref">13</a> <a href="#bib.bib14" title="" class="ltx_ref">14</a>]</cite>

This may be a local issue, and if this is the case, I apologise.

jstoobysmith avatar Feb 24 '22 18:02 jstoobysmith

Hi @jstoobysmith !

Your issue is our first report related to accessibility, so I made a new label. I expect we have multiple problems when it comes to using the pages with present-day accessibility tools, and I also suspect we have different issues based on which tool is used.

So, my first question is -- do you have experience with working together with the team behind the mac 'voiceover' screen reader? Or, alternatively, could you link to pages that explain which types of markup work and which don't, as they relate to this example?

From what I can see, all examples are reasonable HTML, so I would need to understand the guidelines that distinguish "good" and "bad" markup for the screen reader.

dginev avatar Feb 24 '22 18:02 dginev

One point that could be raised is that latexml's use of the <cite> element may be too generalized, as I am mostly seeing examples in the spec where <cite> is used only with a single citation child - I didn't see it used with multiple entries.

So it is possible we would need to reconsider that model...

dginev avatar Feb 24 '22 18:02 dginev