Přeskočit na obsah

Vysvětleny zprávy EPUBCheck

EPUBCheck hlásí každý problém v EPUB jako kód, například RSC-005 nebo OPF-014 s označením závažnosti. Tento referenční dokument obsahuje všechny 246 zprávy EPUBCheck 5.4.0 s jejich oficiálním textem a vysvětluje příčiny a opravy pro 188 z nich.

Aktualizováno:

Závažnosti

Fatální chyba
EPUBCheck nemohla pokračovat v kontrole této části EPUB. Soubor je neplatný.
Chyba
EPUB porušuje pravidlo specifikace a je neplatný. Obchody a Odeslat do Kindle ho mohou odmítnout, a EPUBCheck ukončuje s chybovým stavem 1.
Varování
EPUB je stále platný, ale něco pravděpodobně způsobí problémy v některých čtecích aplikacích. EPUBCheck končí s 0, pokud nepřejdete na --failonwarnings.
Použití
Pouze informativní a ve výchozím nastavení skryté: objeví se, když EPUBCheck běží s -u (--usage). Nečiní EPUB neplatným.
Informace
Pouze informativní. Nečiní EPUB neplatným.
Potlačeno
EPUBCheck výchozí zprávu nehlásí. Objeví se pouze, pokud vlastní zprávový soubor (-c) změní její závažnost.

PKG: Balíček a ZIP kontejner

Soubor EPUB sám: ZIP archiv, soubor mimetype, názvy a přípony souborů.

KódVýchozí závažnostZpráva
PKG-001VarováníValidating the EPUB against version … but detected version ….
PKG-003ChybaUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Fatální chybaCorrupted EPUB ZIP header.
PKG-005ChybaThe 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-006ChybaMimetype file entry is missing or is not the first file in the archive.
PKG-007ChybaThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Fatální chybaUnable to read file "…".
PKG-009ChybaThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010VarováníThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011ChybaThe file name "…" is not allowed to end with ".".
PKG-012PoužitíThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013ChybaThe EPUB file includes multiple OPS renditions.
PKG-014VarováníThe EPUB contains empty directory "…".
PKG-015Fatální chybaUnable to read EPUB contents: …
PKG-016VarováníUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017VarováníUncommon EPUB file extension.
PKG-018Fatální chybaThe EPUB file could not be found.
PKG-020ChybaOPF file "…" could not be found.
PKG-021ChybaCorrupted image file encountered.
PKG-022VarováníWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023PoužitíValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024PoužitíUncommon EPUB file extension.
PKG-025ChybaPublication resource must not be located in the META-INF directory
PKG-026ChybaObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Fatální chybaCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Zdroje a odkazy

Soubory a odkazy mezi nimi: chybějící soubory, poškozené odkazy, URL, kódování a XML parsování.

KódVýchozí závažnostZpráva
RSC-001ChybaFile "…" could not be found.
RSC-002Fatální chybaRequired META-INF/container.xml resource could not be found.
RSC-003ChybaNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004InformaceFile "…" is encrypted, its content will not be checked.
RSC-005ChybaError while parsing file: …
RSC-006ChybaRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bPoužitíResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007ChybaReferenced resource "…" could not be found in the EPUB.
RSC-007wVarováníReferenced resource "…" could not be found in the EPUB.
RSC-008ChybaReferenced resource "…" is not declared in the OPF manifest.
RSC-009VarováníA non-SVG image resource should not be defined with a fragment identifier.
RSC-010ChybaReference to non-standard resource type found.
RSC-011ChybaFound a reference to a resource that is not a spine item.
RSC-012ChybaFragment identifier is not defined.
RSC-013PoužitíFragment identifier is used in a reference to a stylesheet resource.
RSC-014PoužitíFragment identifier defines an incompatible resource type.
RSC-015PoužitíA fragment identifier is required for svg use tag references.
RSC-016Fatální chybaFatal Error while parsing file: …
RSC-017VarováníWarning while parsing file: …
RSC-019VarováníEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Chyba"…" is not a valid URL (…)
RSC-021ChybaA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022InformaceCannot check image details (requires Java version 7 or higher).
RSC-024PoužitíInformative parsing warning: …
RSC-025PoužitíInformative parsing error: …
RSC-026ChybaURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027VarováníXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028ChybaXML documents must be encoded in UTF-8, but … was detected.
RSC-029ChybaData URL is not allowed in this context.
RSC-030ChybaFile URLs are not allowed in EPUB, but found "…".
RSC-031VarováníRemote resource references should use HTTPS, but found "…".
RSC-032ChybaFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033ChybaRelative URL strings must not have a query component, but found one in "…".
RSC-034ChybaScripts must have a JavaScript media type.
RSC-035Použití"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Použití…

OPF: Počet stran, zhruba v poměru, jakmile jsou zahrnuty obrázky.

Dokument balíčku: metadata, manifest, spine, vlastnosti a náhrady.

