Zum Inhalt springen

EPUBCheck Nachrichten erklärt

EPUBCheck meldet jedes Problem in einem EPUB als Code wie RSC-005 oder OPF-014 mit einer Schwere. Diese Referenz listet alle 246 Nachrichten von EPUBCheck 5.4.0 mit ihrem offiziellen Text auf und erklärt Ursachen und Lösungen für 188 davon.

Aktualisiert:

Schweregrade

Fataler Fehler
EPUBCheck konnte diese Teilprüfung des EPUB nicht fortsetzen. Die Datei ist ungültig.
Fehler
Das EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet die Ausführung mit Status 1.
Warnung
Die EPUB ist weiterhin gültig, aber irgendetwas wird wahrscheinlich Probleme in einigen Leseanwendungen verursachen. EPUBCheck beendet die Ausführung mit 0, es sei denn, Sie übergeben --failonwarnings.
Nutzung
Nur informativ und standardmäßig ausgeblendet: es erscheint, wenn EPUBCheck mit -u (--usage) ausgeführt wird. Es macht EPUB nicht ungültig.
Information
Nur informativ. Es macht EPUB nicht ungültig.
Unterdrückt
EPUBCheck gibt diese Nachricht standardmäßig nicht aus. Sie erscheint nur, wenn eine benutzerdefinierte Nachrichten-Datei (-c) ihre Schwere ändert.

PKG: Paket und ZIP-Container

Die EPUB Datei selbst: das ZIP-Archiv, die mimetype-Datei, Dateinamen und Erweiterungen.

CodeStandard-SchweregradNachricht
PKG-001WarnungValidating the EPUB against version … but detected version ….
PKG-003FehlerUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Fataler FehlerCorrupted EPUB ZIP header.
PKG-005FehlerThe 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-006FehlerMimetype file entry is missing or is not the first file in the archive.
PKG-007FehlerThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Fataler FehlerUnable to read file "…".
PKG-009FehlerThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010WarnungThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011FehlerThe file name "…" is not allowed to end with ".".
PKG-012NutzungThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013FehlerThe EPUB file includes multiple OPS renditions.
PKG-014WarnungThe EPUB contains empty directory "…".
PKG-015Fataler FehlerUnable to read EPUB contents: …
PKG-016WarnungUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017WarnungUncommon EPUB file extension.
PKG-018Fataler FehlerThe EPUB file could not be found.
PKG-020FehlerOPF file "…" could not be found.
PKG-021FehlerCorrupted image file encountered.
PKG-022WarnungWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023NutzungValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024NutzungUncommon EPUB file extension.
PKG-025FehlerPublication resource must not be located in the META-INF directory
PKG-026FehlerObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Fataler FehlerCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Ressourcen und Verweise

Dateien und Links zwischen ihnen: fehlende Dateien, defekte Verweise, URLs, Kodierungen und XML-Parsing.

CodeStandard-SchweregradNachricht
RSC-001FehlerFile "…" could not be found.
RSC-002Fataler FehlerRequired META-INF/container.xml resource could not be found.
RSC-003FehlerNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004InformationFile "…" is encrypted, its content will not be checked.
RSC-005FehlerError while parsing file: …
RSC-006FehlerRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bNutzungResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007FehlerReferenced resource "…" could not be found in the EPUB.
RSC-007wWarnungReferenced resource "…" could not be found in the EPUB.
RSC-008FehlerReferenced resource "…" is not declared in the OPF manifest.
RSC-009WarnungA non-SVG image resource should not be defined with a fragment identifier.
RSC-010FehlerReference to non-standard resource type found.
RSC-011FehlerFound a reference to a resource that is not a spine item.
RSC-012FehlerFragment identifier is not defined.
RSC-013NutzungFragment identifier is used in a reference to a stylesheet resource.
RSC-014NutzungFragment identifier defines an incompatible resource type.
RSC-015NutzungA fragment identifier is required for svg use tag references.
RSC-016Fataler FehlerFatal Error while parsing file: …
RSC-017WarnungWarning while parsing file: …
RSC-019WarnungEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Fehler"…" is not a valid URL (…)
RSC-021FehlerA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022InformationCannot check image details (requires Java version 7 or higher).
RSC-024NutzungInformative parsing warning: …
RSC-025NutzungInformative parsing error: …
RSC-026FehlerURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027WarnungXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028FehlerXML documents must be encoded in UTF-8, but … was detected.
RSC-029FehlerData URL is not allowed in this context.
RSC-030FehlerFile URLs are not allowed in EPUB, but found "…".
RSC-031WarnungRemote resource references should use HTTPS, but found "…".
RSC-032FehlerFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033FehlerRelative URL strings must not have a query component, but found one in "…".
RSC-034FehlerScripts must have a JavaScript media type.
RSC-035Nutzung"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Nutzung…

OPF: Paketdokument (OPF)

Das Paketdokument: Metadaten, Manifest, spine, Eigenschaften und Rückfälligkeiten.

