EpubCCEPUBCheck RSC-005: erro de esquema em um arquivo
Atualizado:
EPUBCheck RSC-005 é uma mensagem de erro: “Error while parsing file: ….” Um arquivo não segue o esquema que EPUB requer para ele. Um elemento, atributo ou valor não é permitido onde está, ou algo exigido está faltando; o texto após "Error while parsing file:" diz qual é. É o erro EPUBCheck mais comum, e um erro estrutural pode causar várias mensagens.
A mensagem oficial
Error while parsing file: %1$s
- Severidade padrão
- 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.
- versão EPUBCheck
- 5.4.0
%1$s, %2$s… são preenchidos com o arquivo, valor ou elemento EPUBCheck encontrado.
Causas típicas
- "element X not allowed here" ou "attribute X not allowed here": elementos aninhados onde o esquema os proíbe (um div dentro de um p), ou atributos que HTML ou EPUB não definem, frequentemente copiados de páginas da web ou processadores de texto.
- "Duplicate ID": o mesmo valor de id usado duas vezes em um documento, muitas vezes de notas de rodapé ou títulos copiados.
- Metadados obrigatórios ausentes, como a data dcterms:modified de um documento de pacote EPUB 3, ou um elemento obrigatório ausente, como título no cabeçalho de XHTML.
- "value of attribute X is invalid": um valor do tipo errado, como uma data no formato errado ou um id que começa com um dígito.
Como consertar isso
- Leia o texto após os dois pontos: EPUBCheck relata o arquivo, a linha e coluna, e a descrição do problema pelo próprio analisador.
- Corrija o elemento ou atributo que ele menciona: mova ou remova o elemento, delete o atributo desconhecido ou torne o id duplicado único e atualize os links que apontavam para ele.
- Em documentos de pacote, adicione os metadados faltantes, por exemplo
<meta property="dcterms:modified">2026-11-03T00:00:00Z</meta>(exatamente um, nesse formato). - Corrija os primeiros erros primeiro e valide novamente: um erro estrutural pode causar vários posterior.
Quando não é isso
Se o arquivo não for nem XML bem formado (um & não escapado ou uma tag não fechada), EPUBCheck reporta o fatal RSC-016 em vez disso.
Termos usados aqui
Outras mensagens de RSC
RSC-004File "…" is encrypted, its content will not be checked.RSC-006Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.RSC-006bResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.RSC-003No rootfile tag with media type "application/oebps-package+xml" was found in the container.RSC-007Referenced resource "…" could not be found in the EPUB.RSC-002Required META-INF/container.xml resource could not be found.
Fontes
Texto da mensagem e severidade de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicação por EpubCC.