Préparatifs

Avant le tutoriel, merci de préparer votre environnement de travail.

Raccourci recommandé : le paquet tutoquartotypst

À installer d’abord : Quarto et un éditeur (RStudio ou Positron) — voir la section Installation juste en dessous. Le paquet R compagnon les vérifie mais ne peut pas les installer à votre place.

Une fois Quarto et votre éditeur en place, le paquet tutoquartotypst enchaîne le reste : il installe tous les paquets R du tutoriel, vérifie votre environnement et pose les exercices.

1. Installer le paquet. Il tire automatiquement les 8 paquets R du tutoriel :

install.packages("tutoquartotypst",
  repos = c("https://cderv.r-universe.dev", "https://cloud.r-project.org"))

2. Vérifier que tout est prêt — R, Quarto, Typst, paquets, et un rendu de test de bout en bout :

tutoquartotypst::verifier_installation()

Si tout s’affiche en vert, vous êtes prêt·e.

3. Installer les exercices dans un dossier de travail local. En session interactive, la fonction vous demande où les installer (sélecteur de dossier dans RStudio, sinon une invite), puis affiche la destination retenue :

tutoquartotypst::installer_exercices()

Exemple quand tout est ok

> tutoquartotypst::verifier_installation()

── Vérification de votre installation ────────────────────────────────────────────────────────────────────────────────────────────
✔ R 4.6.0 : version compatible (>= 4.1.0).
✔ Quarto 1.10.7 : version recommandée.
✔ Paquets R : les 8 prérequis sont installés.
✔ Rendu de test réussi : PDF produit (chaîne R → Quarto → Typst → gt → ggplot OK).

── Bilan ──

✔ R
✔ Quarto
✔ Paquets R
✔ Rendu PDF de test
✔ Tout est prêt : .qmd → PDF pro → livre → à personnaliser. On se retrouve pour le tutoriel !
ℹ Au moment de démarrer, ouvrez RStudio ou Positron (récent).
ℹ Prochaine étape : installez les exercices avec tutoquartotypst::installer_exercices().

Les sections ci-dessous sont facultatives : c’est le même chemin, mais à la main. Si l’installation via r-universe échoue (réseau, pare-feu d’entreprise…), suivez simplement le chemin manuel ci-dessous.

Installation

Dernier R 4 : https://cran.r-project.org ou avec rig.
Un éditeur, au choix :
- RStudio 2026.05 ou plus récent — download
- Positron 2026.05 ou plus récent — download (l’éditeur de Posit basé sur VS Code)
Quarto :
- Recommandé : pre-release v1.10.7 ou supérieure — la dernière, qui contient toutes les corrections de bugs.
- Version minimale : stable 1.9 ou supérieure — fonctionnera, mais le tutoriel signalera un contournement à appliquer à l’étape concernée de l’exercice 2.
RStudio récent inclut Quarto, donc rien de plus à installer. Positron embarque Quarto 1.9 (suffisant comme minimum) ; pour profiter de la pre-release recommandée, installez Quarto séparément et, au besoin, réglez le chemin via le paramètre quarto.path de Positron.
Paquets R :

pkg <- c("quarto", "dplyr", "ggplot2", "ggrepel", "gt", "scales", "brand.yml", "prismatic")
install.packages(pkg)
# ou pak 
pak::pkg_install(pkg)

Téléchargements

Déjà couvert par tutoquartotypst::installer_exercices(), qui pose les exercices pour vous. Cette section est le téléchargement manuel, utile seulement si vous n’avez pas utilisé le paquet.

Les exercices sont versionnés dans le dépôt GitHub du tutoriel.

📦 Télécharger le dépôt en zip — décompresser sur le bureau, le matériel est dans exercises/
📁 Parcourir exercises/ sur GitHub

Chaque dossier starter/ contient un fichier .Rproj : double-cliquez-le pour ouvrir l’exercice comme projet RStudio (le répertoire de travail est alors correct pour quarto render).

Les dossiers correction/ contiennent les solutions complètes — ⚠️ ne les ouvrez pas avant le tutoriel !

Les corrections ne sont pas posées par installer_exercices() (choix délibéré : une correction est plus utile après avoir cherché). Deux façons d’y accéder via le paquet, chacune après confirmation :

