Projets Quarto & Typst book

PDF sans frictions : Typst dans vos projets Quarto

Christophe Dervieux & Maëlle Salmon

Posit / rOpenSci

16 juin 2026

_quarto.yml — tout régler au même endroit

Un projet Quarto = un dossier avec _quarto.yml.

_quarto.yml

project:
  type: default

format: typst

mon-projet/
├── _quarto.yml   ← config projet
├── _brand.yml    ← charte
├── index.qmd
├── 01-anatomie.qmd
├── 02-origines.qmd
└── conclusion.qmd

• Tous les .qmd du projet produisent un PDF via Typst automatiquement
• Votre _brand.yml à la racine s’applique à tout le projet
• Plus besoin de répéter le YAML dans chaque fichier !

Transition naturelle : au Bloc 1 on a stylé un document unique. Maintenant on passe à l’échelle. Le _brand.yml créé dans l’exercice 1 va être réutilisé ici — on le déplace juste à la racine.

type: book

_quarto.yml

project:
  type: book

book:
  title: "Anatomie d'une saga"
  author: "Mon Mothma"
  chapters:
    - index.qmd
    - 01-anatomie.qmd
    - 02-origines.qmd
    - conclusion.qmd
  appendices:
    - annexe-donnees.qmd

format: typst

Depuis Quarto 1.9, format: typst sur un project.type: book active orange-book :

Le moment wow : zéro configuration supplémentaire. On montre le _quarto.yml, on rend, et on obtient un livre pro. Orange-book est une extension bundlée dans Quarto 1.9.

Pont avec le Bloc 1 (si on le demande) : au Bloc 1, pour des titres rouges il fallait écrire typography.headings.color: primary à la main (template article = Quarto ne colore que les liens). Ici, orange-book reprend primary comme couleur d’accent (main-color) et colore titres + couverture + TOC toute seule — c’est ça, la valeur d’une extension. Orange-book ne lit d’ailleurs pas headings.color : cette clé est donc sans effet en mode book. Et si on demande « comment changer la couleur des titres ici ? » : c’est color.primary (= main-color) qu’on modifie — mais ça recolore tout l’accent d’un coup (couverture, TOC, numéros de chapitre, liens), on ne dissocie pas la couleur des titres du reste. Bloc 1 = contrôle fin clé par clé ; Bloc 2 = un seul levier (primary), c’est le prix de l’opinionated. À ressortir seulement si la question vient.

Découpage du YAML en 4 fragments via code-line-numbers pour étaler le récit : (1) project.type: book = on déclare un projet livre ; (2) bloc book: avec titre/auteur/chapters = configuration minimale ; (3) appendices: = ce qui sort du flux principal et devient « Annexe A » ; (4) format: typst = inchangé depuis l’étape 1, c’est type: book qui active orange-book. 4 beats = 4 idées, plus digestible que tout d’un coup.

Construisons un livre ensemble

Faisons ensemble !

On part du dossier starter/, on y crée un _quarto.yml, puis on le bascule en livre.

1. type: default → render → 5 PDF séparés

_quarto.yml

project:
  type: default

format: typst

2. type: book → render → PDF unique (couverture + TOC)

_quarto.yml

project:
  type: book

book:
  title: "Anatomie d'une saga"
  author: "Mon Mothma"
  chapters:
    - index.qmd
    - 01-anatomie.qmd
    - 02-origines.qmd
    - conclusion.qmd

format: typst

Rendre le projet : quarto render à la racine du dossier (ou bouton Render) — Quarto rend tout le projet. → Ensuite, à vous : appendices, _brand.yml au niveau projet, bonus.

Démo live ultra-courte : 5-6 min. Le pas-à-pas détaillé (snippets à coller, ressources, pièges, transition Your turn) est dans le doc animateur dédié _speaker/demo-bloc2-our-turn.qmd — pas de duplication ici (les snippets sont déjà sur la slide).

Pourquoi minimal : Our turn montre comment _quarto.yml + type: book produit un livre PDF unique. appendices, copie de _brand.yml et bonus restent dans Your turn — éviter la redondance Bloc 1.

