Como editar un mini libro usando Github?

El proceso de creacion de un libro siempre me parecio algo fascinante, es decir, poder elegir un tema y desarrollarlo a lo largo de la cantidad de paginas que quisieramos, de forma de poder consultarlo por siempre jamas.

Empece a encontrar distintos libros en formato online como Text Mining with R y Advance R, los cuales me parecieron muy relevantes y al mismo poder acceder a los mismos en forma online hizo mas facil el proceso de lectura y evaluacion de los mismos para una futura compra.

Estos primeros libros que encontre pertenecen a autores conocidos como Julia Silge o Hadley Wickham, sin embargo tambien encontre pequenos autores que a traves del formato libro buscaban compartir con otros, su experiencia sobre algun tema o investigaciones propias sobre distintos datasets. Crear libros como tantos otros procesos cambio (si no pensemos en taxis, hoteles, compras en el supermercado), y tenemos nuevas formas de crear libros y compartirlos online.

El paquete que permite crear un libro es el paquete bookdown, a continuacion el << paso a paso >> acerca de como publicar un libro.

Bookdown

El paquete bookdown esta basado en R Markdown, y se apoya en su sintaxis para que pasar el texto de nuestro interes a un libro sea un proceso facil y rapido.

El autor del paquete es Yihui Xie, tambien autor del paquete open-source Knitr en R, y de varios libros entre ellos Authoring Books and Technical Documents with R Markdown

Como publicar un libro usando bookdown en Github

Objetivo

En este paso a paso vamos a explicar como generar un libro en github, tal como este: https://frm1789.github.io/bookdown/

Paso a paso en R Studio

1. 1. Descargar los archivos de ejemplo de: https://github.com/rstudio/bookdown-demo como un archivo ZIP, then unzip it locally.
   2. Abrir los mismos en R Studio.
   3. Instalar el paquete

      install.packages("bookdown")

   4. Abrir el repositorio bookdown-demo haciendo click en bookdown-demo.Rproj.
   5. Abrir el archivo R Markdown index.Rmd y hacer click sobre  Build Book en el ficheroBuild de RStudio. Si utilizamos los archivos que obtuvimos en el ejemplo, el resultado que se encuentran en la carpeta ../bookdown-demo-master/_books/.
   6. Para realizar las modificaciones correspondientes (esto es sumar nuestro contenido), modificar los archivos con extension .Rmd
   7. Para exportar el libro en PDF, instalar el paquete TinyTeX

      install.packages("tinytex")
      tinytex::install_tinytex()
      

En el libro, el detalle de estos pasos: Get Started

Paso a paso en nuestros archivos

1. Crear un repositorio en github, por ejemplo: bookdown
2. Crear el directorio docs dentro del repositorio creado
3. Incluir dentro del directorio docs incluir el contenido de nuestro libro
4. Crear dentro del directorio docs un archivo

   # create a hidden file .nojekyll
   touch .nojekyll
   # add to git here because will not show up in RStudio
   git add .nojekyll

En el libro, el detalle de estos pasos: GitHub

Paso a paso en Github

Modificar la configuracion para Github Pages, indicando que cambia el origen desde donde se mostraran nuestros archivos al directorio docs.

Luego se muestra el link: “Your site is published at…”

Comentarios finales

Es un paquete altamente recomendable. Muy bien documentado. Tiene cero costo y si estas realizando una investigacion o un mini libro es una forma facil, rapida y profesional de difundir el contenido del mismo.