bookdown: Escritura de libros y documentos técnicos con R Markdown
Yihui Xie
2018-01-10
Prefacio
Este breve libro presenta el paquete de R, bookdown, que cambia la forma de escribir libros. Escribir un libro debe ser técnicamente fácil, visualmente agradable a la hora de leerlo, divertido para interactuar con él, cómodo para navegar a través de sus páginas y sencillo si los lectores desean contribuir o dejar comentarios para su(s) autor(es), y lo más importante, para que los autores no se distraigan con los detalles de composición tipográfica.
El paquete bookdown fue construido con base en R Markdown (http://rmarkdown.rstudio.com), y heredó la simplicidad en la sintaxis de R Markdown (puede aprenderse lo básico en cinco minutos; véase la sección 2.1), así como la posibilidad de múltiples tipos de formatos de salida (PDF/HTML/Word/…). Asimismo, ha añadido diferentes características como la salida de múltiples páginas HTML, numeración y referenciación cruzada a figuras/tablas/secciones/ecuaciones, inserción de partes/apéndices, e importación del estilo GitBook (https://www.gitbook.com) para crear páginas de libros en un formato elegante y atractivo en HTML. Este libro en sí es un ejemplo de cómo se puede producir un libro de una serie de documentos R Markdown, y tanto la versión impresa como la versión en línea puede parecer profesional. Puede encontrar más ejemplos en https://bookdown.org.
A pesar de que el nombre del paquete contiene la palabra “libro”, bookdown no es sólo para libros. El “libro” puede ser cualquier cosa que se componga de varios documentos R Markdown, como documentación de un curso, notas de estudio, un manual de software, una tesis de maestría/doctorado, o incluso un diario. De hecho, muchas características de bookdown se aplican a documentos sencillos de R Markdown (Sección 3.4).
La versión online de este documento está licenciada bajo la Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. You can purchase a hardcopy from Chapman & Hall or Amazon.