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

MathML contentequiv annotations are for content mathml #1104

Open
mattgarrish opened this issue Mar 6, 2020 · 1 comment
Open

MathML contentequiv annotations are for content mathml #1104

mattgarrish opened this issue Mar 6, 2020 · 1 comment
Assignees
Labels
priority: low To be processed when time allows spec: EPUB 3.x Impacting the support of EPUB 3.x specifications status: in discussion The issue is being discussed by the development team type: spec The issue is related to a Specification update

Comments

@mattgarrish
Copy link
Member

In porting over the MathML tests, I noticed that one of the valid mathml annotation tests has a presentation MathML contentequiv annotation for a presentation MathML equation:

<annotation-xml encoding="application/mathml-presentation+xml" name="contentequiv">

This gets flagged by validator.nu as invalid, however.

Looking at the section on content equivalents in the MathML spec, it says:

Consequently, in MathML 3, the contentequiv annotation key should be used to make an explicit assertion that the annotation provides a definitive content markup equivalent for an expression.

While it doesn't have to contain content MathML, the suggestion is that it should contain that or some other semantically meaningful markup. Another case of presentation mathml should at least result in a warning, in other words, which makes the validator.nu result closer to what I would have expected.

(Oddly, if you switch the encoding to "MathML-Presentation", the error in validator.nu goes away, but that looks like a bug.)

@rdeltour rdeltour added priority: medium To be processed and published in one of the upcoming releases spec: EPUB 3.x Impacting the support of EPUB 3.x specifications status: in discussion The issue is being discussed by the development team type: spec The issue is related to a Specification update labels Mar 12, 2020
@rdeltour rdeltour added this to the v5.0.0-rc milestone Dec 8, 2022
@rdeltour rdeltour self-assigned this Dec 8, 2022
@rdeltour
Copy link
Member

validator.nu rejects any encoding value that is not one of ("application/xhtml+xml", "text/html", "SVG1.1", "MathML", "MathML-Content", or "MathML-Presentation"). It does not reject the "application/mathml-presentation+xml" value because the annotation is a content equivalent, but simply because the value is not in the allowed subset.

I would say this is a bug in validator.nu, that we should not strive to port.

As for issuing a warning if the contentequiv key is used with any other encoding than "application/mathml-presentation+xml" or "MathML-Content", I have no strong opinion. It would certainly be in the spirit of the MathML spec language quoted by @mattgarrish above, but not sure it is worth implementing this specifically (with a schematron check or in Java).

Thoughts @mattgarrish?

I'm moving this out of the v5.0.0 milestone, as this looks low priority.

@rdeltour rdeltour added priority: low To be processed when time allows and removed priority: medium To be processed and published in one of the upcoming releases labels Dec 31, 2022
@rdeltour rdeltour removed this from the v5.0.0-rc milestone Dec 31, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
priority: low To be processed when time allows spec: EPUB 3.x Impacting the support of EPUB 3.x specifications status: in discussion The issue is being discussed by the development team type: spec The issue is related to a Specification update
Projects
None yet
Development

No branches or pull requests

2 participants