Pule para o conteúdo

Mensagens EPUBCheck explicadas

EPUBCheck relata cada problema em um EPUB como um código como RSC-005 ou OPF-014 com uma severidade. Esta referência lista todas as mensagens 246 de EPUBCheck 5.4.0 com seu texto oficial, e explica as causas e soluções para 188 delas.

Atualizado:

Severidades

Erro fatal
EPUBCheck não conseguiu continuar verificando esta parte do EPUB. O arquivo é inválido.
Erro
O EPUB quebra uma regra da especificação e é inválido. Lojas e Enviar para Kindle podem rejeitá-lo, e EPUBCheck sai com status 1.
Aviso
O EPUB ainda é válido, mas algo provavelmente causará problemas em alguns aplicativos de leitura. EPUBCheck sai com 0, a menos que você passe --failonwarnings.
Uso
Apenas informativo e oculto por padrão: aparece quando EPUBCheck é executado com -u (--usage). Não torna o EPUB inválido.
Informações
Apenas informativo. Não torna o EPUB inválido.
Suprimido
EPUBCheck não relata esta mensagem por padrão. Ela só aparece se um arquivo de mensagens personalizado (-c) alterar sua gravidade.

PKG: Pacote e contêiner ZIP

O EPUB arquivo em si: o arquivo ZIP, o arquivo mimetype, nomes e extensões de arquivos.

CódigoSeveridade padrãoMensagem
PKG-001AvisoValidating the EPUB against version … but detected version ….
PKG-003ErroUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Erro fatalCorrupted EPUB ZIP header.
PKG-005ErroThe 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-006ErroMimetype file entry is missing or is not the first file in the archive.
PKG-007ErroThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Erro fatalUnable to read file "…".
PKG-009ErroThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010AvisoThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011ErroThe file name "…" is not allowed to end with ".".
PKG-012UsoThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013ErroThe EPUB file includes multiple OPS renditions.
PKG-014AvisoThe EPUB contains empty directory "…".
PKG-015Erro fatalUnable to read EPUB contents: …
PKG-016AvisoUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017AvisoUncommon EPUB file extension.
PKG-018Erro fatalThe EPUB file could not be found.
PKG-020ErroOPF file "…" could not be found.
PKG-021ErroCorrupted image file encountered.
PKG-022AvisoWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023UsoValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024UsoUncommon EPUB file extension.
PKG-025ErroPublication resource must not be located in the META-INF directory
PKG-026ErroObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Erro fatalCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Recursos e referências

Arquivos e links entre eles: arquivos ausentes, referências quebradas, URLs, codificações e análise XML.

CódigoSeveridade padrãoMensagem
RSC-001ErroFile "…" could not be found.
RSC-002Erro fatalRequired META-INF/container.xml resource could not be found.
RSC-003ErroNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004InformaçõesFile "…" is encrypted, its content will not be checked.
RSC-005ErroError while parsing file: …
RSC-006ErroRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bUsoResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007ErroReferenced resource "…" could not be found in the EPUB.
RSC-007wAvisoReferenced resource "…" could not be found in the EPUB.
RSC-008ErroReferenced resource "…" is not declared in the OPF manifest.
RSC-009AvisoA non-SVG image resource should not be defined with a fragment identifier.
RSC-010ErroReference to non-standard resource type found.
RSC-011ErroFound a reference to a resource that is not a spine item.
RSC-012ErroFragment identifier is not defined.
RSC-013UsoFragment identifier is used in a reference to a stylesheet resource.
RSC-014UsoFragment identifier defines an incompatible resource type.
RSC-015UsoA fragment identifier is required for svg use tag references.
RSC-016Erro fatalFatal Error while parsing file: …
RSC-017AvisoWarning while parsing file: …
RSC-019AvisoEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Erro"…" is not a valid URL (…)
RSC-021ErroA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022InformaçõesCannot check image details (requires Java version 7 or higher).
RSC-024UsoInformative parsing warning: …
RSC-025UsoInformative parsing error: …
RSC-026ErroURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027AvisoXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028ErroXML documents must be encoded in UTF-8, but … was detected.
RSC-029ErroData URL is not allowed in this context.
RSC-030ErroFile URLs are not allowed in EPUB, but found "…".
RSC-031AvisoRemote resource references should use HTTPS, but found "…".
RSC-032ErroFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033ErroRelative URL strings must not have a query component, but found one in "…".
RSC-034ErroScripts must have a JavaScript media type.
RSC-035Uso"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Uso…

OPF: Documento do pacote (OPF)

O documento de pacote: metadados, manifesto, spine, propriedades e soluções alternativas.

