من Mermaid إلى LaTeX

تتيح أداة من Mermaid إلى LaTeX أن يبدأ المخطط بأسطر قليلة مقروءة وينتهي داخل ورقة بحثية. فالمخططات الانسيابية الشائعة تتحول إلى TikZ قابل للتحرير، بحيث تبقى التسميات وأنماط الخطوط والمواضع جزءًا من مصدر LaTeX.

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

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

ولشكل منشور يتضمن رسومًا بيانية أو ترميزًا خاصًا بمجال ما أو تنسيقًا يدويًا دقيقًا، استخدم أدوات المخططات والأشكال بدلًا من ذلك. ولا تتوقع أن يكون لكل عائلة من عائلات مخططات Mermaid مقابل TikZ أمين. ولمستند Typst، تكتب أداة من Mermaid إلى Typst كود fletcher بدلًا من ذلك.

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

1. افتح Mermaid to LaTeX، أو شغِّل /mermaid-to-latex.
2. الصق مصدر Mermaid، أو حمِّل المثال.
3. اختر Convert.
4. اقرأ الملاحظة أعلى النتيجة لتعرف ما إذا كنت قد حصلت على TikZ أم على شكل LaTeX مدعوم بصورة.
5. انسخ مصدر .tex أو احفظه مع أي أصل مولَّد.

مثال:

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

تُحوَّل المخططات الانسيابية الشائعة ذات الاتجاه TD أو TB أو BT أو LR أو RL والعقد والحافات الأساسية تحويلًا حتميًا إلى TikZ. وإذا استخدمت الصيغة ميزة من ميزات Mermaid بلا مقابل آمن في TikZ، يرسم Oleafly المخطط محليًا إلى PNG ويعيد مقتطف شكل LaTeX بدلًا من إسقاط العلاقات.

مراجعة الشكل

جمِّع عند عرض العمود النهائي. وتحقق من تقاطعات الخطوط والتفاف التسميات والتباين وحجم الخط وترتيب قراءة المخطط. وأضِف تسمية توضيحية شارحة أو بديلًا نصيًا للقراء الذين لا يستطيعون رؤية الشكل.

يعمل التحويل على جهازك. ومدخل Mermaid محدود بـ 50,000 حرف. ويحتاج مسار الصورة البديلة إلى graphicx؛ أما TikZ القابل للتحرير فيحتاج إلى الحزم المسماة في المصدر المولَّد.