Przejdź do treści

Wyjaśnienie komunikatów EPUBCheck

EPUBCheck zgłasza każdy problem w EPUB jako kod, taki jak RSC-005 lub OPF-014 z określoną powagą. To odniesienie zawiera wszystkie komunikaty 246 z EPUBCheck 5.4.0 z ich oficjalnym tekstem i wyjaśnia przyczyny oraz poprawki dla 188 z nich.

Zaktualizowane:

Powagi

Błąd krytyczny
EPUBCheck nie mogło kontynuować sprawdzania tej części EPUB. Plik jest nieprawidłowy.
Błąd
EPUB łamie zasady specyfikacji i jest nieprawidłowy. Sklepy i Wysłanie do Kindle mogą go odrzucić, a EPUBCheck kończy działanie ze statusem 1.
Ostrzeżenie
EPUB jest wciąż ważny, ale coś może powodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy działanie z wynikiem 0, chyba że przekażesz --failonwarnings.
Użycie
Tylko informacyjne i domyślnie ukryte: pojawia się, gdy EPUBCheck jest uruchamiane z -u (--usage). Nie czyni to EPUB nieważnym.
Informacje
Tylko informacyjne. Nie czyni to EPUB nieważnym.
Stłumione
EPUBCheck nie zgłasza tej wiadomości domyślnie. Pojawia się tylko wtedy, gdy niestandardowy plik wiadomości (-c) zmienia jej ciężkość.

PKG: Pakiet i kontener ZIP

Plik EPUB: archiwum ZIP, plik mimetype, nazwy plików i rozszerzenia.

KodDomyślna powagaWiadomość
PKG-001OstrzeżenieValidating the EPUB against version … but detected version ….
PKG-003BłądUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Błąd krytycznyCorrupted EPUB ZIP header.
PKG-005BłądThe 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-006BłądMimetype file entry is missing or is not the first file in the archive.
PKG-007BłądThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Błąd krytycznyUnable to read file "…".
PKG-009BłądThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010OstrzeżenieThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011BłądThe file name "…" is not allowed to end with ".".
PKG-012UżycieThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013BłądThe EPUB file includes multiple OPS renditions.
PKG-014OstrzeżenieThe EPUB contains empty directory "…".
PKG-015Błąd krytycznyUnable to read EPUB contents: …
PKG-016OstrzeżenieUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017OstrzeżenieUncommon EPUB file extension.
PKG-018Błąd krytycznyThe EPUB file could not be found.
PKG-020BłądOPF file "…" could not be found.
PKG-021BłądCorrupted image file encountered.
PKG-022OstrzeżenieWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023UżycieValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024UżycieUncommon EPUB file extension.
PKG-025BłądPublication resource must not be located in the META-INF directory
PKG-026BłądObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Błąd krytycznyCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Zasoby i odniesienia

Pliki i linki między nimi: brakujące pliki, uszkodzone odwołania, adresy URL, kodowania i analizowanie XML.

KodDomyślna powagaWiadomość
RSC-001BłądFile "…" could not be found.
RSC-002Błąd krytycznyRequired META-INF/container.xml resource could not be found.
RSC-003BłądNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004InformacjeFile "…" is encrypted, its content will not be checked.
RSC-005BłądError while parsing file: …
RSC-006BłądRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bUżycieResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007BłądReferenced resource "…" could not be found in the EPUB.
RSC-007wOstrzeżenieReferenced resource "…" could not be found in the EPUB.
RSC-008BłądReferenced resource "…" is not declared in the OPF manifest.
RSC-009OstrzeżenieA non-SVG image resource should not be defined with a fragment identifier.
RSC-010BłądReference to non-standard resource type found.
RSC-011BłądFound a reference to a resource that is not a spine item.
RSC-012BłądFragment identifier is not defined.
RSC-013UżycieFragment identifier is used in a reference to a stylesheet resource.
RSC-014UżycieFragment identifier defines an incompatible resource type.
RSC-015UżycieA fragment identifier is required for svg use tag references.
RSC-016Błąd krytycznyFatal Error while parsing file: …
RSC-017OstrzeżenieWarning while parsing file: …
RSC-019OstrzeżenieEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Błąd"…" is not a valid URL (…)
RSC-021BłądA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022InformacjeCannot check image details (requires Java version 7 or higher).
RSC-024UżycieInformative parsing warning: …
RSC-025UżycieInformative parsing error: …
RSC-026BłądURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027OstrzeżenieXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028BłądXML documents must be encoded in UTF-8, but … was detected.
RSC-029BłądData URL is not allowed in this context.
RSC-030BłądFile URLs are not allowed in EPUB, but found "…".
RSC-031OstrzeżenieRemote resource references should use HTTPS, but found "…".
RSC-032BłądFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033BłądRelative URL strings must not have a query component, but found one in "…".
RSC-034BłądScripts must have a JavaScript media type.
RSC-035Użycie"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Użycie…

OPF: Dokument pakietu (OPF)

Dokument pakietu: metadane, manifest, spine, właściwości i alternatywy.

