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

WARNING (NAV-011): Misfiring when endnotes will be moved together per chapter in single file #1101

Closed
manojksharma80 opened this issue Feb 3, 2020 · 1 comment
Labels
status: wontfix The issue is rejected due to limitations (of scope or dev resources)

Comments

@manojksharma80
Copy link

manojksharma80 commented Feb 3, 2020

Hi all,

I feel that EPUBCheck v4.2.2 is misfiring warnings when we insert page numbers in sequence in page-list nav order and the order of file naming are different from spine order:

  1. 60
  2. 61
  3. 62
  4. 63
  5. 64
  6. 65

Untitled

Actually, all endnotes are paginated at end of the each chapter in the printed book, but for ebook we have instruction to move all endnotes together per chapter in a single file (notes.xhtml) file and set it at end of the book. When we insert page number of the book in page-list in sequential order then page number 62 and 63 which is acutely belongs to chapter004.xhtml but now has been moved to notes.xhtml should be set between the chapter004 and chapter005 as the file naming “notes.xhtml” - epubcheck-v4.2.2 raised a warning that the nav order of notes.xhtml and chapter005.xhtml are different from spine order i.e. notes.xhtml should not come before the chapter005.xhtml, see example above.

In the page-list nav order, EPUBCheck v4.2.2 should be check only page sequences in page-list not file naming where the pages are present. Please correct if I am wrong.

Could you please check and suggest how to correct these warnings?

@rdeltour
Copy link
Member

rdeltour commented Feb 4, 2020

Hi @manojksharma80, thanks the report.

The core of the issue is that EPUB does require the page list to be matching the spine order. See section 5.4.2.3. The page-list nav Element:

The page references within the page-list nav MUST be ordered so that they match both the order of the targeted EPUB Content Documents in the spine and the order of each page within its respective EPUB Content Document.

In fact, this was originally reported by EPUBCheck as an error (following issue #888), but was then downgraded to a warning following a lengthly discussion in #1036, which is still an open issue in the EPUB Community Group as w3c/epub-specs#1283).

There's probably not much we can do in EPUBCheck about that. If you'd like the rules to change, I'd advise you to contribute to the discussion in the community group. Meanwhile, your options are either to ignore this warning (it's "only" a warning after all) or to somehow make your page list and spine match the same order.

I'm closing this issue as wontfix, but feel free to keep on commenting here, and we could always reopen if the CG decides to change the spec or to further downgrade EPUBCheck's reporting!

@rdeltour rdeltour added the status: wontfix The issue is rejected due to limitations (of scope or dev resources) label Feb 4, 2020
@rdeltour rdeltour closed this as completed Feb 4, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
status: wontfix The issue is rejected due to limitations (of scope or dev resources)
Projects
None yet
Development

No branches or pull requests

2 participants