EPUBCheck · Paket och ZIP-behållare

EPUBCheck PKG-001: EPUB versionsmismatch

Uppdaterad: 4 november 2026

EPUBCheck PKG-001 är ett varningsmeddelande: “Validating the EPUB against version … but detected version ….” EPUBCheck blev ombedd att validera en EPUB version men paketdokumentet anger en annan. Versionen kommer från versionsegenskapen i paketelementet, och EPUBCheck rapporterar mismatchen som en varning innan det tillämpar reglerna för den version du bad om.

Det officiella meddelandet

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

Standardsvårighetsgrad: Varning. EPUB är fortfarande giltig, men något kan troligen orsaka problem i vissa läsappar. EPUBCheck avslutas med 0 om du inte passerar --failonwarnings.
EPUBCheck version: 5.4.0

%1$s, %2$s… fylls med filen, värdet eller elementet EPUBCheck som hittades.

Typiska orsaker

EPUBCheck kördes med -v 2.0 eller -v 3.0 och filens paket-element har en annan versionsattribut.
Ett byggscript eller valideringstjänst som alltid går igenom samma -v alternativ, oavsett vilken bok det handlar om.
En bok som halvkonverterades från EPUB 2 till EPUB 3 vars versionsattribut inte uppdaterades.

Hur man åtgärdar det

Kör EPUBCheck utan -v på en paketerad .epub-fil: den läser versionen från paketdokumentet.
Om versionsattributet själv är fel, sätt det till den version som innehållet verkligen följer: version="3.0" för EPUB 3.
Validera igen och åtgärda meddelandena för rätt version.

När det inte är detta

Om EPUBCheck säger att det validerar mot 2.0 med standardprofilen, är det den informativa PKG-023, inte en diskrepans.

Villkor som används här

Andra PKG meddelanden

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

Källor

EPUB 3.3, §5.4 The package element · läs 4 november 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · läs 4 november 2026

Meddelandetext och allvarlighetsgrad från EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Förklaring av EpubCC.

FAQ

Vad betyder EPUBCheck PKG-001?

Är PKG-001 ett fel?

PKG-001 rapporteras som varning som standard. EPUB är fortfarande giltig, men något kan troligtvis orsaka problem i vissa läsappar. EPUBCheck avslutas med 0 om du inte använder --failonwarnings.