EPUBCheck · Stylesheets

EPUBCheck CSS-029: nicht deklariertes Überlagerungs-CSS-Klasse

Aktualisiert: 4. November 2026

EPUBCheck CSS-029 ist eine Verwendungsmeldung: “Found CSS class name "…" but no "…" property was declared in the package document.” Das CSS verwendet einen Medien-Overlay-Hervorhebungs-Klassennamen, aber das Paketdokument erklärt die passende Eigenschaft nicht. Bei Medienüberlagerungen muss die Klasse, die den Text hervorhebt, der laut gelesen wird, in den Paketmetadaten deklariert werden (media:active-class oder media:playback-active-class); EPUBCheck benennt sowohl die Klasse als auch die fehlende Eigenschaft.

Die offizielle Nachricht

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

Standard-Schweregrad: Nutzung. Nur informativ und standardmäßig ausgeblendet: es erscheint, wenn EPUBCheck mit -u (--usage) ausgeführt wird. Es macht EPUB nicht ungültig.
EPUBCheck Version: 5.4.0

%1$s, %2$s… werden mit der Datei, dem Wert oder dem Element EPUBCheck ausgefüllt.

Typische Ursachen

Ein Stylesheet, das aus einem Buch mit Erzählung in ein Paket kopiert wurde, das die Klasse nie deklariert hat.
Die Paketmetadaten wurden bearbeitet und die media: meta-Elemente wurden entfernt.

Wie man es behebt

Fügen Sie die Eigenschaft zu den Metadaten des Pakets hinzu, zum Beispiel <meta property="media:active-class">my-active-item</meta>, mit genau einem Klassennamen und keinem Selektor.
Oder entfernen Sie die ungenutzte Klasse aus dem CSS, wenn das Buch keine Medienüberlagerungen hat.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Wenn die Klasse deklariert ist, aber kein CSS das Kapitel erreicht, ist der Fehler CSS-030.

Hier verwendete Begriffe

Was sind EPUB Medienüberlagerungen?

Andere CSS Nachrichten

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 "…".

Quellen

EPUB 3.3, §9.3.4 Associating style information · lesen 4. November 2026

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck CSS-029?

Ist CSS-029 ein Fehler?

CSS-029 wird standardmäßig als Nutzung gemeldet. Nur informativ und standardmäßig versteckt: es erscheint, wenn EPUBCheck mit -u (--usage) ausgeführt wird. Es macht das EPUB nicht ungültig.