Sla over naar inhoud

EPUBCheck berichten uitgelegd

EPUBCheck rapporteert elk probleem in een EPUB als een code zoals RSC-005 of OPF-014 met een ernst. Deze verwijzing lijst alle 246 berichten van EPUBCheck 5.4.0 met hun officiële tekst, en legt oorzaken en oplossingen uit voor 188 daarvan.

Bijgewerkt:

Ernstigheden

Fatale fout
EPUBCheck kon deze sectie van de EPUB niet verder controleren. Het bestand is ongeldig.
Fout
De EPUB overtreedt een regel van de specificatie en is ongeldig. Opslaan en Verzenden naar Kindle kunnen het afwijzen, en EPUBCheck verlaat met status 1.
Waarschuwing
De EPUB is nog steeds geldig, maar iets veroorzaakt waarschijnlijk problemen in sommige lees-apps. EPUBCheck verlaat met 0, tenzij je --failonwarnings doorgeeft.
Gebruik
Alleen informatief en standaard verborgen: het verschijnt wanneer EPUBCheck draait met -u (--usage). Het maakt de EPUB niet ongeldig.
Informatie
Alleen informatief. Het maakt de EPUB niet ongeldig.
Onderdrukt
EPUBCheck rapporteert dit bericht standaard niet. Het verschijnt alleen als een aangepast berichtenbestand (-c) de ernst wijzigt.

PKG: Pakket en ZIP-container

Het EPUB bestand zelf: het ZIP-archief, het mimetype-bestand, bestandsnamen en extensies.

CodeStandaard ernstBericht
PKG-001WaarschuwingValidating the EPUB against version … but detected version ….
PKG-003FoutUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Fatale foutCorrupted EPUB ZIP header.
PKG-005FoutThe mimetype file has an extra field of length …. The use of the extra field feature of the ZIP format is not permitted for the mimetype file.
PKG-006FoutMimetype file entry is missing or is not the first file in the archive.
PKG-007FoutThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Fatale foutUnable to read file "…".
PKG-009FoutThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010WaarschuwingThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011FoutThe file name "…" is not allowed to end with ".".
PKG-012GebruikThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013FoutThe EPUB file includes multiple OPS renditions.
PKG-014WaarschuwingThe EPUB contains empty directory "…".
PKG-015Fatale foutUnable to read EPUB contents: …
PKG-016WaarschuwingUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017WaarschuwingUncommon EPUB file extension.
PKG-018Fatale foutThe EPUB file could not be found.
PKG-020FoutOPF file "…" could not be found.
PKG-021FoutCorrupted image file encountered.
PKG-022WaarschuwingWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023GebruikValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024GebruikUncommon EPUB file extension.
PKG-025FoutPublication resource must not be located in the META-INF directory
PKG-026FoutObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Fatale foutCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Hulpmiddelen en verwijzingen

Bestanden en links ertussen: ontbrekende bestanden, gebroken referenties, URL's, coderingen en XML-parsing.

CodeStandaard ernstBericht
RSC-001FoutFile "…" could not be found.
RSC-002Fatale foutRequired META-INF/container.xml resource could not be found.
RSC-003FoutNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004InformatieFile "…" is encrypted, its content will not be checked.
RSC-005FoutError while parsing file: …
RSC-006FoutRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bGebruikResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007FoutReferenced resource "…" could not be found in the EPUB.
RSC-007wWaarschuwingReferenced resource "…" could not be found in the EPUB.
RSC-008FoutReferenced resource "…" is not declared in the OPF manifest.
RSC-009WaarschuwingA non-SVG image resource should not be defined with a fragment identifier.
RSC-010FoutReference to non-standard resource type found.
RSC-011FoutFound a reference to a resource that is not a spine item.
RSC-012FoutFragment identifier is not defined.
RSC-013GebruikFragment identifier is used in a reference to a stylesheet resource.
RSC-014GebruikFragment identifier defines an incompatible resource type.
RSC-015GebruikA fragment identifier is required for svg use tag references.
RSC-016Fatale foutFatal Error while parsing file: …
RSC-017WaarschuwingWarning while parsing file: …
RSC-019WaarschuwingEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Fout"…" is not a valid URL (…)
RSC-021FoutA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022InformatieCannot check image details (requires Java version 7 or higher).
RSC-024GebruikInformative parsing warning: …
RSC-025GebruikInformative parsing error: …
RSC-026FoutURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027WaarschuwingXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028FoutXML documents must be encoded in UTF-8, but … was detected.
RSC-029FoutData URL is not allowed in this context.
RSC-030FoutFile URLs are not allowed in EPUB, but found "…".
RSC-031WaarschuwingRemote resource references should use HTTPS, but found "…".
RSC-032FoutFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033FoutRelative URL strings must not have a query component, but found one in "…".
RSC-034FoutScripts must have a JavaScript media type.
RSC-035Gebruik"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Gebruik…

