Síntomas: Has entregado tu archivo EPUB a través de FTP, nuestro Publisher Portal o mediante API, pero el libro no puede procesarse ni publicarse. Nuestro equipo de soporte puede haberte remitido a este artículo para resolver un problema con un "directorio explícito" (explicit directory) o "META-INF".
¿Por qué ocurre esto?
El problema se debe a cómo se empaquetó tu archivo EPUB. Un EPUB es básicamente un archivo ZIP estándar cuyo sufijo se ha cambiado a .epub.
Las herramientas profesionales para crear archivos EPUB empaquetan estos archivos según estrictos estándares de la industria. Pero si un EPUB se comprime manualmente (por ejemplo, seleccionando archivos en el ordenador, haciendo clic derecho y eligiendo "Comprimir en ZIP"), el sistema operativo crea lo que se llaman "entradas de directorio explícitas" (explicit directory entries). Esto significa que crea nodos de carpetas vacíos e independientes dentro del archivo para directorios como META-INF y OEBPS. Nuestro sistema de procesamiento requiere un formato EPUB estricto y estandarizado, y no puede procesar archivos que contengan estas carpetas vacías creadas manualmente.
Cómo comprobar si tu EPUB tiene este problema
Puedes comprobar si tu EPUB está mal empaquetado sin necesidad de extraerlo.
Para usuarios de Windows:
Abre el Símbolo del sistema (pulsa la tecla de Windows, escribe
cmdy pulsa Intro).Escribe
tar -tvf(asegúrate de incluir el espacio al final).Arrastra y suelta tu archivo .epub directamente en la ventana del Símbolo del sistema para rellenar automáticamente la ruta del archivo, y pulsa Intro.
Qué buscar: Observa la lista de salida. Si ves entradas independientes para META-INF/ o OEBPS/ con un tamaño de archivo de 0, tu archivo tiene directorios explícitos y fallará.
Para usuarios de Mac/Linux:
Abre la Terminal.
Escribe
unzip -l(incluye el espacio al final).Arrastra y suelta tu archivo .epub en la ventana de la Terminal y pulsa Intro.
Qué buscar: Observa las columnas "Length" (Longitud) y "Name" (Nombre). Si ves una carpeta META-INF/ con longitud 0, tu archivo fallará en el procesamiento.
Cómo arreglar tu EPUB
¡No necesitas ser desarrollador para solucionarlo! Simplemente tienes que pasar tu libro por un editor EPUB estandarizado en la industria para reconstruir correctamente la estructura del archivo.
Instrucciones generales paso a paso:
Abre tu EPUB: Importa o abre tu archivo EPUB defectuoso en un software dedicado para edición de EPUB.
Forzar una reconstrucción: Para forzar que el software vuelva a empaquetar el libro, realiza un pequeño cambio invisible. Abre cualquier archivo de texto o HTML en el editor, elimina una sola letra o un espacio y vuelve a escribirlo exactamente igual.
Guarda y exporta: Guarda tu proyecto y expórtalo como un nuevo archivo EPUB. Esta acción normalmente reconstruye el archivo EPUB según estrictos estándares de la industria y elimina automáticamente las carpetas ocultas problemáticas.