EPUBCheck · Fogli di stile

EPUBCheck CSS-030: stili di sovrapposizione senza CSS

Aggiornato: 04 Novembre 2026

EPUBCheck CSS-030 è un messaggio di errore: “The package document declares media overlays styling class names but no CSS was found in the content document.” Il pacchetto dichiara i nomi di classe di stile di sovrapposizione mediatica, ma un capitolo con narrazione non ha CSS. EPUB richiede che ogni documento di contenuto con una sovrapposizione mediatica includa un foglio di stile, collegato o incorporato, che definisce quelle classi, altrimenti il testo letto non viene evidenziato come previsto.

Il messaggio ufficiale

The package document declares media overlays styling class names but no CSS was found in the content document.

Gravità predefinita: Errore. Il EPUB viola una regola della specifica ed è non valido. I negozi e Invia a Kindle potrebbero rifiutarlo, e EPUBCheck esce con stato 1.
versione EPUBCheck: 5.4.0

Cause tipiche

Un capitolo con narrazione che non collega il foglio di stile che usano gli altri capitoli.
media:active-class dichiarata nel pacchetto mentre la classe non è definita da nessuna parte.

Come correggerlo

Collega il foglio di stile che definisce le classi dai nomi del capitolo EPUBCheck, per esempio <link rel="stylesheet" href="styles.css" type="text/css"/>.
Assicurati che il foglio di stile definisca realmente la classe dichiarata in media:active-class (e media:playback-active-class, se utilizzato).
Ricostruisci il EPUB e riesegui EPUBCheck di nuovo per confermare che il messaggio sia scomparso.

Quando non è questo

Se il CSS definisce la classe ma il pacchetto non la dichiara, il messaggio è CSS-029.

Termini usati qui

Cosa sono i media overlays EPUB?

Altri messaggi di CSS

CSS-029 Found CSS class name "…" but no "…" property was declared in the package document.
CSS-028 Use of Font-face declaration.
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 "…".

Fonti

EPUB 3.3, §9.3.4 Associating style information · leggi 04 Novembre 2026

Testo e gravità del messaggio da EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Spiegazione di EpubCC.

FAQ

Cosa significa EPUBCheck CSS-030?

È CSS-030 un errore?

CSS-030 è riportato come errore per impostazione predefinita. Il EPUB infrange una regola della specifica ed è non valido. I punti di archiviazione e Invia a Kindle potrebbero rifiutarlo, e EPUBCheck esce con stato 1.