# Les consulter en ligne (ouvre la page GitHub)
tutoquartotypst::ouvrir_correction("01")     # ou "02"

# Les copier en local pour les retravailler (à côté du starter)
tutoquartotypst::recuperer_correction("01")  # ou "02"

Vérification

Déjà couvert par tutoquartotypst::verifier_installation(). Ces commandes sont l’équivalent manuel, utile seulement si vous n’avez pas utilisé le paquet.

Vérifiez que tout fonctionne en exécutant dans R :

quarto::quarto_version() # >= 1.9 minimum, 1.10.7+ pre-release recommandée
library(dplyr)
head(starwars)

Si la version de quarto n’est pas celle attendue, lancez quarto::quarto_binary_sitrep(debug = TRUE) pour diagnostiquer.

Locale UTF-8. R doit tourner en UTF-8. C’est le cas par défaut sur un poste récent (R ≥ 4.2 sous Windows, macOS, distributions Linux de bureau) — donc rien à faire pour la quasi-totalité des participant·e·s. Les environnements minimaux (conteneurs, CI, serveurs sans locale configurée) démarrent parfois R en locale C (ASCII), et là le rendu des fichiers accentués (_brand.yml, titres) échoue. Contrôle : l10n_info()[["UTF-8"]] doit valoir TRUE ; sinon, lancez R avec une locale UTF-8 installée sur la machine (variable d’environnement LANG, p. ex. C.UTF-8 ou fr_FR.UTF-8). tutoquartotypst::verifier_installation() vous prévient automatiquement.

Test de la chaîne Typst

Pas besoin de le faire à la main si vous avez utilisé le paquet : verifier_installation() rend déjà ce même fichier de test (ligne « Rendu de test réussi » du bilan). La commande ci-dessous est l’équivalent manuel.

La vérification ci-dessus n’exécute que du R. Pour valider que Quarto + Typst + gt + ggplot s’enchaînent bien sur votre machine, rendez le mini-fichier de test fourni dans le dépôt :

quarto render exercises/00-test-install/test-install.qmd

Résultat attendu : un fichier test-install.pdf apparaît à côté du .qmd, avec un titre accentué, un tableau de 3 lignes et un graphique. Aucune erreur en console — en revanche plusieurs avertissements unknown font family sont normaux et documentés ci-dessous. Tant que vous voyez Output created, c’est bon.

Si ça échoue :

Typst executable not found → Quarto < 1.9, mettez à jour.
unknown font family (souvent plusieurs : sans-serif, segoe ui, roboto…) → ignorez-les, le PDF se génère quand même avec une police de repli (ce test n’utilise pas _brand.yml). Ces avertissements sont purement visuels (sans conséquence) : Typst signale chaque police absente de la liste de polices, là où le navigateur les ignore en silence — pas de moyen de les masquer pour l’instant. Suivi sur quarto-cli#12556. (À ne pas confondre avec le bug d’affichage « 1 7 5 » dans les tableaux, quarto-cli#11683, corrigé par gt::opt_table_font().)

Plan B — polices sans réseau le jour J

Le tutoriel utilise par défaut _brand.yml avec source: google pour Inter (corps), qui télécharge la police au premier rendu. Star Jedi (titres) est livrée en local dans _fonts/. Si vous n’avez pas d’accès réseau le matin du tutoriel, un _brand-offline.yml avec Inter en source: file est fourni pour chaque exercice :

Exercice 1 :

Récupérez _brand-offline.yml et le dossier _fonts/ depuis exercises/01-document-typst/correction/.
Copiez-les à côté de votre rapport-starwars.qmd (dans starter/).
Renommez _brand-offline.yml en _brand.yml.

Exercice 2 :

Récupérez _brand-offline.yml et les 3 fichiers _fonts/Inter-*.ttf depuis exercises/02-projet-book/ (à la racine de l’exercice, à côté de _brand-starter.yml).
Copiez-les à la racine de votre projet livre (starter/ — Starjedi.ttf y est déjà dans _fonts/, complétez avec les Inter).
Renommez _brand-offline.yml en _brand.yml.
Récupérez aussi _logo-sw.svg à la racine de l’exo si ce n’est pas déjà fait (cf. README starter).

Le rendu Typst utilisera alors les fichiers TTF locaux (Inter-*.ttf + Starjedi.ttf, ~1 Mo) — aucun téléchargement requis.