EPUBCheck · Pacchetto e contenitore ZIP

EPUBCheck PKG-022: conflitto di estensione dell'immagine

Aggiornato: 04 Novembre 2026

EPUBCheck PKG-022 è un messaggio di avviso: “Wrong file extension for image. The image is a "…" file but has the file extension "…".” L'estensione di un'immagine non corrisponde al suo formato reale, ad esempio un file PNG nominato .jpg. La maggior parte delle app di lettura lo mostra comunque, ma gli strumenti che si fidano dell'estensione o del tipo di media del manifesto possono fallire.

Il messaggio ufficiale

Wrong file extension for image. The image is a "%1$s" file but has the file extension "%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

Immagini rinominate invece di convertite.
Strumenti che salvano in un formato ma mantengono l'estensione precedente.

Come correggerlo

Rinomina il file con l'estensione corretta o converti nel formato che il suo nome indica.
Fai in modo che il tipo di media del manifesto corrisponda al formato reale (image/png, image/jpeg…).
Dopo aver rinominato, aggiorna ogni riferimento al file: il manifest nel documento pacchetto, i link e le fonti delle immagini nel XHTML, e i riferimenti url() nel CSS.

Quando non è questo

Se l'immagine non può essere decifrata affatto, il messaggio è PKG-021.

Termini usati qui

Altri messaggi di PKG

PKG-021 Corrupted image file encountered.
PKG-023 Validating the EPUB against version 2.0, default validation profile will be used.
PKG-020 OPF file "…" could not be found.
PKG-025 Publication resource must not be located in the META-INF directory
PKG-018 The EPUB file could not be found.
PKG-026 Obfuscated resource must be a Font Core Media Type (was declared as "…" in "…").

Fonti

EPUB 3.3, §3.2 Core media types · leggi 04 Novembre 2026
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 PKG-022?

È PKG-022 un errore?

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