EpubCCEPUBCheck HTM-001: versão XML não é 1.0
Atualizado:
EPUBCheck HTM-001 é uma mensagem de erro: “Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….” Um arquivo XML no EPUB declara uma versão XML diferente de 1.0. EPUB requer que cada recurso baseado em XML (XHTML capítulos, o documento do pacote, o NCX, imagens SVG) seja um documento XML 1.0 válido, e EPUBCheck nomeia a versão que encontrou.
A mensagem oficial
Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: %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
- Uma declaração XML que diz version="1.1", escrita por um editor ou uma ferramenta de exportação que o define como padrão.
- Um modelo copiado de outro projeto XML e reutilizado para cada capítulo.
Como consertar isso
- Abra o arquivo EPUBCheck names (a mensagem dá o caminho, linha e coluna) em um editor de texto ou EPUB como Sigil, ou descompacte o EPUB e abra-o lá.
- Altere a primeira linha para
<?xml version="1.0" encoding="UTF-8"?>, ou remova a declaração XML: sem uma, XML 1.0 e UTF-8 são presumidos. - Se a ferramenta que fez o livro escreve 1.1 em cada arquivo, corrija seu modelo para que a próxima exportação esteja correta.
- Reconstrua o EPUB e execute EPUBCheck novamente para confirmar que a mensagem desapareceu.
Quando não é isso
Se a declaração diz 1.0, mas o arquivo está salvo em UTF-16, isso é HTM_058, não HTM-001.
Termos usados aqui
Outras mensagens de HTM
HTM-003External entities are not allowed in EPUB v3 documents. External entity declaration found: ….HTM-004Irregular DOCTYPE: found "…", expected "…".HTM-007Empty or whitespace-only value of attribute ssml:ph.HTM-009The DOCTYPE provided is obsolete or irregular and can be removed.HTM-010Namespace "…" is unusual for the prefix "epub".HTM-011Entity is undeclared.
Fontes
Texto da mensagem e severidade de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicação por EpubCC.