OPF: Pakketdocument (OPF)

Het package-document: metadata, manifest, spine, eigenschappen en fallbacks.

CodeStandaard ernstBericht
OPF-001FoutThere was an error when parsing the EPUB version: ….
OPF-002Fatale foutThe OPF file "…" was not found in the EPUB.
OPF-003GebruikItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004WaarschuwingInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aFoutInvalid prefix declaration: found empty prefix.
OPF-004bFoutInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cFoutInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dFoutInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eWaarschuwingInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fWaarschuwingInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005FoutInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006FoutInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007WaarschuwingRe-declaration of reserved prefix "…".
OPF-007aFoutInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bFoutInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cFoutInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010FoutError resolving reference: "…".
OPF-011Foutitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012FoutItem property "…" is not defined for media type "…".
OPF-013WaarschuwingResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014FoutThe property "…" should be declared in the OPF file.
OPF-015FoutThe property "…" should not be declared in the OPF file.
OPF-016FoutThe element "rootfile" is missing its required attribute "full-path".
OPF-017FoutThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018WaarschuwingThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bGebruikThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found; please check scripted content to make sure the property is legit.
OPF-021WaarschuwingUse of non-registered URI scheme type in href: "…".
OPF-025FoutProperty value list "…" is not allowed, only one value must be specified.
OPF-026FoutFound malformed property value: "…".
OPF-027FoutUndefined property: "…".
OPF-028FoutUndeclared prefix: "…".
OPF-029FoutThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030FoutThe unique-identifier "…" was not found.
OPF-031FoutFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032FoutGuide references "…" which is not a valid "OPS Content Document".
OPF-033FoutThe spine contains no linear resources.
OPF-034FoutThe spine contains multiple references to the manifest item with id "…".
OPF-035WaarschuwingMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036GebruikVideo type "…" might not be supported by reading systems
OPF-037WaarschuwingFound deprecated media-type "…".
OPF-038WaarschuwingMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039WaarschuwingMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040FoutFallback item with id "…" could not be found.
OPF-041FoutFallback-style item with id "…" could not be found.
OPF-042Fout"…" is not a permissible spine media-type.
OPF-043FoutSpine item with non-standard media-type "…" has no fallback.
OPF-044FoutSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045FoutEncountered circular reference in fallback chain.
OPF-047GebruikOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048FoutPackage tag is missing its required unique-identifier attribute and value.
OPF-049FoutItem id "…" was not found in the manifest.
OPF-050FoutTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051OnderdruktImage dimensions exceed recommended size.
OPF-052FoutRole value "…" is not valid.
OPF-053WaarschuwingDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054FoutDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Waarschuwing… tag is empty.
OPF-057OnderdruktImage file length exceeds recommended size.
OPF-060FoutDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062GebruikFound Adobe page-map attribute on spine element in opf file.
OPF-063WaarschuwingReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformatieOPF declares type "…", validating using profile "…".
OPF-065FoutInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066FoutMissing "dc:source" or "source-of" pagination metadata. The pagination source must be identified using the "dc:source" and "source-of" properties when the content includes page break markers.
OPF-067FoutThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070WaarschuwingCustom collection role "…" is an invalid URL.
OPF-071FoutIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072GebruikMetadata element "…" is empty.
OPF-073FoutExternal identifiers must not appear in the document type declaration.
OPF-074FoutPackage resource "…" is declared in several manifest items.
OPF-075FoutPreview collections must only point to EPUB Content Documents.
OPF-076FoutThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077WaarschuwingA Data Navigation Document should not be included in the spine.
OPF-078FoutAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079WaarschuwingDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080WaarschuwingA Search Key Map document file name should have the extension ".xml".
OPF-081FoutResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082FoutFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083FoutFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084FoutFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Waarschuwing"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086WaarschuwingProperty "…" is deprecated. Consider using … instead.
OPF-086bGebruikepub:type value "…" is deprecated. Consider using … instead.
OPF-086cWaarschuwingthe "…" reserved prefix is deprecated.
OPF-087Gebruikepub:type value "…" is not allowed on documents of type "…".
OPF-088GebruikUnrecognized epub:type value "…".
OPF-089FoutThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090GebruikIt is encouraged to use MIME media type "…" instead of "…".
OPF-091FoutThe item href URL must not have a fragment identifier.
OPF-092FoutLanguage tag "…" is not well-formed: …
OPF-093FoutThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094FoutThe "media-type" attribute is required for "…" links.
OPF-095FoutThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096FoutNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bGebruikNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097GebruikResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098FoutThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099FoutThe manifest must not list the package document.
OPF-100GebruikThe "…" property only applies to pre-paginated content.

