EPUBCheck · Pakiet i kontener ZIP

EPUBCheck PKG-001: niezgodność wersji EPUB

Zaktualizowane: 4 listopada 2026

EPUBCheck PKG-001 to komunikat ostrzegawczy: „Validating the EPUB against version … but detected version ….” EPUBCheck otrzymał polecenie, aby zwalidować jedną wersję EPUB, ale dokument pakietu deklaruje inną. Wersja pochodzi z atrybutu wersji elementu pakietu, a EPUBCheck zgłasza niezgodność jako ostrzeżenie, zanim zastosuje zasady wersji, o którą prosiłeś.

Oficjalna wiadomość

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

Domyślna powaga: Ostrzeżenie. EPUB jest wciąż ważny, ale coś może powodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy działanie z wynikiem 0, chyba że przekażesz --failonwarnings.
Wersja EPUBCheck: 5.4.0

%1$s, %2$s… wypełnione są plikiem, wartością lub elementem EPUBCheck znalezionym.

Typowe przyczyny

EPUBCheck uruchomiono z -v 2.0 lub -v 3.0, a element pakietu pliku ma inny atrybut wersji.
Skrypt budujący lub usługa walidacyjna, która zawsze przekazuje tę samą opcję -v, nieważne, jaka jest książka.
Książka półprzetworzona z EPUB 2 do EPUB 3, której atrybut wersji nie został zaktualizowany.

Jak to naprawić

Uruchom EPUBCheck bez -v na spakowanym pliku .epub: odczytuje wersję z dokumentu pakietu.
Jeśli atrybut wersji jest błędny, ustaw go na wersję, której treść naprawdę przestrzega: version="3.0" dla EPUB 3.
Zwaliduj ponownie i popraw wiadomości dla właściwej wersji.

Kiedy to nie to

Jeśli EPUBCheck mówi, że waliduje zgodność z 2.0 przy domyślnym profilu, to jest informacyjne PKG-023, a nie niezgodność.

Terminy używane tutaj

Inne komunikaty PKG

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

Źródła

EPUB 3.3, §5.4 The package element · czytaj 4 listopada 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · czytaj 4 listopada 2026

Tekst wiadomości i poważność z EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Wyjaśnienie przez EpubCC.

FAQ

Co oznacza EPUBCheck PKG-001?

Czy PKG-001 to błąd?

PKG-001 jest domyślnie zgłaszane jako ostrzeżenie. EPUB wciąż jest ważny, ale coś prawdopodobnie spowoduje problemy w niektórych aplikacjach do czytania. EPUBCheck kończy się z 0, chyba że przekazujesz --failonwarnings.