EPUBCheck RSC-005: error de esquema en un archivo
Actualizado:
EPUBCheck RSC-005 es un mensaje de error: “Error while parsing file: ….” Un archivo no sigue el esquema que EPUB requiere para él. Un elemento, atributo o valor no está permitido donde está, o falta algo requerido; el texto después de "Error while parsing file:" indica cuál. Es el error más común de EPUBCheck, y un solo error estructural puede causar varios mensajes.
El mensaje oficial
Error while parsing file: %1$s
- Severidad por defecto
- Error. El EPUB rompe una regla de la especificación y es inválido. Las tiendas y el envío a Kindle pueden rechazarlo, y EPUBCheck sale con estado 1.
- versión de EPUBCheck
- 5.4.0
%1$s, %2$s… se completan con el archivo, valor o elemento EPUBCheck encontrado.
Causas típicas
- "element X not allowed here" o "attribute X not allowed here": elementos anidados donde el esquema lo prohíbe (un div dentro de un p), o atributos que HTML o EPUB no definen, a menudo copiados de páginas web o procesadores de texto.
- "Duplicate ID": el mismo valor de id utilizado dos veces en un documento, a menudo de notas al pie o encabezados copiados.
- Faltan metadatos requeridos, como la fecha dcterms:modified de un documento de paquete EPUB 3, o un elemento requerido faltante como el título en la cabecera de XHTML.
- "value of attribute X is invalid": un valor del tipo incorrecto, como una fecha en el formato incorrecto o un id que comienza con un dígito.
Cómo arreglarlo
- Lee el texto después de los dos puntos: EPUBCheck informa del archivo, la línea y la columna, y la propia descripción del problema del analizador.
- Corrige el elemento o atributo que nombra: mueve o elimina el elemento, elimina el atributo desconocido, o haz que el id duplicado sea único y actualiza los enlaces que apuntaban a él.
- En documentos de paquete, añade los metadatos faltantes, por ejemplo
<meta property="dcterms:modified">2026-11-03T00:00:00Z</meta>(exactamente uno, en ese formato). - Corrige primero los errores iniciales y valida nuevamente: un error estructural puede causar varios errores posteriores.
Cuándo no es esto
Si el archivo ni siquiera está bien formado como XML (un & no escapado o una etiqueta no cerrada), EPUBCheck informa el fatal RSC-016 en su lugar.
Términos usados aquí
Otros mensajes de RSC
RSC-004File "…" is encrypted, its content will not be checked.RSC-006Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.RSC-006bResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.RSC-003No rootfile tag with media type "application/oebps-package+xml" was found in the container.RSC-007Referenced resource "…" could not be found in the EPUB.RSC-002Required META-INF/container.xml resource could not be found.
Fuentes
Texto y severidad del mensaje de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicación por EpubCC.