لربط مخططين فرعيين في Mermaid داخل Obsidian، امنح كل مجموعة معرّفًا صريحًا، ثم اربط بين المعرّفين. على جهاز Mac، اختبر مخططًا مبسطًا أولًا، ثم تحقّق مما إذا كانت المشكلة في الصياغة أو اتجاه التخطيط أو اختلاف في العارض المثبّت.

يغطي هذا الدليل الأسهم الظاهرة بين المجموعات في مخطط انسيابي واحد. الهدف هو إظهار الاتصال المقصود، وتحديد نقطتي نهايته، واختيار بديل عملي عندما لا ينتج العارض الترتيب المطلوب.

ابدأ باتصال مبسط بين مجموعتين

أنشئ ملاحظة مؤقتة والصق فيها الكتلة المحاطة بسياج أدناه كاملةً. والطريقة الموثقة لإضافة مخطط في Obsidian هي كتلة برمجية لغتها mermaid؛ ولا حاجة إلى ملف مخطط منفصل. صياغة التنسيق المتقدم

```mermaid
flowchart LR
    subgraph groupA [Group A]
        direction TB
        A1[Item A1] --> A2[Item A2]
    end
    subgraph groupB [Group B]
        direction TB
        B1[Item B1] --> B2[Item B2]
    end
    groupA --> groupB
```

يوثّق Mermaid استخدام معرّفات صريحة للمخططات الفرعية وإنشاء روابط منها وإليها. هنا، يحدّد groupA وgroupB الحاويتين؛ أما النص بين الأقواس فيحدّد عنوانيهما. ويربط السطر الأخير بين الحاويتين. صياغة المخططات الانسيابية

انتقل إلى عرض القراءة لمعاينة النتيجة. في macOS، الاختصار الموثق للتبديل بين عرض القراءة وعرض التحرير هو Cmd+E. ويمكنك أيضًا اختيار عرض القراءة من أداة التحكم بالعرض في شريط الحالة. ولتحرير المصدر بدقة، اختر وضع المصدر. العروض ووضع التحرير

تحقّق من ثلاثة أمور: ظهور المجموعتين، وظهور العناصر الداخلية فيهما، واتصال سهم بحدود المجموعتين. تجاهل التباعد والتنسيق خلال هذا الفحص الأول. تستند هذه الأمثلة إلى وثائق الصياغة التي جرى الاطلاع عليها؛ ولم تُعرض في تثبيت محلي لـ Obsidian أثناء إعداد هذا المقال.

إذا نجح المثال المبسط، فأبقِ تلك الملاحظة مرجعًا. وقارن مخططك الأصلي به على خطوات صغيرة: ابدأ بتعريفات المجموعات، ثم معرّفاتها، ثم سطر الربط الواحد. ولا تستعد المحتوى الإضافي إلا بعد ظهور الاتصال الأساسي.

تحقّق من العارض الذي يستخدمه إصدار Obsidian لديك

سجّل إصدار التطبيق المثبّت قبل مقارنة النتائج بالأمثلة المنشورة عبر الإنترنت. توضح وثائق تحديث Obsidian أن إصدار التطبيق والمثبّت يظهران ضمن الإعدادات → عام. اختر التحقق من وجود تحديثات، ثم إعادة التشغيل إذا توفر تحديث. واتبع أي إشعار منفصل للمثبّت أيضًا. تحديث Obsidian

هناك فارق مهم بين الإصدارات: تذكر ملاحظات إصدار Obsidian الصادرة في 22 أكتوبر 2026 أن Desktop 1.15.0 إصدار مبكر الوصول، وأن المخططات تستخدم Pele مع التوافق مع صياغة Mermaid 12.1.0. وتذكر الملاحظات نفسها أن Obsidian لم يعد يتضمن Mermaid في ذلك الإصدار. لذا تعامل مع التعليمات التي تفترض أن كل تثبيت لـ Obsidian يضم Mermaid على أنها تعتمد على الإصدار. Obsidian 1.15.0 Desktop (وصول مبكر)

وتزيل ملاحظات الإصدار هذه أيضًا إعداد عرض مخططات Mermaid في الملاحظات في الإصدار 1.15.0. إذا ظهر هذا الإعداد أو مطالبة تفعيله في تثبيتك، فسجّل هذا الاختلاف بدلًا من مواصلة البحث عن عنصر تحكم موصوف لإصدار آخر. Obsidian 1.15.0 Desktop (وصول مبكر)

لأغراض استكشاف الأخطاء وإصلاحها، احتفظ بسجل موجز للمقارنة: إصدار التطبيق، وعرض التحرير أو القراءة، ونص المخطط كما هو، والنتيجة التي ظهرت. صِف النتيجة بوضوح؛ مثلًا: «تظهر مجموعتان، لكن سهم الربط غائب». فهذا أجدى من الاكتفاء بتسجيل أن المخطط معطوب.

قرّر ما إذا كان السهم سيربط بين المجموعات أم العناصر

اختر نقطتي النهاية وفقًا لما يحتاج المخطط إلى توصيله. لعرض علاقة عامة بين المجموعات، ابدأ بمثال الحاويتين. أما للانتقال المحدد بين العناصر، فاستخدم البديل الكامل التالي وقيّمه على حدة.

```mermaid
flowchart LR
    subgraph groupA [Group A]
        A1[Item A1] --> A2[Item A2]
    end
    subgraph groupB [Group B]
        B1[Item B1] --> B2[Item B2]
    end
    A2 --> B1
```

