EPUBCheck · Documento del pacchetto (OPF)

EPUBCheck OPF-028: prefisso utilizzato ma non dichiarato

Aggiornato: 04 Novembre 2026

EPUBCheck OPF-028 è un messaggio di errore: “Undeclared prefix: "…".” Una proprietà utilizza un prefisso che non è dichiarato nell'attributo prefix del documento del pacchetto. A parte i prefissi riservati, ogni prefisso deve essere mappato a un URI di vocabolario prima di poter essere utilizzato.

Il messaggio ufficiale

Undeclared prefix: "%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

Proprietà del venditore come ibooks:version utilizzate senza dichiarare il prefisso ibooks.
L'attributo prefix è stato rimosso o pulito mentre le proprietà lo usano ancora.
Un errore di battitura nel prefisso di una proprietà, quindi non corrisponde più a quella dichiarata.

Come correggerlo

Leggi i nomi del prefisso EPUBCheck.
Aggiungi la sua mappatura all'attributo prefisso dell'elemento pacchetto. Scrivi ogni mappatura come il nome del prefisso, due punti, uno spazio e l'URI del vocabolario, e separa le mappature con spazi bianchi, ad esempio prefix="ibooks: http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/ foaf: http://xmlns.com/foaf/spec/".
Oppure, se la proprietà non è necessaria, rimuovila.

Quando non è questo

Se il prefisso è dichiarato ma la dichiarazione è mal scritta, è una variante di OPF-004.

Termini usati qui

Altri messaggi di OPF

OPF-027 Undefined property: "…".
OPF-029 The file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-026 Found malformed property value: "…".
OPF-030 The unique-identifier "…" was not found.
OPF-025 Property value list "…" is not allowed, only one value must be specified.
OPF-031 File listed in reference element in guide was not declared in OPF manifest: ….

Fonti

EPUB 3.3, §D.1.4 The prefix attribute · leggi 04 Novembre 2026
EPUB 3.3, §D.1.5 Reserved prefixes · 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-028?

È un errore OPF-028?

OPF-028 viene segnalato come errore per impostazione predefinita. Il EPUB viola una regola della specifica ed è non valido. Gli Store e l'invio a Kindle potrebbero rifiutarlo, e EPUBCheck esce con stato 1.