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

[EPUB 3.3 RS] [question] Small difference between the XHTML Content Documents section and the SVG Content Documents section #1774

Closed
gregoriopellegrino opened this issue Aug 20, 2021 · 6 comments · Fixed by #1785
Labels
EPUB33 Issues addressed in the EPUB 3.3 revision Spec-ReadingSystems The issue affects the EPUB Reading Systems 3.3 Recommendation

Comments

@gregoriopellegrino
Copy link
Contributor

The SVG Content Documents section explicitly says:

SHOULD support user selection and searching of text within SVG elements

While the XHTML Content Documents section makes no mention of searching for content.

Maybe it makes sense to align them?

@OriIdan
Copy link

OriIdan commented Aug 20, 2021 via email

@dauwhe
Copy link
Contributor

dauwhe commented Aug 20, 2021

Are there reading systems that don't offer search because it's. not mentioned in the EPUB spec?

@OriIdan
Copy link

OriIdan commented Aug 20, 2021 via email

@mattgarrish
Copy link
Member

I wonder whether we shouldn't have the SVG bullet at all. We've gone beyond supporting SVG into requirements on the UI, which we typically don't do.

If it's just to remind devs that SVGs aren't always pure images, maybe it could be a note rather than a recommendation?

@iherman
Copy link
Member

iherman commented Aug 25, 2021

I wonder whether we shouldn't have the SVG bullet at all. We've gone beyond supporting SVG into requirements on the UI, which we typically don't do.

If it's just to remind devs that SVGs aren't always pure images, maybe it could be a note rather than a recommendation?

+1 to that. I was not sure why this statement was in the spec in the first place, and you have just given the answer... But that is the type of statement that should be in a note rather than the specification text.

@dauwhe dauwhe added the Agenda+ Issues that should be discussed during the next working group call. label Aug 25, 2021
@mattgarrish mattgarrish added the Spec-ReadingSystems The issue affects the EPUB Reading Systems 3.3 Recommendation label Aug 25, 2021
@iherman
Copy link
Member

iherman commented Sep 5, 2021

The issue was discussed in a meeting on 2021-08-27

List of resolutions:

  • Resolution No. 2: Remove the search point from the SVG section, close issue 1774
View the transcript

2. XHTML and SVG

See github issue #1774.

Dave Cramer: apparently the SVG content doc section says RS should support searching of text, but the XHTML content doc section doesn't mention searching
… i see the point, but I'm also concerned that in general we try to avoid describing how RS should present epub to users
… my preference is to take out the line about SVG

Matt Garrish: I don't think we mandate certain UI features in any other point of spec. I agree on removing this. We leave this to the developers to figure out.

Tzviya Siegman: +1 to mgarrish

Matt Garrish: maybe just a note reminding RS people that SVGs can contain text

Brady Duga: fine with removing. Alternative would be to say that any text interactions that RS supports with XHTML should also be supported for SVG text. A more vague way of doing what we want.

Wendy Reid: gpellegrino which would you prefer, since it is your issue?

Gregorio Pellegrino: no position as it doesn't strongly impact a11y. I just wanted to point out this discrepancy.

Dave Cramer: I have no objection to duga language. But probably more simple to just remove SVG bullet. Hoping that developers already know that SVG can contain text. Not sure that our reminder will change their minds about what UI feature to put in their RS.

Proposed resolution: Remove the search point from the SVG section, close issue 1774 (Wendy Reid)

Ben Schroeter: +1

Brady Duga: +1

Tzviya Siegman: +1

Deborah Kaplan: +0

Gregorio Pellegrino: +1

Toshiaki Koike: +1

Matthew Chan: +1

Wendy Reid: +1

Dan Lazin: +1

Matt Garrish: +!

Dave Cramer: +1

Masakazu Kitahara: +1

Murata Makoto: +1

Bill Kasdorf: +1

Resolution #2: Remove the search point from the SVG section, close issue 1774

@mattgarrish mattgarrish added EPUB33 Issues addressed in the EPUB 3.3 revision and removed Agenda+ Issues that should be discussed during the next working group call. labels Sep 9, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
EPUB33 Issues addressed in the EPUB 3.3 revision Spec-ReadingSystems The issue affects the EPUB Reading Systems 3.3 Recommendation
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants