EPUBCheck · Hojas de estilo

EPUBCheck CSS-029: clase CSS de superposición no declarada

Actualizado: 4 de noviembre de 2026

EPUBCheck CSS-029 es un mensaje de uso: “Found CSS class name "…" but no "…" property was declared in the package document.” El CSS utiliza un nombre de clase de resaltado de superposición de medios, pero el documento del paquete no declara la propiedad correspondiente. Con las superposiciones de medios, la clase que resalta el texto que se lee en voz alta debe ser declarada en los metadatos del paquete (media:active-class o media:playback-active-class); EPUBCheck nombra tanto la clase como la propiedad que falta.

El mensaje oficial

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

Severidad por defecto: Uso. Informativo solo y oculto por defecto: aparece cuando EPUBCheck se ejecuta con -u (--usage). No hace que el EPUB sea inválido.
versión de EPUBCheck: 5.4.0

%1$s, %2$s… se completan con el archivo, valor o elemento EPUBCheck encontrado.

Causas típicas

Una hoja de estilos copiada de un libro con narración en un paquete que nunca declaró la clase.
Los metadatos del paquete fueron editados y los elementos media:meta fueron eliminados.

Cómo arreglarlo

Añadir la propiedad a los metadatos del paquete, por ejemplo <meta property="media:active-class">my-active-item</meta>, con exactamente un nombre de clase y ningún selector.
O elimina la clase no utilizada del CSS si el libro no tiene superposiciones multimedia.
Reconstruye el EPUB y ejecuta EPUBCheck nuevamente para confirmar que el mensaje ha desaparecido.

Cuándo no es esto

Si la clase está declarada pero ningún CSS llega al capítulo, el error es CSS-030.

Términos usados aquí

Otros mensajes de 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 "…".

Fuentes

EPUB 3.3, §9.3.4 Associating style information · leer 4 de noviembre de 2026

Texto y severidad del mensaje de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicación por EpubCC.

FAQ

¿Qué significa EPUBCheck CSS-029?

¿Es CSS-029 un error?

CSS-029 se informa como uso por defecto. Solo informativo y oculto por defecto: aparece cuando EPUBCheck se ejecuta con -u (--usage). No hace que el EPUB sea inválido.