EPUBCheck · XHTML documenti di contenuto

EPUBCheck HTM-011: entità nominata non dichiarata

Aggiornato: 04 Novembre 2026

EPUBCheck HTM-011 è un messaggio di errore: “Entity is undeclared.” Un'entità nominata è utilizzata che il documento non dichiara. XML conosce solo &, <, >, " e ', quindi nomi HTML come   interrompono il XHTML e il capitolo potrebbe non aprirsi affatto.

Il messaggio ufficiale

Entity is undeclared.

suggerimento di EPUBCheck: Define the entity or use the numbered entity instead.

Gravità predefinita: Errore. Il EPUB viola una regola della specifica ed è non valido. I negozi e Invia a Kindle potrebbero rifiutarlo, e EPUBCheck esce con stato 1.
versione EPUBCheck: 5.4.0

Cause tipiche

Entità HTML come  , —, … o © incollate in XHTML.
Testo esportato da un elaboratore di testi o da una pagina web, dove i nomi delle entità HTML sono normali.

Come correggerlo

Apri il file EPUBCheck nominato (il messaggio fornisce il percorso, la linea e la colonna) in un editor di testo o EPUB come Sigil, oppure decomprimi il EPUB e aprilo lì.
Sostituisci ogni entità nominata con un riferimento numerico (  per uno spazio non interrompente, — per un trattino em, … per un'ellissi) oppure digita il carattere stesso in UTF-8.
Cerca in tutto il libro & seguito da lettere per catturare tutte le altre occorrenze in una volta.
Ricostruisci il EPUB e riesegui EPUBCheck di nuovo per confermare che il messaggio sia scomparso.

Quando non è questo

Se l'entità è dichiarata nel DOCTYPE attraverso un file esterno, il messaggio è HTM-003.

Altri messaggi di HTM

HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-004 Irregular DOCTYPE: found "…", expected "…".
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: ….

Fonti

EPUB 3.3, §3.9 XML conformance · leggi 04 Novembre 2026
EPUB 3.3, §6.1.2 XHTML requirements · leggi 04 Novembre 2026

Testo e gravità del messaggio da EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Spiegazione di EpubCC.

FAQ

Cosa significa EPUBCheck HTM-011?

È HTM-011 un errore?

HTM-011 viene segnalato come errore per impostazione predefinita. Il EPUB infringe una regola della specifica e non è valido. I negozi e l'invio a Kindle potrebbero rifiutarlo e EPUBCheck esce con stato 1.