_site.yml

El archivo "_site.yml" controla la configuración y pinta de todo el sitio. Es archivo de texto plano con argumentos all estilo YAML. El contenido del archivo para esta web tiene la siguiente pinta:

navbar:
  title: Una web con muchos .Rmd!
  left:
  - text: Configuración
    href: archivo-site.html
  - text: Contenido
    menu:
      - text: El index
        href: archivo-index.html
      - text: Un post
        href: post.html
output:
  html_document:
    theme: united

¿Qué es lo que hace cada parte?

• navbar:... define la barra de navegación que ves ahí arriba. Tiene varias partes, el título, un primer elemento que “Configuración” que lleva a esta misma página y otro elementos que es un menú desplegable desde donde podés acceder a más contenido. Estos elementos tienen un nombre o text y el archivo al que hacen referencia, siempre el html.

• output:... define opciones globales de salida para no tener que definirlas dentro de cada archivo Rmd. Podés ver las opciones disponibles en la documentación con ?rmarkdown::html_document(). En este caso, define que la apariencia a a ser con el tema “united”.

Hay muchas más opciones, por ejemplo:

• output_dir: docs define que el sitio web se va a generar en la carpeta “docs”, adentro de la carpeta del proyecto. Esto cambia el nombre por defecto de la carpeta "_site" que contiene los archivos html y demás archivos necesarios para que el sitio funcione. Esta opción es particularmente útil si se quiere utilizar GitHub Pages que requieren que la carpeta se llame “docs” en vez de "_site".

Las partes del navbar

Tener el archivo _site.yaml tiene otra gran ventaja. Ahora RStudio sabe que querés hacer un sitio web y podés generar todo el sitio web directamente yendo a la solapa “Build” y haciendo click en “Build Website” o con el atajo de teclado Ctrl + Shift + B. Esto va a renderizar todos los archivos .Rmd que estén en la raiz del proyecto y va a generar el sitio web en la carpeta especificada en output_dir.