Quarto

Objectif

L’objectif de cet exercice est de vous familiariser à l’utilisation de Quarto. Vous verrez comment exécuter l’ensemble des analyses et la rédaction dans un même fichier .qmd.

Consignes

Analyses

  Nous allons utiliser les données WildFinder du WWF pour répondre à la question suivante : Dans combien d’écorégions différentes retrouve-t-on chaque espèce d’Ursidés ?

Pour ce faire, continuez à travailler dans votre research compendium de l’exercice 2 et écrivez des fonctions pour :

  • Importer chaque fichier .csv (utiliser la fonction readr::read_csv())
  • Sélectionner uniquement les espèces de la famille des Ursidae
  • Joindre les trois tables entre elles
  • Compter le nombre d’écorégions où se retrouve chaque espèce
  • Faire une visualisation graphique montrant le nombre d’écorégions par espèce

  Si vous n’avez pas réussi à terminer l’exercice précédent, vous pouvez forker et cloner ce dépôt Github.


Programmation lettrée

  Créez un fichier index.qmd à la racine du projet qui appellera chaque fonction créée précédemment. Devront figurer dans le document final, a minima, le résultat demandé sous forme de tableaux (fonction knitr::kable()) et de figures, ainsi que la source des données. Structurez votre document avec des titres et des paragraphes.

Finalement, ajoutez une ligne de code dans votre make.R qui permettra de transpiler votre index.qmd en version index.html (fonction quarto::quarto_render()).

  Pensez aux commits ! Pensez aussi à mettre à jour la liste des dépendances dans le fichiers DESCRIPTION avec la fonction add_dependencies() de rcompendium.


Bonus

GitHub Pages

L’option GitHub Pages permet de déployer un site Web gratuitement sur GitHub. Avec un fichier index.html placé à la racine de votre dépôt (ou dans un dossier docs/), vous pouvez activer cette option afin d’afficher ce fichier comme une page Web.

  • Rendez-vous dans les Settings de votre dépôt
  • Cliquez sur Pages
  • Dans Source, sélectionnez Deploy from a branch
  • Dans Branch, sélectionnez Main et /(root)
  • Sauvegardez

Après quelques minutes, votre page Web sera accessible à cette URL : https://__github-account__.github.io/__github-repo__