EPUBCheck · Documento del pacchetto (OPF)

EPUBCheck OPF-003: file mancante dal manifesto

Aggiornato: 04 Novembre 2026

EPUBCheck OPF-003 è un messaggio di utilizzo: “Item "…" exists in the EPUB, but is not declared in the OPF manifest.” Un file è nell'archivio ma non dichiarato nel manifesto. Le app di lettura lavorano a partire dal manifesto, quindi un file non dichiarato potrebbe essere ignorato; questa è una nota di utilizzo, mostrata solo quando EPUBCheck viene eseguito con -u.

Il messaggio ufficiale

Item "%1$s" exists in the EPUB, but is not declared in the OPF manifest.

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

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

Cause tipiche

File di sistema residui come .DS_Store o Thumbs.db compressi insieme al libro.
Vecchie immagini, backup o bozze che sono rimaste nella cartella del libro dopo la modifica.
Un nuovo file aggiunto alla cartella senza aggiornare il manifesto.

Come correggerlo

Guarda i nomi dei file EPUBCheck e decidi se il libro lo utilizza.
Se il libro non lo utilizza, eliminalo dalla cartella e ricostruisci l'archivio.
Se il libro lo utilizza, aggiungi un item manifest con un id unico, il suo percorso e il suo tipo di media, ad esempio <item id="img2" href="images/map.png" media-type="image/png"/>.

Quando non è questo

Se il file non dichiarato è anche referenziato dal contenuto, EPUBCheck riporta RSC-008, che è quello da correggere per primo.

Termini usati qui

Altri messaggi di OPF

OPF-002 The OPF file "…" was not found in the EPUB.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-001 There was an error when parsing the EPUB version: ….
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-007 Re-declaration of reserved prefix "…".

Fonti

EPUB 3.3, §5.6.2 The item element · 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 OPF-003?

È OPF-003 un errore?

OPF-003 è segnalato come utilizzo per impostazione predefinita. Informativo solo e nascosto per impostazione predefinita: appare quando EPUBCheck viene eseguito con -u (--usage). Non rende il EPUB non valido.