EPUBCheck · Pacchetto e contenitore ZIP

EPUBCheck PKG-001: EPUB discrepanza di versione

Aggiornato: 04 Novembre 2026

EPUBCheck PKG-001 è un messaggio di avviso: “Validating the EPUB against version … but detected version ….” EPUBCheck è stato istruito a convalidare una versione EPUB, ma il documento del pacchetto dichiara un'altra versione. La versione deriva dall'attributo versione dell'elemento pacchetto, e EPUBCheck segnala la discrepanza come avviso prima di applicare le regole della versione che hai richiesto.

Il messaggio ufficiale

Validating the EPUB against version %1$s but detected version %2$s.

Gravità predefinita: Avviso. Il EPUB è ancora valido, ma qualcosa potrebbe causare problemi in alcune app di lettura. EPUBCheck esce con 0 a meno che non passi --failonwarnings.
versione EPUBCheck: 5.4.0

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

Cause tipiche

EPUBCheck è stato eseguito con -v 2.0 o -v 3.0 e l'elemento pacchetto del file ha un attributo versione diverso.
Uno script di build o un servizio di validazione che passa sempre la stessa opzione -v, qualunque sia il libro.
Un libro convertito a metà da EPUB 2 a EPUB 3 la cui proprietà versione non è stata aggiornata.

Come correggerlo

Esegui EPUBCheck senza -v su un file .epub impacchettato: legge la versione dal documento di pacchetto.
Se l'attributo versione stesso è errato, impostalo sulla versione che il contenuto segue realmente: version="3.0" per EPUB 3.
Valida di nuovo e correggi i messaggi per la versione corretta.

Quando non è questo

Se EPUBCheck dice che sta convalidando contro 2.0 con il profilo predefinito, ciò è l'informativo PKG-023, non un disallineamento.

Termini usati qui

Altri messaggi di PKG

PKG-003 Unable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004 Corrupted EPUB ZIP header.
PKG-005 The mimetype file has an extra field of length …. The use of the extra field feature of the ZIP format is not permitted for the mimetype file.
PKG-006 Mimetype file entry is missing or is not the first file in the archive.
PKG-007 The content of the mimetype file must be the string "application/epub+zip"…
PKG-008 Unable to read file "…".

Fonti

EPUB 3.3, §5.4 The package element · leggi 04 Novembre 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · 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 PKG-001?

È PKG-001 un errore?

PKG-001 è segnalato come avviso per impostazione predefinita. Il EPUB è ancora valido, ma qualcosa è probabile che causi problemi in alcune app di lettura. EPUBCheck esce con 0 a meno che tu non passi --failonwarnings.