Empieza por hacerlo. Si tienes un EPUB a mano, esto es todo lo que hace falta.
.epub a .zip Ya está. Sin software especial. Un EPUB es un ZIP, así que se desempaqueta sin siquiera un aviso.
Podrías pensar «si se descomprime, entonces comprimir una carpeta y renombrarla a .epub hace un EPUB». No es tan simple, por las reglas sobre cómo debe comprimirse que se describen en la siguiente sección.
Desempaquetado, suele verse así.
OEBPS — ese nombre de carpeta, y cómo se reparten las cosas dentro de ella, varían según la herramienta que lo construyó. Podría ser item o xhtml en su lugar, y no pasa nada.
Lo que no puedes cambiar, ni de nombre ni de posición, es mimetype al principio y META-INF/container.xml . Esos dos son fijos y todo lo demás es libre: ese es el paso uno para entender la estructura.
Su contenido es una sola línea.
Su función es declarar «este ZIP es un EPUB». Pero viene con reglas estrictas que ningún otro archivo tiene.
Una aplicación de lectura puede decidir «esto es un EPUB» leyendo solo los primeros bytes del archivo. Por eso la posición y la forma están fijadas.
Comprime una carpeta con una herramienta corriente y no puedes elegir el orden de los archivos, y el mimetype se comprime junto con todo lo demás. El resultado: lo renombras a .epub y las aplicaciones de lectura no lo abren.
Cumplir la condición de «el primero, sin comprimir» implica ejecutar la compresión en dos pasos separados. Eso es lo primerísimo que hace una herramienta de construcción de EPUB.
META-INF/container.xml tiene este aspecto.
Hace exactamente una cosa: dice «los datos del libro están en OEBPS/content.opf ».
Gracias a esa señal los nombres de carpeta pueden ser libres. Una aplicación de lectura mira primero META-INF/container.xml y va adonde apunte.
Este es el archivo más importante de un EPUB. Se divide en tres partes.
| Parte | Qué hace |
|---|---|
| metadata | Título, autor, idioma: los datos propios del libro |
| manifest | Una lista de todos los archivos incluidos |
| spine | El orden en que se pasan las páginas |
El que hay que vigilar es dc:title . Lo que aparece en la estantería de una aplicación de lectura es este valor, no el nombre del archivo. Por muy bien que hayas nombrado el archivo, si esto está vacío la estantería muestra «Untitled».
dc:language también importa. Pon es para español, ja para japonés. Sin él, una aplicación de lectura puede no aplicar las reglas de composición del idioma, algo que se nota sobre todo en japonés.
Todos los archivos del EPUB tienen que registrarse aquí. Añade una imagen y olvida registrarla, y solo eso ya es un error. Al revés —registrada pero no presente— también es un error.
El archivo del índice se marca con properties="nav" , que es como dice «este archivo es el índice».
manifest es la lista de lo que hay dentro; spine es en qué orden se lee. El orden de aquí se convierte en el orden de páginas.
Y la parte que más importa en un libro japonés es page-progression-direction .
| Valor | Significado | Libros que lo usan |
|---|---|---|
| rtl | Avanza de derecha a izquierda | Escritura vertical, manga |
| ltr | Avanza de izquierda a derecha | Escritura horizontal |
Déjalo fuera de un libro compuesto en vertical y las páginas pasan al revés. Es de lo primero que hay que comprobar cuando la escritura vertical no funciona.
EPUB 3 exige siempre el índice como archivo propio. Parece una lista corriente de enlaces en HTML, distinguida por la marca epub:type="toc" .
Esto es lo que sale cuando el lector pulsa el botón de índice. Si falta un archivo enlazado, tienes un libro por el que no se puede navegar.
En el antiguo EPUB 2, un archivo llamado toc.ncx hacía el trabajo del índice. EPUB 3 lo sustituyó por nav.xhtml , pero algunos EPUB incluyen los dos para que las aplicaciones de lectura antiguas sigan funcionando.
De aquí en adelante es prácticamente igual que una página web.
Cómo repartas el texto es cosa tuya, pero un archivo demasiado grande vuelve lentas a las aplicaciones de lectura, así que repartir por capítulos es lo normal.
Como has visto, la estructura de un EPUB no es complicada. Texto, imágenes e instrucciones de diseño empaquetados en una caja con una señal y una lista — eso es todo.
Las reglas que hay que obedecer, en cambio, son quisquillosas.
mimetype va el primero y sin comprimirmanifest spine Si falta uno, el libro no abre o lo rechazan al enviarlo a la tienda. Y la causa del error normalmente no se ve en lo que aparece en pantalla.
Por eso en producción real se usa una herramienta que monta la estructura a partir de un manuscrito o de imágenes. Aun así, haber mirado dentro una vez significa que puedes adivinar dónde mirar cuando algo falla — que es el objetivo de este artículo.
EPUB FACTORY construye automáticamente cada parte de la estructura descrita aquí. Solo tienes que elegir una carpeta de imágenes o un manuscrito de texto. Sin cuenta y sin instalar nada.
Probar EPUB FACTORY