EPUBCheck · documentos de XHTML

EPUBCheck HTM-004: DOCTYPE inesperado encontrado

Actualizado: 4 de noviembre de 2026

EPUBCheck HTM-004 es un mensaje de error: “Irregular DOCTYPE: found "…", expected "…".” Un documento tiene un DOCTYPE diferente al que se espera para su tipo y versión EPUB. EPUBCheck muestra el DOCTYPE que encontró y el que esperaba, por lo que la solución suele ser copiar el esperado.

El mensaje oficial

Irregular DOCTYPE: found "%1$s", expected "%2$s".

Severidad por defecto: Error. El EPUB rompe una regla de la especificación y es inválido. Las tiendas y el envío a Kindle pueden rechazarlo, y EPUBCheck sale con estado 1.
versión de EPUBCheck: 5.4.0

%1$s, %2$s… se completan con el archivo, valor o elemento EPUBCheck encontrado.

Causas típicas

Un DOCTYPE XHTML 1.1 que quedó de un libro EPUB 2 dentro de un paquete que ahora declara EPUB 3.
Una plantilla de capítulo copiada de una página web con un DOCTYPE HTML 4 o XHTML 1.0 Transitional.
Un archivo NCX o SVG con un DOCTYPE que tiene un identificador público o de sistema incorrecto.

Cómo arreglarlo

Abre el archivo EPUBCheck nombrado (el mensaje da la ruta, línea y columna) en un editor de texto o EPUB como Sigil, o descomprime el EPUB y ábrelo allí.
Para EPUB 3 XHTML capítulos, reemplaza el DOCTYPE con <!DOCTYPE html>.
Para otros archivos, usa exactamente el DOCTYPE que EPUBCheck muestra como se esperaba, o elimínalo donde el formato no permite ningún DOCTYPE.
Reconstruye el EPUB y ejecuta EPUBCheck nuevamente para confirmar que el mensaje ha desaparecido.

Cuándo no es esto

Si EPUBCheck dice que el DOCTYPE es obsoleto y se puede eliminar, eso es HTM-009; HTM-004 muestra el DOCTYPE esperado.

Términos usados aquí

Otros mensajes 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.

Fuentes

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

Texto y severidad del mensaje de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicación por EpubCC.

FAQ

¿Qué significa EPUBCheck HTM-004?

¿Es HTM-004 un error?

HTM-004 se informa como error por defecto. El EPUB rompe una regla de la especificación y es inválido. Almacenes y Enviar a Kindle pueden rechazarlo, y EPUBCheck sale con estado 1.