EPUBCheck · XHTML documenti di contenuto

EPUBCheck HTM_054: spazio dei nomi personalizzato riservato

Aggiornato: 04 Novembre 2026

EPUBCheck HTM_054 è un messaggio di errore: “Custom attribute namespace ("…") must not include the string "…" in its domain.” Un attributo personalizzato utilizza uno spazio dei nomi il cui dominio contiene w3.org o idpf.org. EPUB consente solo attributi personalizzati con prefisso in spazi dei nomi al di fuori di questi due domini, che sono riservati agli standard stessi.

Il messaggio ufficiale

Custom attribute namespace ("%1$s") must not include the string "%2$s" in its domain.

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

EPUBCheck stampa questo ID con un trattino basso invece di un trattino; questa pagina utilizza l'ID esattamente come EPUBCheck lo riporta.

%1$s, %2$s… sono completati con il file, valore o elemento EPUBCheck trovato.

Cause tipiche

Un attributo in uno spazio dei nomi inventato sotto w3.org o idpf.org, spesso un errore di battitura per uno spazio dei nomi reale.
Un vero EPUB o un attributo HTML scritto con il namespace URI errato, quindi trattato come un personalizzato.

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ì.
Se l'attributo è uno standard (come epub:type), dichiara il suo corretto namespace, ad esempio xmlns:epub="http://www.idpf.org/2007/ops".
Se è un tuo attributo o di un fornitore, spostalo in un URI di namespace su un dominio che controlli, o rimuovilo.
Ricostruisci il EPUB e riesegui EPUBCheck di nuovo per confermare che il messaggio sia scomparso.

Quando non è questo

Se il problema è un nome attributo data-*, è HTM_061.

Altri messaggi di HTM

HTM_055 The "…" element should not be used (discouraged construct)
HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM_057 Viewport "…" value must be a positive number or the keyword "device-…"
HTM_058 HTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059 Viewport "…" property must not be defined more than once, but found values […].

Fonti

EPUB 3.3, §6.1.3.5 Custom attributes · 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_054?

È HTM_054 un errore?

HTM_054 viene segnalato come errore di default. Il EPUB viola una regola della specifica ed è non valido. Le librerie e l'invio a Kindle potrebbero rifiutarlo, e EPUBCheck termina con stato 1.