EPUBCheck · Pacchetto e contenitore ZIP

EPUBCheck PKG-012: lettere non ASCII nel nome del file

Aggiornato: 04 Novembre 2026

EPUBCheck PKG-012 è un messaggio di utilizzo: “The file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.” Un nome di file all'interno del EPUB contiene caratteri non ASCII (accenti, altri script). Questo è valido in EPUB 3, ma potrebbe causare problemi sui sistemi di lettura più vecchi, quindi EPUBCheck lo riporta come informazione di utilizzo.

Il messaggio ufficiale

The file name "%1$s" contains non-ASCII characters, which might create interoperability issues with older reading systems.

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 denominati in titoli in lingue diverse dall'inglese, come "capítulo-1.xhtml".
Le immagini esportate hanno la didascalia o il nome del fotografo come nome del file.

Come correggerlo

Decidi se punti a dispositivi più vecchi; in caso contrario, puoi lasciare i nomi così come sono.
Se lo fai, rinomina il file con soli caratteri ASCII.
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 EPUBCheck non riesce a estrarre l'archivio a causa dei nomi, ciò è PKG-027.

Termini usati qui

Che cos'è il contenitore EPUB (OCF)?

Altri messaggi di PKG

PKG-011 The file name "…" is not allowed to end with ".".
PKG-010 The file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-014 The EPUB contains empty directory "…".
PKG-009 The file name "…" contains characters that are not allowed in OCF file names: ….
PKG-008 Unable to read file "…".
PKG-016 Use only lowercase characters for the EPUB file extension for maximum compatibility.

Fonti

EPUB 3.3, §4.2.3 File paths and file names · 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-012?

È PKG-012 un errore?

PKG-012 viene 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.