Escribiendo con R y Quarto - Trucos: workflow

1 Render

Cuando haces el Render de un QMD ocurre lo siguiente: se abre un background job, donde primero, knitr ejecuta los chunks y crea un nuevo documento .md que ya incluye el código y su output; ese fichero .md es procesado por pandoc que crea el output final.

1.1 Render

Se puede hacer el render de un .qmd de varias formas:

#- desde la Terminal
quarto render document.qmd  # default is html
quarto render document.qmd --to pdf
quarto render document.qmd --to docx

#- desde la Consola
quarto::quarto_render("document.qmd") # defaults to html
quarto::quarto_render("document.qmd", output_format = "pdf")

1.2 Render con opciones

También se puede hacer el render con opciones, p.ej:

quarto render document.qmd --to html -M code-fold:true                  
quarto render document.qmd --to html -M code-fold:true -P alpha:0.2 -P ratio:0.3

1.3 Render book a epub

Para crear epub en Quarto bastaría con hacer en la Terminal:

quarto render my_file.qmd --to epub

Aún así, Bruno Rodrigues y Sam Parmar nos cuentan algunos truquillo sobre como hacer render de un Quarto book a epub, o a pdf.

1.4 Parametrised reports

Para hacer el render desde la Terminal con parámetros:
```
 quarto render annual_report.qmd -P year:2024
```
En parametrised reports, cuando haces el render, me gustaría que los archivos de salida se guardasen en otro directorio, pero se ve que esto no es fácil-fácil, al menos aún. En este toot explican que como no encontraron la solución, así que lo que hace es hacer el render en la misma carpeta donde está el script, pero luego mueve los archivos que se han generado. para moverlos usa

file.copy(full_path_source, full_path_destination)

1.5 Ejecutar script from Terminal

Si quieres ejecutar un R script desde la Terminal:

Rscript -e "rmarkdown::render('document.Rmd')"

1.6 Word a .md

Para pasar un documento Word a .md utilizando Pandoc. Lo vi en este toot

pandoc -f docx -t markdown foo.docx -o foo.markdown

Para pasar un documento Word a .md desde R:

rmarkdown::pandoc_convert("input.docx", to = "md")

1.7 Truqillos to render

Cómo hacer el render rápidamente (ptse): https://github.com/quarto-dev/quarto-cli/discussions/6173
Truco para q se haga el render solo en partes; https://fosstodon.org/@mccarthymg/111889746218019391. De Rennie.

2 Instalación

prework de T. Mock: In order to create PDFs you will need to install a recent distribution of LaTeX. We recommend the use of TinyTeX (which is based on TexLive):

quarto install tool tinytext
quarto install tool chromium

Reutilizar

CC BY 4.0