إبراز الصياغة الثابت

الإبراز الثابت للصياغة هو إبراز الكود الذي لا يستطيع المستخدم تغييره. ويشمل ذلك مقاطع الكود والتكرارات وغيرها.

التنفيذ

يتم الإبراز الثابت للصياغة باستخدام مكتبة highlightjs.

عند إضافة الدعم للغة مسارك، أمامك ثلاثة خيارات:

1. أن تكون اللغة مدعومة بشكل جاهز من highlightjs (أي أنها مدرجة ضمن اللغات المدعومة). وفي هذه الحالة، انتقل إلى قسم إعداد المسار.
2. أن تكون اللغة مدعومة عبر إضافة موجودة من إضافات highlightjs. وفي هذه الحالة، انتقل إلى قسم استخدام إضافة موجودة.
3. ألّا تكون اللغة مدعومة. وفي هذه الحالة أمامك ثلاثة خيارات:
   1. أن تكتب إضافة highlightjs من الصفر، كما هو موضح في قسم إنشاء إضافة جديدة.
   2. أن تشبه صياغة لغتك صياغة لغة أخرى (تشابهًا وثيقًا)، مثلما تشبه صياغة Unison صياغة Haskell، وفي هذه الحالة يمكنك التفكير في استخدام إبراز الصياغة الخاص بتلك اللغة للغتك. راجع قسم إعداد المسار لمزيد من المعلومات.
   3. ألّا تستخدم الإبراز الثابت للصياغة.

إعداد المسار

لتفعيل دعم highlightjs للغة مسارك، ستحتاج إلى تعديل ملف config.json الخاص بالمسار. داخل ملف config.json، أضف أو اضبط المفتاح online_editor.highlightjs_language على معرّف اللغة المناسب في highlightjs (والموجود في التوثيق).

مثال

{
  "online_editor": {
    "highlightjs_language": "csharp"
  }
}

استخدام إضافة موجودة

لاستخدام إضافة موجودة، يجب أن تكون منشورة على NPM. وإذا لم تكن الإضافة منشورة على NPM، فأمامك أحد الخيارات التالية:

1. أن تسأل مؤلف الإضافة إن كان يرغب في نشرها على NPM.
2. أن تنشئ نسخة متفرعة من المستودع وتنشرها بنفسك.
3. أن ننشئ نحن (Exercism) نسخة متفرعة من المستودع ونتولى نشرها. وللقيام بذلك، افتح موضوعًا في المنتدى طالبًا ذلك.

الخطوة التالية هي تفعيل الإضافة.

تفعيل الإضافة

لتفعيل إضافة (يجب أن تكون منشورة على NPM)، افتح موضوعًا في المنتدى تطلب فيه أن نضيف دعم هذه الإضافة إلى الموقع. وسننشئ نحن (Exercism) عندئذ طلب سحب يضيف الإضافة إلى الموقع. وبعد دمج طلب السحب، يمكنك تفعيل دعم highlightjs باتباع التعليمات الواردة في قسم إعداد المسار.

إنشاء إضافة جديدة

إذا أردت إنشاء إضافة، فأمامك خياران لاستضافتها:

1. أن تنشئ مستودعًا على حسابك الشخصي وتنشره بنفسك.
2. أن ننشئ نحن (Exercism) مستودعًا ونتولى نشره. وللقيام بذلك، افتح موضوعًا في المنتدى طالبًا ذلك.

وبعد أن يصبح لديك مستودع، اتبع تعليمات المساهمة بلغة جديدة لتنفيذ الإضافة.

ثم ستحتاج إلى نشر الإضافة على NPM. الخطوة التالية هي تفعيل الإضافة.

استخدام لغة مختلفة

أن تشبه صياغة لغتك صياغة لغة أخرى (تشابهًا وثيقًا)، وفي هذه الحالة يمكنك التفكير في استخدام إبراز الصياغة الخاص بتلك اللغة للغتك. وللقيام بذلك، اضبط المسار على استخدام معرّف اللغة في highlightjs الخاص باللغة الأخرى. راجع قسم إعداد المسار لمزيد من المعلومات.