3.3 E-Books

Actualmente bookdown proporciona dos formatos de libros electrónicos, EPUB y MOBI. Los libros en estos formatos se pueden leer en dispositivos como teléfonos inteligentes, tabletas o lectores electrónicos especiales como el Kindle.

3.3.1 EPUB

Para crear un libro EPUB, puede utilizar el formato epub_book(). Este formato tiene algunas opciones en común con rmarkdown::html_document():

epub_book(fig_width = 5, fig_height = 4, dev = "png",
  fig_caption = TRUE, number_sections = TRUE,
  toc = FALSE, toc_depth = 3, stylesheet = NULL,
  cover_image = NULL, metadata = NULL,
  chapter_level = 1, epub_version = c("epub3", "epub"),
  md_extensions = NULL, pandoc_args = NULL)

La opción toc se deshabilita debido a que el lector de libros electrónicos puede determinar a menudo una tabla de contenido de forma automática desde el libro, por lo que no es necesario añadir unas pocas páginas para la tabla de contenido. Hay algunas opciones específicas para EPUB:

• stylesheet: Es similar a la opción css en formatos de salida HTML, y se puede personalizar la apariencia de los elementos usando CSS;
• cover_image: La ruta de la imagen de la portada del libro;
• metadata: La ruta de acceso a un archivo XML para los metadatos del libro (ver documentación Pandoc para más detalles);
• chapter_level: Internamente un libro EPUB es una serie de archivos “capítulo”, y esta opción determina el nivel por el cual el libro se divide en estos archivos. Esto es similar al argumento split_by de formatos de salida HTML que hemos mencionado en la sección 3.1, con la diferencia de que un libro EPUB es un solo archivo, y no se verán estos archivos “capítulo” directamente. El nivel predeterminado es el primer nivel, y si lo ajusta a 2, significa que el libro será organizado por la sección de archivos internos, lo que puede hacer al lector más rápido para cargar el libro;
• epub_version: Versión 3 o 2 de EPUB;

Un libro EPUB es esencialmente una colección de páginas HTML, por ejemplo, se pueden aplicar reglas CSS a sus elementos, incrustar imágenes, insertar expresiones matemáticas (debido a MathML está soportado parcialmente), etc. Las leyendas de las figuras/tablas, referencias cruzadas, bloques personalizados, y las citas mencionadas en el capítulo 2 también deben trabajar en EPUB. Es posible comparar la salida EPUB de este libro a la salida HTML, con la única diferencia importante del aspecto visual.

Hay varios lectores EPUB disponibles, incluyendo Calibre (https://www.calibre-ebook.com), iBooks de Apple y Google Play Books.

3.3.2 MOBI

Los libros electrónicos MOBI pueden leerse en dispositivos Kindle de Amazon. Pandoc no es compatible con la salida MOBI de forma nativa, pero Amazon ha proporcionado una herramienta llamada KindleGen (https://www.amazon.com/gp/feature.html?docId=1000765211) para crear libros MOBI de otros formatos, incluyendo EPUB y HTML. Hemos proporcionado una simple función de contenedor KindleGen() en bookdown para llamar KindleGen con el fin de convertir un libro EPUB a MOBI. Esto requiere que se descargue primero KindleGen, y asegurarse de que el ejecutable KindleGen se pueda encontrar a través de la variable de entorno de sistema PATH.

Otra herramienta para convertir EPUB a MOBI es proporcionada por Calibre. A diferencia de KindleGen, Calibre es de código abierto y libre, y soporta la conversión entre muchos más formatos. Por ejemplo, se puede convertir HTML a EPUB, documentos de Word a MOBI, etc. La función calibre() en bookdown es una función de contenedor de la utilidad de línea de comandos ebook-convert en Calibre. Del mismo modo, es necesario asegurarse de que el ejecutable ebook-convert se pueda encontrar a través de la variable de entorno PATH. Si utiliza OS X, puede instalar tanto KindleGen como Calibre a través de Homebrew-Cask (https://caskroom.github.io), por lo que no necesita preocuparse por el problema PATH.