Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Excluding math types? #574

Open
mattgarrish opened this issue Jan 7, 2025 · 6 comments
Open

Excluding math types? #574

mattgarrish opened this issue Jan 7, 2025 · 6 comments
Labels
a11y-display-techniques-epub Issue with the epub accessibility metadata display techniques a11y-display-techniques-onix Issue with the onix accessibility metadata display techniques

Comments

@mattgarrish
Copy link
Member

Isn't it possible that a book could have mathml and latex equations, or some mathml and some described images?

The rich content output strings start with an if/else if/ else if for the math possibilities, so only one can occur. The same isn't done for the different chemistry types.

Should these be switched so they are all "if" checks?

@mattgarrish mattgarrish added the a11y-display-techniques-epub Issue with the epub accessibility metadata display techniques label Jan 7, 2025
@mattgarrish mattgarrish added the a11y-display-techniques-onix Issue with the onix accessibility metadata display techniques label Jan 8, 2025
@mattgarrish
Copy link
Member Author

Reopening as this also occurs in the onix techniques

@mattgarrish mattgarrish reopened this Jan 9, 2025
@gregoriopellegrino
Copy link
Collaborator

I remember that describedMath we had mutually-excluded it with MathML, because many GCA titles contain both MathML metadata and describedMath

@mattgarrish
Copy link
Member Author

MathML improves the layout and provides some navigation, but the actual readability of the equations may be poor depending on the device, so I'd think it would be helpful to know if it's also described.

@mattgarrish
Copy link
Member Author

It looks like the output string for described math is a bit misleading. MathML with descriptions is also described math. The output is assuming only images are described.

@clapierre
Copy link
Collaborator

GCA originally was encouraging publishers to put into the MathML itself the "alttext" description of the math it represented. In doing that we also recommended that the metadata accessibilityFeature="describedMath" and "MathML" both be present.

However, after one of our calls it was encouraged that this practice be discontinued and that we shouldn't be encouraging publisher to put anything in the MathML's "alttext" and let the ReadingSystem handle how to speak that mathML with its own "Read Aloud" functionality (usually implemented with either MathCAT or MathJAX") as this would provide a better user experience with potentially synchronized highlighting of the math elements.

accessibilityFeature="describedMath" should only be present with an image of math contains an "alt" description of the math equation.

So the only way you would ever have both "MathML" and "describedMath" metadata in the same book is when there is both real MathML equations and images of math with an alt text description provided. (Why you would ever have both is a good question, maybe as a fallback if MathML is not supported, like our test books have both the image of MathML with alt text and below it a Details element containing the real MathML.

This was my understand from our last meeting on this topic.
If this is the case our GCA next Technical Bulletin will also be pointing out this new 'Best Practice' on how to handle math within an EPUB and what metadata should accompany it.

@mattgarrish
Copy link
Member Author

Math is visual media, though. I wouldn't want to tell publishers not to also describe their equations for people who have difficulty reading them (whatever the reason, which could include cognitive disabilities), even if there is MathML markup.

It may not be strictly required to pass WCAG to describe the MathML, but it feels like we're making an assumption for a certain kind of production.

It feels a lot like the fixed layout transformability issue. Are we going too far in overriding what the publisher may be trying to claim?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
a11y-display-techniques-epub Issue with the epub accessibility metadata display techniques a11y-display-techniques-onix Issue with the onix accessibility metadata display techniques
Projects
None yet
Development

No branches or pull requests

3 participants