Clarify nav content rules and RS processing of elements#1485
Clarify nav content rules and RS processing of elements#1485mattgarrish merged 6 commits intomainfrom
Conversation
…epub:type attribute; clarify expected access to nav elements
wareid
left a comment
There was a problem hiding this comment.
See comment, but otherwise looks good.
iherman
left a comment
There was a problem hiding this comment.
I am fine with the changes.
However: the RS says something about the page-list and toc. It seems to be entirely silent on what it should do with the landmark nav element, although that is defined in the content document, alongside with page-list and toc. I must admit I do not know what a RS is expected to do with it... Should we give at least some guidance for RS-s?
Nothing specifically, so I consider it part of the "MAY" section. It's supposed to help RSes implement their own interface -- like providing a mapping for a dedicated toc button. That's the "efficient access" part of the definition. But other than skipping to the body matter when a book opens I don't know how much the links are even used. We can't mandate reading systems implement behaviours or buttons, and otherwise there isn't a specific user-facing expectation. I haven't seen a reading system that lets users pull up the landmarks, for example, so it'd probably be hard to bump it up to a recommendation and also find implementations. |
O.k. I may be very picky, but I just may be the average reader: maybe it is worth adding (e.g., as a remark in parentheses) that this the "MAY" remark also applies to the landmark nav element, although that value of epub:type is explicitly defined in the spec. But, again, I may just be too picky. |
|
Thorium has in the navigation area landmarks in addition to TOC, bookmarks, annotations and go to page.
I hear students say they wish publishers had a landmark at the beginning of a chapter that identifies all the essentials they should learn in this chapter. They would read this before they start reading.
|
I'm fine either way. I've added this for now:
If there exists another implementation that gives users direct access to the links we could always consider moving it to a recommendation.
You could probably do this with the |
|
Merged this as we need a clarification. We can always review the requirements if testing shows they're unrealistic. |
This PR fixes two problems with the current nav doc definition:
epub:typeattribute from the content model restrictions since their use by reading systems is generally unrealistic anyway.Reading Systems spec: preview diff
Fixes #976
Fixes #975
Preview | Diff