KodDomyślna powagaWiadomość
OPF-001BłądThere was an error when parsing the EPUB version: ….
OPF-002Błąd krytycznyThe OPF file "…" was not found in the EPUB.
OPF-003UżycieItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004OstrzeżenieInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aBłądInvalid prefix declaration: found empty prefix.
OPF-004bBłądInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cBłądInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dBłądInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eOstrzeżenieInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fOstrzeżenieInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005BłądInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006BłądInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007OstrzeżenieRe-declaration of reserved prefix "…".
OPF-007aBłądInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bBłądInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cBłądInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010BłądError resolving reference: "…".
OPF-011Błąditemref can’t have both page-spread-right and page-spread-left properties.
OPF-012BłądItem property "…" is not defined for media type "…".
OPF-013OstrzeżenieResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014BłądThe property "…" should be declared in the OPF file.
OPF-015BłądThe property "…" should not be declared in the OPF file.
OPF-016BłądThe element "rootfile" is missing its required attribute "full-path".
OPF-017BłądThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018OstrzeżenieThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bUżycieThe "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-021OstrzeżenieUse of non-registered URI scheme type in href: "…".
OPF-025BłądProperty value list "…" is not allowed, only one value must be specified.
OPF-026BłądFound malformed property value: "…".
OPF-027BłądUndefined property: "…".
OPF-028BłądUndeclared prefix: "…".
OPF-029BłądThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030BłądThe unique-identifier "…" was not found.
OPF-031BłądFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032BłądGuide references "…" which is not a valid "OPS Content Document".
OPF-033BłądThe spine contains no linear resources.
OPF-034BłądThe spine contains multiple references to the manifest item with id "…".
OPF-035OstrzeżenieMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036UżycieVideo type "…" might not be supported by reading systems
OPF-037OstrzeżenieFound deprecated media-type "…".
OPF-038OstrzeżenieMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039OstrzeżenieMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040BłądFallback item with id "…" could not be found.
OPF-041BłądFallback-style item with id "…" could not be found.
OPF-042Błąd"…" is not a permissible spine media-type.
OPF-043BłądSpine item with non-standard media-type "…" has no fallback.
OPF-044BłądSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045BłądEncountered circular reference in fallback chain.
OPF-047UżycieOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048BłądPackage tag is missing its required unique-identifier attribute and value.
OPF-049BłądItem id "…" was not found in the manifest.
OPF-050BłądTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051StłumioneImage dimensions exceed recommended size.
OPF-052BłądRole value "…" is not valid.
OPF-053OstrzeżenieDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054BłądDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Ostrzeżenie… tag is empty.
OPF-057StłumioneImage file length exceeds recommended size.
OPF-060BłądDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062UżycieFound Adobe page-map attribute on spine element in opf file.
OPF-063OstrzeżenieReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformacjeOPF declares type "…", validating using profile "…".
OPF-065BłądInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066BłądMissing "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-067BłądThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070OstrzeżenieCustom collection role "…" is an invalid URL.
OPF-071BłądIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072UżycieMetadata element "…" is empty.
OPF-073BłądExternal identifiers must not appear in the document type declaration.
OPF-074BłądPackage resource "…" is declared in several manifest items.
OPF-075BłądPreview collections must only point to EPUB Content Documents.
OPF-076BłądThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077OstrzeżenieA Data Navigation Document should not be included in the spine.
OPF-078BłądAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079OstrzeżenieDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080OstrzeżenieA Search Key Map document file name should have the extension ".xml".
OPF-081BłądResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082BłądFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083BłądFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084BłądFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Ostrzeżenie"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086OstrzeżenieProperty "…" is deprecated. Consider using … instead.
OPF-086bUżycieepub:type value "…" is deprecated. Consider using … instead.
OPF-086cOstrzeżeniethe "…" reserved prefix is deprecated.
OPF-087Użycieepub:type value "…" is not allowed on documents of type "…".
OPF-088UżycieUnrecognized epub:type value "…".
OPF-089BłądThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090UżycieIt is encouraged to use MIME media type "…" instead of "…".
OPF-091BłądThe item href URL must not have a fragment identifier.
OPF-092BłądLanguage tag "…" is not well-formed: …
OPF-093BłądThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094BłądThe "media-type" attribute is required for "…" links.
OPF-095BłądThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096BłądNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bUżycieNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097UżycieResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098BłądThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099BłądThe manifest must not list the package document.
OPF-100UżycieThe "…" property only applies to pre-paginated content.

HTM: XHTML dokumenty treści

Rozdziały XHTML: DOCTYPE, encje, przestrzenie nazw i widoki o stałym układzie.

