Salta al contenuto

Messaggi di EPUBCheck spiegati

EPUBCheck segnala ogni problema in un EPUB come un codice del tipo RSC-005 o OPF-014 con una gravità. Questo riferimento elenca tutti i messaggi di 246 di EPUBCheck 5.4.0 con il loro testo ufficiale e spiega cause e soluzioni per 188 di essi.

Aggiornato:

Severità

Errore fatale
EPUBCheck non ha potuto continuare a controllare questa parte del EPUB. Il file non è valido.
Errore
Il EPUB viola una regola della specifica ed è non valido. I negozi e Invia a Kindle potrebbero rifiutarlo, e EPUBCheck esce con stato 1.
Avviso
Il EPUB è ancora valido, ma qualcosa potrebbe causare problemi in alcune app di lettura. EPUBCheck esce con 0 a meno che non passi --failonwarnings.
Utilizzo
Solo informativo e nascosto per impostazione predefinita: appare quando EPUBCheck viene eseguito con -u (--usage). Non rende invalido il EPUB.
Informazioni
Solo informativo. Non rende invalido il EPUB.
Soppresso
EPUBCheck non riporta questo messaggio di default. Apparirà solo se un file di messaggi personalizzati (-c) ne modifica la gravità.

PKG: Pacchetto e contenitore ZIP

Il file EPUB stesso: l'archivio ZIP, il file mimetype, i nomi e le estensioni dei file.

CodiceGravità predefinitaMessaggio
PKG-001AvvisoValidating the EPUB against version … but detected version ….
PKG-003ErroreUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Errore fataleCorrupted EPUB ZIP header.
PKG-005ErroreThe 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-006ErroreMimetype file entry is missing or is not the first file in the archive.
PKG-007ErroreThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Errore fataleUnable to read file "…".
PKG-009ErroreThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010AvvisoThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011ErroreThe file name "…" is not allowed to end with ".".
PKG-012UtilizzoThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013ErroreThe EPUB file includes multiple OPS renditions.
PKG-014AvvisoThe EPUB contains empty directory "…".
PKG-015Errore fataleUnable to read EPUB contents: …
PKG-016AvvisoUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017AvvisoUncommon EPUB file extension.
PKG-018Errore fataleThe EPUB file could not be found.
PKG-020ErroreOPF file "…" could not be found.
PKG-021ErroreCorrupted image file encountered.
PKG-022AvvisoWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023UtilizzoValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024UtilizzoUncommon EPUB file extension.
PKG-025ErrorePublication resource must not be located in the META-INF directory
PKG-026ErroreObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Errore fataleCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Risorse e riferimenti

File e collegamenti tra di essi: file mancanti, riferimenti interrotti, URL, codifiche e parsing XML.

CodiceGravità predefinitaMessaggio
RSC-001ErroreFile "…" could not be found.
RSC-002Errore fataleRequired META-INF/container.xml resource could not be found.
RSC-003ErroreNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004InformazioniFile "…" is encrypted, its content will not be checked.
RSC-005ErroreError while parsing file: …
RSC-006ErroreRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bUtilizzoResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007ErroreReferenced resource "…" could not be found in the EPUB.
RSC-007wAvvisoReferenced resource "…" could not be found in the EPUB.
RSC-008ErroreReferenced resource "…" is not declared in the OPF manifest.
RSC-009AvvisoA non-SVG image resource should not be defined with a fragment identifier.
RSC-010ErroreReference to non-standard resource type found.
RSC-011ErroreFound a reference to a resource that is not a spine item.
RSC-012ErroreFragment identifier is not defined.
RSC-013UtilizzoFragment identifier is used in a reference to a stylesheet resource.
RSC-014UtilizzoFragment identifier defines an incompatible resource type.
RSC-015UtilizzoA fragment identifier is required for svg use tag references.
RSC-016Errore fataleFatal Error while parsing file: …
RSC-017AvvisoWarning while parsing file: …
RSC-019AvvisoEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Errore"…" is not a valid URL (…)
RSC-021ErroreA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022InformazioniCannot check image details (requires Java version 7 or higher).
RSC-024UtilizzoInformative parsing warning: …
RSC-025UtilizzoInformative parsing error: …
RSC-026ErroreURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027AvvisoXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028ErroreXML documents must be encoded in UTF-8, but … was detected.
RSC-029ErroreData URL is not allowed in this context.
RSC-030ErroreFile URLs are not allowed in EPUB, but found "…".
RSC-031AvvisoRemote resource references should use HTTPS, but found "…".
RSC-032ErroreFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033ErroreRelative URL strings must not have a query component, but found one in "…".
RSC-034ErroreScripts must have a JavaScript media type.
RSC-035Utilizzo"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Utilizzo…

OPF: Documento del pacchetto (OPF)

Il documento del pacchetto: metadati, manifesto, spine, proprietà e fallback.

