EPUBCheck · XHTML documenti di contenuto

EPUBCheck HTM-004: DOCTYPE imprevisto trovato

Aggiornato: 04 Novembre 2026

EPUBCheck HTM-004 è un messaggio di errore: “Irregular DOCTYPE: found "…", expected "…".” Un documento ha un DOCTYPE diverso da quello previsto per il suo tipo e la versione di EPUB. EPUBCheck mostra il DOCTYPE trovato e quello previsto, quindi la correzione è solitamente copiare quello previsto.

Il messaggio ufficiale

Irregular DOCTYPE: found "%1$s", expected "%2$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 XHTML 1.1 rimasto da un libro EPUB 2 all'interno di un pacchetto che ora dichiara EPUB 3.
Un modello di capitolo copiato da una pagina web con un DOCTYPE HTML 4 o XHTML 1.0 Transitional.
Un file NCX o SVG con un DOCTYPE che ha l'identificatore pubblico o di sistema errato.

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ì.
Per i capitoli EPUB 3 XHTML, sostituire il DOCTYPE con <!DOCTYPE html>.
Per altri file, utilizzare esattamente il DOCTYPE che EPUBCheck mostra come previsto, oppure rimuoverlo dove il formato non consente alcun DOCTYPE.
Ricostruisci il EPUB e riesegui EPUBCheck di nuovo per confermare che il messaggio sia scomparso.

Quando non è questo

Se EPUBCheck dice che il DOCTYPE è obsoleto e può essere rimosso, ciò è HTM-009; HTM-004 mostra il DOCTYPE previsto.

Termini usati qui

Altri messaggi di HTM

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

Fonti

EPUB 3.3, §B. Allowed external identifiers · leggi 04 Novembre 2026
EPUB 3.3, §3.9 XML conformance · 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-004?

È HTM-004 un errore?

HTM-004 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.