EPUBCheck · Arkusz stylów

EPUBCheck CSS-029: niezadeklarowana klasa CSS nakładki

Zaktualizowane: 4 listopada 2026

EPUBCheck CSS-029 to komunikat o użytkowaniu: „Found CSS class name "…" but no "…" property was declared in the package document.” CSS używa nazwy klasy akcentującej nakładki media, ale dokument pakietu nie deklaruje pasującej właściwości. Przy nakładkach media klasa, która akcentuje tekst odczytywany na głos, musi być zadeklarowana w metadanych pakietu (media:active-class lub media:playback-active-class); EPUBCheck nazywa zarówno klasę, jak i brakującą właściwość.

Oficjalna wiadomość

Found CSS class name "%1$s" but no "%2$s" property was declared in the package document.

Domyślna powaga: Użycie. Tylko informacyjne i domyślnie ukryte: pojawia się, gdy EPUBCheck jest uruchamiane z -u (--usage). Nie czyni to EPUB nieważnym.
Wersja EPUBCheck: 5.4.0

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

Typowe przyczyny

Arkusz stylów skopiowany z książki z narracją do pakietu, który nigdy nie zadeklarował klasy.
Metadane pakietu zostały edytowane, a elementy media: meta zostały usunięte.

Jak to naprawić

Dodaj właściwość do metadanych pakietu, na przykład <meta property="media:active-class">my-active-item</meta>, z dokładnie jedną nazwą klasy i bez selektora.
Lub usuń nieużywaną klasę z CSS, jeśli książka nie ma mediów przeźroczystych.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli klasa jest zadeklarowana, ale żaden CSS nie dociera do rozdziału, błąd to CSS-030.

Terminy używane tutaj

Inne komunikaty CSS

CSS-028 Use of Font-face declaration.
CSS-030 The package document declares media overlays styling class names but no CSS was found in the content document.
CSS-019 CSS font-face declaration has no attributes.
CSS-015 Alternative style sheets must have a title.
CSS-008 An error occurred while parsing the CSS: ….
CSS-007 Font-face reference "…" refers to non-standard font type "…".

Źródła

EPUB 3.3, §9.3.4 Associating style information · 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 CSS-029?

Czy CSS-029 to błąd?

CSS-029 jest zgłaszany domyślnie jako użycie. Tylko informacyjne i domyślnie ukryte: pojawia się, gdy EPUBCheck uruchamia się z parametrem -u (--usage). Nie czyni to EPUB nieprawidłowym.