search

nlbdev / nordic-epub3-dtbook-migrator

Tools for converting between a strict subset of DTBook and EPUB3.
http://nlbdev.github.io/nordic-epub3-dtbook-migrator/
GNU Lesser General Public License v2.1
8 stars 7 forks source link

fix epub:type="frontmatter toc" #181

Closed TamJ closed 9 years ago

TamJ commented 9 years ago
  1. The EPUB 3.0 SSV appears to define the toc value for sectioning content - our validation on the otherhand appears to check for occurance of toc on a structure deeper than the top section. But this change will happen when we include more allowable values, right?
  2. The guidelines will need to be revised here also. Guidelines 3.1.3.4 is not exactly clear.
josteinaj commented 9 years ago

The EPUB 3.0 SSV defines the epub:type "toc" under "Document Navigation", rather than "Document sections and components", "Document divisions" or "Document partitions". Its usage is specified as "sectioning content" as you say, which according to HTML5 is <article>, <aside>, <nav> and <section>. EPUB3 uses "toc" on its <nav> elements in the navigation document. We use it in addition on the <body> element for the table of contents as displayed in the book. I think it's safe to consider the body element to be a sectioning element in itself, so I don't see any problem here? We could consider using "toc-brief" when we revise the guidelines in the future maybe, but I think it's fine as it is now, isn't it? Or maybe I misunderstand the problem.

TamJ commented 9 years ago

When I try to validate the content doc that contains the printed TOC with the toc value in epub:type, I get the following errors: 1.

<body id="level1_4" epub:type="frontmatter toc">

•[nordic127] The epub:type "toc" is only allowed in frontmatter, backmatter, and in the EPUB3 Navigation Document (nav.xhtml).

2.

<body id="level1_4" epub:type="frontmatter">
<h1 id="h1_1">Innehåll</h1>
<ol epub:type="toc">

