تنبيهات Obsidian (Callouts): بناء الجملة والأنواع والأمثلة وتخصيص CSS

تتيح لك تنبيهات Obsidian (Callouts) تمييز محتوى معين وتجميعه وإخفائه داخل ملاحظاتك باستخدام بناء جمل بسيط يعتمد على الاقتباسات (Blockquotes). سواء كنت تريد لفت الانتباه إلى نصائح الامتحان، أو إنشاء قوائم مهام قابلة للطي، أو فصل ملاحظات المؤلف عن نص المخطوطة، توفر التنبيهات طريقة مرنة لتنظيم المعلومات دون إيقاف تدفق الكتابة.

إجابة سريعة: كيفية إنشاء تنبيه (Callout) في Obsidian

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

إليك بناء الجملة الأساسي لإنشاء تنبيه:

> [!note] هذا تنبيه.

• استخدم > [!type] في السطر الأول من كتلة الاقتباس

• استبدل note بنوع آخر مثل tip أو warning أو question

• اضغط Enter وتابع بـ > لإضافة محتوى متعدد الأسطر

• في المعاينة المباشرة (Live Preview)، استخدم لوحة الأوامر وحدد Insert callout لإضافة كتلة تنبيه افتراضية فورًا. يمكنك أيضًا تحديد محتوى حالي وتشغيل نفس الأمر لتغليفه داخل تنبيه.

ما هي تنبيهات Obsidian (Callouts)؟

التنبيهات هي كتل اقتباس منسقة يعرضها Obsidian مع ألوان وأيقونات وسلوك طي اختياري. تم تقديمها في منتصف عام 2022 وأصبحت ميزة أساسية لتنظيم الملاحظات بصريًا.

عندما يواجه Obsidian كتلة اقتباس تبدأ بـ [!type]، فإنه يعالجها بشكل خاص ويعرض صندوق تنبيه مخصص بدلاً من اقتباس عادي. داخل الجسم، يمكنك استخدام بناء جملة Markdown القياسي، والروابط المتشعبة (Wikilinks)، والتضمينات، والمهام، وكتل الكود، والروابط الداخلية.

بصريًا، يظهر التنبيه بشريط جانبي ملون، وأيقونة تنبيه (مثل مصباح ضوئي للنصائح أو علامة تعجب للتحذيرات)، وشريط عنوان اختياري، ونص الجسم في الأسفل.

تشمل الاستخدامات الشائعة:

• تلخيص النقاط الرئيسية في أعلى ملاحظات الاجتماع

• تسليط الضوء على المواد ذات الصلة بالامتحان في ملاحظات الدراسة

• إضافة صناديق حرق الأحداث في التدوينات على الكتب

لاحظ أن التنبيهات تُعرض بهذا الشكل فقط داخل Obsidian. في عارضات Markdown العادية أو على GitHub، تظهر ككتل اقتباس متداخلة عادية — يظل المحتوى قابلاً للقراءة، فقط دون التنسيق البصري.

بناء جملة التنبيهات وإعدادها

يغطي هذا القسم جميع عناصر بناء الجملة: النوع، العنوان، الطي، ومحتوى الجسم.

الهيكل الأساسي يبدو كالتالي:

> [!note] نص العنوان
> يوضع محتوى الجسم هنا
> - النقاط النقطية تعمل أيضًا

يحتوي السطر الأول على ثلاثة أجزاء:

• معرف النوع بين قوسين مربعين: [!note]، [!warning]، [!tip]

• علامة الطي الاختيارية: + أو - بعد النوع مباشرة (مثال: [!tip]-)

• عنوان مخصص اختياري بعد النوع (مثال: [!tip] تلميح الامتحان)

تبدأ أسطر الجسم بـ > مثل كتل الاقتباس العادية ويمكن أن تتضمن نقاطًا، أو كتل كود، أو صورًا، أو خانات اختيار المهام.

الكلمة الرئيسية للنوع غير حساسة لحالة الأحرف — [!NOTE] و [!Note] و [!note] تعمل بشكل متطابق بالنسبة للتنبيهات المدمجة.

تغيير عناوين التنبيهات