KódVýchozí závažnostZpráva
OPF-001ChybaThere was an error when parsing the EPUB version: ….
OPF-002Fatální chybaThe OPF file "…" was not found in the EPUB.
OPF-003PoužitíItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004VarováníInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aChybaInvalid prefix declaration: found empty prefix.
OPF-004bChybaInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cChybaInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dChybaInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eVarováníInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fVarováníInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005ChybaInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006ChybaInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007VarováníRe-declaration of reserved prefix "…".
OPF-007aChybaInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bChybaInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cChybaInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010ChybaError resolving reference: "…".
OPF-011Chybaitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012ChybaItem property "…" is not defined for media type "…".
OPF-013VarováníResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014ChybaThe property "…" should be declared in the OPF file.
OPF-015ChybaThe property "…" should not be declared in the OPF file.
OPF-016ChybaThe element "rootfile" is missing its required attribute "full-path".
OPF-017ChybaThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018VarováníThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bPoužitíThe "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-021VarováníUse of non-registered URI scheme type in href: "…".
OPF-025ChybaProperty value list "…" is not allowed, only one value must be specified.
OPF-026ChybaFound malformed property value: "…".
OPF-027ChybaUndefined property: "…".
OPF-028ChybaUndeclared prefix: "…".
OPF-029ChybaThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030ChybaThe unique-identifier "…" was not found.
OPF-031ChybaFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032ChybaGuide references "…" which is not a valid "OPS Content Document".
OPF-033ChybaThe spine contains no linear resources.
OPF-034ChybaThe spine contains multiple references to the manifest item with id "…".
OPF-035VarováníMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036PoužitíVideo type "…" might not be supported by reading systems
OPF-037VarováníFound deprecated media-type "…".
OPF-038VarováníMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039VarováníMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040ChybaFallback item with id "…" could not be found.
OPF-041ChybaFallback-style item with id "…" could not be found.
OPF-042Chyba"…" is not a permissible spine media-type.
OPF-043ChybaSpine item with non-standard media-type "…" has no fallback.
OPF-044ChybaSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045ChybaEncountered circular reference in fallback chain.
OPF-047PoužitíOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048ChybaPackage tag is missing its required unique-identifier attribute and value.
OPF-049ChybaItem id "…" was not found in the manifest.
OPF-050ChybaTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051PotlačenoImage dimensions exceed recommended size.
OPF-052ChybaRole value "…" is not valid.
OPF-053VarováníDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054ChybaDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Varování… tag is empty.
OPF-057PotlačenoImage file length exceeds recommended size.
OPF-060ChybaDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062PoužitíFound Adobe page-map attribute on spine element in opf file.
OPF-063VarováníReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformaceOPF declares type "…", validating using profile "…".
OPF-065ChybaInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066ChybaMissing "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-067ChybaThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070VarováníCustom collection role "…" is an invalid URL.
OPF-071ChybaIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072PoužitíMetadata element "…" is empty.
OPF-073ChybaExternal identifiers must not appear in the document type declaration.
OPF-074ChybaPackage resource "…" is declared in several manifest items.
OPF-075ChybaPreview collections must only point to EPUB Content Documents.
OPF-076ChybaThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077VarováníA Data Navigation Document should not be included in the spine.
OPF-078ChybaAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079VarováníDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080VarováníA Search Key Map document file name should have the extension ".xml".
OPF-081ChybaResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082ChybaFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083ChybaFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084ChybaFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Varování"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086VarováníProperty "…" is deprecated. Consider using … instead.
OPF-086bPoužitíepub:type value "…" is deprecated. Consider using … instead.
OPF-086cVarováníthe "…" reserved prefix is deprecated.
OPF-087Použitíepub:type value "…" is not allowed on documents of type "…".
OPF-088PoužitíUnrecognized epub:type value "…".
OPF-089ChybaThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090PoužitíIt is encouraged to use MIME media type "…" instead of "…".
OPF-091ChybaThe item href URL must not have a fragment identifier.
OPF-092ChybaLanguage tag "…" is not well-formed: …
OPF-093ChybaThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094ChybaThe "media-type" attribute is required for "…" links.
OPF-095ChybaThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096ChybaNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bPoužitíNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097PoužitíResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098ChybaThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099ChybaThe manifest must not list the package document.
OPF-100PoužitíThe "…" property only applies to pre-paginated content.

HTM: XHTML dokumenty obsahu

XHTML kapitoly: DOCTYPE, entity, jmenné prostory a fixní rozvržení viewportů.

