Saltar al contenido
EPUBCheck · Recursos y referencias

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

  1. 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.
  2. 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.
  3. 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).
  4. 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-004 File "…" is encrypted, its content will not be checked.
  • RSC-006 Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
  • RSC-006b Resource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
  • RSC-003 No rootfile tag with media type "application/oebps-package+xml" was found in the container.
  • RSC-007 Referenced resource "…" could not be found in the EPUB.
  • RSC-002 Required 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.

FAQ

¿Qué significa EPUBCheck RSC-005?

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.

¿Es RSC-005 un error?

RSC-005 se informa como error por defecto. El EPUB rompe una regla de la especificación y es inválido. Las tiendas y Enviar a Kindle pueden rechazarlo, y EPUBCheck sale con estado 1.

Herramientas de PDF a EPUB

Cada herramienta utiliza el mismo motor. Hasta 3 libros al día son gratuitos.

Ver todas las herramientas