Hoppa till innehåll

EPUBCheck meddelanden förklarade

EPUBCheck rapporterar varje problem i en EPUB som en kod som RSC-005 eller OPF-014 med en svårighetsgrad. Denna referens listar alla 246 meddelanden från EPUBCheck 5.4.0 med deras officiella text och förklarar orsaker och lösningar för 188 av dem.

Uppdaterad:

Svårighetsgrader

Farligt fel
EPUBCheck kunde inte fortsätta kontrollera denna del av EPUB. Filen är ogiltig.
Fel
EPUB bryter mot en regel i specifikationen och är ogiltig. Butiker och Skicka till Kindle kan avvisa den, och EPUBCheck avslutas med status 1.
Varning
EPUB är fortfarande giltig, men något kan troligen orsaka problem i vissa läsappar. EPUBCheck avslutas med 0 om du inte passerar --failonwarnings.
Användning
Informativ endast och gömd som standard: den visas när EPUBCheck körs med -u (--usage). Det gör inte EPUB ogiltig.
Information
Informativ endast. Det gör inte EPUB ogiltig.
Undertryckt
EPUBCheck rapporterar inte detta meddelande som standard. Det visas endast om en anpassad meddelandefil (-c) ändrar dess allvarlighet.

PKG: Paket och ZIP-behållare

EPUB-filen i sig: ZIP-arkivet, mimetype-filen, filnamn och tillägg.

KodStandardsvårighetsgradMeddelande
PKG-001VarningValidating the EPUB against version … but detected version ….
PKG-003FelUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Farligt felCorrupted EPUB ZIP header.
PKG-005FelThe 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-006FelMimetype file entry is missing or is not the first file in the archive.
PKG-007FelThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Farligt felUnable to read file "…".
PKG-009FelThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010VarningThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011FelThe file name "…" is not allowed to end with ".".
PKG-012AnvändningThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013FelThe EPUB file includes multiple OPS renditions.
PKG-014VarningThe EPUB contains empty directory "…".
PKG-015Farligt felUnable to read EPUB contents: …
PKG-016VarningUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017VarningUncommon EPUB file extension.
PKG-018Farligt felThe EPUB file could not be found.
PKG-020FelOPF file "…" could not be found.
PKG-021FelCorrupted image file encountered.
PKG-022VarningWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023AnvändningValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024AnvändningUncommon EPUB file extension.
PKG-025FelPublication resource must not be located in the META-INF directory
PKG-026FelObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Farligt felCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Resurser och referenser

Filer och länkar mellan dem: saknade filer, brutna referenser, URL:er, kodningar och XML-parsing.

KodStandardsvårighetsgradMeddelande
RSC-001FelFile "…" could not be found.
RSC-002Farligt felRequired META-INF/container.xml resource could not be found.
RSC-003FelNo 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-005FelError while parsing file: …
RSC-006FelRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bAnvändningResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007FelReferenced resource "…" could not be found in the EPUB.
RSC-007wVarningReferenced resource "…" could not be found in the EPUB.
RSC-008FelReferenced resource "…" is not declared in the OPF manifest.
RSC-009VarningA non-SVG image resource should not be defined with a fragment identifier.
RSC-010FelReference to non-standard resource type found.
RSC-011FelFound a reference to a resource that is not a spine item.
RSC-012FelFragment identifier is not defined.
RSC-013AnvändningFragment identifier is used in a reference to a stylesheet resource.
RSC-014AnvändningFragment identifier defines an incompatible resource type.
RSC-015AnvändningA fragment identifier is required for svg use tag references.
RSC-016Farligt felFatal Error while parsing file: …
RSC-017VarningWarning while parsing file: …
RSC-019VarningEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Fel"…" is not a valid URL (…)
RSC-021FelA 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-024AnvändningInformative parsing warning: …
RSC-025AnvändningInformative parsing error: …
RSC-026FelURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027VarningXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028FelXML documents must be encoded in UTF-8, but … was detected.
RSC-029FelData URL is not allowed in this context.
RSC-030FelFile URLs are not allowed in EPUB, but found "…".
RSC-031VarningRemote resource references should use HTTPS, but found "…".
RSC-032FelFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033FelRelative URL strings must not have a query component, but found one in "…".
RSC-034FelScripts must have a JavaScript media type.
RSC-035Användning"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Användning…

OPF: Paketdokument (OPF)

Paketdokumentet: metadata, manifest, spine, egenskaper och fallback.

