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:
- Descargue el repositorio de GitHub https://github.com/rstudio/bookdown-demo como un [archivo Zip] y luego descomprímalo localmente;
- 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);
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')
Abra el repositorio
bookdown-demo
que descargó en RStudio haciendo click enbookdown-demo.Rproj
.Abra el archivo de R Markdown
index.Rmd
y haga clic en el botónBuild Book
en la pestañaBuild
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.