CodeStandard-SchweregradNachricht
OPF-001FehlerThere was an error when parsing the EPUB version: ….
OPF-002Fataler FehlerThe OPF file "…" was not found in the EPUB.
OPF-003NutzungItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004WarnungInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aFehlerInvalid prefix declaration: found empty prefix.
OPF-004bFehlerInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cFehlerInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dFehlerInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eWarnungInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fWarnungInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005FehlerInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006FehlerInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007WarnungRe-declaration of reserved prefix "…".
OPF-007aFehlerInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bFehlerInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cFehlerInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010FehlerError resolving reference: "…".
OPF-011Fehleritemref can’t have both page-spread-right and page-spread-left properties.
OPF-012FehlerItem property "…" is not defined for media type "…".
OPF-013WarnungResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014FehlerThe property "…" should be declared in the OPF file.
OPF-015FehlerThe property "…" should not be declared in the OPF file.
OPF-016FehlerThe element "rootfile" is missing its required attribute "full-path".
OPF-017FehlerThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018WarnungThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bNutzungThe "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-021WarnungUse of non-registered URI scheme type in href: "…".
OPF-025FehlerProperty value list "…" is not allowed, only one value must be specified.
OPF-026FehlerFound malformed property value: "…".
OPF-027FehlerUndefined property: "…".
OPF-028FehlerUndeclared prefix: "…".
OPF-029FehlerThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030FehlerThe unique-identifier "…" was not found.
OPF-031FehlerFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032FehlerGuide references "…" which is not a valid "OPS Content Document".
OPF-033FehlerThe spine contains no linear resources.
OPF-034FehlerThe spine contains multiple references to the manifest item with id "…".
OPF-035WarnungMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036NutzungVideo type "…" might not be supported by reading systems
OPF-037WarnungFound deprecated media-type "…".
OPF-038WarnungMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039WarnungMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040FehlerFallback item with id "…" could not be found.
OPF-041FehlerFallback-style item with id "…" could not be found.
OPF-042Fehler"…" is not a permissible spine media-type.
OPF-043FehlerSpine item with non-standard media-type "…" has no fallback.
OPF-044FehlerSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045FehlerEncountered circular reference in fallback chain.
OPF-047NutzungOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048FehlerPackage tag is missing its required unique-identifier attribute and value.
OPF-049FehlerItem id "…" was not found in the manifest.
OPF-050FehlerTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051UnterdrücktImage dimensions exceed recommended size.
OPF-052FehlerRole value "…" is not valid.
OPF-053WarnungDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054FehlerDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Warnung… tag is empty.
OPF-057UnterdrücktImage file length exceeds recommended size.
OPF-060FehlerDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062NutzungFound Adobe page-map attribute on spine element in opf file.
OPF-063WarnungReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformationOPF declares type "…", validating using profile "…".
OPF-065FehlerInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066FehlerMissing "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-067FehlerThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070WarnungCustom collection role "…" is an invalid URL.
OPF-071FehlerIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072NutzungMetadata element "…" is empty.
OPF-073FehlerExternal identifiers must not appear in the document type declaration.
OPF-074FehlerPackage resource "…" is declared in several manifest items.
OPF-075FehlerPreview collections must only point to EPUB Content Documents.
OPF-076FehlerThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077WarnungA Data Navigation Document should not be included in the spine.
OPF-078FehlerAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079WarnungDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080WarnungA Search Key Map document file name should have the extension ".xml".
OPF-081FehlerResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082FehlerFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083FehlerFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084FehlerFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Warnung"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086WarnungProperty "…" is deprecated. Consider using … instead.
OPF-086bNutzungepub:type value "…" is deprecated. Consider using … instead.
OPF-086cWarnungthe "…" reserved prefix is deprecated.
OPF-087Nutzungepub:type value "…" is not allowed on documents of type "…".
OPF-088NutzungUnrecognized epub:type value "…".
OPF-089FehlerThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090NutzungIt is encouraged to use MIME media type "…" instead of "…".
OPF-091FehlerThe item href URL must not have a fragment identifier.
OPF-092FehlerLanguage tag "…" is not well-formed: …
OPF-093FehlerThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094FehlerThe "media-type" attribute is required for "…" links.
OPF-095FehlerThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096FehlerNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bNutzungNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097NutzungResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098FehlerThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099FehlerThe manifest must not list the package document.
OPF-100NutzungThe "…" property only applies to pre-paginated content.

HTM: XHTML Inhaltsdokumente

Die XHTML Kapitel: DOCTYPE, Entitäten, Namensräume und feste Layout-Viewport.