HTM: XHTML inhoudsdocumenten

De XHTML hoofdstukken: DOCTYPE, entiteiten, namespaces en vast-indeling viewporten.

CodeStandaard ernstBericht
HTM-001FoutAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002WaarschuwingThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003FoutExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004FoutIrregular DOCTYPE: found "…", expected "…".
HTM-005GebruikAn external reference was found.
HTM-007WaarschuwingEmpty or whitespace-only value of attribute ssml:ph.
HTM-009FoutThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010GebruikNamespace "…" is unusual for the prefix "epub".
HTM-011FoutEntity is undeclared.
HTM-025WaarschuwingNon-registered URI scheme type found in href.
HTM-044GebruikNamespace uri "…" was included but not used.
HTM-045GebruikEncountered empty href.
HTM-046FoutFixed layout document has no "viewport" meta element.
HTM-047FoutViewport metadata "…" has a syntax error
HTM-048FoutSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051WaarschuwingFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052FoutThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054FoutCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055GebruikThe "…" element should not be used (discouraged construct)
HTM_056FoutViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057FoutViewport "…" value must be a positive number or the keyword "device-…"
HTM_058FoutHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059FoutViewport "…" property must not be defined more than once, but found values […].
HTM_060aGebruikEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bGebruikEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Fout"…" is not a valid custom data attribute (it must have at least one character after the hyphen, be XML-compatible, and not contain ASCII uppercase letters).
HTM_062GebruikSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063GebruikSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Stijlen

CSS-bestanden en stijl elementen: verboden eigenschappen, coderingen, lettertypen en syntaxis.

CodeStandaard ernstBericht
CSS-001FoutThe "…" property must not be included in an EPUB Style Sheet.
CSS-002FoutEmpty or NULL reference found.
CSS-003WaarschuwingCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004FoutCSS documents must be encoded in UTF-8, detected …;
CSS-005GebruikConflicting alternate style tags found: ….
CSS-006GebruikCSS selector specifies fixed position.
CSS-007InformatieFont-face reference "…" refers to non-standard font type "…".
CSS-008FoutAn error occurred while parsing the CSS: ….
CSS-015FoutAlternative style sheets must have a title.
CSS-019WaarschuwingCSS font-face declaration has no attributes.
CSS-028GebruikUse of Font-face declaration.
CSS-029GebruikFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030FoutThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 inhoudsopgave)

De legacy NCX inhoudsopgave.

CodeStandaard ernstBericht
NCX-001FoutNCX identifier ("…") does not match OPF identifier ("…").
NCX-004GebruikNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006GebruikEmpty "text" label in the NCX document

MED: Afbeeldingen, audio en media overlays

