Spring til indhold

EPUBCheck meddelelser forklaret

EPUBCheck rapporterer hvert problem i en EPUB som en kode såsom RSC-005 eller OPF-014 med en severitet. Denne reference viser alle 246 meddelelser fra EPUBCheck 5.4.0 med deres officielle tekst og forklarer årsager og løsninger for 188 af dem.

Opdateret:

Alvorligheder

Fatal fejl
EPUBCheck kunne ikke fortsætte med at kontrollere denne del af EPUB. Filen er ugyldig.
Fejl
EPUB bryder en regel i specifikationen og er ugyldig. Lagring og Send til Kindle kan afvise det, og EPUBCheck afsluttes med status 1.
Advarsel
EPUB er stadig gyldig, men noget vil sandsynligvis forårsage problemer i nogle læse-apps. EPUBCheck afsluttes med 0, medmindre du angiver --failonwarnings.
Brug
Kun informativ og skjult som standard: den vises, når EPUBCheck køres med -u (--usage). Det gør ikke EPUB ugyldig.
Information
Kun informativ. Det gør ikke EPUB ugyldig.
Undertrykt
EPUBCheck rapporterer ikke denne meddelelse som standard. Den vises kun, hvis en brugerdefineret meddelelsesfil (-c) ændrer dens alvorlighed.

PKG: Pakke og ZIP-container

EPUB filen selv: ZIP-arkivet, mimetype-filen, filnavne og -udvidelser.

KodeStandard alvorlighedBesked
PKG-001AdvarselValidating the EPUB against version … but detected version ….
PKG-003FejlUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Fatal fejlCorrupted EPUB ZIP header.
PKG-005FejlThe 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-006FejlMimetype file entry is missing or is not the first file in the archive.
PKG-007FejlThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Fatal fejlUnable to read file "…".
PKG-009FejlThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010AdvarselThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011FejlThe file name "…" is not allowed to end with ".".
PKG-012BrugThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013FejlThe EPUB file includes multiple OPS renditions.
PKG-014AdvarselThe EPUB contains empty directory "…".
PKG-015Fatal fejlUnable to read EPUB contents: …
PKG-016AdvarselUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017AdvarselUncommon EPUB file extension.
PKG-018Fatal fejlThe EPUB file could not be found.
PKG-020FejlOPF file "…" could not be found.
PKG-021FejlCorrupted image file encountered.
PKG-022AdvarselWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023BrugValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024BrugUncommon EPUB file extension.
PKG-025FejlPublication resource must not be located in the META-INF directory
PKG-026FejlObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Fatal fejlCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Ressourcer og referencer

Filer og links imellem dem: manglende filer, brudte referencer, URLs, kodninger og XML-parsing.

KodeStandard alvorlighedBesked
RSC-001FejlFile "…" could not be found.
RSC-002Fatal fejlRequired META-INF/container.xml resource could not be found.
RSC-003FejlNo 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-005FejlError while parsing file: …
RSC-006FejlRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bBrugResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007FejlReferenced resource "…" could not be found in the EPUB.
RSC-007wAdvarselReferenced resource "…" could not be found in the EPUB.
RSC-008FejlReferenced resource "…" is not declared in the OPF manifest.
RSC-009AdvarselA non-SVG image resource should not be defined with a fragment identifier.
RSC-010FejlReference to non-standard resource type found.
RSC-011FejlFound a reference to a resource that is not a spine item.
RSC-012FejlFragment identifier is not defined.
RSC-013BrugFragment identifier is used in a reference to a stylesheet resource.
RSC-014BrugFragment identifier defines an incompatible resource type.
RSC-015BrugA fragment identifier is required for svg use tag references.
RSC-016Fatal fejlFatal Error while parsing file: …
RSC-017AdvarselWarning while parsing file: …
RSC-019AdvarselEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Fejl"…" is not a valid URL (…)
RSC-021FejlA 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-024BrugInformative parsing warning: …
RSC-025BrugInformative parsing error: …
RSC-026FejlURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027AdvarselXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028FejlXML documents must be encoded in UTF-8, but … was detected.
RSC-029FejlData URL is not allowed in this context.
RSC-030FejlFile URLs are not allowed in EPUB, but found "…".
RSC-031AdvarselRemote resource references should use HTTPS, but found "…".
RSC-032FejlFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033FejlRelative URL strings must not have a query component, but found one in "…".
RSC-034FejlScripts must have a JavaScript media type.
RSC-035Brug"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Brug…

OPF: Pakke-dokument (OPF)

Pakagedokumentet: metadata, manifest, spine, egenskaber og fallback.

