يشرح هذا الدليل كيفية تحديد لغة البرمجة المستخدمة في كتل التعليمات البرمجية ضمن منشورات Discourse، بالإضافة إلى كيفية منع تمييز بناء الجملة.
مستوى المستخدم المطلوب: جميع المستخدمين
عندما تحيط التعليمات البرمجية بثلاثة من علامات الاقتباس العكسية في منشوراتك، يستخدم Discourse مكتبة highlight.js للكشف التلقائي عن بناء الجملة وتطبيقه على التعليمات البرمجية. ومع ذلك، يمكنك تحديد لغة البرمجة إذا لم يعمل الكشف التلقائي كما هو متوقع.
تحديد لغة البرمجة لكتل التعليمات البرمجية
لتحديد لغة البرمجة لكتلة تعليمات برمجية، اكتب اسم اللغة مباشرة بعد المجموعة الأولى من علامات الاقتباس العكسية:
``` your_language
# الكود الخاص بك هنا
```
على سبيل المثال، لتحديد لغة Ruby:
``` ruby
3.times do |stuff|
stuff.do
end
```
ستبدو النتيجة كما يلي:
3.times do |stuff|
stuff.do
end
يجب أن تكون اللغة إحدى “اللغات المميزة” (highlighted languages) المكونة لتمييز بناء الجملة على موقعك. إذا كانت اللغة لا تعمل، استشر مسؤول الموقع.
منع التمييز
إذا كنت ترغب في منع أي تمييز لبناء الجملة، يمكنك استخدام text أو plain أو pre كلغة:
``` text
النص الخاص بك الذي لا تريد تمييزه هنا
```
ستظهر النتيجة كنص عادي بدون أي تمييز:
النص الخاص بك الذي لا تريد تمييزه هنا
أفضل الممارسات
- حدد اللغة دائمًا إذا كان الكشف التلقائي لا يتعرف على التعليمات البرمجية الخاصة بك بشكل صحيح.
- للمسؤولين: تأكد من التحقق من أن اللغة المختارة مهيأة في إعداد الموقع “اللغات المميزة” (highlighted languages).