KodDomyślna powagaWiadomość
HTM-001BłądAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002OstrzeżenieThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003BłądExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004BłądIrregular DOCTYPE: found "…", expected "…".
HTM-005UżycieAn external reference was found.
HTM-007OstrzeżenieEmpty or whitespace-only value of attribute ssml:ph.
HTM-009BłądThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010UżycieNamespace "…" is unusual for the prefix "epub".
HTM-011BłądEntity is undeclared.
HTM-025OstrzeżenieNon-registered URI scheme type found in href.
HTM-044UżycieNamespace uri "…" was included but not used.
HTM-045UżycieEncountered empty href.
HTM-046BłądFixed layout document has no "viewport" meta element.
HTM-047BłądViewport metadata "…" has a syntax error
HTM-048BłądSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051OstrzeżenieFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052BłądThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054BłądCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055UżycieThe "…" element should not be used (discouraged construct)
HTM_056BłądViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057BłądViewport "…" value must be a positive number or the keyword "device-…"
HTM_058BłądHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059BłądViewport "…" property must not be defined more than once, but found values […].
HTM_060aUżycieEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bUżycieEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Błąd"…" 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_062UżycieSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063UżycieSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Arkusz stylów

Pliki CSS i elementy stylu: zastrzeżone właściwości, kodowania, czcionki i składnia.

KodDomyślna powagaWiadomość
CSS-001BłądThe "…" property must not be included in an EPUB Style Sheet.
CSS-002BłądEmpty or NULL reference found.
CSS-003OstrzeżenieCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004BłądCSS documents must be encoded in UTF-8, detected …;
CSS-005UżycieConflicting alternate style tags found: ….
CSS-006UżycieCSS selector specifies fixed position.
CSS-007InformacjeFont-face reference "…" refers to non-standard font type "…".
CSS-008BłądAn error occurred while parsing the CSS: ….
CSS-015BłądAlternative style sheets must have a title.
CSS-019OstrzeżenieCSS font-face declaration has no attributes.
CSS-028UżycieUse of Font-face declaration.
CSS-029UżycieFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030BłądThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 spis treści)

Dziedziczne NCX spis treści.

KodDomyślna powagaWiadomość
NCX-001BłądNCX identifier ("…") does not match OPF identifier ("…").
NCX-004UżycieNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006UżycieEmpty "text" label in the NCX document

MED: Obrazy, dźwięk i nakładki multimedialne

Formaty obrazów i nagłówki, oraz zsynchronizowany dźwięk (media overlays).

KodDomyślna powagaWiadomość
MED-003BłądPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004BłądImage file header may be corrupted.
MED-005BłądMedia Overlay audio reference … to non-standard audio type … found.
MED-008BłądThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009BłądThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007BłądPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010BłądEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011BłądEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012BłądThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013BłądMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014BłądMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015UżycieMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016OstrzeżenieMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017OstrzeżenieURL fragment should indicate an element ID, but found '#…'.
MED_018OstrzeżenieURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Dostępność

Kontrola dostępności dokumentów treści (większość jest domyślnie stłumiona).

KodDomyślna powagaWiadomość
ACC-004StłumioneHtml "a" element must have text.
ACC-005StłumioneTable heading cells should be identified by "th" elements for accessibility.
ACC-006StłumioneTables should include a "thead" element for accessibility.
ACC-007StłumioneContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009UżycieMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011UżycieSVG hyperlink has no accessible name
ACC-012StłumioneTable elements should include a caption element.

OBS: Funkcje przestarzałe

Funkcje, które nadal działają, ale są przestarzałe.

KodDomyślna powagaWiadomość
OBS-001UżycieUsage of … is outdated.

INF: Informacja

Uwagi dotyczące EPUBCheck samego w sobie.

KodDomyślna powagaWiadomość
INF-001InformacjeRule … is under review and its severity may change in a future release. See the discussion at …

CHK: EPUBCheck konfiguracja

Problemy z własnym plikiem komunikatów EPUBCheck, a nie z EPUB.

KodDomyślna powagaWiadomość
CHK-001BłądThe custom message overrides file was not found.
CHK-002BłądUnrecognized custom message id … encountered in message overrides file "…".
CHK-003BłądUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004BłądThe custom message contains too many parameters in message overrides file "…".
CHK-005BłądThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006BłądUnable to parse the custom format parameter in message overrides file "…".
CHK-007BłądError encountered while processing custom message file "…": "…".
CHK-008BłądError encountered while processing an item "…"; skip other checks for the item.

Wycofane identyfikatory wiadomości

Te identyfikatory wciąż istnieją na liście wiadomości EPUBCheck, ale nie mają tekstu i są domyślnie tłumione, więc EPUBCheck nigdy ich nie zgłasza, chyba że niestandardowy plik wiadomości je włączy.

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

Źródło i licencja

Teksty komunikatów i domyślne poziomy powagi pochodzą z EPUBCheck 5.4.0, walidatora W3C EPUB, wydanego na licencji BSD-3-Clause. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Przyczyny i rozwiązania są napisane przez EpubCC. Kody bez wyjaśnienia pokazują tylko oficjalny komunikat i nie są oferowane dla wyszukiwarek, aż napiszemy jeden. EpubCC nie jest powiązane z W3C.

PDF do EPUB narzędzi

Każde narzędzie używa tej samej maszyny. Do 3 książek dziennie jest za darmo.

Zobacz wszystkie narzędzia