Afbeeldingsformaten en headers, en gesynchroniseerde audio (media overlays).

CodeStandaard ernstBericht
MED-003FoutPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004FoutImage file header may be corrupted.
MED-005FoutMedia Overlay audio reference … to non-standard audio type … found.
MED-008FoutThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009FoutThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007FoutPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010FoutEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011FoutEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012FoutThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013FoutMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014FoutMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015GebruikMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016WaarschuwingMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017WaarschuwingURL fragment should indicate an element ID, but found '#…'.
MED_018WaarschuwingURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Toegankelijkheid

Toegankelijkheidscontroles op inhouddocumenten (de meeste worden standaard onderdrukt).

CodeStandaard ernstBericht
ACC-004OnderdruktHtml "a" element must have text.
ACC-005OnderdruktTable heading cells should be identified by "th" elements for accessibility.
ACC-006OnderdruktTables should include a "thead" element for accessibility.
ACC-007OnderdruktContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009GebruikMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011GebruikSVG hyperlink has no accessible name
ACC-012OnderdruktTable elements should include a caption element.

OBS: Verouderde functies

Functies die nog werken maar verouderd zijn.

CodeStandaard ernstBericht
OBS-001GebruikUsage of … is outdated.

INF: Informatie

Aantekeningen over EPUBCheck zelf.

CodeStandaard ernstBericht
INF-001InformatieRule … is under review and its severity may change in a future release. See the discussion at …

CHK: EPUBCheck configuratie

Problemen met EPUBCheck's eigen aangepaste berichtbestand, niet met de EPUB.

CodeStandaard ernstBericht
CHK-001FoutThe custom message overrides file was not found.
CHK-002FoutUnrecognized custom message id … encountered in message overrides file "…".
CHK-003FoutUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004FoutThe custom message contains too many parameters in message overrides file "…".
CHK-005FoutThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006FoutUnable to parse the custom format parameter in message overrides file "…".
CHK-007FoutError encountered while processing custom message file "…": "…".
CHK-008FoutError encountered while processing an item "…"; skip other checks for the item.

Afgekeurde bericht-ID's

Deze ID's bestaan nog steeds in de EPUBCheck's lijst van berichten, maar hebben geen tekst en worden standaard onderdrukt, zodat EPUBCheck ze nooit rapporteert, tenzij een aangepast berichtenbestand ze inschakelt.

ACC-001, ACC-002, ACC-003, ACC-008, ACC-010, ACC-013, ACC-014, ACC-015, ACC-016, ACC-017, CSS-009, CSS-010, CSS-011, CSS-012, CSS-013, CSS-016, CSS-017, CSS-020, CSS-021, CSS-022, CSS-023, CSS-024, CSS-025, HTM-006, HTM-008, HTM-012, HTM-013, HTM-014, HTM-014a, HTM-015, HTM-016, HTM-017, HTM-018, HTM-019, HTM-020, HTM-021, HTM-022, HTM-023, HTM-024, HTM-027, HTM-028, HTM-029, HTM-033, HTM-036, HTM-038, HTM-049, HTM-050, HTM_053, MED-001, MED-002, MED_006, NAV-002, NCX-002, NCX-003, NCX-005, OPF-008, OPF-009, OPF-019, OPF-020, OPF-046, OPF-056, OPF-058, OPF-059, OPF-068, OPF-069, RSC-018, RSC-023, SCP-001, SCP-002, SCP-003, SCP-004, SCP-005, SCP-006, SCP-007, SCP-008, SCP-009, SCP-010

Bron en licentie

Berichtteksten en standaard ernst komen van EPUBCheck 5.4.0, de EPUB validator van de W3C, uitgebracht onder de BSD-3-Clause licentie. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Oorzaken en oplossingen zijn geschreven door EpubCC. Codes zonder uitleg tonen alleen de officiële boodschap en worden niet aangeboden aan zoekmachines totdat we er één schrijven. EpubCC is niet verbonden met de W3C.

PDF naar EPUB tools

Elke tool gebruikt dezelfde engine. Tot 3 boeken per dag zijn gratis.

Bekijk alle tools