Sari la conținut

EPUBCheck mesaje explicate

EPUBCheck raportează fiecare problemă într-un EPUB ca un cod precum RSC-005 sau OPF-014 cu o severitate. Această referință listează toate mesajele 246 ale EPUBCheck 5.4.0 cu textul lor oficial și explică cauzele și soluțiile pentru 188 dintre ele.

Actualizat:

Severități

Eroare fatală
EPUBCheck nu a putut continua verificarea acestei părți a EPUB. Fișierul este invalid.
Eroare
EPUB încalcă o regulă a specificației și este invalid. Magazinele și Trimite către Kindle pot să o respingă, iar EPUBCheck iese cu statut 1.
Atenționare
EPUB este încă valid, dar ceva este probabil să cauzeze probleme în unele aplicații de citire. EPUBCheck iese cu 0, cu excepția cazului în care treci --failonwarnings.
Utilizare
Informațional doar și ascuns implicit: apare când EPUBCheck rulează cu -u (--usage). Nu face ca EPUB să devină invalid.
Informații
Informațional doar. Nu face ca EPUB să devină invalid.
Suprimat
EPUBCheck nu raportează acest mesaj în mod implicit. Apare doar dacă un fișier de mesaj personalizat (-c) îi schimbă severitatea.

PKG: Pachet și container ZIP

Fișierul EPUB în sine: arhiva ZIP, fișierul mimetype, numele fișierelor și extensiile.

CodSeveritate implicităMesaj
PKG-001AtenționareValidating the EPUB against version … but detected version ….
PKG-003EroareUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Eroare fatalăCorrupted EPUB ZIP header.
PKG-005EroareThe 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-006EroareMimetype file entry is missing or is not the first file in the archive.
PKG-007EroareThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Eroare fatalăUnable to read file "…".
PKG-009EroareThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010AtenționareThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011EroareThe file name "…" is not allowed to end with ".".
PKG-012UtilizareThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013EroareThe EPUB file includes multiple OPS renditions.
PKG-014AtenționareThe EPUB contains empty directory "…".
PKG-015Eroare fatalăUnable to read EPUB contents: …
PKG-016AtenționareUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017AtenționareUncommon EPUB file extension.
PKG-018Eroare fatalăThe EPUB file could not be found.
PKG-020EroareOPF file "…" could not be found.
PKG-021EroareCorrupted image file encountered.
PKG-022AtenționareWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023UtilizareValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024UtilizareUncommon EPUB file extension.
PKG-025EroarePublication resource must not be located in the META-INF directory
PKG-026EroareObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Eroare fatalăCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Resurse și referințe

Fișiere și legături între ele: fișiere lipsă, referințe rupte, URL-uri, encodări și parsare XML.

CodSeveritate implicităMesaj
RSC-001EroareFile "…" could not be found.
RSC-002Eroare fatalăRequired META-INF/container.xml resource could not be found.
RSC-003EroareNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004InformațiiFile "…" is encrypted, its content will not be checked.
RSC-005EroareError while parsing file: …
RSC-006EroareRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bUtilizareResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007EroareReferenced resource "…" could not be found in the EPUB.
RSC-007wAtenționareReferenced resource "…" could not be found in the EPUB.
RSC-008EroareReferenced resource "…" is not declared in the OPF manifest.
RSC-009AtenționareA non-SVG image resource should not be defined with a fragment identifier.
RSC-010EroareReference to non-standard resource type found.
RSC-011EroareFound a reference to a resource that is not a spine item.
RSC-012EroareFragment identifier is not defined.
RSC-013UtilizareFragment identifier is used in a reference to a stylesheet resource.
RSC-014UtilizareFragment identifier defines an incompatible resource type.
RSC-015UtilizareA fragment identifier is required for svg use tag references.
RSC-016Eroare fatalăFatal Error while parsing file: …
RSC-017AtenționareWarning while parsing file: …
RSC-019AtenționareEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Eroare"…" is not a valid URL (…)
RSC-021EroareA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022InformațiiCannot check image details (requires Java version 7 or higher).
RSC-024UtilizareInformative parsing warning: …
RSC-025UtilizareInformative parsing error: …
RSC-026EroareURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027AtenționareXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028EroareXML documents must be encoded in UTF-8, but … was detected.
RSC-029EroareData URL is not allowed in this context.
RSC-030EroareFile URLs are not allowed in EPUB, but found "…".
RSC-031AtenționareRemote resource references should use HTTPS, but found "…".
RSC-032EroareFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033EroareRelative URL strings must not have a query component, but found one in "…".
RSC-034EroareScripts must have a JavaScript media type.
RSC-035Utilizare"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Utilizare…

OPF: Document pachet (OPF)

Documentul de pachet: metadate, manifest, spine, proprietăți și opțiuni de rezervă.