يربط السطر الأخير الآن بين عنصرين مسمّيين عبر حدود المجموعة. تميّز وثائق Mermaid للمخططات الانسيابية بين العقد والروابط والمخططات الفرعية؛ فاستخدم معرّفات نقطتي النهاية المقصودتين باستمرار. صياغة المخططات الانسيابية

إذا أخفق مثال الحاويتين في العارض المثبّت لديك بينما نجح مثال العناصر، فالبديل الثاني عملي عندما تعبّر العلاقة بين عنصرين عن المعنى المقصود. وحافظ على هذا التمييز في المخطط: لا تعرض انتقالًا محددًا بين عنصرين على أنه دليل على اتصال الحاويتين نفسيهما.

عند تعديل أي من المثالين، أجرِ تغييرًا واحدًا في كل مرة. أعد تسمية العناوين الظاهرة أولًا، ثم عاين النتيجة، وبعد ذلك أضف مزيدًا من العناصر. وأجّل التنسيق والتداخل إلى مرحلة لاحقة. يمنح هذا التسلسل كل تعديل غرضًا واضحًا، ويسهّل تحديد أول تغيير ارتبط بظهور المشكلة.

افهم سبب تغيّر اتجاه المخطط الفرعي

توثّق Mermaid أحد قيود التخطيط: عندما تتصل عقدة في مخطط فرعي بشيء خارج مجموعتها، يُتجاهل اتجاه المخطط الفرعي نفسه ويرث اتجاه المخطط الأب. وتقارن وثائقها ذلك بالاتصال بالحاوية. الاتجاه في المخططات الفرعية

لذلك قد يكون السهم صحيحًا رغم اختلاف الترتيب عن قصدك. في المثال الأول، افحص الترتيب الداخلي والأسهم بين المجموعتين كلًّا على حدة. وفي المثال الثاني، تحقّق من نقطتي نهاية العنصرين قبل تقييم التخطيط. وضع في الحسبان اختلاف العارض المذكور أعلاه عند تفسير أي من النتيجتين.

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

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

اعزل سبب المشكلة قبل إعادة بناء المخطط

استخدم تسلسل التشخيص هذا لتحديد الخطوة التالية. وهو أداة إرشادية مستندة إلى الصياغة الموثقة والفروق بين العوارض، وليس قائمة بأعطال مؤكدة.

الملاحظة الفحص التالي ما ينبغي تسجيله
تظهر في الملاحظة نصوص المخطط حرفيًا افحص سياجي الشيفرة الافتتاحي والختامي، ثم انتقل إلى عرض القراءة هل تُعرض الكتلة أصلًا
ينتج المثال المبسط خطأً قارن الكتلة الملصقة بالمثال حرفًا حرفًا نص الخطأ كاملًا
تظهر المجموعات، لكن اتصالها لا يظهر اختبر البديل الكامل الذي يربط بين عنصرين على حدة أي نوع من نقطتي النهاية ينجح
يظهر السهم، لكن الاتجاه الداخلي يتغير راجع القيد الموثق المتعلق بالاتصال بعقدة خارجية هل بقيت مشكلة في الاتصال أم في الترتيب
ينجح المثال حتى استعادة مزيد من المحتوى تراجع عن أحدث إضافة وكرر ذلك التغيير وحده أصغر إضافة ارتبطت بظهور المشكلة
يتصرف النص نفسه بطريقة مختلفة في موضع آخر قارن إصدارات التطبيق والعوارض وأوضاع العرض البيئات والنتائج كما هي

لإجراء مقارنة مستقلة للصياغة، توصي وثائق Obsidian باستخدام المحرر المباشر لـ Mermaid. الصق محتوى المخطط فيه من دون سياجي Markdown المحيطين به. ونجاح العرض في المتصفح دليل مفيد للمقارنة، لكنه لا يثبت تطابق السلوك في إصدار Obsidian لديك. صياغة التنسيق المتقدم

إذا ظلت النتيجة مختلفة داخل Obsidian، فأعد الاختبار المبسط في خزنة وضع الحماية على سطح المكتب. وتشير إرشادات استكشاف الأخطاء وإصلاحها الرسمية من Obsidian إلى فتح المساعدة > خزنة وضع الحماية بوصفه اختبار سطح المكتب لإعادة إنتاج المشكلة خارج إعداد الخزنة المعتادة. كما توصي بتحديث السمات والإضافات المجتمعية وإعادة التشغيل قبل مواصلة التشخيص. نبذة عن فئة تقارير الأخطاء

إذا نجح الاختبار في وضع الحماية، فتحقّق من اختلافات الخزنة الأصلية واحدًا تلو الآخر. وإذا أخفق فيها أيضًا، فاحتفظ بالمثال المبسط، وإصداري التطبيق والمثبّت، ووضع العرض، والنتيجة التي ظهرت كما هي. وقبل الإبلاغ عن المشكلة، ابحث في المنتدى الرسمي عن بلاغ مطابق قائم، كما تطلب إرشادات الإبلاغ من Obsidian. نبذة عن فئة تقارير الأخطاء

اختم بأصغر مخطط يعبّر عن العلاقة المطلوبة. احتفظ باتصال الحاويتين حين تكون المجموعتان هما نقطتي النهاية المقصودتين؛ واستخدم اتصال العناصر حين يتعلق الانتقال بعناصر محددة. بعد أن يظهر هذا الاختيار على نحو مقبول في إصدار Obsidian المثبّت لديك، أعد التفاصيل الإضافية تدريجيًا وتوقف ما دام المخطط واضحًا.

المصادر