افتراضيًا، يستخدم Obsidian اسم النوع كعنوان (مثل “Note” أو “Warning”).

لتجاوز العنوان الافتراضي:

> [!warning] اقرأ هذا قبل النشر

قارن بين هذين الأسلوبين:

• > [!tip] يُعرض مع العنوان الافتراضي “Tip”

• > [!tip] سير عمل أسرع يُعرض بدلاً من ذلك “سير عمل أسرع”

التنبيه الذي يحتوي على عنوان فقط يعمل أيضًا — فقط استخدم سطرًا واحدًا مثل > [!info] متطلبات النظام دون أسطر جسم تالية.

يمكن أن تحتوي العناوين على رموز تعبيرية ورابط وسائط وتنسيقات مثل النص العريض.

تنبيهات قابلة للطي (Collapsible)

إضافة علامة زائد أو ناقص بعد النوع مباشرة تتحكم فيما إذا كان التنبيه قابلاً للطي:

• > [!note]+ موسع دائمًا افتراضيًا

• > [!note]- مطوي افتراضيًا

كلا العلامتين تجعلان التنبيه قابلاً للطي. تحدد العلامة ما إذا كان يبدأ مفتوحًا أم مغلقًا.

تشمل الاستخدامات العملية للتنبيهات القابلة للطي:

• إخفاء الحلول التفصيلية في ملاحظات الدراسة

• طي قوائم التحقق الطويلة تحت عنوان [!todo]-

• إخفاء حرق الأحداث في ملاحظات الكتب

في مودي القراءة والمعاينة المباشرة، ينقر المستخدمون على أيقونة المثلث للتوسيع أو الطي. في مود المصدر، تظهر علامة الطي كـ Markdown خام.

التنبيهات المتداخلة

يمكنك تداخل التنبيهات عن طريق وضع كتلة تنبيه أخرى داخل جسم التنبيه الرئيسي.

تستخدم أسطر التنبيه الداخلي رمز > إضافي لكل مستوى تداخل:

> [!warning] مشكلة محتملة
>> [!tip] إليك حلاً بديلاً

ينشئ هذا تنبيه تحذير يحتوي على نصيحة متداخلة. مثال آخر: [!question] يحتوي على إجابات [!example] متداخلة.

قم بتحديد عمق التداخل لسهولة القراءة — مستويان يكفيان عادةً.

أنواع التنبيهات المدعومة في Obsidian

يأتي Obsidian بأنواع مدمجة، كل منها مربوط بلون وأيقونة. الأنواع غير المدعومة ترجع افتراضيًا إلى تنسيق note.

الأنواع الافتراضية الشائعة وأسماؤها المستعارة:

• note: معلومات عامة

• abstract / summary / tldr: ملخصات

• info: سياق إضافي

• todo: المهام وعناصر العمل

• tip / hint / important: النصائح والنقاط الرئيسية

• success / check / done: العناصر المكتملة

• question / help / faq: الأسئلة

• warning / caution / attention: المشاكل المحتملة

• failure / fail / missing: المعلومات المفقودة

• danger / error: المشاكل الخطيرة

• bug: أخطاء البرامج

• example: أمثلة الكود أو المفاهيم

• quote / cite: الاقتباسات المظللة

يمكن لسمات المجتمع (Themes) المختلفة إعادة إعادة تنسيق هذه الأنواع، لذا قد يبدو نفس الـ [!warning] مختلفًا عبر السمات.

في المعاينة المباشرة، انقر بزر الماوس الأيمن على الهامش الجانبي للتنبيه لتغيير نوعه من قائمة سياقية بدلاً من تحرير Markdown يدوياً.

تُعرض الأنواع غير معروفة مثل [!idea] بصريًا كـ note ولكنها تظل متاحة للاستهداف عبر CSS.

أي تنبيه يجب أن تستخدم؟

يتحكم النوع في الإشارة، وليس فقط في اللون. اختر اتفاقية صغيرة تخبرك بما يجب فعله عند مسح الملاحظة لاحقًا:

