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

Navigation document without toc, page-list, or landmarks #826

Closed
murata2makoto opened this issue Aug 25, 2016 · 7 comments
Closed

Navigation document without toc, page-list, or landmarks #826

murata2makoto opened this issue Aug 25, 2016 · 7 comments
Labels
EPUB32 Issues from 3.0.1 resolved in the EPUB 3.2 specification Topic-PackageDoc The issue affects package documents
Milestone

Comments

@murata2makoto
Copy link
Contributor

Is the use of <nav epub:type="toc" ...>, or <nav epub:type="page-list" ...>, or <nav epub:type="landmarks" ...> required? If I am not mistaken, the current text allows a navigation document not to have any such.

@rdeltour
Copy link
Member

The toc nav is explicitly required, in 5.4.2.2

The toc nav element must occur exactly once in an EPUB Navigation Document.

But the other two are optional. Inclusion of page-list is recommended by the Accessibility Techniques document.

@murata2makoto
Copy link
Contributor Author

Thanks. I looked over this sentence.

I would like 5.4.2.1 Introduction to specify that toc nav is require while toc page-list and toc landmarks are optional.

@mattgarrish
Copy link
Member

We don't make normative statements in informative sections.

The most I'd offer to do for this is add the following to the toc nav description: "The toc nav is the only navigation aid that has to be included in the EPUB Navigation Document."

@laudrain
Copy link

Should we also recommend page-list with a reference to accessibility docs?
BTW, as publisher we have made it mandatory in our RFP.

@mattgarrish mattgarrish modified the milestone: EPUB 3.1 Aug 25, 2016
@mattgarrish mattgarrish added the Topic-PackageDoc The issue affects package documents label Aug 25, 2016
@mattgarrish
Copy link
Member

We've tried not to cross-pollinate requirements to avoid them getting out of synch. If we move the recommendation into the packages spec, it also potentially becomes a warning for everyone who doesn't include.

If you want it considered, though, please open a new issue.

@mattgarrish
Copy link
Member

Proposed Solution

Add the following qualification to the nav types introduction: "The toc nav is the only navigation aid that has to be included in the EPUB Navigation Document."

@mattgarrish mattgarrish added the Status-Proposed Solution A proposed solution has been included in the issue for working group review label Aug 25, 2016
@laudrain
Copy link

Ok to leave accessibility requirements in a11y docs.
No new issue.

mattgarrish added a commit that referenced this issue Sep 1, 2016
#755 - change alt-script to alt-rep and clarify language
#761 - make image cmts required when there is a viewport
#773 - update roadmap and add diagram
#778 - clarify package conformance
#780 - generalize backwards compatibility statement
#800 - clarify svg handling for fxl documents
#808 - replace spaces with underscores in rootfile examples
#822 - fix obsolete feature labels/descriptions
#823 - add note about incomplete RS requirements for scrolled-continuous
#824 - add clearer content model for nav elements
#826 - note toc nav is required in intro
#828 - clarify ordering requirements for toc nav references
#829 - note optional use of pagebreak with page-list

adds a link to the informative a11y faq;
patches errata not applied to doi examples;
probably some other minor stuff, too
@mattgarrish mattgarrish removed the Status-Proposed Solution A proposed solution has been included in the issue for working group review label Sep 1, 2016
@mattgarrish mattgarrish added the EPUB32 Issues from 3.0.1 resolved in the EPUB 3.2 specification label Aug 14, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
EPUB32 Issues from 3.0.1 resolved in the EPUB 3.2 specification Topic-PackageDoc The issue affects package documents
Projects
None yet
Development

No branches or pull requests

4 participants