5.3 Generados del sitio web por defecto en rmarkdown
Antes de que se inventara blogdown, en realidad existía una forma relativamente simple de hacer sitios web usando rmarkdown. La estructura del sitio web debe ser un directorio plano de archivos Rmd (sin subdirectorios para archivos Rmd) y un archivo de configuración en el que puede especificar una barra de navegación para todas sus páginas y opciones de formato de salida.
Puede encontrar más información sobre este generador de sitios en su documentación en http://rmarkdown.rstudio.com/rmarkdown_websites.html, y no vamos a repetir la documentación aquí, solo queremos destacar las principales diferencias entre el sitio predeterminado generador en rmarkdown y otros generadores de sitios especializados como Hugo:
El generador de sitios rmarkdown requiere que todos los archivos Rmd estén bajo el directorio raíz. Hugo no tiene restricciones en la estructura del sitio, y puede crear directorios y archivos arbitrarios bajo
/content/
.Hugo es un generador de sitios de uso general altamente personalizable, y hay muchas cosas que el generador de sitios predeterminado de rmarkdown no admite, por ejemplo, fuentes RSS, metadatos especialmente comunes en blogs como categorías y etiquetas, y la personalización de enlaces permanentes para ciertas páginas.
Todavía hay razones legítimas para elegir el generador de sitios predeterminado rmarkdown, aunque no parece ser tan poderoso como Hugo, incluyendo:
Está familiarizado con generar resultados HTML de una sola página a partir de R Markdown, y todo lo que desea es ampliar esto para generar varias páginas a partir de múltiples archivos Rmd.
Basta usar un directorio plano de archivos Rmd. No escribe un blog o necesita fuentes RSS.
Prefiere los estilos Bootstrap. En teoría, también puede aplicar estilos de Bootstrap a los sitios web de Hugo, pero requerirá que aprenda más sobre Hugo. Bootstrap tiene un buen soporte en rmarkdown, y puede dedicar más tiempo a las configuraciones en lugar de aprender los detalles técnicos sobre cómo funciona.
Hay ciertas características en la salida de rmarkdown HTML que faltan en blogdown. Por ejemplo, actualmente no puede imprimir cuadros de datos fácilmente como tablas paginadas, agregar una tabla de contenido flotante o doblar/desplegar bloques de código dinámicamente en la salida de blogdown. Todo esto podría implementarse a través de JavaScript y CSS, pero ciertamente no es tan simple como especificar algunas opciones en rmarkdown como
toc_float: true
.
Tenga en cuenta que el generador de sitios rmarkdown también es extensible. Por ejemplo, el paquete bookdown (Xie 2018a) es esencialmente un generador de sitios personalizado para generar libros como sitios web.
Referencias
Xie, Yihui. 2018a. Bookdown: Authoring Books and Technical Documents with R Markdown. https://CRAN.R-project.org/package=bookdown.