KodeStandard alvorlighedBesked
OPF-001FejlThere was an error when parsing the EPUB version: ….
OPF-002Fatal fejlThe OPF file "…" was not found in the EPUB.
OPF-003BrugItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004AdvarselInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aFejlInvalid prefix declaration: found empty prefix.
OPF-004bFejlInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cFejlInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dFejlInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eAdvarselInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fAdvarselInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005FejlInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006FejlInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007AdvarselRe-declaration of reserved prefix "…".
OPF-007aFejlInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bFejlInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cFejlInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010FejlError resolving reference: "…".
OPF-011Fejlitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012FejlItem property "…" is not defined for media type "…".
OPF-013AdvarselResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014FejlThe property "…" should be declared in the OPF file.
OPF-015FejlThe property "…" should not be declared in the OPF file.
OPF-016FejlThe element "rootfile" is missing its required attribute "full-path".
OPF-017FejlThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018AdvarselThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bBrugThe "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-021AdvarselUse of non-registered URI scheme type in href: "…".
OPF-025FejlProperty value list "…" is not allowed, only one value must be specified.
OPF-026FejlFound malformed property value: "…".
OPF-027FejlUndefined property: "…".
OPF-028FejlUndeclared prefix: "…".
OPF-029FejlThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030FejlThe unique-identifier "…" was not found.
OPF-031FejlFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032FejlGuide references "…" which is not a valid "OPS Content Document".
OPF-033FejlThe spine contains no linear resources.
OPF-034FejlThe spine contains multiple references to the manifest item with id "…".
OPF-035AdvarselMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036BrugVideo type "…" might not be supported by reading systems
OPF-037AdvarselFound deprecated media-type "…".
OPF-038AdvarselMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039AdvarselMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040FejlFallback item with id "…" could not be found.
OPF-041FejlFallback-style item with id "…" could not be found.
OPF-042Fejl"…" is not a permissible spine media-type.
OPF-043FejlSpine item with non-standard media-type "…" has no fallback.
OPF-044FejlSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045FejlEncountered circular reference in fallback chain.
OPF-047BrugOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048FejlPackage tag is missing its required unique-identifier attribute and value.
OPF-049FejlItem id "…" was not found in the manifest.
OPF-050FejlTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051UndertryktImage dimensions exceed recommended size.
OPF-052FejlRole value "…" is not valid.
OPF-053AdvarselDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054FejlDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Advarsel… tag is empty.
OPF-057UndertryktImage file length exceeds recommended size.
OPF-060FejlDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062BrugFound Adobe page-map attribute on spine element in opf file.
OPF-063AdvarselReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformationOPF declares type "…", validating using profile "…".
OPF-065FejlInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066FejlMissing "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-067FejlThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070AdvarselCustom collection role "…" is an invalid URL.
OPF-071FejlIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072BrugMetadata element "…" is empty.
OPF-073FejlExternal identifiers must not appear in the document type declaration.
OPF-074FejlPackage resource "…" is declared in several manifest items.
OPF-075FejlPreview collections must only point to EPUB Content Documents.
OPF-076FejlThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077AdvarselA Data Navigation Document should not be included in the spine.
OPF-078FejlAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079AdvarselDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080AdvarselA Search Key Map document file name should have the extension ".xml".
OPF-081FejlResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082FejlFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083FejlFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084FejlFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Advarsel"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086AdvarselProperty "…" is deprecated. Consider using … instead.
OPF-086bBrugepub:type value "…" is deprecated. Consider using … instead.
OPF-086cAdvarselthe "…" reserved prefix is deprecated.
OPF-087Brugepub:type value "…" is not allowed on documents of type "…".
OPF-088BrugUnrecognized epub:type value "…".
OPF-089FejlThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090BrugIt is encouraged to use MIME media type "…" instead of "…".
OPF-091FejlThe item href URL must not have a fragment identifier.
OPF-092FejlLanguage tag "…" is not well-formed: …
OPF-093FejlThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094FejlThe "media-type" attribute is required for "…" links.
OPF-095FejlThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096FejlNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bBrugNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097BrugResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098FejlThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099FejlThe manifest must not list the package document.
OPF-100BrugThe "…" property only applies to pre-paginated content.

HTM: XHTML indholds dokumenter

XHTML kapitler: DOCTYPE, enheder, navnerum og fast-layout visninger.