ما تحتاج إلى الإشارة إليه	نوع بداية جيد	نمط مفيد
سياق أو تعريف	info أو abstract	ضع الشرح بجوار الادعاء الذي يدعمه.
إجراء تالٍ	todo	اجعل قائمة التحقق قريبة من سياق المشروع أو الاجتماع.
قرار أو خطر	question أو warning أو نوع مخصص	اجعل النقطة غير المحسومة مرئية دون دفنها في النص.
تفصيل تحتاج إليه أحيانًا فقط	example أو note قابل للطي	استخدم - لإبقاء التفاصيل الفرعية مطوية افتراضيًا.
نتيجة مكتملة	success أو done	خصصها لنتيجة فعلية وليس لكل جملة إيجابية.

بالنسبة لخزانة الإنتاجية، فإن الحد الأدنى العملي هو todo للإجراءات، و warning للمحاصرات، و question للقرارات المفتوحة، و summary لملاحظات المراجعة.

طرق عملية لاستخدام التنبيهات في خزانتك

إليك كيفية توافق التنبيهات مع مسارات العمل الحقيقية:

• الدراسة والتعلم: استخدم [!tip] لنصائح الامتحان، و [!question]- لأسئلة التمارين مع حلول مطوية، و [!summary] في أعلى ملاحظات المحاضرة

• تطوير البرمجيات: أضف [!warning] حول الأوامر المدمرة، و [!bug] للمشاكل المعروفة، و [!example] لمقتطفات استخدام API

• إدارة المشاريع والمهام: احفظ قوائم التحقق في تنبيهات [!todo]+ مجمعة حسب المرحلة، وحولها إلى [!success] عند الانتهاء

• الكتابة طويلة Form: افصل ملاحظات المؤلف باستخدام [!note]- أو أنواع مخصصة، وعلم أدلة الحبكة كـ [!clue] في المسودات

• قاعدة المعرفة الشخصية: استخدم [!info] للحقائق الرئيسية، و [!quote] للاقتباسات، و [!danger] للتحذيرات الحرجة

امزج التنبيهات مع قوالب Obsidian الجاهزة. ولمسارات الاجتماعات، راجع دليل قوالب الاجتماعات في Obsidian.

التنبيهات للمهام وقوائم التحقق

تتصرف المهام داخل التنبيهات كمهام Obsidian العادية وتظهر في البحث العالمي للمهام.

ينشئ تنبيه [!todo] تجميعة لخانات الاختيار المرتبطة:

> [!todo]+ قائمة تحقق الإصدار 1.2
> - [ ] تحديث CHANGELOG للإصدار بتاريخ 2025-04-01
> - [ ] تشغيل اختبارات الانحدار

غير النوع من todo إلى success للإشارة بصريًا إلى إكمال كتلة بالكامل.

التنبيهات في مسارات النشر

التنبيهات هي أدوات تحرير داخلية وغالبًا لا ينبغي أن تظهر في الصادرات النهائية مثل الكتب أو ملفات PDF أو منشورات المدونة.

