EpubCCEPUBCheck HTM-003: entidad externa declarada
Actualizado:
EPUBCheck HTM-003 es un mensaje de error: “External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Un EPUB 3 documento declara una entidad externa, que EPUB no permite. Las entidades externas extraen texto de otro archivo a través del DOCTYPE, y las aplicaciones de lectura no las resuelven, por lo que el texto estaría ausente.
El mensaje oficial
External entities are not allowed in EPUB v3 documents. External entity declaration 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
- Un DOCTYPE con un subconjunto interno (la parte en corchetes) que declara entidades cargadas desde un archivo externo.
- XML exportado de un sistema de publicación que utilizó archivos de entidad para texto compartido como el título del libro.
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í.
- Eliminar las declaraciones de entidad del DOCTYPE; en los capítulos XHTML el DOCTYPE debería ser solo
<!DOCTYPE html>. - Reemplaza cada uso de la entidad con el texto real o con una referencia de carácter numérico tal como
 cuando representaba un solo carácter. - Reconstruye el EPUB y ejecuta EPUBCheck nuevamente para confirmar que el mensaje ha desaparecido.
Cuándo no es esto
Si se usa una entidad como sin ser declarada en absoluto, eso es HTM-011, no HTM-003.
Términos usados aquí
Otros mensajes de HTM
HTM-004Irregular DOCTYPE: found "…", expected "…".HTM-001Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….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.