EPUBCheck · Paket und ZIP-Container

EPUBCheck PKG-001: EPUB Versionsunterschied

Aktualisiert: 4. November 2026

EPUBCheck PKG-001 ist eine Warnmeldung: „Validating the EPUB against version … but detected version ….“ EPUBCheck wurde aufgefordert, eine EPUB-Version zu validieren, aber das Paketdokument erklärt eine andere. Die Version stammt von dem Versionsattribut des Paketelements, und EPUBCheck meldet die Unstimmigkeit als Warnung, bevor es die Regeln der Version anwendet, die Sie angefordert haben.

Die offizielle Nachricht

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

Standard-Schweregrad: Warnung. Die EPUB ist weiterhin gültig, aber irgendetwas wird wahrscheinlich Probleme in einigen Leseanwendungen verursachen. EPUBCheck beendet die Ausführung mit 0, es sei denn, Sie übergeben --failonwarnings.
EPUBCheck Version: 5.4.0

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

Typische Ursachen

EPUBCheck wurde mit -v 2.0 oder -v 3.0 ausgeführt, und das Paketelement der Datei hat ein anderes Versionsattribut.
Ein Build-Skript oder Validierungsdienst, der immer dasselbe -v-Argument übergibt, egal, welches Buch es ist.
Ein Buch, das halb von EPUB 2 zu EPUB 3 konvertiert wurde, dessen Versionsattribut jedoch nicht aktualisiert wurde.

Wie man es behebt

Führen Sie EPUBCheck ohne -v auf einer gepackten .epub-Datei aus: es liest die Version aus dem Paketdokument.
Wenn das Versionsattribut selbst falsch ist, setzen Sie es auf die Version, die der Inhalt tatsächlich einhält: version="3.0" für EPUB 3.
Validieren Sie erneut und beheben Sie die Nachrichten für die richtige Version.

Wann es nicht das ist

Wenn EPUBCheck sagt, dass es gegen 2.0 mit dem Standardprofil validiert, ist das die informative PKG-023, kein Mismatch.

Hier verwendete Begriffe

Andere PKG Nachrichten

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 "…".

Quellen

EPUB 3.3, §5.4 The package element · lesen 4. November 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · 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-001?

Ist PKG-001 ein Fehler?

PKG-001 wird standardmäßig als Warnung gemeldet. Das EPUB ist weiterhin gültig, aber etwas wird wahrscheinlich in einigen Lese-Apps Probleme verursachen. EPUBCheck beendet mit 0, es sei denn, Sie übergeben --failonwarnings.