•org.xml.sax.SAXParseException; systemId: file:/C:/Users/tajo/AppData/Roaming/DAISY%20Pipeline%202/jobs/d90d7453-e8af-4841-822b-beb17bd4f6ac/output/temp-dir/validate/EPUB/DTB12591-004-toc.xhtml; lineNumber: 12; columnNumber: 21; value of attribute "epub:type" is invalid; token "toc" invalid; must be equal to "acknowledgments", "biblioentry", "bibliography", "concluding-sentence", "contributors", "copyright-page", "dedication", "division", "errata", "footnote", "footnotes", "glossdef", "glossterm", "halftitle", "halftitlepage", "help", "imprimatur", "imprint", "keyword", "landmarks", "list", "list-item", "loi", "lot", "marginalia", "notice", "other-credits", "page-list", "practice", "preamble", "rearnote", "rearnotes", "subchapter", "subtitle", "table", "table-cell", "table-row", "title", "topic-sentence", "volume", "warning", "z3998:abbreviations", "z3998:acknowledgments", "z3998:acronym", "z3998:actor", "z3998:alteration", "z3998:article", "z3998:aside", "z3998:attribution", "z3998:award", "z3998:bcc", "z3998:bibliography", "z3998:biographical-note", "z3998:cardinal", "z3998:catalogue", "z3998:cc", "z3998:citation", "z3998:clarification", "z3998:collection", "z3998:commentary", "z3998:commentator", "z3998:compound", "z3998:concluding-sentence", "z3998:continuation", "z3998:continuation-of", "z3998:contributors", "z3998:coordinate", "z3998:correction", "z3998:currency", "z3998:decimal", "z3998:decorative", "z3998:dedication", "z3998:diary", "z3998:diary-entry", "z3998:discography", "z3998:division", "z3998:drama", "z3998:dramatis-personae", "z3998:editor", "z3998:editorial-note", "z3998:email", "z3998:email-message", "z3998:errata", "z3998:essay", "z3998:event", "z3998:example", "z3998:family-name", "z3998:fiction", "z3998:figure", "z3998:filmography", "z3998:footnote", "z3998:fraction", "z3998:from", "z3998:frontispiece", "z3998:ftp", "z3998:gallery", "z3998:general-editor", "z3998:geographic", "z3998:given-name", "z3998:grant-acknowledgment", "z3998:grapheme", "z3998:halftitle", "z3998:halftitle-page", "z3998:help", "z3998:homograph", "z3998:http", "z3998:hymn", "z3998:illustration", "z3998:image-placeholder", "z3998:imprimatur", "z3998:imprint", "z3998:initialism", "z3998:introductory-note", "z3998:ip", "z3998:isbn", "z3998:keyword", "z3998:letter", "z3998:loi", "z3998:lot", "z3998:lyrics", "z3998:marginalia", "z3998:measure", "z3998:mixed", "z3998:morpheme", "z3998:name-title", "z3998:nationality", "z3998:non-fiction", "z3998:nonresolving-reference", "z3998:notice", "z3998:orderedlist", "z3998:ordinal", "z3998:organization", "z3998:other-credits", "z3998:page-footer", "z3998:page-header", "z3998:percentage", "z3998:persona", "z3998:personal-name", "z3998:pgroup", "z3998:phone", "z3998:phoneme", "z3998:photograph", "z3998:phrase", "z3998:place", "z3998:plate", "z3998:portmanteau", "z3998:postal", "z3998:postal-code", "z3998:postscript", "z3998:practice", "z3998:preamble", "z3998:prefix", "z3998:presentation", "z3998:primary", "z3998:product", "z3998:promotional-copy", "z3998:published-works", "z3998:publisher-address", "z3998:publisher-logo", "z3998:range", "z3998:ratio", "z3998:rearnote", "z3998:recipient", "z3998:recto", "z3998:reference", "z3998:republisher", "z3998:resolving-reference", "z3998:result", "z3998:role-description", "z3998:roman", "z3998:root", "z3998:salutation", "z3998:scene", "z3998:secondary", "z3998:section", "z3998:sender", "z3998:signature", "z3998:song", "z3998:speech", "z3998:stage-direction", "z3998:stem", "z3998:structure", "z3998:subchapter", "z3998:subject", "z3998:subsection", "z3998:subtitle", "z3998:suffix", "z3998:surname", "z3998:t-form", "z3998:taxonomy", "z3998:tertiary", "z3998:text", "z3998:textbook", "z3998:timeline", "z3998:title", "z3998:title-page", "z3998:to", "z3998:topic-sentence", "z3998:translator", "z3998:translator-note", "z3998:truncation", "z3998:unorderedlist", "z3998:v-form", "z3998:valediction", "z3998:verso", "z3998:volume", "z3998:warning" or "z3998:weight"

josteinaj commented 9 years ago

Interesting. Could you send me the epub?

Jostein

  1. Nov. 2014 08:26 skrev "TamJ" notifications@github.com:

When I try to validate the content doc that contains the printed TOC with the toc value in epub:type, I get the following errors: 1.

•[nordic127] The epub:type "toc" is only allowed in frontmatter, backmatter, and in the EPUB3 Navigation Document (nav.xhtml). 2.

