Typst, la structure

Table des matières

Un document Typst se découpe en 3 grandes parties:

Les imports et includes
En-tête et métadonnées
Corps du texte

Les “imports”

Dans Typst, la directive #import permet de charger du contenu depuis un autre fichier. C’est l’équivalent d’un module en programmation : on peut y stocker des fonctions, des styles, ou même des morceaux de document, puis les réutiliser ailleurs.

On peut importer des modules depuis https://typst.app/universe/ pour enrichir nos documents.

#import "@preview/drafting:0.2.2"
#set-page-properties(margin-left: 2cm)
#lorem(20)
#margin-note[Hello, world!]

Les “includes”

Pour les grands projets, une bonne pratique est de structurer le structurer.

Exemple:

mon-projet/
 ├─ main.typ          # fichier principal
 ├─ style.typ         # définitions globales
 ├─ chapitre1.typ     # contenu d’un chapitre
 ├─ chapitre2.typ
 ├─ chapitre3.typ

Dans notre fichier main.typst

// On inclue les autres fichiers
#include "chapitre1.typ"
#include "chapitre2.typ"
#include "chapitre3.typ"

Exemple: https://typst.app/project/rrR1xkL63NcVpTWamc14Px

En-tête et métadonnées

Typst n’a pas de “front matter” dédié. À la place, il utilise des commandes déclaratives (#set, #show, etc.) placées au début du document pour définir ses paramètres globaux.

// Paramètres des métadonnées du PDF (invisible)
// https://typst.app/docs/reference/model/document/
#set document(
  title: "Mon document",
  author: "christophe",
  description: "Petite description",
  keywords: "typst, document",
  date: auto,
)
// Paramétres page
//https://typst.app/docs/reference/layout/page/
#set page(
  paper: "a4",
)

// Paramétres du texte
// https://typst.app/docs/reference/text/text/
#set text(
  lang: "fr",
)

// Parametres des chapitres
//https://typst.app/docs/reference/model/heading/
#set heading(
  numbering: "I,1,a"
)

// Paramétres des paragraphes
// https://typst.app/docs/reference/model/par/
#set par()