Introduction

Je commence toujours par une introduction que je ne numérote pas avec la propriété unumbered. Dans l’idéal, je trouve une phrase d’accroche en citant par exemple une actualité ou un fait marquant en rapport avec le sujet. Je présente le contexte, puis j’expose la problématique et le plan.

Ce rapport est rédigé en utilisant Quarto et Typst.

1 Quarto et Typst

1.1 Typst

Typst est un nouveau système de composition de documents conçu pour remplacer LaTeX. Il se distingue par une syntaxe moderne, intuitive et une compilation quasi instantanée. Il offre une gestion fluide des polices et une mise en page élégante, tout en permettant de créer des templates personnalisés avec une logique de programmation simplifiée.

1.2 Quarto

Quarto est un système de publication scientifique multi-langage qui permet de mélanger texte (Markdown) et code exécutable (Python, R, Julia). Il agit comme un orchestrateur capable de transformer un document unique en formats variés (HTML, diapo, PDF…). Sa force réside dans la reproductibilité totale des analyses et des graphiques.

1.3 Typst inclus dans Quarto

Typst est désormais intégré nativement dans Quarto, offrant une flexibilité d’utilisation à trois niveaux :

  • un moteur de rendu automatique pour vos fichiers .qmd
  • la possibilité d’injecter directement du code Typst dans votre texte
  • via des fichiers .typ pour créer des templates

https://quarto.org/docs/output-formats/typst.html

Important

Je n’oublie pas de faire une petite phrase de transition.

Après avoir typst et Quarto, nous allons utiliser ces outils pour créer un rapport de projet.

2 Créer un rapport de projet

La majorité de ce rapport est rédigée en utilisant le markdown. Cependant il arrive que cela ne soit pas suffisant pour avoir une gestion fine du rendu.

Par exemple pour obtenir une page de garde propre, nous allons utiliser directement du code typst

2.1 La page de garde

Ce code est placé au début de ce document et permet de créer la page de garde et la table des matières.

```{=typst}
#import "model.typ": project_template

#show: body => project_template(
  title: [Créer un rapport de projet\ avec Quarto et Typst],
  team: [Équipe 8],
  authors: ([Jean-Guy Badiane], [Serena Williams], [François Pignon], [Anne Hathaway]),
  tutor: [Philippe Lucas],
  project: [Projet Statistique de 1ère année - Année 2025-2026],
  body
)
```

2.2 Comment ça fonctionne

Nous commençons par importer le fichier model.typ et sa fonction nommée project_template. Celle-ci contient le code typst pour créer une belle page de garde.

Ensuite nous appelons cette fonction avec les paramètres adéquats pour générer la page de garde.

Tip

Vous noterez que cela permet de gérer également la numérotation des pages à partir de l’introduction.

Remarque : le code a été déplacé dans le fichier model.typ pour alléger ce document et séparer le fond et la forme. Mais le résultat serait le même si vous remplaciez l’import par tout le contenu du fichier model.typ.

3 Quelques exemples de mise en forme

3.1 Police

quarto typst fonts pour afficher la liste des polices disponibles sur votre machine.

3.2 Code

SELECT *
  FROM user
 WHERE 1 = 1

3.2.1 Code R exécuté

Nous pouvons exécuter du code R et en afficher le résultat

Figure 1: Un labyrinthe

Je cite la Figure 1.

3.3 Liste

  • Paper-based exam
  • Duration: 1h30
  • 1 handwritten A4 sheet (front and back) allowed
  • No calculator

3.4 Tableau

Table 1: Java méthods visibility
Modifier Same Class Same Package Subclasses Everywhere
public ✅ ✅ ✅ ✅
protected ✅ ✅ ✅ ❌
default (no modifier) ✅ ✅ ❌ ❌
private ✅ ❌ ❌ ❌

Comme indiqué ici Table 1, c’est facile de citer un tableau.

3.5 Images

Normalement vous n’avez pas besoin d’intégrer souvent des images, car vos figures peuvent être générées directement par du code R ou Python.

3.6 Callout blocks

Note

Les callout blocks servent à casser la monotonie visuelle et à hiérarchiser l’information.

Leurs intérêts principaux sont :

  • Attirer l’attention sur des points cruciaux (avertissements, notes, astuces).
  • Structurer la lecture en isolant des éléments spécifiques (définitions, conseils, exemples).
  • Améliorer la lisibilité en créant des zones de respiration visuelle dans un texte dense.

3.7 Formules

  • with one $ : inline \(\overline{X}_n = \frac{1}{n} \sum_{i=1}^{n}X_{i}\)
  • with two $$: \[\tilde{S}^2 = \frac{1}{n} \sum_{i=1}^{n}(X_{i} - \overline{X}_n)^{2}\]

4 Bonnes pratiques

4.1 Rédaction

  • Evitez la forme passive
  • On a ➡️ Nous avons
Warning

RELISEZ-VOUS !!!

4.2 Figures

  • Titre, Numéro, Source, Champ, Note de lecture
  • Elle doit être citée dans le texte
  • Elle doit pourvoir être comprise seule sans lire le texte

4.3 Graphique

  • Je choisis le type le mieux adapté
  • J’utilise une palette de couleurs harmonisées

4.4 Références bibliographique

Important

Citer des références bibliographiques permet de situer notre projet dans un cadre plus large. Cela montre que nous maîtrisons le sujet et que nous avons pris connaissance des travaux de nos pairs. Une bibliographie riche et pertinente démontre la profondeur de notre recherche documentaire.

Comme le spécifie cet article [@prospect_theory], la Prospect Theory c’est cool.

Conclusion

Je ne rappelle pas un à un tous les résultats obtenus.

Je fais un bilan, est-ce que ça répond à mes questions, est-ce que ça confirme.

Quelles sont les limites ? Comment faire pour aller plus loin ?

Annexes

J’ajoute ici les éléments utiles pour la compréhension mais trop lourds pour la lecture fluide.