Convertir et créer
Mermaid vers Typst
Transformez un organigramme Mermaid en diagramme fletcher modifiable pour Typst, avec une image générée quand la syntaxe n'a pas d'équivalent.
Mermaid vers Typst prend un organigramme écrit en quelques lignes de Mermaid et l’écrit sous forme de diagramme fletcher. Fletcher est un paquet Typst qui sert à dessiner des diagrammes avec des nœuds et des flèches. Les étiquettes, les formes et les flèches restent dans le code source, où vous pouvez les modifier.
Cas d’usage
Section intitulée « Cas d’usage »Utilisez-le pour des flux de travail de recherche, des diagrammes de méthode, des arbres de décision et d’autres organigrammes où les connexions comptent plus que le graphisme.
Pour dessiner un diagramme à la main, ou ajuster un diagramme converti sur un canevas, utilisez le composeur de diagrammes. Pour un document LaTeX, utilisez Mermaid vers LaTeX.
Convertir un organigramme
Section intitulée « Convertir un organigramme »- Ouvrez Mermaid vers Typst, ou exécutez
/mermaid-to-typst. - Collez du code source Mermaid, ou choisissez Charger un exemple.
- Choisissez Convertir.
- Lisez la note sous le résultat. Elle indique si vous avez obtenu du code fletcher modifiable ou une image générée.
- Copiez ou enregistrez
diagram.typ. Quand le résultat contient une image, Enregistrer le ZIP garde l’image avec le code source.
Exemple :
flowchart LR question[Research question] --> search[Search literature] search --> decide{Enough evidence?} decide -->|Yes| write[Write synthesis] decide -.->|No| searchUn flowchart ou un graph en direction TD, TB, LR, BT ou RL, avec des étiquettes, des étiquettes d’arête, des liens en pointillés ou épais et des formes de nœud courantes, devient du code fletcher. Le résultat commence par la ligne #import de fletcher, suivie d’un appel #diagram avec un node par boîte et un edge par flèche.
Versions de fletcher
Section intitulée « Versions de fletcher »La ligne d’import nomme une version de fletcher qui fonctionne avec votre Typst. Avec un projet Typst ouvert, Oleafly la choisit d’après la version Typst de ce projet : fletcher 0.5.8 pour Typst 0.13 et ultérieur, 0.5.5 pour Typst 0.12, et 0.5.1 pour les versions plus anciennes. Sans projet Typst ouvert, vous obtenez 0.5.8.
Typst télécharge fletcher depuis Typst Universe la première fois qu’un document qui l’utilise est compilé. Ensuite, il fonctionne hors ligne.
Quand Oleafly génère une image à la place
Section intitulée « Quand Oleafly génère une image à la place »Certaines syntaxes Mermaid n’ont pas de correspondance fletcher sûre : d’autres types de diagrammes comme les diagrammes de séquence, les sous-graphes, les lignes style et classDef, et les liens en chaîne comme a --> b --> c. Dans ce cas, Oleafly dessine le diagramme sur votre appareil, l’enregistre sous assets/diagram.png et renvoie un court #figure qui affiche cette image. Les relations restent visibles, mais l’image ne se modifie pas comme du code.
La conversion s’exécute sur votre appareil. L’entrée Mermaid est limitée à 50 000 caractères. Compilez le résultat à sa largeur définitive et vérifiez le retour à la ligne des étiquettes, les croisements et le sens des flèches.