EPUBCheck · Pakiet i kontener ZIP

EPUBCheck PKG-009: zabroniony znak w nazwie pliku

Zaktualizowane: 4 listopada 2026

EPUBCheck PKG-009 jest komunikatem o błędzie: “The file name "…" contains characters that are not allowed in OCF file names: ….” Nazwa pliku wewnątrz EPUB zawiera znak, którego zasady kontenera EPUB nie dopuszczają w nazwach plików. Ograniczenie istnieje, aby te same nazwy działały na każdym systemie operacyjnym, który rozpakowuje książkę.

Oficjalna wiadomość

The file name "%1$s" contains characters that are not allowed in OCF file names: %2$s.

Domyślna powaga: Błąd. EPUB łamie zasady specyfikacji i jest nieprawidłowy. Sklepy i Wysłanie do Kindle mogą go odrzucić, a EPUBCheck kończy działanie ze statusem 1.
Wersja EPUBCheck: 5.4.0

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

Typowe przyczyny

Znaki takie jak ", *, :, <, >, ?, \ lub |, lub znaki kontrolne, zazwyczaj kopiowane z oryginalnego tytułu obrazu lub rozdziału.
Pliki eksportowane z narzędzia, które nazywa je na podstawie nagłówków lub podpisów.

Jak to naprawić

Zmień nazwę pliku używając liter, cyfr, myślników i podkreśleń.
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.
Odbuduj archiwum i zwaliduj ponownie; wszelkie odniesienia, które pominąłeś, pojawią się jako RSC-007.

Kiedy to nie to

Spacje są dozwolone i tylko dają ostrzeżenie PKG-010; znaki nie-ASCII dają PKG-012.

Terminy używane tutaj

Co to jest kontener EPUB (OCF)?

Inne komunikaty PKG

PKG-008 Unable to read file "…".
PKG-010 The file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-007 The content of the mimetype file must be the string "application/epub+zip"…
PKG-011 The file name "…" is not allowed to end with ".".
PKG-006 Mimetype file entry is missing or is not the first file in the archive.
PKG-012 The file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.

Źródła

EPUB 3.3, §4.2.3 File paths and file names · 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-009?

Czy PKG-009 to błąd?

PKG-009 jest zgłaszany jako błąd domyślnie. EPUB łamie zasady specyfikacji i jest nieważny. Sklepy i Wysyłanie do Kindle mogą go odrzucić, a EPUBCheck kończy pracę z kodem stanu 1.