يشرح دليل المرجع هذا جميع خيارات التنسيق المتاحة في منشورات Discourse، بما في ذلك ترميز ماركداون (markdown)، وBBCode، وHTML. ويوضح ما هو مدعوم ويوفر مصادر يمكنك من خلالها رؤية الأمثلة.
مستوى المستخدم المطلوب: جميع المستخدمين
فهم التنسيق المدعوم في المنشورات
على الرغم من أن النص العادي كافٍ لمعظم الردود، يسمح Discourse للمستخدمين بتحسين تنسيق منشوراتهم باستخدام ترميز ماركداون، وBBCode، وHTML. يشرح هذا الدليل أنواع التنسيق المدعومة وكيفية استخدامها بفعالية.
يمكنك أيضًا التدرب على بعض الأساسيات في برنامج تعليمي تفاعلي عن طريق إرسال رسالة خاصة إلى @discobot هنا أو على أي موقع Discourse.
ملخص
يغطي هذا الدليل:
- بناء جملة ماركداون المدعومة
- وسوم BBCode المدعومة
- وسوم وسمات HTML المدعومة والآمنة
أفضل الممارسات
- استخدم ترميز ماركداون بشكل أساسي لبساطته وسهولة قراءته.
- اخلط بين ترميز ماركداون وBBCode فقط عند الضرورة، وحافظ على اتساق الاستخدام.
- اقتصر على استخدام HTML على الوسوم البسيطة والآمنة لتجنب مشكلات التنسيق وضمان أمان المنشورات.
ترميز ماركداون المدعوم
يستخدم Discourse markdown-it لتنفيذ ترميز ماركداون الخاص به.
تشمل بعض ميزات ترميز ماركداون الشائعة الاستخدام ما يلي:
- نص عريض:
`**text**` - نص مائل:
`*text*` - رابط:
`[title](https://example.com)` كود مضمن:code- تمييز:
`<mark></mark>` - اقتباس ككتلة:
`> نص مقتبس` - كتلة كود:
``` كتلة كود ```
في المنشورات الأطول (مثل هذا المنشور)، قد يكون من المفيد أيضًا إضافة هيكل باستخدام العناوين:
# عنوان 1
## عنوان 2
### عنوان 3
ملاحظة: عند تحميل صورة، سيتم إنشاء بناء جملة ترميز ماركداون للإشارة إلى الصورة تلقائيًا.
للحصول على قائمة كاملة بميزات ترميز ماركداون، يرجى الرجوع إلى الدليل التفاعلي.
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 للتنسيق البسيط الذي يدعمه ترميز ماركداون أو يتم دعمه:
[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]
للحصول على قائمة كاملة بوسوم BBCode المدعومة والأمثلة، تحقق من اختبارات Discourse BBCode.
HTML المدعوم
يدعم Discourse مجموعة فرعية آمنة من HTML. بينما يمكنك مزج HTML مع ترميز ماركداون، يُسمح فقط بوسوم وسمات HTML محددة لضمان الأمان والتنسيق المتسق.
تشمل بعض وسوم HTML المسموح بها ما يلي:
<a>link</a><strong>نص عريض</strong><em>نص مائل</em><ul><li>عنصر قائمة</li></ul><img src="https://example.com/image.png" alt="description">
للحصول على قائمة مفصلة بالوسوم والسمات المسموح بها في HTML، راجع قائمة السماح في Discourse.
ملاحظة: الأنماط المضمنة (Inline styles)، مثل <span>نص ملون</span>، غير مدعومة. للحصول على أنماط مخصصة، راجع تخصيص محتويات المنشورات.
المشكلات الشائعة والحلول
- عدم عمل وسوم BBCode أو HTML: تأكد من أن الوسوم التي تستخدمها جزء من المجموعة الفرعية المدعومة.
- إزالة الأنماط المضمنة: لا يدعم Discourse الأنماط المضمنة لأسباب أمنية. استخدم أنماطًا مخصصة أو إضافات (plugins) إذا لزم الأمر.
- تغيير التنسيق عند اللصق من محررين آخرين: قد لا يتم عرض بعض تنسيقات النص الغني بشكل صحيح. استخدم ترميز ماركداون لتنسيق النص بشكل متسق.
الأسئلة الشائعة
س: هل يمكنني استخدام الجداول في Discourse؟
ج: نعم، يمكنك استخدام ترميز ماركداون لإنشاء جداول. لمزيد من المعلومات، راجع هذا الدليل حول الجداول.
س: لماذا لا يعمل النمط المضمن الخاص بي؟
ج: لا يدعم Discourse الأنماط المضمنة في HTML لأسباب أمنية. فكر في استخدام BBCode مخصص أو دليل الأنماط المخصص لـ Discourse.
س: هل يمكنني إضافة وسوم BBCode مخصصة؟
ج: نعم، يمكنك إضافة وسوم BBCode مخصصة. راجع إضافة Discourse BBCode لمزيد من المعلومات.
موارد إضافية
- دليل ترميز ماركداون التفاعلي: https://markdown-it.github.io/
- تخصيص محتويات المنشورات: Customize posts' contents with your own styles
- إضافة Discourse BBCode: Discourse BBCode
