Aller au contenu principal

🧾 Écrire en Typst

Typst est un outil de rédaction et de mise en page scientifique.
Dans ce cours, vous l'utiliserez pour rédiger les documents associés à votre projet scientifique.
Typst fonctionne directement dans le navigateur : aucune installation n'est nécessaire.

Votre équipe utilisera un même projet Typst pendant toute la session.

Le document commencera comme une proposition de projet, puis évoluera progressivement pour devenir votre article scientifique final.

📚 Ressources​

🌐 Utiliser Typst Web​

Rendez-vous sur :

👉 https://typst.app

Créez un compte ou connectez-vous.

Une fois un projet créé (Project > New Project), l'interface présente principalement (les colonnes, de gauche à droite) :

  • les fichiers du projet
  • l'éditeur Typst
  • un aperçu du PDF

Le PDF est généré automatiquement pendant que vous rédigez. Si vous voulez le télécharger, cliquez sur la flèche vers le bas, en haut à droite.

👥 Travailler en équipe​

Tous les membres de votre équipe peuvent travailler dans le même projet Typst.

Dans un projet ouvert :

  1. cliquez sur Share (en haut à droite)
  2. invitez les autres membres de votre équipe
  3. donnez-leur l'autorisation de modifier le projet

Vous pouvez alors travailler ensemble dans les mêmes fichiers.

Ne créez pas une copie différente du document pour chaque membre de l'équipe.

Votre équipe doit conserver un seul projet Typst commun.

📁 Organisation du projet​

Le gabarit fourni dans le cours contient notamment :

article.typ
style-4a3.typ
references.bib
figures/

article.typ​

C'est votre document principal.

Vous y rédigerez progressivement votre proposition, puis votre article scientifique.

style-4a3.typ​

Ce fichier contrôle automatiquement la mise en page :

  • les marges
  • les deux colonnes
  • les polices
  • les titres
  • les figures
  • les tableaux
  • la bibliographie

Vous ne devez normalement pas modifier style-4a3.typ.

references.bib​

Ce fichier contient les références bibliographiques utilisées dans votre projet.

Vous le compléterez progressivement pendant toute la session.

figures/​

Ce dossier contient les graphiques et les images utilisés dans votre document.

✍️ Écrire dans Typst​

La syntaxe de Typst est volontairement simple.

Titres​

= Introduction

== Sous-section

Gras et italique​

*texte en gras*

_texte en italique_

Listes​

- premier élément
- deuxième élément
- troisième élément

Vous n'avez pas besoin de connaître toute la syntaxe de Typst pour réaliser votre projet.

Le gabarit contient déjà la structure et les principaux exemples dont vous aurez besoin.

📊 Ajouter une figure​

Déposez votre graphique ou votre image dans le dossier :

figures/

Lorsque possible, exportez les graphiques produits avec Python en SVG afin de conserver une excellente qualité dans le PDF.

Par exemple :

figures/resultats.svg

Dans article.typ :

#scientific-figure(
  image("figures/resultats.svg", width: 100%),
  caption: [Description claire de la figure.],
) <fig-resultats>

Vous pouvez ensuite faire référence automatiquement à cette figure dans le texte :

Comme le montre la @fig-resultats, ...

Typst affichera automatiquement le numéro correspondant.

Chaque figure doit :

  • être mentionnée dans le texte
  • avoir une légende claire
  • être suffisamment lisible
  • être interprétée dans le document

📋 Ajouter un tableau​

Le gabarit permet également de créer des tableaux scientifiques.

Par exemple :

#scientific-table(
  (1.2fr, 1fr, 1fr),
  (
    [*Condition*], [*Mesure A*], [*Mesure B*],
  ),
  (
    [A], [12,4], [8,1],
    [B], [14,8], [9,3],
  ),
  align: (left, center, center),
  caption: [Exemple de tableau présentant deux mesures pour deux conditions.],
) <tab-resultats>

Vous pouvez ensuite y faire référence dans le texte :

Les résultats sont présentés dans le @tab-resultats.

Les tableaux sont automatiquement numérotés.

➗ Écrire une équation​

Typst permet d'écrire directement les expressions mathématiques.

Par exemple :

$ bar(x) = 1/n sum_(i=1)^n x_i $

Les équations demeurent ainsi nettes, peu importe la taille du document.

N'insérez pas vos équations sous forme de captures d'écran ou d'images.
Écrivez-les directement dans Typst.

📚 Ajouter des références​

Les références bibliographiques sont enregistrées dans :

references.bib

Chaque référence possède une clé unique.

Par exemple :

@article{hubble1929,
  author  = {Hubble, Edwin},
  title   = {A Relation between Distance and Radial Velocity among Extra-Galactic Nebulae},
  journal = {Proceedings of the National Academy of Sciences},
  year    = {1929}
}

La clé de cette référence est :

hubble1929

Pour citer cette source dans votre document :

@hubble1929

Typst ajoute automatiquement la citation dans le texte et génère la liste des références à la fin du document.

Vous pouvez ajouter autant de références que nécessaire dans references.bib.

Toutes les sources utilisées dans votre document doivent être :

  • ajoutées dans references.bib
  • citées dans le texte
  • suffisamment précises pour permettre de retrouver la source originale

📄 Exporter le PDF​

Lorsque vous devez remettre une version de votre document :

  1. exportez le document en PDF (flèche vers le bas, en haut à droite)
  2. ouvrez le fichier obtenu
  3. vérifiez attentivement la mise en page
  4. vérifiez les figures, les tableaux et les références
  5. remettez le PDF demandé

Le projet Typst continue d'évoluer pendant la session.
N'effacez pas votre projet après une remise.