Has pasado tu EPUB por un validador y recibes una lista de códigos, rutas de archivos, números de línea y mensajes técnicos en inglés. A primera vista parece que el libro tiene decenas de problemas. En realidad, varias advertencias pueden provenir de una misma causa, y no todas se resuelven de la misma forma.

La clave es leer el informe como un mapa de investigación, no como una lista de botones que hay que pulsar hasta que aparezca un cero.

Antes de empezar: conserva el archivo que produjo el informe

Guarda una copia del EPUB exactamente como fue analizado. Anota la fecha de revisión, la herramienta utilizada y, si puedes, su versión. Un informe deja de describir el archivo real en cuanto modificas el EPUB sin repetir el análisis.

Si trabajas con una herramienta de maquetación o con un flujo de exportación, conserva también el archivo fuente. Corregir directamente el ZIP final puede ser útil en casos puntuales, pero si vuelves a exportar desde una fuente sin corregir, la incidencia reaparecerá.

Cómo se estructura un mensaje

Un informe suele contener nivel de gravedad, código, explicación y ubicación. Por ejemplo, puede indicar que existe una referencia inválida en un XHTML y señalar el archivo y una línea aproximada. El código permite localizar la regla; la ruta te dice dónde investigar.

No todos los informes tienen exactamente el mismo formato. EPUBCheck admite diferentes modos de ejecución y de exportación del resultado. La interfaz web que lo integra puede resumir o reorganizar los mensajes.

FATAL

Indica un problema de gran gravedad que puede impedir el procesamiento correcto del EPUB o comprometer su estructura esencial. Debe investigarse primero. No conviene dedicar tiempo a cuestiones cosméticas mientras exista una incidencia de este nivel.

ERROR

Señala un incumplimiento que requiere corrección para alcanzar la conformidad técnica comprobada por la herramienta. Varios errores pueden estar relacionados: una imagen ausente, por ejemplo, puede generar avisos en más de un documento.

WARNING

Advierte de una condición que merece atención. No significa necesariamente que el archivo sea imposible de publicar, pero tampoco debería ignorarse automáticamente. Su importancia depende del mensaje, del contenido y de los requisitos del canal.

INFO y USAGE

Estos niveles pueden aportar información o indicar el uso de determinadas características del EPUB. No deben leerse como si fueran errores. Algunas salidas de EPUBCheck incluyen este nivel solo cuando se solicita.

El orden de corrección que evita trabajo duplicado

Primero, la estructura del paquete. Comprueba archivos faltantes, rutas, manifiesto y orden de lectura. Si el archivo base está mal armado, otras comprobaciones pueden arrojar resultados secundarios.

Segundo, los documentos de contenido. Revisa XHTML, referencias y elementos que afectan la interpretación del texto.

Tercero, navegación y enlaces. Prueba índice, notas, llamadas y regreso al texto principal.

Cuarto, advertencias y calidad funcional. Evalúa cada aviso en contexto y realiza una lectura manual.

Después de corregir un grupo de incidencias, vuelve a exportar o guardar y repite el análisis. No esperes al final si has modificado el empaquetado o referencias importantes.

Un ejemplo: cinco mensajes, una causa

Imagina que un EPUB menciona imagenes/mapa-final.jpg desde tres capítulos, pero en el paquete el archivo se llama mapa-final-2.jpg. Un validador puede informar del recurso ausente o de referencias que no se resuelven en varios lugares.

Cambiar cada mensaje por separado no arregla el origen. La pregunta correcta es: ¿qué archivo debe estar realmente en el paquete, con qué nombre y desde dónde se enlaza? Una corrección en la fuente puede resolver varias líneas del informe.

El ejemplo sirve para explicar el método; los códigos exactos y el número de mensajes dependen de la estructura del EPUB y de la versión de EPUBCheck.

Cuándo no conviene «arreglar» directamente un aviso

Una advertencia puede señalar un atributo opcional, una característica que necesita revisión o una situación que depende del tipo de publicación. No elimines elementos útiles solo para dejar el informe vacío. Puedes terminar con un archivo técnicamente más silencioso pero menos funcional.

Si el libro contiene tablas, poemas con disposición significativa, fórmulas, imágenes informativas o notas extensas, la revisión requiere especial cuidado: hay decisiones editoriales que no se resuelven con una sustitución automática de código.

Cómo documentar el resultado

Mantén un pequeño registro de control:

  • Versión del EPUB y fecha del análisis.
  • Herramienta y versión.
  • Mensajes agrupados por causa probable.
  • Corrección aplicada y archivo fuente modificado.
  • Resultado de la nueva validación.
  • Pruebas manuales pendientes.

No basta con escribir «solucionado» si todavía no se ha verificado el archivo exportado que recibirá el distribuidor.

Qué hacer cuando el informe queda limpio

Pasa a pruebas que no cubre el validador: lectura real en sistemas relevantes, comportamiento al cambiar tamaño del texto, accesibilidad, información de la edición y compatibilidad con el canal. Para eso, consulta Un EPUB válido no siempre es accesible y ¿Está listo tu EPUB para publicar?.

Si todavía no has generado el informe, comienza con Nommera Prism.

Preguntas frecuentes

¿Tengo que corregir primero todas las advertencias? Primero identifica errores graves y su causa. Después analiza las advertencias una por una, sin asumir que todas equivalen a un bloqueo.

¿Un código concreto siempre significa lo mismo? El identificador remite a una comprobación específica, pero la reparación depende de la ubicación y el contexto. Consulta la documentación de la versión utilizada.

¿Puedo publicar cuando solo quedan avisos? Depende de qué indiquen y de las exigencias del canal. Una respuesta responsable requiere revisar el contenido, no solo contar mensajes.

Fuentes y documentación: EPUBCheck — Getting Started; EPUBCheck — opciones de ejecución y niveles; EPUBCheck — proyecto oficial.