CodeStandard-SchweregradNachricht
HTM-001FehlerAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002WarnungThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003FehlerExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004FehlerIrregular DOCTYPE: found "…", expected "…".
HTM-005NutzungAn external reference was found.
HTM-007WarnungEmpty or whitespace-only value of attribute ssml:ph.
HTM-009FehlerThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010NutzungNamespace "…" is unusual for the prefix "epub".
HTM-011FehlerEntity is undeclared.
HTM-025WarnungNon-registered URI scheme type found in href.
HTM-044NutzungNamespace uri "…" was included but not used.
HTM-045NutzungEncountered empty href.
HTM-046FehlerFixed layout document has no "viewport" meta element.
HTM-047FehlerViewport metadata "…" has a syntax error
HTM-048FehlerSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051WarnungFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052FehlerThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054FehlerCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055NutzungThe "…" element should not be used (discouraged construct)
HTM_056FehlerViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057FehlerViewport "…" value must be a positive number or the keyword "device-…"
HTM_058FehlerHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059FehlerViewport "…" property must not be defined more than once, but found values […].
HTM_060aNutzungEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bNutzungEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Fehler"…" 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_062NutzungSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063NutzungSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Stylesheets

CSS-Dateien und Stilelemente: verbotene Eigenschaften, Kodierungen, Schriftarten und Syntax.

CodeStandard-SchweregradNachricht
CSS-001FehlerThe "…" property must not be included in an EPUB Style Sheet.
CSS-002FehlerEmpty or NULL reference found.
CSS-003WarnungCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004FehlerCSS documents must be encoded in UTF-8, detected …;
CSS-005NutzungConflicting alternate style tags found: ….
CSS-006NutzungCSS selector specifies fixed position.
CSS-007InformationFont-face reference "…" refers to non-standard font type "…".
CSS-008FehlerAn error occurred while parsing the CSS: ….
CSS-015FehlerAlternative style sheets must have a title.
CSS-019WarnungCSS font-face declaration has no attributes.
CSS-028NutzungUse of Font-face declaration.
CSS-029NutzungFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030FehlerThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 Inhaltsverzeichnis)

Die alte NCX-Inhaltsübersicht.

CodeStandard-SchweregradNachricht
NCX-001FehlerNCX identifier ("…") does not match OPF identifier ("…").
NCX-004NutzungNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006NutzungEmpty "text" label in the NCX document

MED: Bilder, Audio und Medienüberlagerungen

Bildformate und -header sowie synchronisierte Audio (Medienüberlagerungen).

CodeStandard-SchweregradNachricht
MED-003FehlerPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004FehlerImage file header may be corrupted.
MED-005FehlerMedia Overlay audio reference … to non-standard audio type … found.
MED-008FehlerThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009FehlerThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007FehlerPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010FehlerEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011FehlerEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012FehlerThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013FehlerMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014FehlerMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015NutzungMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016WarnungMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017WarnungURL fragment should indicate an element ID, but found '#…'.
MED_018WarnungURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Barrierefreiheit

Barrierefreiheitsprüfungen für Inhaltsdokumente (die meisten sind standardmäßig verborgen).

CodeStandard-SchweregradNachricht
ACC-004UnterdrücktHtml "a" element must have text.
ACC-005UnterdrücktTable heading cells should be identified by "th" elements for accessibility.
ACC-006UnterdrücktTables should include a "thead" element for accessibility.
ACC-007UnterdrücktContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009NutzungMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011NutzungSVG hyperlink has no accessible name
ACC-012UnterdrücktTable elements should include a caption element.

OBS: Veraltete Funktionen

Funktionen, die noch funktionieren, aber veraltet sind.

CodeStandard-SchweregradNachricht
OBS-001NutzungUsage of … is outdated.

INF: Informationen

Hinweise zu EPUBCheck selbst.

CodeStandard-SchweregradNachricht
INF-001InformationRule … is under review and its severity may change in a future release. See the discussion at …

CHK: EPUBCheck Konfiguration

Probleme mit EPUBCheck's eigener benutzerdefinierter Nachrichten-Datei, nicht mit der EPUB.

CodeStandard-SchweregradNachricht
CHK-001FehlerThe custom message overrides file was not found.
CHK-002FehlerUnrecognized custom message id … encountered in message overrides file "…".
CHK-003FehlerUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004FehlerThe custom message contains too many parameters in message overrides file "…".
CHK-005FehlerThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006FehlerUnable to parse the custom format parameter in message overrides file "…".
CHK-007FehlerError encountered while processing custom message file "…": "…".
CHK-008FehlerError encountered while processing an item "…"; skip other checks for the item.

Abgelehnte Nachrichten-IDs

Diese IDs existieren noch in der Liste der Nachrichten von EPUBCheck, haben jedoch keinen Text und werden standardmäßig unterdrückt, sodass EPUBCheck sie niemals meldet, es sei denn, eine benutzerdefinierte Nachrichten-Datei aktiviert sie.

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

Quelle und Lizenz

Nachrichtentexte und Standard-Schwere stammen von EPUBCheck 5.4.0, dem EPUB-Validator der W3C, veröffentlicht unter der BSD-3-Clause Lizenz. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Ursachen und Lösungen werden von EpubCC beschrieben. Codes ohne Erklärung zeigen nur die offizielle Nachricht und werden nicht für Suchmaschinen angeboten, bis wir eine schreiben. EpubCC ist nicht mit dem W3C verbunden.

PDF zu EPUB Tools

Jedes Tool verwendet die gleiche Engine. Bis zu 3 Bücher pro Tag sind kostenlos.

Alle Werkzeuge ansehen