EPUBCheck · documentos XHTML

EPUBCheck HTM-004: DOCTYPE inesperado encontrado

Atualizado: 4 de Novembro de 2026

EPUBCheck HTM-004 é uma mensagem de erro: “Irregular DOCTYPE: found "…", expected "…".” Um documento possui um DOCTYPE diferente do esperado para seu tipo e versão EPUB. EPUBCheck mostra o DOCTYPE que encontrou e o que esperava, então a correção geralmente é copiar o esperado.

A mensagem oficial

Irregular DOCTYPE: found "%1$s", expected "%2$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

Um DOCTYPE XHTML 1.1 que sobrou de um livro EPUB 2 dentro de um pacote que agora declara EPUB 3.
Um modelo de capítulo copiado de uma página da web com um HTML 4 ou XHTML 1.0 Transitional DOCTYPE.
Um arquivo NCX ou SVG com um DOCTYPE que possui o identificador público ou de sistema errado.

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á.
Para EPUB 3 XHTML capítulos, substitua o DOCTYPE por <!DOCTYPE html>.
Para outros arquivos, use exatamente o DOCTYPE que EPUBCheck mostra como esperado, ou remova-o onde o formato não permite DOCTYPE.
Reconstrua o EPUB e execute EPUBCheck novamente para confirmar que a mensagem desapareceu.

Quando não é isso

Se o EPUBCheck disser que o DOCTYPE está obsoleto e pode ser removido, isso é HTM-009; HTM-004 mostra o DOCTYPE esperado.

Termos usados aqui

Outras mensagens de HTM

HTM-003 External entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-001 Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-011 Entity is undeclared.

Fontes

EPUB 3.3, §B. Allowed external identifiers · ler 4 de Novembro de 2026
EPUB 3.3, §3.9 XML conformance · ler 4 de Novembro de 2026

Texto da mensagem e severidade de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicação por EpubCC.

FAQ

O que significa EPUBCheck HTM-004?

É HTM-004 um erro?

HTM-004 é relatado como erro por padrão. O EPUB quebra uma regra da especificação e é inválido. Armazéns e Enviar para Kindle podem rejeitá-lo, e EPUBCheck sai com status 1.