CódigoSeveridade padrãoMensagem
OPF-001ErroThere was an error when parsing the EPUB version: ….
OPF-002Erro fatalThe OPF file "…" was not found in the EPUB.
OPF-003UsoItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004AvisoInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aErroInvalid prefix declaration: found empty prefix.
OPF-004bErroInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cErroInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dErroInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eAvisoInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fAvisoInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005ErroInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006ErroInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007AvisoRe-declaration of reserved prefix "…".
OPF-007aErroInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bErroInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cErroInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010ErroError resolving reference: "…".
OPF-011Erroitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012ErroItem property "…" is not defined for media type "…".
OPF-013AvisoResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014ErroThe property "…" should be declared in the OPF file.
OPF-015ErroThe property "…" should not be declared in the OPF file.
OPF-016ErroThe element "rootfile" is missing its required attribute "full-path".
OPF-017ErroThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018AvisoThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bUsoThe "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-021AvisoUse of non-registered URI scheme type in href: "…".
OPF-025ErroProperty value list "…" is not allowed, only one value must be specified.
OPF-026ErroFound malformed property value: "…".
OPF-027ErroUndefined property: "…".
OPF-028ErroUndeclared prefix: "…".
OPF-029ErroThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030ErroThe unique-identifier "…" was not found.
OPF-031ErroFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032ErroGuide references "…" which is not a valid "OPS Content Document".
OPF-033ErroThe spine contains no linear resources.
OPF-034ErroThe spine contains multiple references to the manifest item with id "…".
OPF-035AvisoMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036UsoVideo type "…" might not be supported by reading systems
OPF-037AvisoFound deprecated media-type "…".
OPF-038AvisoMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039AvisoMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040ErroFallback item with id "…" could not be found.
OPF-041ErroFallback-style item with id "…" could not be found.
OPF-042Erro"…" is not a permissible spine media-type.
OPF-043ErroSpine item with non-standard media-type "…" has no fallback.
OPF-044ErroSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045ErroEncountered circular reference in fallback chain.
OPF-047UsoOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048ErroPackage tag is missing its required unique-identifier attribute and value.
OPF-049ErroItem id "…" was not found in the manifest.
OPF-050ErroTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051SuprimidoImage dimensions exceed recommended size.
OPF-052ErroRole value "…" is not valid.
OPF-053AvisoDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054ErroDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Aviso… tag is empty.
OPF-057SuprimidoImage file length exceeds recommended size.
OPF-060ErroDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062UsoFound Adobe page-map attribute on spine element in opf file.
OPF-063AvisoReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InformaçõesOPF declares type "…", validating using profile "…".
OPF-065ErroInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066ErroMissing "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-067ErroThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070AvisoCustom collection role "…" is an invalid URL.
OPF-071ErroIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072UsoMetadata element "…" is empty.
OPF-073ErroExternal identifiers must not appear in the document type declaration.
OPF-074ErroPackage resource "…" is declared in several manifest items.
OPF-075ErroPreview collections must only point to EPUB Content Documents.
OPF-076ErroThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077AvisoA Data Navigation Document should not be included in the spine.
OPF-078ErroAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079AvisoDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080AvisoA Search Key Map document file name should have the extension ".xml".
OPF-081ErroResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082ErroFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083ErroFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084ErroFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Aviso"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086AvisoProperty "…" is deprecated. Consider using … instead.
OPF-086bUsoepub:type value "…" is deprecated. Consider using … instead.
OPF-086cAvisothe "…" reserved prefix is deprecated.
OPF-087Usoepub:type value "…" is not allowed on documents of type "…".
OPF-088UsoUnrecognized epub:type value "…".
OPF-089ErroThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090UsoIt is encouraged to use MIME media type "…" instead of "…".
OPF-091ErroThe item href URL must not have a fragment identifier.
OPF-092ErroLanguage tag "…" is not well-formed: …
OPF-093ErroThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094ErroThe "media-type" attribute is required for "…" links.
OPF-095ErroThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096ErroNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bUsoNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097UsoResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098ErroThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099ErroThe manifest must not list the package document.
OPF-100UsoThe "…" property only applies to pre-paginated content.

HTM: documentos XHTML

Os capítulos do XHTML: DOCTYPE, entidades, namespaces e viewports de layout fixo.