CodSeveritate implicităMesaj
OPF-001EroareThere was an error when parsing the EPUB version: ….
OPF-002Eroare fatalăThe OPF file "…" was not found in the EPUB.
OPF-003UtilizareItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004AtenționareInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aEroareInvalid prefix declaration: found empty prefix.
OPF-004bEroareInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cEroareInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dEroareInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eAtenționareInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fAtenționareInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005EroareInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006EroareInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007AtenționareRe-declaration of reserved prefix "…".
OPF-007aEroareInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bEroareInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cEroareInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010EroareError resolving reference: "…".
OPF-011Eroareitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012EroareItem property "…" is not defined for media type "…".
OPF-013AtenționareResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014EroareThe property "…" should be declared in the OPF file.
OPF-015EroareThe property "…" should not be declared in the OPF file.
OPF-016EroareThe element "rootfile" is missing its required attribute "full-path".
OPF-017EroareThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018AtenționareThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bUtilizareThe "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-021AtenționareUse of non-registered URI scheme type in href: "…".
OPF-025EroareProperty value list "…" is not allowed, only one value must be specified.
OPF-026EroareFound malformed property value: "…".
OPF-027EroareUndefined property: "…".
OPF-028EroareUndeclared prefix: "…".
OPF-029EroareThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030EroareThe unique-identifier "…" was not found.
OPF-031EroareFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032EroareGuide references "…" which is not a valid "OPS Content Document".
OPF-033EroareThe spine contains no linear resources.
OPF-034EroareThe spine contains multiple references to the manifest item with id "…".
OPF-035AtenționareMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036UtilizareVideo type "…" might not be supported by reading systems
OPF-037AtenționareFound deprecated media-type "…".
OPF-038AtenționareMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039AtenționareMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040EroareFallback item with id "…" could not be found.
OPF-041EroareFallback-style item with id "…" could not be found.
OPF-042Eroare"…" is not a permissible spine media-type.
OPF-043EroareSpine item with non-standard media-type "…" has no fallback.
OPF-044EroareSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045EroareEncountered circular reference in fallback chain.
OPF-047UtilizareOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048EroarePackage tag is missing its required unique-identifier attribute and value.
OPF-049EroareItem id "…" was not found in the manifest.
OPF-050EroareTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051SuprimatImage dimensions exceed recommended size.
OPF-052EroareRole value "…" is not valid.
OPF-053AtenționareDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054EroareDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Atenționare… tag is empty.
OPF-057SuprimatImage file length exceeds recommended size.
OPF-060EroareDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062UtilizareFound Adobe page-map attribute on spine element in opf file.
OPF-063AtenționareReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformațiiOPF declares type "…", validating using profile "…".
OPF-065EroareInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066EroareMissing "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-067EroareThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070AtenționareCustom collection role "…" is an invalid URL.
OPF-071EroareIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072UtilizareMetadata element "…" is empty.
OPF-073EroareExternal identifiers must not appear in the document type declaration.
OPF-074EroarePackage resource "…" is declared in several manifest items.
OPF-075EroarePreview collections must only point to EPUB Content Documents.
OPF-076EroareThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077AtenționareA Data Navigation Document should not be included in the spine.
OPF-078EroareAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079AtenționareDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080AtenționareA Search Key Map document file name should have the extension ".xml".
OPF-081EroareResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082EroareFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083EroareFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084EroareFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Atenționare"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086AtenționareProperty "…" is deprecated. Consider using … instead.
OPF-086bUtilizareepub:type value "…" is deprecated. Consider using … instead.
OPF-086cAtenționarethe "…" reserved prefix is deprecated.
OPF-087Utilizareepub:type value "…" is not allowed on documents of type "…".
OPF-088UtilizareUnrecognized epub:type value "…".
OPF-089EroareThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090UtilizareIt is encouraged to use MIME media type "…" instead of "…".
OPF-091EroareThe item href URL must not have a fragment identifier.
OPF-092EroareLanguage tag "…" is not well-formed: …
OPF-093EroareThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094EroareThe "media-type" attribute is required for "…" links.
OPF-095EroareThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096EroareNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bUtilizareNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097UtilizareResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098EroareThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099EroareThe manifest must not list the package document.
OPF-100UtilizareThe "…" property only applies to pre-paginated content.

HTM: Documente de conținut XHTML

Capitolele XHTML: DOCTYPE, entități, namespace-uri și viewport-uri cu layout fix.