KodStandardsvårighetsgradMeddelande
OPF-001FelThere was an error when parsing the EPUB version: ….
OPF-002Farligt felThe OPF file "…" was not found in the EPUB.
OPF-003AnvändningItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004VarningInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aFelInvalid prefix declaration: found empty prefix.
OPF-004bFelInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cFelInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dFelInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eVarningInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fVarningInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005FelInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006FelInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007VarningRe-declaration of reserved prefix "…".
OPF-007aFelInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bFelInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cFelInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010FelError resolving reference: "…".
OPF-011Felitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012FelItem property "…" is not defined for media type "…".
OPF-013VarningResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014FelThe property "…" should be declared in the OPF file.
OPF-015FelThe property "…" should not be declared in the OPF file.
OPF-016FelThe element "rootfile" is missing its required attribute "full-path".
OPF-017FelThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018VarningThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bAnvändningThe "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-021VarningUse of non-registered URI scheme type in href: "…".
OPF-025FelProperty value list "…" is not allowed, only one value must be specified.
OPF-026FelFound malformed property value: "…".
OPF-027FelUndefined property: "…".
OPF-028FelUndeclared prefix: "…".
OPF-029FelThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030FelThe unique-identifier "…" was not found.
OPF-031FelFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032FelGuide references "…" which is not a valid "OPS Content Document".
OPF-033FelThe spine contains no linear resources.
OPF-034FelThe spine contains multiple references to the manifest item with id "…".
OPF-035VarningMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036AnvändningVideo type "…" might not be supported by reading systems
OPF-037VarningFound deprecated media-type "…".
OPF-038VarningMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039VarningMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040FelFallback item with id "…" could not be found.
OPF-041FelFallback-style item with id "…" could not be found.
OPF-042Fel"…" is not a permissible spine media-type.
OPF-043FelSpine item with non-standard media-type "…" has no fallback.
OPF-044FelSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045FelEncountered circular reference in fallback chain.
OPF-047AnvändningOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048FelPackage tag is missing its required unique-identifier attribute and value.
OPF-049FelItem id "…" was not found in the manifest.
OPF-050FelTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051UndertrycktImage dimensions exceed recommended size.
OPF-052FelRole value "…" is not valid.
OPF-053VarningDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054FelDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Varning… tag is empty.
OPF-057UndertrycktImage file length exceeds recommended size.
OPF-060FelDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062AnvändningFound Adobe page-map attribute on spine element in opf file.
OPF-063VarningReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformationOPF declares type "…", validating using profile "…".
OPF-065FelInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066FelMissing "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-067FelThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070VarningCustom collection role "…" is an invalid URL.
OPF-071FelIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072AnvändningMetadata element "…" is empty.
OPF-073FelExternal identifiers must not appear in the document type declaration.
OPF-074FelPackage resource "…" is declared in several manifest items.
OPF-075FelPreview collections must only point to EPUB Content Documents.
OPF-076FelThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077VarningA Data Navigation Document should not be included in the spine.
OPF-078FelAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079VarningDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080VarningA Search Key Map document file name should have the extension ".xml".
OPF-081FelResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082FelFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083FelFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084FelFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Varning"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086VarningProperty "…" is deprecated. Consider using … instead.
OPF-086bAnvändningepub:type value "…" is deprecated. Consider using … instead.
OPF-086cVarningthe "…" reserved prefix is deprecated.
OPF-087Användningepub:type value "…" is not allowed on documents of type "…".
OPF-088AnvändningUnrecognized epub:type value "…".
OPF-089FelThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090AnvändningIt is encouraged to use MIME media type "…" instead of "…".
OPF-091FelThe item href URL must not have a fragment identifier.
OPF-092FelLanguage tag "…" is not well-formed: …
OPF-093FelThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094FelThe "media-type" attribute is required for "…" links.
OPF-095FelThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096FelNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bAnvändningNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097AnvändningResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098FelThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099FelThe manifest must not list the package document.
OPF-100AnvändningThe "…" property only applies to pre-paginated content.

HTM: XHTML innehållsdokument

XHTML kapitel: DOCTYPE, entiteter, namnrymder och fasta layout-vyer.

