# من Mermaid إلى Typst

حوِّل مخططًا انسيابيًا بصيغة Mermaid إلى مخطط fletcher قابل للتحرير في Typst، مع صورة مرسومة عندما لا يمكن مطابقة الصيغة.

تأخذ أداة من Mermaid إلى Typst مخططًا انسيابيًا مكتوبًا بأسطر قليلة من Mermaid وتكتبه كمخطط fletcher. وfletcher هي حزمة Typst لرسم المخططات بالعقد والأسهم. وتبقى التسميات والأشكال والأسهم في المصدر حيث يمكنك تحريرها.

## الاستخدامات الأنسب

استخدمها لمسارات البحث والمخططات المنهجية وأشجار القرار وسائر المخططات الانسيابية التي تكون فيها الروابط أهم من الرسم.

ولرسم مخطط يدويًا، أو لتعديل مخطط محوَّل على لوحة رسم، استخدم [مُركِّب المخططات](/docs/figures-diagrams/). ولمستند LaTeX استخدم [من Mermaid إلى LaTeX](/docs/tools/mermaid-to-latex/).

## تحويل مخطط انسيابي

1. افتح **Mermaid to Typst**، أو شغِّل `/mermaid-to-typst`.
2. الصق مصدر Mermaid، أو اختر **Load example**.
3. اختر **Convert**.
4. اقرأ الملاحظة أسفل النتيجة. فهي تبين ما إذا كنت قد حصلت على كود fletcher قابل للتحرير أم على صورة مرسومة.
5. انسخ `diagram.typ` أو احفظه. وعندما تتضمن النتيجة صورة، يحفظ خيار **Save ZIP** الصورة مع المصدر.

مثال:

```mermaid
flowchart LR
  question[Research question] --> search[Search literature]
  search --> decide{Enough evidence?}
  decide -->|Yes| write[Write synthesis]
  decide -.->|No| search
```

يصبح كود fletcher أي مخطط `flowchart` أو `graph` يعمل بالاتجاه `TD` أو `TB` أو `LR` أو `BT` أو `RL`، مع التسميات وتسميات الحواف والوصلات المتقطعة أو السميكة وأشكال العقد الشائعة. ويبدأ الناتج بسطر `#import` الخاص بحزمة fletcher، يليه استدعاء `#diagram` فيه `node` واحد لكل صندوق و`edge` واحد لكل سهم.

## إصدارات fletcher

يسمّي سطر الاستيراد إصدار fletcher يعمل على نسخة Typst لديك. وعندما يكون مشروع Typst مفتوحًا، يختار Oleafly الإصدار وفق نسخة Typst الخاصة بذلك المشروع: fletcher 0.5.8 لإصدار Typst 0.13 وما بعده، و0.5.5 لإصدار Typst 0.12، و0.5.1 للإصدارات الأقدم. وإذا لم يكن مشروع Typst مفتوحًا فستحصل على 0.5.8.

ينزّل Typst حزمة fletcher من Typst Universe في أول مرة يُجمَّع فيها مستند يستخدمها. وبعد ذلك تعمل دون اتصال.

## عندما يرسم Oleafly صورة بدلًا من ذلك

بعض صيغ Mermaid ليس لها مقابل آمن في fletcher: أنواع المخططات الأخرى مثل المخططات التسلسلية، والمخططات الفرعية، وأسطر `style` و`classDef`، والوصلات المتسلسلة مثل `a --> b --> c`. عندها يرسم Oleafly المخطط على جهازك، ويحفظه باسم `assets/diagram.png`، ويعيد استدعاء `#figure` قصيرًا يعرض تلك الصورة. وتبقى العلاقات ظاهرة، لكن الصورة ليست قابلة للتحرير ككود.

يعمل التحويل على جهازك. ومدخل Mermaid محدود بـ 50,000 حرف. جمِّع النتيجة عند عرضها النهائي وتحقق من التفاف التسميات والتقاطعات واتجاه الأسهم.
