1.2 Comenzando

El camino más fácil para que los principiantes comiencen con la escritura de un libro con R Markdown y bookdown es a través de la demostración bookdown-demo en GitHub:

  1. Descargue el repositorio de GitHub https://github.com/rstudio/bookdown-demo como un [archivo Zip] y luego descomprímalo localmente;
  2. Instale el IDE RStudio. Observe que necesita una versión superior a la 1.0.0. Por favor descargue la última versión si su versión de RStudio es menor a la 1.0.0);
  3. Instale el paquete de R bookdown:

    # version estable en el CRAN
    install.packages('bookdown')
    # o la versión de desarrollo en GitHub
    # devtools::install_github('rstudio/bookdown')
  4. Abra el repositorio bookdown-demo que descargó en RStudio haciendo click en bookdown-demo.Rproj.

  5. Abra el archivo de R Markdown index.Rmd y haga clic en el botón Build Book en la pestaña Build de RStudio;

Ahora debería ver la página de índice de ese libro de demostración en el visor de RStudio. Puede agregar o cambiar los archivos de R Markdown, volver a index.Rmd, y pulsar el botón Knit de nuevo para obtener una vista previa del libro. Si prefiere no utilizar RStudio, también puede compilar el libro a través de línea de comandos. Consulte la siguiente sección para más detalles.

Aunque se ve un buen número de archivos en el ejemplo bookdown-demo, la mayoría de ellos no son esenciales para un libro. Si se siente abrumado por el número de archivos, puede utilizar este mínimo ejemplo, en lugar del otro, que es esencialmente un archivo index.Rmd: https://github.com/yihui/bookdown-minimal El ejemplo bookdown-demo contiene algunas configuraciones avanzadas que es posible que desee aprender más adelante, como la forma de personalizar el preámbulo de LaTeX, modificar el CSS, y construir el libro en GitHub, etc.