CodiceGravità predefinitaMessaggio
OPF-001ErroreThere was an error when parsing the EPUB version: ….
OPF-002Errore fataleThe OPF file "…" was not found in the EPUB.
OPF-003UtilizzoItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004AvvisoInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aErroreInvalid prefix declaration: found empty prefix.
OPF-004bErroreInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cErroreInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dErroreInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eAvvisoInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fAvvisoInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005ErroreInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006ErroreInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007AvvisoRe-declaration of reserved prefix "…".
OPF-007aErroreInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bErroreInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cErroreInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010ErroreError resolving reference: "…".
OPF-011Erroreitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012ErroreItem property "…" is not defined for media type "…".
OPF-013AvvisoResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014ErroreThe property "…" should be declared in the OPF file.
OPF-015ErroreThe property "…" should not be declared in the OPF file.
OPF-016ErroreThe element "rootfile" is missing its required attribute "full-path".
OPF-017ErroreThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018AvvisoThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bUtilizzoThe "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-021AvvisoUse of non-registered URI scheme type in href: "…".
OPF-025ErroreProperty value list "…" is not allowed, only one value must be specified.
OPF-026ErroreFound malformed property value: "…".
OPF-027ErroreUndefined property: "…".
OPF-028ErroreUndeclared prefix: "…".
OPF-029ErroreThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030ErroreThe unique-identifier "…" was not found.
OPF-031ErroreFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032ErroreGuide references "…" which is not a valid "OPS Content Document".
OPF-033ErroreThe spine contains no linear resources.
OPF-034ErroreThe spine contains multiple references to the manifest item with id "…".
OPF-035AvvisoMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036UtilizzoVideo type "…" might not be supported by reading systems
OPF-037AvvisoFound deprecated media-type "…".
OPF-038AvvisoMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039AvvisoMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040ErroreFallback item with id "…" could not be found.
OPF-041ErroreFallback-style item with id "…" could not be found.
OPF-042Errore"…" is not a permissible spine media-type.
OPF-043ErroreSpine item with non-standard media-type "…" has no fallback.
OPF-044ErroreSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045ErroreEncountered circular reference in fallback chain.
OPF-047UtilizzoOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048ErrorePackage tag is missing its required unique-identifier attribute and value.
OPF-049ErroreItem id "…" was not found in the manifest.
OPF-050ErroreTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051SoppressoImage dimensions exceed recommended size.
OPF-052ErroreRole value "…" is not valid.
OPF-053AvvisoDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054ErroreDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Avviso… tag is empty.
OPF-057SoppressoImage file length exceeds recommended size.
OPF-060ErroreDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062UtilizzoFound Adobe page-map attribute on spine element in opf file.
OPF-063AvvisoReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformazioniOPF declares type "…", validating using profile "…".
OPF-065ErroreInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066ErroreMissing "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-067ErroreThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070AvvisoCustom collection role "…" is an invalid URL.
OPF-071ErroreIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072UtilizzoMetadata element "…" is empty.
OPF-073ErroreExternal identifiers must not appear in the document type declaration.
OPF-074ErrorePackage resource "…" is declared in several manifest items.
OPF-075ErrorePreview collections must only point to EPUB Content Documents.
OPF-076ErroreThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077AvvisoA Data Navigation Document should not be included in the spine.
OPF-078ErroreAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079AvvisoDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080AvvisoA Search Key Map document file name should have the extension ".xml".
OPF-081ErroreResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082ErroreFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083ErroreFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084ErroreFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Avviso"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086AvvisoProperty "…" is deprecated. Consider using … instead.
OPF-086bUtilizzoepub:type value "…" is deprecated. Consider using … instead.
OPF-086cAvvisothe "…" reserved prefix is deprecated.
OPF-087Utilizzoepub:type value "…" is not allowed on documents of type "…".
OPF-088UtilizzoUnrecognized epub:type value "…".
OPF-089ErroreThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090UtilizzoIt is encouraged to use MIME media type "…" instead of "…".
OPF-091ErroreThe item href URL must not have a fragment identifier.
OPF-092ErroreLanguage tag "…" is not well-formed: …
OPF-093ErroreThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094ErroreThe "media-type" attribute is required for "…" links.
OPF-095ErroreThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096ErroreNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bUtilizzoNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097UtilizzoResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098ErroreThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099ErroreThe manifest must not list the package document.
OPF-100UtilizzoThe "…" property only applies to pre-paginated content.

HTM: XHTML documenti di contenuto

I capitoli XHTML: DOCTYPE, entità, spazi dei nomi e viewport a layout fisso.

