EPUBCheck · Pakiet i kontener ZIP

EPUBCheck PKG-022: niezgodność rozszerzenia obrazu

Zaktualizowane: 4 listopada 2026

EPUBCheck PKG-022 to komunikat ostrzegawczy: „Wrong file extension for image. The image is a "…" file but has the file extension "…".” Rozszerzenie obrazu nie pasuje do jego rzeczywistego formatu, na przykład plik PNG nazwany .jpg. Większość aplikacji do czytania nadal go wyświetla, ale narzędzia, które ufają rozszerzeniu lub manifestowi, mogą zawieść.

Oficjalna wiadomość

Wrong file extension for image. The image is a "%1$s" file but has the file extension "%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

Obrazy zrenamowane zamiast konwertowanych.
Narzędzia, które zapisują w jednym formacie, ale zachowują starą rozszerzoną nazwę.

Jak to naprawić

Zmień nazwę pliku na odpowiednie rozszerzenie lub przekonwertuj go na format, na który wskazuje jego nazwa.
Upewnij się, że typ mediów manifestu odpowiada prawdziwemu formatowi (image/png, image/jpeg…).
Po zmianie nazwy zaktualizuj każde odwołanie do pliku: manifest w dokumencie pakietu, linki i źródła obrazów w XHTML oraz odniesienia url() w CSS.

Kiedy to nie to

Jeśli obraz nie może być w ogóle dekodowany, wiadomość to PKG-021.

Terminy używane tutaj

Inne komunikaty PKG

PKG-021 Corrupted image file encountered.
PKG-023 Validating the EPUB against version 2.0, default validation profile will be used.
PKG-020 OPF file "…" could not be found.
PKG-025 Publication resource must not be located in the META-INF directory
PKG-018 The EPUB file could not be found.
PKG-026 Obfuscated resource must be a Font Core Media Type (was declared as "…" in "…").

Źródła

EPUB 3.3, §3.2 Core media types · czytaj 4 listopada 2026
EPUB 3.3, §5.6.2 The item element · 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-022?

Czy PKG-022 to błąd?

PKG-022 jest zgłaszany jako ostrzeżenie domyślnie. EPUB jest wciąż ważny, ale coś może powodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy pracę z 0, chyba że prześlesz --failonwarnings.