KódVýchozí závažnostZpráva
HTM-001ChybaAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002VarováníThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003ChybaExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004ChybaIrregular DOCTYPE: found "…", expected "…".
HTM-005PoužitíAn external reference was found.
HTM-007VarováníEmpty or whitespace-only value of attribute ssml:ph.
HTM-009ChybaThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010PoužitíNamespace "…" is unusual for the prefix "epub".
HTM-011ChybaEntity is undeclared.
HTM-025VarováníNon-registered URI scheme type found in href.
HTM-044PoužitíNamespace uri "…" was included but not used.
HTM-045PoužitíEncountered empty href.
HTM-046ChybaFixed layout document has no "viewport" meta element.
HTM-047ChybaViewport metadata "…" has a syntax error
HTM-048ChybaSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051VarováníFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052ChybaThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054ChybaCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055PoužitíThe "…" element should not be used (discouraged construct)
HTM_056ChybaViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057ChybaViewport "…" value must be a positive number or the keyword "device-…"
HTM_058ChybaHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059ChybaViewport "…" property must not be defined more than once, but found values […].
HTM_060aPoužitíEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bPoužitíEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Chyba"…" 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_062PoužitíSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063PoužitíSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Stylové listy

CSS soubory a styly: zakázané vlastnosti, kódování, písma a syntaxe.

KódVýchozí závažnostZpráva
CSS-001ChybaThe "…" property must not be included in an EPUB Style Sheet.
CSS-002ChybaEmpty or NULL reference found.
CSS-003VarováníCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004ChybaCSS documents must be encoded in UTF-8, detected …;
CSS-005PoužitíConflicting alternate style tags found: ….
CSS-006PoužitíCSS selector specifies fixed position.
CSS-007InformaceFont-face reference "…" refers to non-standard font type "…".
CSS-008ChybaAn error occurred while parsing the CSS: ….
CSS-015ChybaAlternative style sheets must have a title.
CSS-019VarováníCSS font-face declaration has no attributes.
CSS-028PoužitíUse of Font-face declaration.
CSS-029PoužitíFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030ChybaThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 tabulka obsahu)

Zastaralá tabulka obsahu NCX.

KódVýchozí závažnostZpráva
NCX-001ChybaNCX identifier ("…") does not match OPF identifier ("…").
NCX-004PoužitíNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006PoužitíEmpty "text" label in the NCX document

MED: Obrázky, zvuk a multimediální překryvy

Obrazové formáty a hlavičky a synchronizovaný zvuk (mediální překryvy).

KódVýchozí závažnostZpráva
MED-003ChybaPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004ChybaImage file header may be corrupted.
MED-005ChybaMedia Overlay audio reference … to non-standard audio type … found.
MED-008ChybaThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009ChybaThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007ChybaPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010ChybaEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011ChybaEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012ChybaThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013ChybaMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014ChybaMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015PoužitíMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016VarováníMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017VarováníURL fragment should indicate an element ID, but found '#…'.
MED_018VarováníURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Přístupnost

Kontroly přístupnosti na obsahových dokumentech (většina je ve výchozím nastavení potlačena).

KódVýchozí závažnostZpráva
ACC-004PotlačenoHtml "a" element must have text.
ACC-005PotlačenoTable heading cells should be identified by "th" elements for accessibility.
ACC-006PotlačenoTables should include a "thead" element for accessibility.
ACC-007PotlačenoContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009PoužitíMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011PoužitíSVG hyperlink has no accessible name
ACC-012PotlačenoTable elements should include a caption element.

OBS: Zastaralé funkce

Funkce, které stále fungují, ale jsou zastaralé.

KódVýchozí závažnostZpráva
OBS-001PoužitíUsage of … is outdated.

INF: Informace

Poznámky o EPUBCheck samotném.

KódVýchozí závažnostZpráva
INF-001InformaceRule … is under review and its severity may change in a future release. See the discussion at …

CHK: EPUBCheck konfigurace

Problémy s vlastním souborovým chybovým protokolem EPUBCheck, ne s EPUB.

KódVýchozí závažnostZpráva
CHK-001ChybaThe custom message overrides file was not found.
CHK-002ChybaUnrecognized custom message id … encountered in message overrides file "…".
CHK-003ChybaUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004ChybaThe custom message contains too many parameters in message overrides file "…".
CHK-005ChybaThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006ChybaUnable to parse the custom format parameter in message overrides file "…".
CHK-007ChybaError encountered while processing custom message file "…": "…".
CHK-008ChybaError encountered while processing an item "…"; skip other checks for the item.

Zrušené ID zpráv

Tyto ID stále existují v seznamu zpráv EPUBCheck, ale nemají žádný text a jsou standardně potlačeny, takže EPUBCheck je nikdy nehlásí, pokud vlastní zprávový soubor je nezapne.

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

Zdroj a licence

Texty zpráv a výchozí závažnosti pocházejí z EPUBCheck 5.4.0, validátoru EPUB W3C, vydaného pod licencí BSD-3-Clause. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Příčiny a řešení píše EpubCC. Kódy bez vysvětlení ukazují pouze oficiální zprávu a nejsou nabízeny vyhledávačům, dokud nenapíšeme jedno. EpubCC není spojeno s W3C.

PDF do EPUB nástrojů

Každý nástroj používá stejný motor. Až 3 knihy denně jsou zdarma.

Vidět všechny nástroje