# Figures et diagrammes

Le compositeur de diagrammes : dessinez sur un canevas ou écrivez le code, en TikZ pour LaTeX, fletcher pour Typst ou Mermaid pour Markdown, avec un aperçu en direct et un source modifiable.

Dessinez un diagramme sur un canevas et obtenez du code source brut dans le langage de votre document : du TikZ pour LaTeX, un diagramme fletcher pour Typst ou un organigramme Mermaid pour Markdown. Le dessin et le code restent synchronisés, donc vous pouvez passer de l'un à l'autre à tout moment.

Le compositeur tourne sur votre appareil et ne demande aucun compte. (Pour les figures écrites par l'assistant, voir [Dessiner des figures avec l'IA](/docs/ai-figures/).)

## Ouvrir le compositeur

Depuis l'écran d'accueil, choisissez **Compositeur de diagrammes** dans le dock. Vous pouvez aussi lancer **Ouvrir le compositeur de diagrammes** depuis la palette de commandes ⌘K (Ctrl+K), ou taper `/diagram` dans la barre de recherche. Une boîte de dialogue, **Choisir un compositeur de diagrammes**, demande à quoi sert le diagramme : **Diagramme TikZ** pour les documents LaTeX, **Diagramme Typst** pour les documents Typst ou **Diagramme Mermaid** pour les documents Markdown.

Depuis un document ouvert, choisissez plutôt **Dessiner un diagramme** dans la barre d'outils de l'éditeur. Le compositeur saute la question et utilise le langage du document : TikZ dans un fichier `.tex`, Typst dans un fichier `.typ` et Mermaid dans un fichier Markdown. **Retour au projet** vous ramène au document.

L'en-tête affiche le nom du diagramme, sur lequel vous pouvez cliquer pour le renommer, et une petite étiquette avec son langage.

