変換と作成
Mermaid から Typst へ
Mermaid のフローチャートを、Typst 用の編集できる fletcher のダイアグラムに変えます。構文が対応しないときは、描画した画像になります。
Mermaid から Typst へは、数行の Mermaid で書かれたフローチャートを、fletcher のダイアグラムとして書き出します。fletcher は、ノードと矢印でダイアグラムを描く Typst のパッケージです。ラベル、図形、矢印はソースに残るので、そこで編集できます。
向いている用途
「向いている用途」セクション研究のワークフロー、手法の図、決定木など、アートワークよりもつながりが重要なフローチャートに使います。
ダイアグラムを手で描いたり、変換したものをキャンバスで調整したりするには、ダイアグラムコンポーザーを使います。LaTeX の文書には、Mermaid から LaTeX へを使います。
フローチャートを変換する
「フローチャートを変換する」セクション- Mermaid から Typst へを開くか、
/mermaid-to-typstを実行します。 - Mermaid のソースを貼り付けるか、例を読み込むを選びます。
- 変換を選びます。
- 結果の下にある注記を読みます。編集できる fletcher のコードが得られたのか、描画された画像なのかが書かれています。
diagram.typをコピーまたは保存します。結果に画像が含まれるときは、ZIP を保存で、画像をソースと一緒に保存できます。
例:
flowchart LR question[Research question] --> search[Search literature] search --> decide{Enough evidence?} decide -->|Yes| write[Write synthesis] decide -.->|No| search方向が TD、TB、LR、BT、RL の flowchart または graph で、ラベル、辺のラベル、破線や太線のリンク、一般的なノードの形を使っているものは、fletcher のコードになります。結果は fletcher の #import 行で始まり、そのあとに #diagram の呼び出しが続きます。ボックスごとに node が 1 つ、矢印ごとに edge が 1 つ付きます。
fletcher のバージョン
「fletcher のバージョン」セクションインポート行には、お使いの Typst で動く fletcher のバージョンが書かれます。Typst プロジェクトを開いている場合、Oleafly はそのプロジェクトの Typst バージョンから選びます。Typst 0.13 以降には fletcher 0.5.8、Typst 0.12 には 0.5.5、それより古いリリースには 0.5.1 です。Typst プロジェクトを開いていないときは、0.5.8 になります。
fletcher を使う文書を初めてコンパイルするとき、Typst は Typst Universe から fletcher をダウンロードします。それ以降はオフラインで動作します。
代わりに Oleafly が画像を描画するとき
「代わりに Oleafly が画像を描画するとき」セクションMermaid の構文には、fletcher に安全に対応づけられないものがあります。シーケンス図などの他の種類の図、サブグラフ、style 行と classDef 行、a --> b --> c のような連鎖したリンクです。その場合、Oleafly は図をお使いのデバイス上で描画して assets/diagram.png として保存し、その画像を表示する短い #figure を返します。関係は見えるままですが、画像はコードとして編集できません。
変換はお使いのデバイス上で行われます。Mermaid の入力は 50,000 文字までです。結果を最終的な幅でコンパイルして、ラベルの折り返し、線の交差、矢印の向きを確認してください。