13  Crear un document

13.1 Introducció

Sempre que comencem una activitat nova, com és aquest cas, el més adequat és crear un projecte nou. Els passos per crear un projecte ja s’han explicat en un apartat anterior. Un cop tinguem creat el nou projecte, instal·larem els paquets rmarkdown, knitr i DT (Allaire et al., 2024; Xie et al., 2022; Xie, 2024). De moment, només ens caldrà instal·lar, però no carregar, aquests paquets:

install.packages(c("rmarkdown", "knitr", "DT"))

Quarto és un tipus de document semblant a l’R Script, però amb algunes diferències essencials que anirem veient al llarg d’aquest mòdul docent. Fixem-nos que un document de Quarto es crea des del mateix desplegable que utilitzem per crear un script.

Exercici 13.1 (Crear un Quarto) Si premem el botó per crear un Quarto, ens sortirà el següent quadre on podrem introduir les característiques bàsiques del document.


En aquest quadre, introduïrem el nostre nom i un títol. Deixarem seleccionada l’opció de crear un Document en Html i premerem el botó OK.

Acabem de crear el nostre primer document de Quarto. A la pantalla, ens apareix un document amb característiques molt semblants a les de l’R Script, però amb algunes petites diferències. Sempre que vulguem crear un Quarto des de zero haurem de seguir aquest procediment que acabem de fer. No obstant això, el que farem a continuació serà tancar el document que acabem d’obrir. Per aprendre el funcionament de Quarto, en aquest mòdul utilitzarem una altra plantilla tutorial que obrirem en la següent secció.

13.2 Preparar el tutorial

La plantilla tutorial amb la qual aprendrem a utilitzar Quarto es troba en el següent enllaç: Tutorial_Qmd_UOC.zip. En aquest arxiu zip hi trobarem informació de la National Material Capabilities (NMC) dataset (v6.0) (Singer et al., 1972; Singer, 1987), una de les bases de dades de Correlates of War.

Exercici 13.2 (Preparar el tutorial) Per preparar aquesta activitat, descarregarem i descomprimirem l’arxiu Tutorial_Qmd_UOC.zip. Situarem els arxius que conté al nostre directori de treball, tal com es veu en la següent imatge. És important que no estiguin en cap subcarpeta:

A dins de l’arxiu zip hi trobem els següents documents:

  1. cinc-structure.png: Aquesta imatge és un esquema de l’estructura de l’índex Composite Indicator of National Capability (CINC).
  2. nmc_60.csv: És la versió simplificada de la NMC dataset.
  3. NMC_cat.qmd: L’arxiu Quarto que conté el tutorial.
  4. Script NMC.R: En aquest script hi podem veure el codi que hem utilitzat per convertir l’arxiu original de NMC a la versió modificada amb la qual treballarem.
  5. logo_uoc.jpg: És un logo d’UOC, que farem servir al final de tot d’aquest mòdul.

Una vegada tinguem tots els arxius que necessitem al directori de treball, obrirem l’arxiu NMC_cat.qmd i ens fixarem en la barra superior del document. Pararem atenció a dos botons:

  • El botó Render ens converteix el document en Html. Si pitgem a la part dreta del botó, podrem escollir que ens ho converteixi en altres formats, com PDF o Word.
  • El botó de la rodeta obre un desplegable on podem seleccionar algunes opcions.

Exercici 13.3 (Configurar Quarto) Obrirem el desplegable de la rodeta i ens assegurarem que les opcions Preview in Viewer Pane i Chunk Output in Console estiguin marcades, com s’indica a la següent imatge.

L’opció Preview in Viewer Pane fa que l’Html s’obri a la pestanya Viewer, dins d’RStudio. Per contra, si posem Preview in Window l’Html s’obrirà en el nostre navegador d’internet. Si volem utilitzar el document de Quarto com un R Script, Chunk Output in Console farà que tots els resultats i missatges es visualitzin a la consola, com passa normalment quan utilitzem un script d’R. En canvi, Chunk Output Inline farà que els resultats i missatges es visualitzin a dins mateix del Quarto.

Quan acabem de configurar aquestes opcions, pitjarem el botó Render (amb el teclat, Ctrl + Shift + K o en Mac Cmd + Shift + K).

Quan pitgem el botó Render, haurien de passar les següents coses:

  1. La consola s’amaga i apareix durant uns instants la pestanya Background Jobs. Un cop acabat el procés, la consola tornarà a aparèixer.
  2. A la pestanya Viewer, apareixà un arxiu en format Html. Si a dalt de la finestra premem el botó que s’indica a la imatge podrem visualitzar aquest arxiu al nostre navegador d’internet.
  3. S’amaga la finestra de l’Environment. Per tornar-la a visualitzar podem prémer el segon botó de la dreta.

Sempre que pitgem el botó Render, R llegeix el document Quarto i el transforma en un document d’Html, en Pdf o en Word, segons haguem indicat. Si, com hem seleccionat anteriorment a les opcions, el reproduïm en Html, el document s’obrirà a la finestra Viewer.