Tienes un EPUB que abre en tu lector, pero el análisis muestra errores. Quizás una plataforma lo rechazó, el índice no funciona o Nommera Prism encontró referencias que no coinciden con los archivos incluidos. La tentación es abrir el EPUB, cambiar lo primero que aparece en el informe y volver a subirlo.
Ese camino puede funcionar para una incidencia muy simple. También puede crear nuevos problemas si el cambio rompe un enlace, afecta a varias páginas o se pierde en la siguiente exportación. La corrección más segura empieza por entender de dónde viene el error y termina comprobando la versión exacta que vas a distribuir.
1. Conserva el archivo original y localiza la versión de trabajo
Antes de modificar nada, guarda el EPUB que se analizó y el informe correspondiente. Crea una copia de trabajo con un nombre que permita reconocerla, por ejemplo novela_revision_02.epub. El nombre es solo una convención interna; el distribuidor puede necesitar otra denominación.
Si tienes acceso al proyecto fuente —InDesign, Sigil, un sistema editorial u otra herramienta—, identifica cuál generó ese EPUB. Conviene corregir allí lo que se volverá a exportar. Si reparas únicamente el ZIP final y después exportas otra vez desde una fuente antigua, puedes perder el arreglo.
Anota tres datos: síntoma, archivo afectado y causa probable. Todavía no necesitas una lista de cincuenta soluciones.
2. Separa los fallos de formato de las decisiones editoriales
Hay problemas que pueden comprobarse objetivamente: un recurso al que apunta el manifiesto no existe, una referencia está mal escrita o una estructura no cumple una condición del formato. Otros dependen del contenido, como decidir si una imagen necesita descripción o si una tabla se comprende al leerla con una tecnología de asistencia.
No trates ambos grupos del mismo modo. Una herramienta puede ayudarte a localizar una referencia rota; no debe decidir por ti el significado de una ilustración.
Si no sabes por qué apareció un mensaje, empieza por Cómo leer tu informe de Prism y por Cómo interpretar un informe EPUBCheck.
3. Repara la causa en lugar de ocultar la alerta
Imagina que el índice contiene este enlace:
<a href="capitulo-08.xhtml">Capítulo ocho</a>Pero el archivo real se llama capitulo-8.xhtml. El problema no está en el título visible «Capítulo ocho», sino en el destino de la referencia. Debes comprobar qué nombre es el correcto y utilizarlo de forma coherente en el documento de navegación y en los demás lugares donde se invoque.
En otros casos, una ruta relativa puede necesitar un segmento adicional: si la navegación está en una carpeta diferente de los capítulos, el destino se calcula desde la ubicación del archivo que contiene el enlace. No corrijas una ruta por intuición; localiza ambos recursos.
Comprobación posterior: abre el EPUB en un sistema de lectura y navega al capítulo desde el índice. Una referencia sintácticamente válida puede seguir llevando a la sección equivocada.
4. Revisa las partes que suelen afectar a todo el EPUB
El paquete OPF y su manifiesto
El documento de paquete declara metadatos y recursos de la publicación. Revisa que los archivos necesarios estén representados de forma correcta y que sus identificadores sean coherentes. No añadas ni quites entradas sin comprobar qué contenido las utiliza.
Un recurso presente dentro del ZIP no es automáticamente utilizable: puede estar mal referenciado, tener una ruta equivocada o no corresponder a su declaración de tipo.
El orden de lectura (spine)
En EPUB 3, el spine establece la secuencia principal de lectura. Un capítulo incluido en el archivo pero colocado en el orden equivocado puede producir una experiencia confusa aunque el contenido de cada página sea válido.
Compara el orden del spine con el índice y con el recorrido natural de la obra: cubierta, preliminares, capítulos, notas y anexos. La estructura correcta depende de la edición; no existe una lista universal de capítulos para todos los libros.
El documento de navegación
En EPUB 3, el índice navegable se representa mediante un documento de navegación. Comprueba que sus entradas sean claras, que apunten a destinos reales y que permitan recorrer el contenido de forma útil. Si el libro tiene notas, anexos o secciones adicionales, revisa también cómo se llega a ellas y cómo se regresa.
Los archivos XHTML y CSS
Corrige etiquetas mal anidadas, identificadores duplicados cuando correspondan, enlaces rotos o estilos que impidan leer el contenido. Pero no elimines estilos solo porque una herramienta los marque como poco habituales: antes comprueba el contexto y la compatibilidad de los sistemas de lectura de destino.
5. No confundas reparar el código con mejorar la accesibilidad
Un EPUB puede superar las validaciones técnicas y seguir siendo difícil de utilizar. Durante la corrección, revisa también:
- Encabezados: que representen la jerarquía real de capítulos y secciones, no únicamente un tamaño de letra.
- Imágenes: que los textos alternativos comuniquen la información necesaria cuando la imagen sea significativa.
- Tablas: que los encabezados y las relaciones entre celdas tengan sentido.
- Enlaces y notas: que los destinos y retornos funcionen y se comprendan fuera del contexto visual.
- Idioma: que los cambios relevantes de lengua se declaren cuando sea necesario para la pronunciación.
- Orden de lectura: que el contenido resulte lógico al recorrerlo secuencialmente.
No basta con introducir un atributo para hacer desaparecer una alerta. Por ejemplo, poner alt="Imagen" en todas las ilustraciones puede silenciar una comprobación automática y seguir ofreciendo muy poca información al lector.
Consulta Diez problemas de accesibilidad EPUB que requieren revisión humana y Textos alternativos en EPUB.
6. Controla cada cambio con una comprobación pequeña
Cuando sea posible, corrige por grupos de causa y vuelve a comprobar después de cada grupo importante. Una tabla de trabajo ayuda más que una lista desordenada de capturas:
| Problema detectado | Cambio realizado | Cómo se comprobó |
|---|---|---|
| Referencia del índice rota | Se corrigió la ruta relativa | El índice abre el capítulo correcto. |
| Imagen informativa sin alternativa | Se redactó y revisó un alt contextual |
Se comprobó con lectura asistida. |
| Orden incorrecto de capítulos | Se ajustó el spine en la fuente |
Se recorrió la secuencia en un lector. |
Ejemplos ilustrativos — datos ficticios.
Cuando una modificación afecta a varios recursos, comprueba las dependencias. Cambiar el nombre de un archivo implica revisar todas las referencias a ese archivo, no únicamente la que originó el primer aviso.
7. Exporta de nuevo y valida el archivo final
Después de corregir, genera el EPUB que realmente se enviará a distribución. Realiza como mínimo estas comprobaciones:
1. Validación técnica: ejecuta EPUBCheck mediante tu flujo habitual y revisa los mensajes que permanezcan.
2. Revisión automatizada de accesibilidad: utiliza Ace u otra herramienta equivalente y estudia sus limitaciones.
3. Revisión de lectura: abre el archivo en sistemas relevantes para tu público; prueba índice, enlaces, notas, tablas, imágenes y cambios de tamaño de texto cuando correspondan.
4. Correspondencia editorial: comprueba título, autor, identificadores, cubierta y edición exacta.
5. Versión de entrega: confirma que el archivo validado es el mismo que vas a distribuir.
No todas las plataformas interpretan un EPUB de la misma manera. Una validación sin errores es una base importante, pero no demuestra compatibilidad absoluta ni aceptación comercial. EPUBCheck comprueba especificaciones del formato; Ace ayuda con comprobaciones automatizables, no con toda la conformidad de accesibilidad.
8. Repite Prism y compara lo que realmente cambió
Si tienes disponible un informe anterior y Prism permite volver a analizar una versión nueva, utiliza esa comparación para saber qué incidencias desaparecieron, cuáles continúan y si surgieron otras. No uses solo la cifra final de mensajes: verifica que los cambios corresponden a las correcciones buscadas.
Si una incidencia desaparece, abre el recurso afectado y comprueba su funcionamiento. Si aparece una incidencia nueva, puede estar relacionada con una modificación reciente o con una exportación diferente; investiga antes de atribuirla a un fallo de la herramienta.
9. ¿Cuándo conviene pedir ayuda especializada?
Si tienes un EPUB muy deteriorado, dependencias difíciles de reconstruir, contenido interactivo complejo o problemas de accesibilidad que requieren juicio editorial, la corrección puede exceder una intervención puntual. En esos casos, prepara una descripción del problema y el informe técnico para solicitar un alcance de trabajo claro.
Pedir ayuda no convierte el análisis gratuito en una reparación automática. Son actividades distintas: Prism documenta el estado del archivo; la corrección modifica y vuelve a verificar el contenido en un perímetro acordado.
Preguntas frecuentes
¿Puedo editar directamente un EPUB con un editor de texto?
Sí, técnicamente es un contenedor que incluye recursos editables, pero hacerlo sin controlar el paquete y las referencias puede romper el archivo. Trabaja sobre una copia y prefiere corregir la fuente de producción cuando esté disponible.
¿Corregir todos los mensajes garantiza que la tienda acepte el libro?
No. Además de la validez técnica, los canales pueden aplicar controles propios y condiciones de catálogo, derechos y metadatos.
¿Tengo que volver a revisar la accesibilidad después de una corrección técnica?
Sí, al menos los aspectos afectados por el cambio. Una modificación de estructura, navegación o marcado puede alterar la forma en que una persona utiliza el libro.
¿Qué hago si el informe nuevo muestra menos errores, pero la lectura empeoró?
Prioriza la experiencia real y examina el cambio que la alteró. Menos mensajes no significa automáticamente un mejor EPUB.
Comprueba tu próxima versión
Cuando termines, vuelve a Nommera Prism y analiza el EPUB final. Conserva el informe junto a la versión revisada: será una referencia útil si necesitas repetir la exportación o explicar los cambios a un proveedor.