Todo lo que siempre quiso saber sobre el formato ePUB de sus ebooks y nunca se atrevió a preguntar (Cap. 03)

Estábamos explicando el detalle de lo que hay dentro

de un ePUB en el

Capítulo 02

de la serie. Un archivo ePUB viene a ser algo parecido a esto:

ePUB File:.    
│     mimetype   
│
├───META-INF    
│    container.xml      
│               
└───OEBPS       
      │    content.opf    
      │    toc.ncx            
      │       
      ├───Images 
      │      img0001.jpeg 
      │      img0002.jpeg
      │         …... 
      │      img0007.png    
      │ 
      ├───Styles 
      │      style001.css 
      │ 
      └───Text  
             content001.xhtml 
             content002.xhtml 
             content003.xhtml  
                     ...       
             content026.xhtml 
             content027.xhtml 
             content028.xhtml 

Y habíamos terminado de describir que es y para que vale el archivo “content.opf”.

Así pues, retomamos la explicación sobre:

La estructura y contenido de un fichero ePUB

Nos habiamos quedado a punto de comentar el archivo
- toc.ncx: que como indica su nombre controla la tabla de contenidos (índice) del libro. Controla lo que se muestra en el panel izquierdo (generalmente) de los programas de lectura (CALIBRE, LUCIFOX, ADE, etc…)



 
El uid debe coincidir con el registrado en “content.opf”.
doctitle: lo contenido por esta etiqueta aparecerá como título del libro en el programa de lectura, aunque no coincida con lo registrado en los metadatos de “content.opf”.
La etiqueta navpoint marca el listado de capítulos, siendo el nombre del capítulo, el texto adjunto y el src (source) el archivo vinculado que incluye el contenido de ese capítulo.
El atributo “playOrder” de la etiqueta navpoint indica el orden de lectura que ese capítulo supone en el hilo narrativo del libro.

Curiosamente, según las especificaciones el “id” de un capítulo puede ser cualquiera cosa, pero evidentemente será mucho más fácil darle el mismo “id” (identificador único) que ya usamos para el archivo que contiene el capítulo en el fichero “content.opf” (ver Capítulo 02) para evitar liarse.
Además, algún programa de lectura es posible que no muestre correctamente el índice o TOC del libro; o simplemente se vuelva loco si los “id”s no coinciden en los 2 archivos (toc.ncx y content.opf)

También es de Perogrullo pero los valores de playorder tienen que estar en orden. (Un ítem con playorder 1 siempre deberá estar antes que el ítem con el playorder 2)
Tampoco son aconsejables los “huecos” en el playorder, generan errores de aplicación durante la lectura.

- styles.css: puedes usar una hoja de estilo CSS para formatear la presentación de estilo de tu libro.

  Pero el archivo debe estar listado en el manifiesto de “content.opf” o no funcionará. 
 

 

- archivos xhtml: son el texto del libro, el contenido; y deben ser documentos XML 1.1. Puedes tener tantos archivos como capítulos (o más) o tener el libro entero en 1 sólo archivo con marcadores que indiquen la separación de los capítulos. Evidentemente, es mejor que coincida con la división en capítulos.

y básicamente, esto es lo más importante que hay que saber sobre en archivo ePUB.
Parece más complicado de lo que es en realidad.

Y recordad, niños, esto es CERCA y esto es LEJOS