EpubCCEPUBCheck HTM-003: entità esterna dichiarata
Aggiornato:
EPUBCheck HTM-003 è un messaggio di errore: “External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Un documento EPUB 3 dichiara un'entità esterna, che EPUB non consente. Le entità esterne estraggono testo da un altro file tramite il DOCTYPE, e le app di lettura non le risolvono, quindi il testo sarebbe mancante.
Il messaggio ufficiale
External entities are not allowed in EPUB v3 documents. External entity declaration found: %1$s.
- 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
%1$s, %2$s… sono completati con il file, valore o elemento EPUBCheck trovato.
Cause tipiche
- Un DOCTYPE con un sottoinsieme interno (la parte tra parentesi quadre) che dichiara entità caricate da un file esterno.
- XML esportato da un sistema di pubblicazione che ha utilizzato file di entità per il testo condiviso, come il titolo del libro.
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ì.
- Rimuovi le dichiarazioni di entità dal DOCTYPE; nei capitoli XHTML il DOCTYPE dovrebbe essere solo
<!DOCTYPE html>. - Sostituisci ogni utilizzo dell'entità con il testo reale, o con un riferimento numerico di carattere come
 quando stava per un singolo carattere. - Ricostruisci il EPUB e riesegui EPUBCheck di nuovo per confermare che il messaggio sia scomparso.
Quando non è questo
Se un'entità come è utilizzata senza essere dichiarata, ciò è HTM-011, non HTM-003.
Altri messaggi di 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.
Fonti
- EPUB 3.3, §3.9 XML conformance · leggi
Testo e gravità del messaggio da EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Spiegazione di EpubCC.