Effet visuel à l’étape 2 : on passe de 5 PDF séparés à 1 PDF unique avec couverture + TOC + numérotation auto (Figure 1.1, Table 2.1…) sans rien d’autre que type: book. C’est orange-book qui s’active sur format: typst + type: book.

Exercice 2

À vous !

🎯 Transformer 5 .qmd en livre PDF Typst stylé.

📄 Charte : charte-starwars.pdf dans le starter (même charte qu’au Bloc 1, référence visuelle).

⏱ 15 minutes — chrono + étapes projetés à l’écran.

🧭 Boussole — objectif, étapes & chrono, à garder sous les yeux

📖 Page de l’exercice — consigne détaillée, doc utile par étape, correction

Pas de _brand.yml ? _brand-starter.yml + _logo-sw.svg dispo dans le dossier exo.

15 min sur les 3 core + 3 min de bonus pour les rapides. Ouvrir la page boussole — 2-projets/boussole.html — dans un onglet à projeter à côté (countdown autonome, démarre au chargement).

Le starter _brand-starter.yml (+ _logo-sw.svg à la racine de l’exo) est important : ceux qui n’ont pas fini Bloc 1 peuvent les copier. Maëlle passe dans les rangs et repère ceux qui peinent à l’étape 1 — souvent un underscore manquant.

Pour ceux qui finissent vite : pousser le bonus B1 (références croisées) en premier — c’est le plus visuel et ça utilise les labels qui sont déjà dans le starter (tbl-anatomie-mass, fig-anatomie-mass, #sec-origines). Le bonus B2 (pagebreak) demande la syntaxe .content-visible when-format="typst" +  — le bloc complet à coller est sur la page Exercice 2.

Saviez-vous que…

Saviez-vous que…

• Template partials — Le fichier typst-show.typ (et son typst-template.typ côté template par défaut) contrôle la génération du .typ. Vous pouvez le remplacer pour personnaliser header, footer, page de titre… Suffit souvent de toucher typst-show.typ seul.
• Créer un format partageable — quarto create extension format:typst génère un squelette d’extension prêt à publier sur GitHub
• Formats communautaires — AMS, IEEE, poster, lettre, CV… sur quarto-ext/typst-templates

Plus de détails sur la page Ressources

Slide rapide, 2-3 minutes max. Template partials = le concept le plus avancé du workshop, mais on ne fait que le mentionner ici. Les gens motivés iront creuser.

Fusible à couper si le timing serre — sauter directement au wrap-up qui suit (3 slides obligatoires, ne pas sauter).

Ce que vous savez faire maintenant

• Produire un PDF pro avec format: typst, sans LaTeX
• Voir ce qui se passe entre le .qmd et le .pdf, avec keep-typ: true
• Personnaliser couleurs, polices (Google ou locales source: file) et logo via _brand.yml
• Assembler plusieurs .qmd en livre avec type: book
• Savoir où chercher pour aller plus loin (partials, formats communautaires — pistes pour après le tutoriel, pas couverts en séance)

Vous êtes parti·e d’un .qmd HTML, vous repartez avec un livre PDF stylé multi-chapitres. Trois lignes de YAML, un fichier de charte, un projet — et c’est tout.

Les 5 bullets font écho aux 3 questions posées en intro (cf. index.qmd:17-19) et aux apprentissages détaillés des 2 pages de bloc (cf. 1-quarto-typst/index.qmd:24-29 + 2-projets/index.qmd:24-28). Le 5ᵉ bullet (« partials, formats communautaires ») est explicitement annoncé comme piste post-tutoriel — pas une promesse non tenue. Rappel mémoriel : pointer du doigt vers la slide précédente Bloc 1 ou la page d’accueil si besoin.

Et maintenant ?

• Cette semaine — ouvrez un de vos .qmd existants, ajoutez format: typst, voyez ce que ça donne
• Pour creuser — la page Pour aller plus loin (partials, blocs raw Typst, accessibilité PDF/UA-1, helpers brand.yml côté R)
• Communauté — quarto-ext/typst-templates, forum Quarto, Awesome Quarto

Merci ! Questions ?

Merci aux Rencontres R, à l’équipe d’organisation, et à vous.

Christophe Dervieux — Posit
Maëlle Salmon — rOpenSci / cynkra