EPUBCheck · Pakiet i kontener ZIP

EPUBCheck PKG-010: spacja w nazwie pliku

Zaktualizowane: 4 listopada 2026

EPUBCheck PKG-010 jest komunikatem o ostrzeżeniu: “The file name "…" contains spaces, which may create interoperability issues with older reading systems.” Nazwa pliku wewnątrz EPUB zawiera spacje. To jest dozwolone, ale może łamać starsze systemy czytania, a każdy URL, który wskazuje na ten plik, musi poprawnie kodować spację.

Oficjalna wiadomość

The file name "%1$s" contains spaces, which may create interoperability issues with older reading systems.

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 lub rozdziały nazwane ich oryginalnymi tytułami, jak "Chapter 1.xhtml".
Pliki eksportowane z edytora tekstu lub narzędzia do układania, które zachowuje nazwy dokumentów.

Jak to naprawić

Zmień nazwę pliku, używając myślników lub podkreśleń zamiast spacji.
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.
Jeśli zachowujesz spację, każdy URL, który wskazuje na plik, musi kodować ją jako %20.

Kiedy to nie to

Jeśli nazwa zawiera znaki takie jak : lub ?, to błąd to PKG-009; źle zakodowany URL to RSC-020.

Terminy używane tutaj

Co to jest kontener EPUB (OCF)?

Inne komunikaty PKG

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

Ź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-010?

Czy PKG-010 to błąd?

PKG-010 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.