EPUBCheck · Paket und ZIP-Container

EPUBCheck PKG-012: nicht-ASCII-Buchstaben im Dateinamen

Aktualisiert: 4. November 2026

EPUBCheck PKG-012 ist eine Gebrauchsnachricht: „The file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.“ Ein Dateiname im EPUB enthält nicht-ASCII-Zeichen (Akzente, andere Skripte). Das ist in EPUB 3 gültig, kann jedoch ältere Lesesysteme stören, sodass EPUBCheck es als Gebrauchsinformation meldet.

Die offizielle Nachricht

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

Standard-Schweregrad: Nutzung. Nur informativ und standardmäßig ausgeblendet: es erscheint, wenn EPUBCheck mit -u (--usage) ausgeführt wird. Es macht EPUB nicht ungültig.
EPUBCheck Version: 5.4.0

%1$s, %2$s… werden mit der Datei, dem Wert oder dem Element EPUBCheck ausgefüllt.

Typische Ursachen

Dateien, die nach Titeln in anderen Sprachen als Englisch benannt sind, wie "capítulo-1.xhtml".
Bilder werden mit der Bildunterschrift oder dem Namen des Fotografen als Dateiname exportiert.

Wie man es behebt

Entscheiden Sie, ob Sie ältere Geräte ansprechen; wenn nicht, können Sie die Namen so belassen, wie sie sind.
Wenn Sie dies tun, benennen Sie die Datei nur mit ASCII-Zeichen um.
Nach der Umbenennung aktualisieren Sie jede Referenz zur Datei: das Manifest im Paketdokument, Links und Bildquellen in der XHTML und url()-Referenzen im CSS.

Wann es nicht das ist

Wenn EPUBCheck das Archiv aufgrund der Namen überhaupt nicht extrahieren kann, ist das PKG-027.

Hier verwendete Begriffe

Was ist der EPUB Container (OCF)?

Andere PKG Nachrichten

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.

Quellen

EPUB 3.3, §4.2.3 File paths and file names · lesen 4. November 2026

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck PKG-012?

Ist PKG-012 ein Fehler?

PKG-012 wird standardmäßig als Verwendung gemeldet. Informativ und standardmäßig verborgen: es erscheint, wenn EPUBCheck mit -u (--usage) ausgeführt wird. Es macht den EPUB nicht ungültig.