EPUBCheck · Zasoby i odniesienia

EPUBCheck RSC-005: błąd schematu w pliku

Zaktualizowane: 4 listopada 2026

EPUBCheck RSC-005 to komunikat o błędzie: „Error while parsing file: ….” Plik nie spełnia schematu, którego EPUB wymaga dla niego. Element, atrybut lub wartość są niedozwolone tam, gdzie są, lub coś wymaganego brakuje; tekst po "Error while parsing file:" mówi, co. Jest to najczęstszy błąd EPUBCheck, a jeden błąd strukturalny może powodować kilka komunikatów.

Oficjalna wiadomość

Error while parsing file: %1$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

"element X not allowed here" lub "attribute X not allowed here": elementy zagnieżdżone tam, gdzie schemat ich zabrania (div wewnątrz p), lub atrybuty, które HTML lub EPUB nie definiują, często skopiowane z stron internetowych lub edytorów tekstu.
"Duplicate ID": ta sama wartość id użyta dwukrotnie w jednym dokumencie, często z skopiowanych przypisów lub nagłówków.
Brak wymaganych metadanych, takich jak data dcterms:modified dokumentu pakietu EPUB 3, lub brakujący wymagany element, taki jak tytuł w nagłówku XHTML.
"value of attribute X is invalid": wartość niewłaściwego typu, taka jak data w niewłaściwym formacie lub id, które zaczyna się od cyfry.

Jak to naprawić

Przeczytaj tekst po dwukropku: EPUBCheck raportuje plik, linię i kolumnę oraz własny opis problemu przez parser.
Napraw element lub atrybut, do którego się odnosi: przenieś lub usuń element, usuń nieznany atrybut, lub spraw, by zduplikowane ID było unikalne i zaktualizuj linki, które do niego prowadziły.
W dokumentach pakietu dodaj brakujące metadane, na przykład <meta property="dcterms:modified">2026-11-03T00:00:00Z</meta> (dokładnie jedno, w tym formacie).
Najpierw napraw pierwsze błędy i zwaliduj ponownie: jeden błąd strukturalny może spowodować kilka późniejszych.

Kiedy to nie to

Jeśli plik nie jest nawet poprawnie sformatowanym XML (nieodkodowany & lub niezamknięty tag), EPUBCheck zgłasza fatalny RSC-016 zamiast tego.

Terminy używane tutaj

Inne komunikaty RSC

RSC-004 File "…" is encrypted, its content will not be checked.
RSC-006 Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006b Resource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-003 No rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-007 Referenced resource "…" could not be found in the EPUB.
RSC-002 Required META-INF/container.xml resource could not be found.

Źródła

EPUB 3.3, §6.1.2 XHTML requirements · czytaj 4 listopada 2026
EPUB 3.3, §5.5.5 Last modified date · 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 RSC-005?

Czy RSC-005 to błąd?

RSC-005 jest zgłaszany jako błąd domyślnie. EPUB łamie regułę specyfikacji i jest nieważny. Sklepy i wysyłka do Kindle mogą go odrzucić, a EPUBCheck kończy z kodem wyjścia 1.