Vamos a necesitar un barco más grande

Te manejas con los proyectos, organizas la información en una estructura de directorios adecuada, ya no tienes problemas para crear documentos, incluir figuras, tablas, referencias bibliográficas, referencias cruzadas, pero… el texto de la memoria aumenta de volumen y de complejidad ¿qué opción tengo? Vamos a estudiar el uso de los paquetes bookdown y bookdownplus para conseguir una memoria de calidad y con versiones en html, pdf y epub.

Bookdown

Para preparar un proyecto con bookdown basta con elegir la opción al crear un proyecto nuevo.

Una vez creado tienes un conjunto de ficheros con los que puedes construir (build) un libro. ¿Construir? Si, en el panel superior izquierda tienes una nueva pestaña.

Entonces ¿ya no vamos a tejer? Si, como verás en un proyecto bookdown puedes encontrar los ficheros Rmd habituales, cada uno aportará un capítulo a tu memoria. Individualmente, puedes tejer cada uno de ellos.

Manos a la obra

Ejemplos básicos

Vamos a utilizar los ejemplos que tienes disponibles en el fichero editColaBookdown.zip. Los documentos están autoexplicados en sus ficheros de código, léelos. En primer lugar crea un proyecto bookdown recurriendo al procedimiento habitual de creación de estos. Compara el contenido del directorio de tu proyecto con el del proyecto ejemploBookdownBaseSpain ¿Es el mismo contenido?

Si abres el proyecto ejemploBookdownBaseSpain verás que también tiene, más o menos, los mismos ficheros; la principal diferencia: los nombres de alguno están en castellano. Este ejemplo es una versión traducida para que puedas reconocer más fácilmente qué elementos son personalizables y puedes cambiar. También encontrarás en ellos algunos cambios para escribir documento es nuestra lengua.

Aquí tienes una breve descripción de los mismos:

  1. ficheros esenciales proyecto

    • proyecto.Rproj: el fichero para el proyecto
    • README.md: descripción del proyecto y contenidos
    • index.Rmd: el fichero de inicio del texto del libro
  2. configuración de libro

    • _bookdown.yml: se indica en el el nombre del fichero del libro, las reglas de traducción al idioma del autor, …
    • _output.yml: se define los aspectos para las distintas opciones de output.
  3. Ficheros de estilo y configuración para

    • preamble.tex: generar el pdf
    • style.css: generar el html
  4. Los capítulos del libro

    • 01-intro.Rmd
    • 02-literature.Rmd
    • 03-method.Rmd
    • 04-application.Rmd
    • 05-summary.Rmd
    • 06-references.Rmd
  5. Referencias

    • book.bib: ejemplo de referencias bibliográficas
    • packages.bib: ejemplo de referencias de paquetes autogenerada
  6. Cuando construyas el libro además encontrarás

    • _book: directorio que contiene las distintas versiones de oputput

Personalizando la memoria

Un ejemplo con bookdownplus: en el proyecto ejemploBookdownPlus.

Te hemos preparado dos plantillas de bookdownplus, Classic y MDPI, para que puedas experimentar con ellas:

    

Cuando tejas los documentos, deberás buscar el output correspondiente en el subdirectorio _book. Es posible que al tejer la ejecución se vea interrumpida, en ese caso deberás borrar el fichero Rmd con el nombre de la plantilla, por ejemplo: mdpi.Rmd.