KodeStandard alvorlighedBesked
HTM-001FejlAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002AdvarselThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003FejlExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004FejlIrregular DOCTYPE: found "…", expected "…".
HTM-005BrugAn external reference was found.
HTM-007AdvarselEmpty or whitespace-only value of attribute ssml:ph.
HTM-009FejlThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010BrugNamespace "…" is unusual for the prefix "epub".
HTM-011FejlEntity is undeclared.
HTM-025AdvarselNon-registered URI scheme type found in href.
HTM-044BrugNamespace uri "…" was included but not used.
HTM-045BrugEncountered empty href.
HTM-046FejlFixed layout document has no "viewport" meta element.
HTM-047FejlViewport metadata "…" has a syntax error
HTM-048FejlSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051AdvarselFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052FejlThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054FejlCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055BrugThe "…" element should not be used (discouraged construct)
HTM_056FejlViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057FejlViewport "…" value must be a positive number or the keyword "device-…"
HTM_058FejlHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059FejlViewport "…" property must not be defined more than once, but found values […].
HTM_060aBrugEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bBrugEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Fejl"…" 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_062BrugSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063BrugSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Stilarter

CSS-filer og stilarter: forbudte egenskaber, kodninger, skrifttyper og syntaks.

KodeStandard alvorlighedBesked
CSS-001FejlThe "…" property must not be included in an EPUB Style Sheet.
CSS-002FejlEmpty or NULL reference found.
CSS-003AdvarselCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004FejlCSS documents must be encoded in UTF-8, detected …;
CSS-005BrugConflicting alternate style tags found: ….
CSS-006BrugCSS selector specifies fixed position.
CSS-007InformationFont-face reference "…" refers to non-standard font type "…".
CSS-008FejlAn error occurred while parsing the CSS: ….
CSS-015FejlAlternative style sheets must have a title.
CSS-019AdvarselCSS font-face declaration has no attributes.
CSS-028BrugUse of Font-face declaration.
CSS-029BrugFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030FejlThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 indholdsfortegnelse)

Den ældre NCX-indholdsfortegnelse.

KodeStandard alvorlighedBesked
NCX-001FejlNCX identifier ("…") does not match OPF identifier ("…").
NCX-004BrugNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006BrugEmpty "text" label in the NCX document

MED: Billeder, lyd og medieoverlays

Billedformater og headers, samt synkroniseret lyd (medieoverlejringer).

KodeStandard alvorlighedBesked
MED-003FejlPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004FejlImage file header may be corrupted.
MED-005FejlMedia Overlay audio reference … to non-standard audio type … found.
MED-008FejlThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009FejlThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007FejlPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010FejlEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011FejlEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012FejlThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013FejlMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014FejlMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015BrugMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016AdvarselMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017AdvarselURL fragment should indicate an element ID, but found '#…'.
MED_018AdvarselURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Tilgængelighed

Tilgængelighedstjek på indholds dokumenter (de fleste er undertrykt som standard).

KodeStandard alvorlighedBesked
ACC-004UndertryktHtml "a" element must have text.
ACC-005UndertryktTable heading cells should be identified by "th" elements for accessibility.
ACC-006UndertryktTables should include a "thead" element for accessibility.
ACC-007UndertryktContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009BrugMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011BrugSVG hyperlink has no accessible name
ACC-012UndertryktTable elements should include a caption element.

OBS: Forældede funktioner

Funktioner der stadig fungerer, men er forældede.

KodeStandard alvorlighedBesked
OBS-001BrugUsage of … is outdated.

INF: Information

Noter om EPUBCheck selv.

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

CHK: EPUBCheck konfiguration

Problemer med EPUBCheck's egen brugerdefinerede meddelelsesfil, ikke med EPUB.

KodeStandard alvorlighedBesked
CHK-001FejlThe custom message overrides file was not found.
CHK-002FejlUnrecognized custom message id … encountered in message overrides file "…".
CHK-003FejlUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004FejlThe custom message contains too many parameters in message overrides file "…".
CHK-005FejlThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006FejlUnable to parse the custom format parameter in message overrides file "…".
CHK-007FejlError encountered while processing custom message file "…": "…".
CHK-008FejlError encountered while processing an item "…"; skip other checks for the item.

Pensionerede besked ID'er

Disse ID'er findes stadig i EPUBCheck's liste over meddelelser, men har ingen tekst og undertrykkes som standard, så EPUBCheck rapporterer dem aldrig, medmindre en brugerdefineret meddelelsesfil tænder dem.

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

Kilde og licens

Beskedtekster og standardalvorligheder kommer fra EPUBCheck 5.4.0, W3C's EPUB validator, udgivet under BSD-3-Klausul licensen. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Årsager og løsninger skrives af EpubCC. Koder uden forklaring viser kun den officielle besked og tilbydes ikke til søgemaskiner, før vi skriver en. EpubCC er ikke associeret med W3C.

PDF til EPUB værktøjer

Hvert værktøj bruger den samme motor. Op til 3 bøger om dagen er gratis.

Se alle værktøjer