EPUBCheck · Immagini, audio e sovrapposizioni multimediali

EPUBCheck MED_012: disallineamento dell'id media-overlay

Aggiornato: 04 Novembre 2026

EPUBCheck MED_012 è un messaggio di errore: “The "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.” L'attributo media-overlay di un capitolo nomina un'overlay diversa da quella che fa riferimento. Il file SMIL che narra un capitolo e l'elemento di manifesto del capitolo devono puntare l'uno all'altro.

Il messaggio ufficiale

The "media-overlay" attribute does not match the ID of the Media Overlay that refers to this 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

EPUBCheck stampa questo ID con un trattino basso invece di un trattino; questa pagina utilizza l'ID esattamente come EPUBCheck lo riporta.

Cause tipiche

IDs di overlay rinominati o scambiati nel manifesto.
Un capitolo copiato con il suo elemento manifest, mantenendo il valore dell'overlay multimediale originale.

Come correggerlo

Trova il file SMIL i cui elementi di testo puntano ai nomi dei capitoli EPUBCheck.
Imposta l'attributo media-overlay del capitolo all'id manifesto di quel file SMIL.
Controlla gli altri capitoli allo stesso modo: questi errori di solito si presentano in gruppi.
Ricostruisci il EPUB e riesegui EPUBCheck di nuovo per confermare che il messaggio sia scomparso.

Quando non è questo

Se l'attributo è completamente assente, l'errore è MED_010.

Termini usati qui

Altri messaggi di MED

MED_011 EPUB Content Document referenced from multiple Media Overlay Documents.
MED_013 Media Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_010 EPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_014 Media overlay audio file URLs must not have a fragment, but found '#…'.
MED-009 The time specified in the clipBegin attribute must not be the same as clipEnd.
MED_015 Media overlay text references must be in reading order. Text target "…" is before the previous link target in … order.

Fonti

EPUB 3.3, §9.3.5.1 Including media overlays · 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 MED_012?

È MED_012 un errore?

MED_012 viene segnalato come errore per impostazione predefinita. Il EPUB viola una regola della specifica ed è non valido. I negozi e Invia a Kindle potrebbero rifiutarlo, e EPUBCheck esce con stato 1.