3.4 Un documento sencillo

A veces, puede que no desee escribir un libro, sino un simple artículo de formato largo o un reporte. Por lo general, lo que se hace es llamar a rmarkdown::render() con un determinado formato de salida. Las principales características que faltan son la numeración automática de títulos de figuras/tablas y referenciación cruzada de figuras/tablas/secciones. Se han descartado estas características en bookdown para que puedan utilizarse sin tener que preparar un libro de varios archivos Rmd.

Las funciones html_document2(), tufte_html2(), pdf_document2(), word_document2(), tufte_handout2() y tufte_book2() están diseñadas para estos propósitos. Si se procesa un documento R Markdown con el formato de salida, por ejemplo, bookdown::html_document2, se obtendrán números de figuras/tablas y podrán referenciarse cruzadamente en una simple página HTML usando la sintaxis descrita en el capítulo 2.

Las funciones de formato de salida HTML y PDF anteriores son básicamente envolturas de formatos de salida bookdown::html_book y bookdown::pdf_book, en el sentido de que cambiaron el argumento base_format. Por ejemplo, puede echar un vistazo al código fuente de pdf_document2:

bookdown::pdf_document2

## function (...) 
## {
##     pdf_book(..., base_format = rmarkdown::pdf_document)
## }
## <environment: namespace:bookdown>

Después de conocer este hecho, puede aplicar la misma idea a otros formatos de salida mediante el base_format apropiado. Por ejemplo, puede portar las características bookdown al formato jss_article en el paquete rticles (???) usando los metadatos YAML:

output:
  bookdown::pdf_book:
    base_format: rticles::jss_article

A continuación, podrá utilizar todas las funciones que hemos introducido en el capítulo 2.

Aunque el formato gitbook() fue diseñado principalmente para libros, en realidad se puede también aplicar a un simple documento R Markdown. La única diferencia es que no habrá ningún botón de búsqueda en la salida de una página, ya que simplemente puede utilizar la herramienta de búsqueda de su navegador web para buscar texto (por ejemplo, pulse Ctrl + F o Command + F). También puede configurar la opción split_by con none para generar una página de salida única, en cuyo caso no habrá ningún botón de navegación, ya que no hay otras páginas para navegar. Aun es posible generar archivos HTML de varias páginas si se desea. Otra opción posible es utilizar `self_contained = TRUE cuando sólo es una página de salida.