CodiceGravità predefinitaMessaggio
HTM-001ErroreAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002AvvisoThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003ErroreExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004ErroreIrregular DOCTYPE: found "…", expected "…".
HTM-005UtilizzoAn external reference was found.
HTM-007AvvisoEmpty or whitespace-only value of attribute ssml:ph.
HTM-009ErroreThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010UtilizzoNamespace "…" is unusual for the prefix "epub".
HTM-011ErroreEntity is undeclared.
HTM-025AvvisoNon-registered URI scheme type found in href.
HTM-044UtilizzoNamespace uri "…" was included but not used.
HTM-045UtilizzoEncountered empty href.
HTM-046ErroreFixed layout document has no "viewport" meta element.
HTM-047ErroreViewport metadata "…" has a syntax error
HTM-048ErroreSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051AvvisoFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052ErroreThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054ErroreCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055UtilizzoThe "…" element should not be used (discouraged construct)
HTM_056ErroreViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057ErroreViewport "…" value must be a positive number or the keyword "device-…"
HTM_058ErroreHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059ErroreViewport "…" property must not be defined more than once, but found values […].
HTM_060aUtilizzoEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bUtilizzoEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Errore"…" 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_062UtilizzoSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063UtilizzoSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Fogli di stile

File CSS e elementi di stile: proprietà vietate, codifiche, caratteri e sintassi.

CodiceGravità predefinitaMessaggio
CSS-001ErroreThe "…" property must not be included in an EPUB Style Sheet.
CSS-002ErroreEmpty or NULL reference found.
CSS-003AvvisoCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004ErroreCSS documents must be encoded in UTF-8, detected …;
CSS-005UtilizzoConflicting alternate style tags found: ….
CSS-006UtilizzoCSS selector specifies fixed position.
CSS-007InformazioniFont-face reference "…" refers to non-standard font type "…".
CSS-008ErroreAn error occurred while parsing the CSS: ….
CSS-015ErroreAlternative style sheets must have a title.
CSS-019AvvisoCSS font-face declaration has no attributes.
CSS-028UtilizzoUse of Font-face declaration.
CSS-029UtilizzoFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030ErroreThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB tabella dei contenuti 2)

Il sommario NCX legacy.

CodiceGravità predefinitaMessaggio
NCX-001ErroreNCX identifier ("…") does not match OPF identifier ("…").
NCX-004UtilizzoNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006UtilizzoEmpty "text" label in the NCX document

MED: Immagini, audio e sovrapposizioni multimediali

Formati di immagine e intestazioni, e audio sincronizzato (sovrapposizioni multimediali).

CodiceGravità predefinitaMessaggio
MED-003ErrorePicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004ErroreImage file header may be corrupted.
MED-005ErroreMedia Overlay audio reference … to non-standard audio type … found.
MED-008ErroreThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009ErroreThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007ErrorePicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010ErroreEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011ErroreEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012ErroreThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013ErroreMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014ErroreMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015UtilizzoMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016AvvisoMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017AvvisoURL fragment should indicate an element ID, but found '#…'.
MED_018AvvisoURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Accessibilità

Controlli di accessibilità su documenti di contenuto (la maggior parte è soppressa per impostazione predefinita).

CodiceGravità predefinitaMessaggio
ACC-004SoppressoHtml "a" element must have text.
ACC-005SoppressoTable heading cells should be identified by "th" elements for accessibility.
ACC-006SoppressoTables should include a "thead" element for accessibility.
ACC-007SoppressoContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009UtilizzoMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011UtilizzoSVG hyperlink has no accessible name
ACC-012SoppressoTable elements should include a caption element.

OBS: Funzionalità obsolete

Funzionalità che funzionano ancora ma sono obsolete.

CodiceGravità predefinitaMessaggio
OBS-001UtilizzoUsage of … is outdated.

INF: Informazioni

Note su EPUBCheck stesso.

CodiceGravità predefinitaMessaggio
INF-001InformazioniRule … is under review and its severity may change in a future release. See the discussion at …

CHK: configurazione EPUBCheck

Problemi con il file di messaggio personalizzato di EPUBCheck, non con il EPUB.

CodiceGravità predefinitaMessaggio
CHK-001ErroreThe custom message overrides file was not found.
CHK-002ErroreUnrecognized custom message id … encountered in message overrides file "…".
CHK-003ErroreUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004ErroreThe custom message contains too many parameters in message overrides file "…".
CHK-005ErroreThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006ErroreUnable to parse the custom format parameter in message overrides file "…".
CHK-007ErroreError encountered while processing custom message file "…": "…".
CHK-008ErroreError encountered while processing an item "…"; skip other checks for the item.

ID messaggi dismessi

Questi ID esistono ancora nell'elenco dei messaggi di EPUBCheck ma non hanno testo e sono soppressi per impostazione predefinita, quindi EPUBCheck non li riporta mai a meno che un file di messaggio personalizzato non li attivi.

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

Fonte e licenza

I testi dei messaggi e le gravità predefinite provengono da EPUBCheck 5.4.0, il validatore EPUB del W3C, rilasciato sotto licenza BSD-3-Clause. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Cause e soluzioni sono scritte da EpubCC. I codici senza spiegazione mostrano solo il messaggio ufficiale e non sono offerti ai motori di ricerca fino a quando non ne scriviamo uno. EpubCC non è affiliato con il W3C.

PDF a EPUB strumenti

Ogni strumento utilizza lo stesso motore. Fino a 3 libri al giorno sono gratuiti.

Vedi tutti gli strumenti