CodSeveritate implicităMesaj
HTM-001EroareAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002AtenționareThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003EroareExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004EroareIrregular DOCTYPE: found "…", expected "…".
HTM-005UtilizareAn external reference was found.
HTM-007AtenționareEmpty or whitespace-only value of attribute ssml:ph.
HTM-009EroareThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010UtilizareNamespace "…" is unusual for the prefix "epub".
HTM-011EroareEntity is undeclared.
HTM-025AtenționareNon-registered URI scheme type found in href.
HTM-044UtilizareNamespace uri "…" was included but not used.
HTM-045UtilizareEncountered empty href.
HTM-046EroareFixed layout document has no "viewport" meta element.
HTM-047EroareViewport metadata "…" has a syntax error
HTM-048EroareSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051AtenționareFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052EroareThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054EroareCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055UtilizareThe "…" element should not be used (discouraged construct)
HTM_056EroareViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057EroareViewport "…" value must be a positive number or the keyword "device-…"
HTM_058EroareHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059EroareViewport "…" property must not be defined more than once, but found values […].
HTM_060aUtilizareEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bUtilizareEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Eroare"…" 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_062UtilizareSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063UtilizareSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Fișiere de stil

Fișiere CSS și elemente de stil: proprietăți interzise, codificări, fonturi și sintaxă.

CodSeveritate implicităMesaj
CSS-001EroareThe "…" property must not be included in an EPUB Style Sheet.
CSS-002EroareEmpty or NULL reference found.
CSS-003AtenționareCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004EroareCSS documents must be encoded in UTF-8, detected …;
CSS-005UtilizareConflicting alternate style tags found: ….
CSS-006UtilizareCSS selector specifies fixed position.
CSS-007InformațiiFont-face reference "…" refers to non-standard font type "…".
CSS-008EroareAn error occurred while parsing the CSS: ….
CSS-015EroareAlternative style sheets must have a title.
CSS-019AtenționareCSS font-face declaration has no attributes.
CSS-028UtilizareUse of Font-face declaration.
CSS-029UtilizareFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030EroareThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 tabel de conținut)

Tabloul de conținut NCX moștenit.

CodSeveritate implicităMesaj
NCX-001EroareNCX identifier ("…") does not match OPF identifier ("…").
NCX-004UtilizareNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006UtilizareEmpty "text" label in the NCX document

MED: Imagini, audio și medii suprapuse

Formate de imagini și antete, și audio sincronizat (mediu suprapus).

CodSeveritate implicităMesaj
MED-003EroarePicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004EroareImage file header may be corrupted.
MED-005EroareMedia Overlay audio reference … to non-standard audio type … found.
MED-008EroareThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009EroareThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007EroarePicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010EroareEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011EroareEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012EroareThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013EroareMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014EroareMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015UtilizareMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016AtenționareMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017AtenționareURL fragment should indicate an element ID, but found '#…'.
MED_018AtenționareURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Accesibilitate

Verificări de accesibilitate pe documentele de conținut (majoritatea sunt suprimate implicit).

CodSeveritate implicităMesaj
ACC-004SuprimatHtml "a" element must have text.
ACC-005SuprimatTable heading cells should be identified by "th" elements for accessibility.
ACC-006SuprimatTables should include a "thead" element for accessibility.
ACC-007SuprimatContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009UtilizareMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011UtilizareSVG hyperlink has no accessible name
ACC-012SuprimatTable elements should include a caption element.

OBS: Funcții învechite

Funcții care încă mai funcționează dar sunt învechite.

CodSeveritate implicităMesaj
OBS-001UtilizareUsage of … is outdated.

INF: Informații

Note despre EPUBCheck în sine.

CodSeveritate implicităMesaj
INF-001InformațiiRule … is under review and its severity may change in a future release. See the discussion at …

CHK: EPUBCheck configurație

Probleme cu fișierul de mesaje personalizat al EPUBCheck, nu cu EPUB.

CodSeveritate implicităMesaj
CHK-001EroareThe custom message overrides file was not found.
CHK-002EroareUnrecognized custom message id … encountered in message overrides file "…".
CHK-003EroareUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004EroareThe custom message contains too many parameters in message overrides file "…".
CHK-005EroareThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006EroareUnable to parse the custom format parameter in message overrides file "…".
CHK-007EroareError encountered while processing custom message file "…": "…".
CHK-008EroareError encountered while processing an item "…"; skip other checks for the item.

IDs de mesaj retrase

Aceste ID-uri există în continuare în lista de mesaje a EPUBCheck, dar nu au text și sunt suprimate în mod implicit, așa că EPUBCheck nu le raportează niciodată, cu excepția cazului în care un fișier de mesaj personalizat le activează.

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

Sursă și licență

Textul mesajelor și severitățile implicite provin din EPUBCheck 5.4.0, validatorul EPUB al W3C, lansat sub licența BSD-3-Clause. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Cauzele și soluțiile sunt scrise de EpubCC. Codurile fără explicație arată doar mesajul oficial și nu sunt oferite motoarelor de căutare până nu scriem unul. EpubCC nu este afiliat cu W3C.

PDF pentru uneltele EPUB

Fiecare instrument folosește același motor. Până la 3 cărți pe zi sunt gratuite.

Vezi toate instrumentele