CódigoSeveridade padrãoMensagem
HTM-001ErroAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002AvisoThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003ErroExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004ErroIrregular DOCTYPE: found "…", expected "…".
HTM-005UsoAn external reference was found.
HTM-007AvisoEmpty or whitespace-only value of attribute ssml:ph.
HTM-009ErroThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010UsoNamespace "…" is unusual for the prefix "epub".
HTM-011ErroEntity is undeclared.
HTM-025AvisoNon-registered URI scheme type found in href.
HTM-044UsoNamespace uri "…" was included but not used.
HTM-045UsoEncountered empty href.
HTM-046ErroFixed layout document has no "viewport" meta element.
HTM-047ErroViewport metadata "…" has a syntax error
HTM-048ErroSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051AvisoFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052ErroThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054ErroCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055UsoThe "…" element should not be used (discouraged construct)
HTM_056ErroViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057ErroViewport "…" value must be a positive number or the keyword "device-…"
HTM_058ErroHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059ErroViewport "…" property must not be defined more than once, but found values […].
HTM_060aUsoEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bUsoEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Erro"…" 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_062UsoSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063UsoSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Folhas de estilo

Arquivos CSS e elementos de estilo: propriedades proibidas, codificações, fontes e sintaxe.

CódigoSeveridade padrãoMensagem
CSS-001ErroThe "…" property must not be included in an EPUB Style Sheet.
CSS-002ErroEmpty or NULL reference found.
CSS-003AvisoCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004ErroCSS documents must be encoded in UTF-8, detected …;
CSS-005UsoConflicting alternate style tags found: ….
CSS-006UsoCSS selector specifies fixed position.
CSS-007InformaçõesFont-face reference "…" refers to non-standard font type "…".
CSS-008ErroAn error occurred while parsing the CSS: ….
CSS-015ErroAlternative style sheets must have a title.
CSS-019AvisoCSS font-face declaration has no attributes.
CSS-028UsoUse of Font-face declaration.
CSS-029UsoFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030ErroThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 tabela de conteúdos)

A tabela de conteúdo NCX legada.

CódigoSeveridade padrãoMensagem
NCX-001ErroNCX identifier ("…") does not match OPF identifier ("…").
NCX-004UsoNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006UsoEmpty "text" label in the NCX document

MED: Imagens, áudio e sobreposições de mídia

Formatos de imagem e cabeçalhos, e áudio sincronizado (sobreposições de mídia).

CódigoSeveridade padrãoMensagem
MED-003ErroPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004ErroImage file header may be corrupted.
MED-005ErroMedia Overlay audio reference … to non-standard audio type … found.
MED-008ErroThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009ErroThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007ErroPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010ErroEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011ErroEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012ErroThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013ErroMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014ErroMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015UsoMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016AvisoMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017AvisoURL fragment should indicate an element ID, but found '#…'.
MED_018AvisoURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Acessibilidade

Verificações de acessibilidade em documentos de conteúdo (a maioria está suprimida por padrão).

CódigoSeveridade padrãoMensagem
ACC-004SuprimidoHtml "a" element must have text.
ACC-005SuprimidoTable heading cells should be identified by "th" elements for accessibility.
ACC-006SuprimidoTables should include a "thead" element for accessibility.
ACC-007SuprimidoContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009UsoMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011UsoSVG hyperlink has no accessible name
ACC-012SuprimidoTable elements should include a caption element.

OBS: Recursos obsoletos

Recursos que ainda funcionam, mas estão desatualizados.

CódigoSeveridade padrãoMensagem
OBS-001UsoUsage of … is outdated.

INF: Informação

Notas sobre EPUBCheck em si.

CódigoSeveridade padrãoMensagem
INF-001InformaçõesRule … is under review and its severity may change in a future release. See the discussion at …

CHK: EPUBCheck configuração

Problemas com o próprio arquivo de mensagem personalizada do EPUBCheck, não com o EPUB.

CódigoSeveridade padrãoMensagem
CHK-001ErroThe custom message overrides file was not found.
CHK-002ErroUnrecognized custom message id … encountered in message overrides file "…".
CHK-003ErroUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004ErroThe custom message contains too many parameters in message overrides file "…".
CHK-005ErroThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006ErroUnable to parse the custom format parameter in message overrides file "…".
CHK-007ErroError encountered while processing custom message file "…": "…".
CHK-008ErroError encountered while processing an item "…"; skip other checks for the item.

IDs de mensagem aposentados

Esses IDs ainda existem na lista de mensagens do EPUBCheck, mas não têm texto e são suprimidos por padrão, então EPUBCheck nunca os relata, a menos que um arquivo de mensagem personalizado os ative.

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 licença

Os textos das mensagens e as gravidades padrão vêm de EPUBCheck 5.4.0, o validador EPUB do W3C, lançado sob a licença BSD-3-Clause. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Causas e soluções são escritas por EpubCC. Códigos sem explicação mostram apenas a mensagem oficial e não são oferecidos a mecanismos de busca até que escrevamos uma. EpubCC não é afiliado ao W3C.

PDF para EPUB ferramentas

Todas as ferramentas usam o mesmo motor. Até 3 livros por dia são gratuitos.

Ver todas as ferramentas