![Un diagramme TikZ écrit en code, puis modifié sous forme de formes sur le canevas.](https://cdn.oleafly.com/images/gifs/desktop/tikz-composer.gif?v=2)

## Dessiner sur le canevas

Le mode **Dessin** est le canevas. Il fonctionne de la même façon dans les trois langages.

Choisissez une forme dans la palette (rectangle, boîte arrondie, cercle, ellipse, losange, parallélogramme ou texte), puis cliquez et faites glisser pour la placer et la dimensionner. **Maths** et **Code** sont des zones de texte qui démarrent avec une équation ou un échantillon de code dans le langage du diagramme.

Pour relier deux formes, faites glisser depuis une poignée de l'une vers l'autre. Le connecteur reste attaché quand vous déplacez l'une ou l'autre forme. Sélectionnez-le pour choisir la pointe de flèche (fin, les deux ou aucune), le routage (droit, orthogonal ou courbe) et une étiquette. Sélectionnez une forme pour changer son étiquette, son remplissage, sa bordure, son rayon d'angle ou sa police.

Les formes s'alignent automatiquement quand vous les déplacez, et annuler et rétablir fonctionnent comme d'habitude. Maintenez Espace et faites glisser pour déplacer la vue, et double-cliquez sur une forme pour modifier son texte.

![Un diagramme de flux de travail dessiné avec le paquet fletcher et compilé.](https://cdn.oleafly.com/images/gifs/desktop/typst-composer.gif?v=2)

## Modifier le code

Le mode **Code** montre le même diagramme en source, avec un menu **Extraits** pour les morceaux courants comme un nœud rectangle, un nœud cercle, une arête fléchée et une arête ligne. Modifiez un côté et l'autre suit : déplacez une boîte et le code change, renommez une étiquette dans le code et le canevas change.

Le code est du source ordinaire pour chaque langage :

- TikZ : un `tikzpicture` avec des nœuds et des arêtes.
- Typst : un extrait fletcher complet, avec la ligne `#import "@preview/fletcher:…"` et un appel `#diagram(…)` contenant des éléments `node(…)` et `edge(…)`. La version de fletcher correspond à la version de Typst du projet Typst ouvert : 0.5.8 pour Typst 0.13 et ultérieur, 0.5.5 pour 0.12 et 0.5.1 pour les versions plus anciennes.
- Mermaid : un organigramme avec des formes de nœuds, des liens étiquetés, des lignes `style` pour les couleurs et des sous-graphes pour les boîtes de groupe. Mermaid dispose le diagramme lui-même, donc les positions que vous réglez sur le canevas ne font pas partie du code.

### Le code que le canevas ne sait pas dessiner

Dans Typst et Mermaid, le code que le canevas ne peut pas afficher reste exactement comme vous l'avez écrit. Pour Typst, cela comprend les imports, les lignes `#let`, les enveloppes comme `#figure(…)`, les réglages de diagramme supplémentaires et les boucles. Pour Mermaid, cela comprend les lignes `click`, les directives, les commentaires et le frontmatter. Un nœud ou une arête que vous ne touchez pas sur le canevas garde son texte, et un que vous touchez garde les options que le canevas ne connaît pas.

Quand le canevas n'affiche pas tout, un bouton de notes apparaît dans l'en-tête avec un compte, par exemple **2 notes**. Il liste ce qui reste uniquement dans le code et ce que le canevas affiche de façon approximative, comme des nœuds sans taille définie, des étiquettes mises en forme ou une forme Mermaid que le canevas n'a pas.

TikZ se comporte différemment. Les notes nomment les commandes TikZ que le canevas ne modélise pas, et une modification sur le canevas réécrit le TikZ à partir du dessin, donc ces commandes sont perdues. Gardez le TikZ écrit à la main ou complexe en mode Code.

## Prévisualiser le résultat

**Compiler** fait le rendu du diagramme isolément, à l'écart de votre document, dans un volet d'aperçu à côté du canevas. Choisissez une échelle PNG de 1x, 2x ou 3x, et une couleur de fond ou un fond transparent.

- TikZ compile avec Tectonic dans un build séparé, donc un diagramme à moitié fini ne touche jamais votre document.
- Typst fait l'aperçu avec la version de Typst et le cache de paquets du projet Typst ouvert, ou avec le Typst intégré quand aucun projet Typst n'est ouvert. Le premier aperçu Typst télécharge fletcher depuis Typst Universe. En mode hors ligne, ou sans connexion, l'aperçu indique que le paquet manque au lieu d'afficher une erreur générale.
- Mermaid fait l'aperçu avec le propre moteur de rendu Mermaid de l'application.

Les erreurs apparaissent dans le volet d'aperçu. Pour Typst et Mermaid, chaque erreur indique sa ligne dans le code, et un clic y saute directement.

Si une compilation échoue, **Corriger avec l'IA** envoie le code et ses erreurs à votre fournisseur d'IA connecté et demande du code corrigé dans le même langage.

## Insérer, enregistrer et télécharger

Compilez d'abord, puis ouvrez le menu **Enregistrer** à côté de **Compiler** :

- **Insérer en TikZ**, **Insérer en Typst** ou **Insérer en Mermaid** place le diagramme au curseur dans le document `.tex`, `.typ` ou Markdown ouvert, dans le langage de ce document. Si le compositeur est réglé sur un autre langage, le dessin est d'abord converti via le canevas, donc le code que le canevas ne peut pas afficher ne passe pas.
- **Enregistrer dans le projet** écrit `figures/<name>.png` et le source, `figures/<name>.tikz`, `.typ` ou `.mmd`, dans un projet que vous choisissez dans la liste. Enregistrer dans un projet qui utilise un autre langage convertit le dessin vers le langage de ce projet. Oleafly demande avant de remplacer des fichiers existants. Ajoutez un diagramme Typst enregistré à un document avec `#include`, et un diagramme Mermaid à l'intérieur d'un bloc de code `mermaid`.
- **Enregistrer dans le projet → Nouveau projet** crée un projet de diagramme dans le langage du compositeur.
- **Enregistrer la figure** garde le PNG et son source dans le cache de figures d'Oleafly, hors de tout projet.

Le menu **Télécharger** enregistre un PNG, un SVG pour les diagrammes Typst et Mermaid, ou le source en **TikZ (.tikz)**, **Typst (.typ)** ou **Mermaid (.mmd)**. Télécharger dans un autre langage convertit le dessin via le canevas.

![Un diagramme de flux Mermaid écrit pour un carnet Markdown et prévisualisé.](https://cdn.oleafly.com/images/gifs/desktop/mermaid-composer.gif?v=2)

## Mermaid dans les documents Markdown

L'insertion dans un document Markdown ajoute un bloc de code `mermaid` clôturé, et l'aperçu Markdown le dessine. Un PDF a besoin d'une image, donc le compositeur enregistre aussi un PNG rendu dans `figures/mermaid-<hash>.png`, et la compilation Markdown met cette image à la place du bloc. Le diagramme apparaît donc aussi dans le PDF compilé. Si vous modifiez le bloc à la main plus tard, le PDF affiche le code jusqu'à ce que vous insériez ou enregistriez de nouveau le diagramme depuis le compositeur.

## Rouvrir et importer des diagrammes

Les fichiers source que le compositeur enregistre se terminent par un commentaire d'une ligne qui contient le modèle du canevas. Importez-en un et le dessin revient exactement comme vous l'avez laissé.

**Importer un fichier de diagramme** dans l'en-tête ouvre un fichier `.tikz`, `.tex`, `.typ`, `.mmd` ou `.md` et remplace le brouillon actuel. Un fichier dans un autre langage fait passer le compositeur à ce langage. Le code que le canevas sait lire est dessiné ; le reste s'ouvre en code seulement.

## Projets de diagramme

Un projet de diagramme contient une seule figure. Créez-en un dans l'un des trois langages avec **Enregistrer dans le projet → Nouveau projet**. Un projet de diagramme Typst a un `main.typ` autonome dont la page est dimensionnée selon le dessin, donc le compiler produit le PDF du diagramme.

Ouvrez le fichier principal du projet et faites passer la barre d'outils de l'éditeur de **Code** à **Canevas** (TikZ) ou **Visuel** (Typst et Markdown) pour le modifier sur le même canevas.

Le modèle **Diagramme / Figure** (TikZ) et le modèle **Figure Typst** démarrent aussi un projet à une figure, écrit en source. Ces projets s'aperçoivent comme la figure elle-même, et leur [menu d'export](/docs/export/) propose **Exporter en PDF (image vectorielle)** et **Exporter en PNG**. Utilisez-les pour les figures que vous réutilisez d'un article à l'autre.
