El mensaje de error que te muestra una tienda suele ser vago. A veces no dice más que «hay un problema con tu archivo».
Así que lo primero es pasarlo por un validador llamado EPUBCheck. Es la herramienta oficial que distribuye el W3C y es gratuita. También hay servicios que la ejecutan en línea.
La herramienta te dice exactamente qué archivo, qué línea y qué está mal. Eso te lleva a la causa mucho más rápido que el mensaje de error de una tienda.
Si EPUBCheck sale limpio y la tienda sigue rechazando el archivo, probablemente no sea cuestión de la especificación EPUB sino de un requisito específico de esa tienda. Mira la sección de más abajo.
Si haces EPUB por tu cuenta, los errores con los que te tropiezas son bastante previsibles.
Dentro de un EPUB hay un archivito llamado mimetype , y la regla es que debe guardarse el primero en el ZIP y sin comprimir.
Comprimir una carpeta con una herramienta de compresión corriente no cumple esa condición. Es el problema más habitual cuando un EPUB se ha montado a mano.
Todos los archivos de un EPUB tienen que registrarse en el <manifest> de content.opf .
Añadiste una imagen y olvidaste registrarla, o un archivo registrado ya no existe: cualquiera de las dos discordancias produce un error.
EPUB 3 exige lo siguiente.
•dc:title (el título)
•dc:language (idioma; es para español)
•dc:identifier (identificador)
•dcterms:modified (última modificación)
Un enlace del índice (nav.xhtml) apunta a un archivo que no está. Pasa cuando borras un capítulo y olvidas actualizar el índice.
El cuerpo de un EPUB se escribe en XHTML, que es más estricto que el HTML corriente. Una etiqueta sin cerrar, o escribir <br> (tiene que ser <br />), produce un error.
Esto suele pasar cuando se han tecleado etiquetas HTML directamente en el manuscrito.
Si EPUBCheck informa de cero errores y la tienda sigue rechazando el archivo, es un requisito de la tienda más que de la especificación.
Los requisitos de envío de cada tienda se actualizan de vez en cuando. Confirma siempre los actuales en las páginas de ayuda de esa tienda.
Los resúmenes de terceros, este artículo incluido, pueden estar desactualizados. Buscar en la ayuda de la tienda el texto exacto del mensaje de error es la vía más fiable.
Amazon convierte a su propio formato el EPUB que recibe. Pueden aparecer problemas en ese paso de conversión, así que comprobarlo en Kindle Previewer antes de enviar acota la causa más rápido.
Si Previewer lo abre pero el envío es rechazado, es más probable que el problema esté en tus datos de registro o en la revisión que en el archivo mismo.
EPUBCheck escribe en inglés, pero una vez conoces la forma no es difícil.
| Etiqueta | Significado |
|---|---|
| FATAL | Fatal. El archivo no se sostiene en absoluto |
| ERROR | Incumple la especificación. Hay que arreglarlo |
| WARNING | Aviso. Funciona, pero no es recomendable |
| INFO | Información. Normalmente no requiere nada |
Mira primero FATAL y ERROR. Los WARNING normalmente se pueden publicar tal cual.
Cuarenta errores seguidos parece desesperante, pero normalmente vienen todos de una sola causa.
Una línea mala en el manifest, por ejemplo, hace fallar todos los archivos referenciados desde ella.Arregla solo el primero de arriba y valida otra vez — la cuenta se desploma a menudo de golpe.
Si editaste a mano un EPUB generado por una herramienta y lo rompiste, reconstruir desde el manuscrito original suele ser más rápido. Arreglar el manuscrito y reconvertir es más fiable que aplastar errores uno a uno.
EPUB FACTORY pasa cada archivo que genera por una validación conforme al estándar y te muestra el resultado. Sin cuenta y sin instalar nada.
Probar EPUB FACTORYNuestro diagnóstico de EPUB señala los puntos que sobre el papel son válidos pero se rompen para lectores reales, en tu propio idioma. Funciona enteramente en el navegador, así que tu archivo no se envía a ninguna parte. Gratis y sin registro.