EPUBCheck · NCX (EPUB tabella dei contenuti 2)

EPUBCheck NCX-004: spazi bianchi nell'uid NCX

Aggiornato: 04 Novembre 2026

EPUBCheck NCX-004 è un messaggio di utilizzo: “NCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.” Il valore dtb:uid dell'NCX ha spazi o interruzioni di riga prima o dopo di esso. L'identificatore dovrebbe corrispondere esattamente all'identificatore unico del pacchetto, e spazi bianchi extra possono far fallire un confronto rigoroso.

Il messaggio ufficiale

NCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.

Gravità predefinita: Utilizzo. Solo informativo e nascosto per impostazione predefinita: appare quando EPUBCheck viene eseguito con -u (--usage). Non rende invalido il EPUB.
versione EPUBCheck: 5.4.0

Cause tipiche

XML formattato prettamente che mette il valore su una propria riga.
Un valore incollato con uno spazio finale.

Come correggerlo

Apri il NCX (di solito toc.ncx) e trova <meta name="dtb:uid" content="..."/>.
Rimuovi gli spazi bianchi attorno al valore dell'attributo content affinché sia identico al dc:identifier del pacchetto.
Ricostruisci il EPUB e riesegui EPUBCheck di nuovo per confermare che il messaggio sia scomparso.

Quando non è questo

Se il valore è diverso dall'identificatore del pacchetto, non solo imbottito, l'errore è NCX-001.

Termini usati qui

Che cos'è la tabella dei contenuti NCX?

Altri messaggi di NCX

NCX-006 Empty "text" label in the NCX document
NCX-001 NCX identifier ("…") does not match OPF identifier ("…").

Fonti

EPUB 3.3, §5.9.5 NCX · 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 NCX-004?

È NCX-004 un errore?

NCX-004 è segnalato come utilizzo per impostazione predefinita. Solo informativo e nascosto per impostazione predefinita: appare quando EPUBCheck viene eseguito con -u (--usage). Non rende il EPUB non valido.