استخدم وسائل الشرح لتضمين محتوى إضافي دون أن تؤثر على تسلسل الملاحظات الخاصة بك. لإنشاء وسيلة شرح، أضف `[!info]` على السطر الأول من وسيلة الشرح، حيث `[!info]` هو معرّف النوع. يحدد معرّف النوع كيفية ظهور وسائل الشرح. لرؤية جميع الأنواع المتاحة، راجع [[#الأنواع المدعومة|الأنواع المدعومة]]. ```md > [!info] معلومة > هنا كتلة وسيلة الشرح. > يدعم **Markdown**، [[روابط داخلية|روابط الويكي]]، و [[تضمين الملفات|التضمين]] > > ![[og-image.png]] ``` > [!info] معلومة > هنا كتلة وسيلة الشرح. > يدعم **Markdown**، [[الروابط الداخلية|روابط الويكي]]، و [[تضمين الملفات|التضمين]] > > ![[og-image.png]] وسائل الشرح مدعومة أيضًا بشكل طبيعي على [[مقدمة إلى Obsidian Publish|Obsidian Publish]]. > [!note] ملحوظة > إذا كنت تستخدم أيضًا إضافة Admonitions، فيجب عليك تحديثها لإصدار 8.0.0 على الأقل لتجنب المشاكل مع ميزة وسائل الشرح الجديدة. ### تغيير العنوان بشكل افتراضي، يحدد عنوان معرّف نوع وسيلة الشرح بكلمات إنجليزية معينة تبدأ بحروف كبيرة. يمكنك تغييره عن طريق إضافة نص بعد "معرّف النوع": ```md > [!tip] يمكن لوسائل الشرح أن تحتوي على عناوين مخصصة > مثل هذا وسيلة الشرح. ``` > [!tip] يمكن لوسائل الشرح أن تحتوي على عناوين مخصصة > مثل هذا وسيلة الشرح. يمكنك حتى أهمال المحتوي لإنشاء وسيلة شرح يحتوي فقط على عنوان: ```md > [!tip] وسيلة شرح بعنوان فقط ``` > [!tip] وسيلة شرح بعنوان فقط ### وسائل الشرح قابلة للطي يمكنك جعل وسائل الشرح قابله للطي عن طريق إضافة علامة زائد `+` أو ناقص `-` مباشرة بعد معرّف النوع. إشارة الزائد تمكّن وسائل الشرح من التوسع افتراضيًا، وإشارة الناقص تطوي بدلاً من ذلك. ```md > [!سؤال]- هل وسائل الشرح قابلة للطي؟ > نعم! في وسائل الشرح القابلة للطي، تختفي المحتويات عندما يتم طي وسيلة الشرح. ``` > [!سؤال]- هل وسائل الشرح قابلة للطي؟ > نعم! في وسائل الشرح القابلة للطي، تختفي المحتويات عندما يتم طي وسيلة الشرح. ## وسائل شرح متداخلة يمكنك تداخل وسائل الشرح في مستويات متعددة. ```md > [!question] هل يمكن تداخل وسائل الشرح؟ > > > [!todo] نعم، يمكن ذلك. > > > > > [!example] يمكنك حتى استخدام عدة طبقات من التداخل. ``` > [!question] هل يمكن تداخل وسائل الشرح؟ > > > [!todo] نعم، يمكن ذلك. > > > > > [!example] يمكنك حتى استخدام عدة طبقات من التداخل. ### تخصيص وسائل شرح يمكن [[مقتطفات CSS|لمقتطفات CSS]] و [[المكوّنات الإضافية المجتمعية|المكوّنات الإضافية المجتمعية]] تعريف وسائل شرح مخصصة، أو حتى استبدال التكوين الافتراضي. لتعريف وسيلة شرح مخصصة، أنشئ كتلة CSS التالية: ```css .callout[data-callout="نوع-سؤال-مخصص"] { --callout-color: 0, 0, 0; --callout-icon: lucide-alert-circle; } ``` قيمة السمة `data-callout` هي معرّف النوع الذي تريد استخدامه، على سبيل المثال ` [!نوع-سؤال-مخصص]`. - <code dir="ltr">--callout-color</code> يحدد لون الخلفية باستخدام الأرقام (0-255) للأحمر والأخضر والأزرق. - <code dir="ltr">--callout-icon</code> يمكن أن يكون معرّف الأيقونة من [lucide.dev](https://lucide.dev)، أو عنصر SVG. > [!تحذير] ملاحظة حول إصدارات أيقونات Lucide > يقوم Obsidian بتحديث أيقونات Lucide بشكل دوري. الإصدار الحالي المضمن مبين أدناه؛ استخدم هذه الأيقونات في تخصيص وسائل الشرح. > ![[الاعتمادات#^lucide]] > [!tip] أيقونات SVG > بدلاً من استخدام أيقونة Lucide، يمكنك أيضُا استخدام عنصر SVG كأيقونة لوسيلة الشرح. > > ``` > --callout-icon: '<svg>...custom svg...</svg>'; > ``` ## الأنواع المدعومة يمكنك استخدام العديد من الأنواع والأسماء المستعارة لوسائل الشرح. كل نوع يأتي مع لون خلفية وأيقونة مختلفة. لاستخدام هذه الأشكال الافتراضية، قم بتغيير `note` في الأمثلة بأي من هذه الأنواع، مثل `[!tip]` أو `[!warning]`. ما لم تقوم [[#تخصيص وسائل شرح|بتخصيص وسائل الشرح]]، فإن أي نوع غير مدعوم يتم تعيينه افتراضيًا على النوع `note`. معرف النوع غير حساس لحالة الأحرف. > [!note] ملاحظة > > ```md > > [!note] ملاحظة > > لوريم ايبسوم دولار سيت أميت > ``` --- > [!abstract] الخلاصة > > ```md > > [!abstract] الخلاصة > > لوريم ايبسوم دولار سيت أميت > ``` أسماء مستعارة: `summary` و `tldr` --- > [!info]- معلومة > > ```md > > [!info] معلومة > > لوريم ايبسوم دولار سيت أميت > ``` --- > [!todo]- مهام > > ```md > > [!todo] مهام > > لوريم ايبسوم دولار سيت أميت > ``` --- > [!tip]- تلميح > > ```md > > [!tip] تلميح > > لوريم ايبسوم دولار سيت أميت > ``` ^8c56e5 أسماء مستعارة: `hint` و `important` --- > [!success]- نجاح > > ```md > > [!success] نجاح > > لوريم ايبسوم دولار سيت أميت > ``` أسماء مستعارة: `check`, `done` --- > [!question]- سؤال > > ```md > > [!question] سؤال > > لوريم ايبسوم دولار سيت أميت > ``` أسماء مستعارة: `help`و `faq` --- > [!warning]- تحذير > > ```md > > [!warning] تحذير > > لوريم ايبسوم دولار سيت أميت > ``` أسماء مستعارة: `caution`و `attention` --- > [!failure]- فشل > > ```md > > [!failure] فشل > > لوريم ايبسوم دولار سيت أميت > ``` أسماء مستعارة: `fail`و `missing` --- > [!danger]- خطر > > ```md > > [!danger] خطر > > لوريم ايبسوم دولار سيت أميت > ``` اسم مستعار: `error` --- > [!bug]- خلل > > ```md > > [!bug] خلل > > لوريم ايبسوم دولار سيت أميت > ``` --- > [!example]- مثال > > ```md > > [!example] مثال > > لوريم ايبسوم دولار سيت أميت > ``` --- > [!quote]- اقتباس > > ```md > > [!quote] اقتباس > > لوريم ايبسوم دولار سيت أميت > ``` اسم مستعار: `cite`