يوضح هذا الدليل المرجعي جميع خيارات التنسيق المتاحة في مشاركات Discourse، بما في ذلك markdown و BBCode و HTML. يحدد ما هو مدعوم ويوفر موارد يمكنك من خلالها رؤية الأمثلة.
مستوى المستخدم المطلوب: جميع المستخدمين
فهم التنسيق المدعوم في المشاركات
في حين أن النص العادي كافٍ لمعظم الردود، يسمح Discourse للمستخدمين بتحسين تنسيق مشاركاتهم باستخدام markdown و BBCode و HTML. يشرح هذا الدليل أنواع التنسيق المدعومة وكيفية استخدامها بفعالية.
يمكنك أيضًا ممارسة بعض الأساسيات في برنامج تعليمي تفاعلي عن طريق إرسال رسالة خاصة إلى @discobot هنا أو على أي موقع Discourse.
ملخص
يغطي هذا الدليل:
- بناء جملة markdown المدعوم
- علامات BBCode المدعومة
- علامات وسمات HTML المدعومة والآمنة
أفضل الممارسات
- استخدم markdown في المقام الأول لبساطته وقابليته للقراءة.
- اخلط بين markdown و BBCode فقط عند الضرورة، وحافظ على الاستخدام متسقًا.
- قلل من استخدام HTML إلى علامات بسيطة وآمنة لتجنب مشكلات التنسيق وضمان أمان المشاركات.
markdown المدعوم
يستخدم Discourse markdown-it لتنفيذ markdown الخاص به.
تتضمن بعض ميزات markdown شائعة الاستخدام ما يلي:
-
غامق:
**text** -
مائل:
*text* -
رابط:
[title](https://example.com) -
رمز مضمن:`code` -
تمييز:
<mark></mark> -
كتلة التعليمات البرمجية:
``` كتلة التعليمات البرمجية ```
في المشاركات الأطول (مثل هذه)، قد يكون من المفيد أيضًا إضافة هيكل باستخدام العناوين:
# العنوان 1
## العنوان 2
### العنوان 3
ملاحظة: عند تحميل صورة، سيتم إنشاء بناء جملة markdown للإشارة إلى الصورة تلقائيًا.
للحصول على قائمة كاملة بميزات markdown، يرجى الرجوع إلى الدليل التفاعلي.
BBCode المدعوم
يدعم Discourse مجموعة فرعية من علامات BBCode الشائعة، يتم إنشاء بعضها تلقائيًا لدعم التنسيق الخاص، على سبيل المثال عند اقتباس مشاركة في ردك:
[quote=“user”]نص مقتبس[/quote]
[quote="user"]quoted text[/quote]
يمكنك أيضًا استخدام BBCode لوضع علامة على النص المخفي كـ “مفسد” أو كـ “تفاصيل”
نص مفسد
[spoiler]spoiled text[/spoiler]
[details=“انقر للتوسيع”]نص مخفي[/details]
[details="click to expand"]hidden text[/details]
يتم أيضًا دعم علامات BBCode للتنسيق البسيط الذي يدعمه markdown أو:
[b]نص عريض[/b][i]تأكيد[/i][u]تسطير[/u][s]تخطي[/s][ul][li]الخيار الأول[/li][/ul][img]http://example.com/image.png[/img][url]http://example.com[/url][code]code[/code]
للحصول على قائمة كاملة بعلامات BBCode المدعومة والأمثلة، تحقق من اختبارات Discourse BBCode.
HTML المدعوم
يدعم Discourse مجموعة فرعية آمنة من HTML. بينما يمكنك مزج HTML مع markdown، يُسمح فقط بعلامات وسمات HTML محددة لضمان الأمان والتنسيق المتسق.
تتضمن بعض علامات HTML المسموح بها ما يلي:
<a href="https://example.com">link</a><strong>نص عريض</strong><em>نص مائل</em><ul><li>عنصر القائمة</li></ul><img src="https://example.com/image.png" alt="description">
للحصول على قائمة مفصلة بعلامات وسمات HTML المسموح بها، راجع قائمة السماح الخاصة بـ Discourse.
ملاحظة: الأنماط المضمنة، مثل <span style="color:red">نص ملون</span>، غير مدعومة. للحصول على أنماط مخصصة، راجع تخصيص محتويات المشاركة.
المشكلات الشائعة والحلول
- عدم عمل علامات BBCode أو HTML: تأكد من أن العلامات التي تستخدمها جزء من المجموعة الفرعية المدعومة.
- إزالة الأنماط المضمنة: لا يدعم Discourse الأنماط المضمنة لأسباب أمنية. استخدم أنماطًا مخصصة أو إضافات إذا لزم الأمر.
- تغيير التنسيق عند اللصق من محررات أخرى: قد لا يتم عرض بعض تنسيقات النص الغني بشكل صحيح. استخدم markdown لتنسيق النص باستمرار.
الأسئلة الشائعة
س: هل يمكنني استخدام الجداول في Discourse؟
ج: نعم، يمكنك استخدام markdown لإنشاء جداول. لمزيد من المعلومات، راجع هذا الدليل حول الجداول.
س: لماذا لا يعمل النمط المضمن الخاص بي؟
ج: لا يدعم Discourse الأنماط المضمنة في HTML لأسباب أمنية. فكر في استخدام BBCode مخصص أو دليل الأنماط المخصص لـ Discourse.
س: هل يمكنني إضافة علامات BBCode مخصصة؟
ج: نعم، يمكنك إضافة علامات BBCode مخصصة. راجع إضافة Discourse BBCode لمزيد من المعلومات.
موارد إضافية
- دليل markdown التفاعلي: https://markdown-it.github.io/
- تخصيص محتويات المشاركة: Customize posts' contents with your own styles
- إضافة Discourse BBCode: Discourse BBCode