KodStandardsvårighetsgradMeddelande
HTM-001FelAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002VarningThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003FelExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004FelIrregular DOCTYPE: found "…", expected "…".
HTM-005AnvändningAn external reference was found.
HTM-007VarningEmpty or whitespace-only value of attribute ssml:ph.
HTM-009FelThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010AnvändningNamespace "…" is unusual for the prefix "epub".
HTM-011FelEntity is undeclared.
HTM-025VarningNon-registered URI scheme type found in href.
HTM-044AnvändningNamespace uri "…" was included but not used.
HTM-045AnvändningEncountered empty href.
HTM-046FelFixed layout document has no "viewport" meta element.
HTM-047FelViewport metadata "…" has a syntax error
HTM-048FelSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051VarningFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052FelThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054FelCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055AnvändningThe "…" element should not be used (discouraged construct)
HTM_056FelViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057FelViewport "…" value must be a positive number or the keyword "device-…"
HTM_058FelHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059FelViewport "…" property must not be defined more than once, but found values […].
HTM_060aAnvändningEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bAnvändningEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Fel"…" 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_062AnvändningSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063AnvändningSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Stilmallar

CSS-filer och stilelement: förbjudna egenskaper, kodningar, typsnitt och syntax.

KodStandardsvårighetsgradMeddelande
CSS-001FelThe "…" property must not be included in an EPUB Style Sheet.
CSS-002FelEmpty or NULL reference found.
CSS-003VarningCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004FelCSS documents must be encoded in UTF-8, detected …;
CSS-005AnvändningConflicting alternate style tags found: ….
CSS-006AnvändningCSS selector specifies fixed position.
CSS-007InformationFont-face reference "…" refers to non-standard font type "…".
CSS-008FelAn error occurred while parsing the CSS: ….
CSS-015FelAlternative style sheets must have a title.
CSS-019VarningCSS font-face declaration has no attributes.
CSS-028AnvändningUse of Font-face declaration.
CSS-029AnvändningFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030FelThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 innehållsförteckning)

Den traditionella NCX-innehållsförteckningen.

KodStandardsvårighetsgradMeddelande
NCX-001FelNCX identifier ("…") does not match OPF identifier ("…").
NCX-004AnvändningNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006AnvändningEmpty "text" label in the NCX document

MED: Bilder, ljud och medieoverlay

Bildformat och rubriker, och synkroniserad ljud (mediaöverlägg).

KodStandardsvårighetsgradMeddelande
MED-003FelPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004FelImage file header may be corrupted.
MED-005FelMedia Overlay audio reference … to non-standard audio type … found.
MED-008FelThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009FelThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007FelPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010FelEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011FelEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012FelThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013FelMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014FelMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015AnvändningMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016VarningMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017VarningURL fragment should indicate an element ID, but found '#…'.
MED_018VarningURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Tillgänglighet

Tillgänglighetskontroller på innehållsdokument (de flesta döljs som standard).

KodStandardsvårighetsgradMeddelande
ACC-004UndertrycktHtml "a" element must have text.
ACC-005UndertrycktTable heading cells should be identified by "th" elements for accessibility.
ACC-006UndertrycktTables should include a "thead" element for accessibility.
ACC-007UndertrycktContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009AnvändningMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011AnvändningSVG hyperlink has no accessible name
ACC-012UndertrycktTable elements should include a caption element.

OBS: Föråldrade funktioner

Funktioner som fortfarande fungerar men är föråldrade.

KodStandardsvårighetsgradMeddelande
OBS-001AnvändningUsage of … is outdated.

INF: Information

Anteckningar om EPUBCheck själv.

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

CHK: EPUBCheck konfiguration

Problem med EPUBCheck's egen anpassade meddelandefil, inte med EPUB.

KodStandardsvårighetsgradMeddelande
CHK-001FelThe custom message overrides file was not found.
CHK-002FelUnrecognized custom message id … encountered in message overrides file "…".
CHK-003FelUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004FelThe custom message contains too many parameters in message overrides file "…".
CHK-005FelThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006FelUnable to parse the custom format parameter in message overrides file "…".
CHK-007FelError encountered while processing custom message file "…": "…".
CHK-008FelError encountered while processing an item "…"; skip other checks for the item.

Pensionerade meddelande-ID

Dessa ID:n finns fortfarande i EPUBCheck 's lista över meddelanden men har ingen text och är som standard dolda, så EPUBCheck rapporterar aldrig dem såvida inte en anpassad meddelandefil aktiverar 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

Källa och licens

Meddelandetexter och standardallvarligheter kommer från EPUBCheck 5.4.0, W3C:s EPUB validator, släppt under BSD-3-Clause-licensen. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Orsaker och lösningar skrivs av EpubCC. Koder utan förklaring visar endast meddelandet och erbjuds inte till sökmotorer förrän vi skriver en. EpubCC är inte kopplad till W3C.

PDF till EPUB verktyg

Varje verktyg använder samma motor. Upp till 3 böcker per dag är gratis.

Se alla verktyg