EpubCCEPUBCheck HTM-011: entidad nombrada no declarada
Actualizado:
EPUBCheck HTM-011 es un mensaje de error: “Entity is undeclared.” Se utiliza una entidad nombrada que el documento no declara. XML solo conoce &, <, >, " y ', así que nombres HTML como rompen el XHTML y el capítulo puede no abrirse en absoluto.
El mensaje oficial
Entity is undeclared.
sugerencia de EPUBCheck: Define the entity or use the numbered entity instead.
- 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
Causas típicas
- Entidades HTML como , —, … o © pegadas en XHTML.
- Texto exportado de un procesador de texto o de una página web, donde los nombres de entidades HTML son normales.
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í.
- Reemplaza cada entidad nombrada con una referencia numérica (  por un espacio en blanco no separable, — por un guion em, … por unipsis) o escribe el carácter mismo en UTF-8.
- Busque todo el libro por
&seguido de letras para capturar las otras ocurrencias a la vez. - Reconstruye el EPUB y ejecuta EPUBCheck nuevamente para confirmar que el mensaje ha desaparecido.
Cuándo no es esto
Si la entidad está declarada en el DOCTYPE a través de un archivo externo, el mensaje es HTM-003.
Términos usados aquí
Otros mensajes de HTM
HTM-010Namespace "…" is unusual for the prefix "epub".HTM-009The DOCTYPE provided is obsolete or irregular and can be removed.HTM-007Empty or whitespace-only value of attribute ssml:ph.HTM-004Irregular DOCTYPE: found "…", expected "…".HTM-003External entities are not allowed in EPUB v3 documents. External entity declaration found: ….HTM-001Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
Fuentes
Texto y severidad del mensaje de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicación por EpubCC.