تسمح إضافات مثل Longform بإضافة خطوة معالجة مسبقة لإزالة ترميز التنبيهات قبل التجميع. يمسح سكريبت الأسطر التي تبدأ بـ > [! ويزيل الغلاف مع الاحتفاظ بالجسم أو التخلص منه.

تخصيص التنبيهات باستخدام CSS

يكشف Obsidian التنبيهات عبر سمات data-callout، مما يتيح لك تعريف أنواع مخصصة باستخدام CSS مخصص.

النمط:

1. اختر معرف نوع مخصص مثل idea

2. استخدمه في الملاحظات: > [!idea] مفهوم منتج جديد

3. في CSS، استهدف .callout[data-callout="idea"] بألوان وأيقونة فريدة.

يستخدم Obsidian أيقونات Lucide. واجهة برمجة تطبيقات CSS المدعومة تستخدم --callout-color و --callout-icon؛ يسرد مرجع المطور لمتغيرات CSS للتنبيهات المتغيرات المتاحة.

أمثلة على تنبيهات مخصصة مفيدة

أفكار أنواع مخصصة ملموسة:

• [!clue]: لكتاب الغموض لتتبع أدلة الحبكة عبر الفصول

• [!risk]: في وثائق الهندسة للإشارة إلى المخاطر التقنية أو التجارية

• [!meeting]: لملخصات الإجراءات في أعلى ملاحظات الاجتماع المؤرخة

• [!definition]: في قاعدة المعرفة لتوحيد مدخلات المصطلحات

أضف هذه الأنماط بإضافة مقتطف (snippet) CSS في مجلد .obsidian/snippets بـ خزانتك.

إصلاح مشاكل CSS المخصصة

تحقق من هذه بالترتيب:

1. ضع ملف CSS في مجلد .obsidian/snippets بالخزانة، وقم بتمكينه في الإعدادات ← المظهر ← مقتطفات CSS، وأعد تحميل المقتطفات.
2. طابق النوع في الملاحظة والمحدد بدقة. على سبيل المثال، [!decision] يتطلب .callout[data-callout="decision"].
3. احرص على أن تكون أسماء الأنواع المخصصة بأحرف صغيرة في كلا المكانين. المعرفات المدمجة غير حساسة لحالة الأحرف، لكن تقرير استكشاف أخطاء في منتدى Obsidian يوضح أن عدم تطابق حالة الأحرف قد يمنع المحدد المخصص من العمل.
4. استخدم أيقونة مضمنة في إصدار Obsidian المثبت لديك.

البحث عن التنبيهات وإدارتها وتصديرها

ابحث عن التنبيهات باستخدام استعلامات مثل "[!todo]" للعثور على جميع تنبيهات المهام. ادمجها مع فلاتر المسار: path:"Drafts" "[!clue]".

القيود وملاحظات التوافق

التنبيهات (Callouts) ليست جزءًا من مواصفات CommonMark القياسية. في محررات مثل Typora أو على GitHub، تتراجع إلى اقتباسات مضمنة عادية.

تعرضها بعض تطبيقات Markdown على الأجهزة المحمولة كنص عادي — يظل المحتوى قابلًا للقراءة ولكن بدون ألوان أو أيقونات.

قد يؤدي الاستخدام المكثف للتنبيهات المضمنة والقابلة للطي إلى إبطاء العرض على الأجهزة المحمولة القديمة.

اختبر عمليات التصدير (PDF، DOCX، HTML) بشكل دوري للتحقق من ظهور المحتوى المهم داخل التنبيهات بشكل صحيح. فكّر في الاحتفاظ بدليل نمط داخل خزانتك حتى يتبع المساهمون نفس الاتفاقيات.

أخطاء بناء الجملة الشائعة

يجب أن تلامس علامة الطي مُعَرِّف النوع مباشرةً:

> [!faq]- مطوي افتراضيًا
> يبدأ هذا المحتوى مخفيًا.

تتضمن > [!faq] - مطوي افتراضيًا مسافة قبل الواصلة، لذا ليست هذه هي صيغة الطي الموثقة. إذا لم يظهر الطي، فحقّق من كون الملاحظة في وضع القراءة أو المعاينة الحية وقارن المكتل بالمثال الرسمي. حدد تقرير منتدى Obsidian لعام 2024 المسافة الإضافية كسبب لعدم طي التنبيه.

التنبيهات (Callouts) هي امتداد لـ Obsidian وليست جزءًا من CommonMark القياسي. إذا ظهر التنبيه اقتباسًا عاديًا في محرر Markdown آخر، فهذا أمر متوقع؛ يظل المحتوى قابلًا للقراءة، لكن أنماط Obsidian وسلوك الطي لن ينتقلا معه.

الخلاصة

تنبيهات Obsidian هي كتل اقتباس محسّنة تتيح لك تمييز المعلومات وتجميعها وإخفائها اختياريًا دون الإخلال بتدفق ملاحظاتك.

الوجبات الرئيسية:

• تعلم بناء الجملة الأساسي: > [!type] العنوان

• اختر مجموعة صغيرة من الأنواع التي تناسب سير عملك

• أضف CSS مخصصًا فقط حيث يدعم عمليتك

إذا كنت تريد توصيل الملاحظات اليومية والمشاريع والمراجعات وقوالب الاجتماعات من البداية، فإن Obsibrain يوفر نظامًا محليًا جاهزًا لـ Obsidian.