Pour aller plus loin

Le paquet compagnon tutoquartotypst

Le paquet R qui a servi à préparer le tutoriel vous suit après le 16 juin :

  • creer_projet_typst() — démarrer un nouveau document ou livre Typst prêt à rendre
  • basculer_charte() / comparer_chartes() — rejouer la pépite « une marque, plusieurs déclinaisons »
  • basculer_hors_ligne(), valider_brand(), diagnostiquer_rendu() — pour se simplifier la vie et se dépanner

→ Guide « Réutiliser Quarto + Typst après le tutoriel » et documentation du paquet.

Documentation officielle Quarto

Apprendre Typst

Articles de blog Quarto

Aller plus loin avec Quarto

Typst depuis R

Formats Typst existants

Options Typst avancées

Options supplémentaires pour format: typst :

  • toc: true et number-sections: true — table des matières et numérotation
  • mainfont — police principale du document (polices Google prises en charge)
  • linestretch — interlignage
  • linkcolor, codefont, mathfont — nouvelles options Quarto 1.9
  • font-paths — embarquer des polices locales dans le projet
  • columns: 2 — document en deux colonnes
  • theorem-appearance — 4 styles d’encadrés pour théorèmes (simple, fancy, clouds, rainbow)
  • Référence complète : Typst Basics

_brand.yml — référence complète

Le fichier _brand.yml prend en charge les sections suivantes :

  • meta — nom de l’organisation, lien
  • color — palette de couleurs nommées + couleurs sémantiques (primary, secondary, background, foreground)
  • typography — base (famille + taille), headings, monospace, polices Google ou locales
  • logo — positionnement dans le PDF : width, location (header/footer), padding, alt
  • brand-mode: dark — inverser background/foreground pour un PDF sombre
  • quarto use brand user/repo — partager une charte depuis GitHub

Dans les blocs raw Typst, les variables liées à la charte sont accessibles via brand-color.primary, brand-color.secondary, brand-logo-images.

Brander vos tableaux et graphiques (côté R)

_brand.yml habille automatiquement la mise en page du PDF (titres, liens, fond, polices). En revanche, vos tableaux gt et graphiques ggplot sont produits par R : ils ne prennent les couleurs de la charte que si vous les y branchez explicitement. C’est le niveau « hors-piste » du tutoriel — le geste à découvrir si vous êtes déjà à l’aise avec Quarto.

Le paquet R brand.yml lit votre _brand.yml depuis R et propage la charte à vos sorties :

  • read_brand_yml() + brand_color_pluck(brand, "primary") — accéder aux couleurs de la charte sans dupliquer les valeurs hex
  • theme_brand_gt(), theme_brand_ggplot2() (et aussi theme_brand_flextable(), theme_brand_plotly(), theme_brand_thematic()) — appliquer la charte d’un coup à un tableau ou un graphe

Pour le pas-à-pas complet, voyez le Bonus B4 du Bloc 2 (page Exercice 2) et la correction commentée exercises/01-document-typst/correction/rapport-starwars.qmd.

Piège à connaître : côté R, les clés palette tiret-séparé sont normalisées en tiret_souligné à la lecture (brand_color_pluck(brand, "sw_yellow"), pas "sw-yellow").

Blocs raw Typst

Injectez du code Typst natif dans un document Quarto :

```{=typst}
#text(fill: rgb("#0055A4"), weight: "bold")[
  Texte bleu en gras, rendu par Typst
]
```
  • Le contenu est passé directement au compilateur Typst
  • Invisible dans les autres formats (HTML, DOCX…)
  • Accédez aux variables de la charte : brand-color.primary, brand-logo-images
  • Référence : Typst Basics — Raw Typst

Traduction CSS → Typst

Depuis Quarto 1.5, certaines propriétés CSS sont traduites automatiquement :

  • color → couleur du texte
  • background-color → fond
  • font-weight, font-style → graisse et style
  • Fonctionne sur les spans [texte]{style="..."} et les divs :::{style="..."}

Les tableaux produits par gt (R) ou Great Tables (Python) avec du CSS sont rendus correctement dans le PDF Typst.

Template partials — guide

Le pipeline de compilation Typst dans Quarto :

document.qmd → Pandoc + partials → document.typ → Typst → document.pdf

Deux fichiers contrôlent la génération du .typ :

  • typst-show.typ — le pont entre Quarto et Typst (reçoit les variables YAML, appelle la fonction template)
  • typst-template.typ — le layout du document (header, footer, page de titre, polices, couleurs)

Déclarez-les dans le YAML :

format:
  typst:
    template-partials:
      - typst-show.typ
      - typst-template.typ

Syntaxe Pandoc dans les partials :

Syntaxe Rôle Exemple
$variable$ Insertion de valeur $title$
$if(var)$...$endif$ Condition $if(date)$...$endif$
$for(var)$...$endfor$ Boucle $for(by-author)$...$endfor$

Variables Quarto 1.9 : $linkcolor$, $codefont$, $mathfont$, $linestretch$.

Créer et partager des extensions

  • quarto create extension format:typst — créer un squelette d’extension Typst
  • quarto add user/repo — installer un format depuis GitHub
  • quarto use brand user/repo — télécharger une _brand.yml depuis un dépôt GitHub

Accessibilité PDF

format:
  typst:
    pdf-standard: ua-1

  • Génère un PDF conforme au standard PDF/UA-1

  • Les lecteurs d’écran peuvent naviguer dans le document

  • Les images avec fig-alt obtiennent un texte alternatif dans le PDF

  • Limitation : les Typst books (type: book) ne sont pas encore compatibles PDF/UA-1

  • Blog post : PDF Accessibility and Standards