Innehåll

    •org.xml.sax.SAXParseException; systemId: file:/C:/Users/tajo/AppData/Roaming/DAISY%20Pipeline%202/jobs/d90d7453-e8af-4841-822b-beb17bd4f6ac/output/temp-dir/validate/EPUB/DTB12591-004-toc.xhtml; lineNumber: 12; columnNumber: 21; value of attribute "epub:type" is invalid; token "toc" invalid; must be equal to "acknowledgments", "biblioentry", "bibliography", "concluding-sentence", "contributors", "copyright-page", "dedication", "division", "errata", "footnote", "footnotes", "glossdef", "glossterm", "halftitle", "halftitlepage", "help", "imprimatur", "imprint", "keyword", "landmarks", "list", "list-item", "loi", "lot", "marginalia", "notice", "other-credits", "page-list", "practice", "preamble", "rearnote", "rearnotes", "subchapter", "subtitle", "table", "table-cell", "table-row", "title", "topic-sentence", "volume", "warning", "z3998:abbreviations", "z3998:acknowledgments", "z3998:acronym", "z3998:actor", "z3998:alteration", "z3998:article", "z3998:aside", "z3998:attribution", "z3998:award", "z3998:bcc", "z3998:bibliography", "z3998:biographical-note", "z3998:cardinal", "z3998:catalogue", "z3998:cc", "z3998:citation", "z3998:clarification", "z3998:collection", "z3998:commentary", "z3998:commentator", "z3998:compound", "z3998:concluding-sentence", "z3998:continuation", "z3998:continuation-of", "z3998:contributors", "z3998:coordinate", "z3998:correction", "z3998:currency", "z3998:decimal", "z3998:decorative", "z3998:dedication", "z3998:diary", "z3998:diary-entry", "z3998:discography", "z3998:division", "z3998:drama", "z3998:dramatis-personae", "z3998:editor", "z3998:editorial-note", "z3998:email", "z3998:email-message", "z3998:errata", "z3998:essay", "z3998:event", "z3998:example", "z3998:family-name", "z3998:fiction", "z3998:figure", "z3998:filmography", "z3998:footnote", "z3998:fraction", "z3998:from", "z3998:frontispiece", "z3998:ftp", "z3998:gallery", "z3998:general-editor", "z3998:geographic", "z3998:given-name", "z3998:grant-acknowledgment", "z3998:grapheme", "z3998:halftitle", "z3998:halftitle-page", "z3998:help", "z3998:homograph", "z3998:http", "z3998:hymn", "z3998:illustration", "z3998:image-placeholder", "z3998:imprimatur", "z3998:imprint", "z3998:initialism", "z3998:introductory-note", "z3998:ip", "z3998:isbn", "z3998:keyword", "z3998:letter", "z3998:loi", "z3998:lot", "z3998:lyrics", "z3998:marginalia", "z3998:measure", "z3998:mixed", "z3998:morpheme", "z3998:name-title", "z3998:nationality", "z3998:non-fiction", "z3998:nonresolving-reference", "z3998:notice", "z3998:orderedlist", "z3998:ordinal", "z3998:organization", "z3998:other-credits", "z3998:page-footer", "z3998:page-header", "z3998:percentage", "z3998:persona", "z3998:personal-name", "z3998:pgroup", "z3998:phone", "z3998:phoneme", "z3998:photograph", "z3998:phrase", "z3998:place", "z3998:plate", "z3998:portmanteau", "z3998:postal", "z3998:postal-code", "z3998:postscript", "z3998:practice", "z3998:preamble", "z3998:prefix", "z3998:presentation", "z3998:primary", "z3998:product", "z3998:promotional-copy", "z3998:published-works", "z3998:publisher-address", "z3998:publisher-logo", "z3998:range", "z3998:ratio", "z3998:rearnote", "z3998:recipient", "z3998:recto", "z3998:reference", "z3998:republisher", "z3998:resolving-reference", "z3998:result", "z3998:role-description", "z3998:roman", "z3998:root", "z3998:salutation", "z3998:scene", "z3998:secondary", "z3998:section", "z3998:sender", "z3998:signature", "z3998:song", "z3998:speech", "z3998:stage-direction", "z3998:stem", "z3998:structure", "z3998:subchapter", "z3998:subject", "z3998:subsection", "z3998:subtitle", "z3998:suffix", "z3998:surname", "z3998:t-form", "z3998:taxonomy", "z3998:tertiary", "z3998:text", "z3998:textbook", "z3998:timeline", "z3998:title", "z3998:title-page", "z3998:to", "z3998:topic-sentence", "z3998:translator", "z3998:translator-note", "z3998:truncation", "z3998:unorderedlist", "z3998:v-form", "z3998:valediction", "z3998:verso", "z3998:volume", "z3998:warning" or "z3998:weight" — Reply to this email directly or view it on GitHub https://github.com/nlbdev/nordic-epub3-dtbook-migrator/issues/181#issuecomment-63415291 .