EpubCCEPUBCheck HTM-001: la versión XML no es 1.0
Actualizado:
EPUBCheck HTM-001 es un mensaje de error: “Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….” Un archivo XML en el EPUB declara una versión XML diferente a 1.0. EPUB requiere que cada recurso basado en XML (XHTML capítulos, el documento de paquete, el NCX, imágenes SVG) sea un documento XML 1.0 válido, y EPUBCheck nombra la versión que encontró.
El mensaje oficial
Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: %1$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
- Una declaración XML que dice version="1.1", escrita por un editor o una herramienta de exportación que predetermina esto.
- Una plantilla copiada de otro proyecto XML y reutilizada para cada capítulo.
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í.
- Cambia la primera línea a
<?xml version="1.0" encoding="UTF-8"?>, o elimina la declaración XML: sin una, XML 1.0 y UTF-8 se asumen. - Si la herramienta que hizo el libro escribe 1.1 en cada archivo, corrige su plantilla para que la próxima exportación sea correcta.
- Reconstruye el EPUB y ejecuta EPUBCheck nuevamente para confirmar que el mensaje ha desaparecido.
Cuándo no es esto
Si la declaración dice 1.0 pero el archivo está guardado en UTF-16, eso es HTM_058, no HTM-001.
Términos usados aquí
Otros mensajes 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.
Fuentes
Texto y severidad del mensaje de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicación por EpubCC.