MarginaGet Margina
Artículos

Publicado

Un EPUB que no se abre no es un misterio: es un ZIP al que le falta una de sus tres partes obligatorias. Estas son esas partes y cómo saber cuál falló.

Qué es realmente un EPUB

Un EPUB no es realmente un solo archivo. Es un archivo ZIP con otra extensión, y dentro hay exactamente tres piezas que una aplicación de lectura necesita para abrir el libro: un archivo pequeño llamado mimetype, un archivo container.xml dentro de una carpeta llamada META-INF, y un documento de paquete —normalmente llamado archivo OPF— que enumera cada capítulo, imagen y hoja de estilo que contiene el libro. Cada uno cumple una función específica. El archivo mimetype identifica el archivo como un EPUB antes de que se descomprima nada más. Container.xml le dice a la aplicación de lectura dónde encontrar el documento de paquete. Y el documento de paquete se encarga de todo lo demás: título, orden de lectura, y los archivos exactos que pertenecen al libro.

Esa es toda la arquitectura. Para conocer con más detalle cómo es un EPUB bien formado por dentro, hemos escrito sobre la anatomía de EPUB 3 en otro artículo. Lo que importa aquí es más concreto: cuando una de esas tres piezas desaparece, se mueve o queda mal formada, el archivo no se degrada poco a poco. Simplemente no se abre.

Las cuatro formas en que un EPUB se rompe de verdad

Casi todos los problemas de "este EPUB no se abre" se reducen a uno de cuatro fallos concretos.

Una cabecera ZIP dañada

Cortado a mitad de la descarga, interrumpido a mitad de la transferencia, copiado desde un origen que se detuvo a medio camino: si el propio archivo está dañado, la aplicación de lectura ni siquiera logra abrir el ZIP. Este es el fallo más contundente: el archivo no está mal formado, sino incompleto, y normalmente no hay nada que valga la pena recuperar dentro de él. Necesitas el archivo de nuevo, desde donde sea que vino.

Un archivo mimetype comprimido o fuera de lugar

Esta es la forma más común en que un EPUB perfectamente bueno se rompe por accidente. El archivo mimetype tiene dos requisitos estrictos: debe ser el primer archivo del archivo comprimido, y debe almacenarse sin comprimir. Las herramientas de compresión habituales no respetan ninguna de las dos reglas por defecto: "Comprimir" de Finder, 7-Zip, un simple comando zip -r — todas comprimen todo y añaden los archivos en el orden que les entregue el sistema de archivos. Abre un EPUB, haz un pequeño cambio, vuelve a comprimirlo con una herramienta genérica, y puedes convertir sin darte cuenta un archivo que funcionaba en uno que algunas aplicaciones de lectura rechazan directamente.

Un container.xml que apunta al lugar equivocado

Container.xml contiene una sola referencia —una ruta de archivo— hacia donde vive el documento de paquete. Si esa ruta está ligeramente equivocada, porque una carpeta fue renombrada, aplanada o movida durante una edición, la aplicación de lectura busca el manifiesto del libro en un lugar que ya no lo tiene. El documento de paquete puede seguir estando ahí, dentro del archivo; la aplicación simplemente no puede encontrar la línea de texto que dice dónde.

Un manifiesto que no coincide con el archivo

El documento de paquete enumera cada archivo que usa el libro, y solo los archivos que usa. Cuando esa lista se desincroniza de lo que realmente hay dentro del archivo —un archivo de capítulo que existe pero nunca se añadió a la lista, o una entrada que apunta a un archivo que ya fue eliminado— el resultado es un libro que se abre pero falla a mitad de camino, o que no pasa la validación. Eso es un problema distinto a los caracteres confusos o incorrectos en el propio texto, que normalmente se debe a un problema de codificación y no estructural.

Qué te dice realmente epubcheck

¿Quieres saber exactamente cuál de esas cuatro cosas ocurrió? Recurre a epubcheck —el validador de código abierto mantenido para el W3C que editoriales, tiendas y aplicaciones de lectura ejecutan sobre un archivo antes de aceptarlo. No se limita a decir "roto". Devuelve un código específico: un error de orden del mimetype se lee de forma distinta a un container.xml ausente, que a su vez se lee distinto a una referencia del manifiesto que apunta a un archivo que no existe. La lista completa de lo que significa cada código es pública, y una vez que sabes qué tipo de error estás viendo, la solución suele ser evidente: reconstruir el archivo, corregir la ruta, o reconciliar el manifiesto con lo que realmente hay dentro.

Lo que esto no es

Aquí se confunden dos problemas distintos, y no son lo mismo. Un EPUB estructuralmente roto no se abre para nadie, en ninguna aplicación, porque falta o está mal formado algo que necesita. Un archivo protegido por DRM es diferente: se abre exactamente como fue diseñado, pero solo dentro de la tienda o cuenta específica a la que está vinculado. Uno es corrupción. El otro es una puerta cerrada con una llave que no es tuya. Se parecen desde fuera —"el libro no se abre"— pero la causa, y la solución, no tienen nada en común.

Preguntas frecuentes

¿Puedo arreglar un EPUB dañado yo mismo?

A veces. Si se trata de un problema de orden o compresión del mimetype, reconstruir el archivo con el mimetype almacenado primero, sin comprimir, suele resolverlo. Si la propia cabecera ZIP está dañada por una transferencia interrumpida, normalmente no hay nada que recuperar: necesitas el archivo de nuevo desde su origen.

¿Por qué se rompió mi EPUB después de editarlo?

La mayoría de las herramientas de edición vuelven a guardar todo el archivo, y muchas utilidades de compresión genéricas comprimen cada elemento y reordenan los archivos por defecto. Eso rompe silenciosamente los dos requisitos estrictos del archivo mimetype —almacenado sin comprimir, primero en el archivo— aunque el ZIP en sí se siga abriendo sin problema en un explorador de archivos.

¿Un EPUB que "no se abre" es lo mismo que uno protegido por DRM?

No. Un EPUB estructuralmente roto falla para cualquier lector, en cualquier lugar, porque falta o está mal formada una pieza necesaria —el mimetype, container.xml o el OPF—. Un archivo protegido por DRM se abre bien desde el punto de vista estructural, pero está vinculado a una cuenta o aplicación específica, lo cual es una restricción de licencia, no una corrupción.

¿Qué significa realmente "archivo OPF no encontrado"?

El archivo que señala el contenido de tu libro —el documento de paquete— o no está donde dice container.xml, o no está en el archivo en absoluto. Esto suele ocurrir cuando una carpeta fue renombrada o aplanada durante una edición, rompiendo la referencia exacta de ruta de la que depende el sistema de lectura.

¿Cómo puedo saber qué está mal exactamente en un archivo?

Pásalo por epubcheck, el validador de código abierto que usan editoriales y tiendas. Devuelve un código específico —un mimetype ausente, una ruta de contenedor incorrecta, un manifiesto que no coincide— que te dice exactamente qué parte obligatoria falló, en lugar de simplemente decir que el archivo está roto.

Conclusión

Un EPUB que no se abre parece un misterio hasta que sabes qué hay realmente dentro de uno. No es el libro lo que está roto: es una de las tres piezas pequeñas y concretas de las que depende el archivo —el archivo mimetype, container.xml, o el documento de paquete—. Una vez que sabes cuál, la solución suele ser mecánica, no mágica. Margina lee cualquier formato que llegue sin pedirte que lo arregles antes, pero para un archivo al que realmente le falta una de estas piezas, conocer la causa convierte un callejón sin salida en una reparación de dos minutos.