Aller au contenu
Oleaflyv0.4.12

Outils d’édition

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.)

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.
Un diagramme TikZ écrit en code, puis modifié sous forme de formes sur le canevas. Ouvrir la capture complète

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é.
Un diagramme de flux de travail dessiné avec le paquet fletcher et compilé. Ouvrir la capture complète

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.

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.

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.

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é.
Un diagramme de flux Mermaid écrit pour un carnet Markdown et prévisualisé. Ouvrir la capture complète

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.

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.

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 propose Exporter en PDF (image vectorielle) et Exporter en PNG. Utilisez-les pour les figures que vous réutilisez d’un article à l’autre.

Aperçu de l’image

Impossible de charger les réponses de l’IA

Réessayez ou cherchez dans la documentation.