استعدّ للإطلاق


قبل أن تصبح جاهزًا لإطلاق مسارك، يُرجى التأكد من إنجاز المهام التالية.

اطلب أيقونة المسار

لكي نصمّم أيقونة للموقع، افتح issue جديدة في مستودع exercism/website-icons، مع الإجابة عن الأسئلة التالية:

  • هل للغة شعار رسمي؟ إذا كان الأمر كذلك
    • أضف رابطًا إلى مثال
    • اذكر متطلبات الإسناد، والحقوق الممنوحة لاستخدام ذلك الشعار
  • هل للغة شعار غير رسمي؟ إذا كان الأمر كذلك
    • اشرح الطرق التي يستخدم بها الناس الشعار غير الرسمي
    • أضف رابطًا إلى مثال
    • اذكر متطلبات الإسناد لذلك الشعار

أضف وثائق المسار

أضف وثائق المسار التالية:

  • docs/ABOUT.md: مقدمة قصيرة عن اللغة.
  • docs/INSTALLATION.md: صف ما يحتاج الطالب إلى تثبيته ليتمكن من العمل على المسار على نظامه المحلي باستخدام واجهة سطر الأوامر.
  • docs/LEARNING.md: روابط إلى مصادر التعلّم.
  • docs/RESOURCES.md: روابط إلى مصادر مفيدة.
  • docs/TESTS.md: صف كل ما يتعلق بتشغيل الاختبارات في المسار.

ستساعد هذه الوثائق الطالب على البدء في المسار، وعلى التعرّف على المسار ولغته. راجع دليل الوثائق لمزيد من المعلومات.

أضف وثائق التمارين

أضف وثائق التمارين التالية:

  • exercises/shared/.docs/help.md: يحتوي على تعليمات خاصة بالمسار حول كيفية الحصول على المساعدة
  • exercises/shared/.docs/tests.md: يحتوي على تعليمات خاصة بالمسار حول كيفية تشغيل الاختبارات

أضف مقتطف كود

أضف مقتطف كود إلى ملف docs/SNIPPET.txt. يمنح هذا المقتطف انطباعًا بصريًا عن شكل صياغة اللغة. راجع دليل الوثائق لمزيد من المعلومات.

حدّث البيانات الوصفية

تُعرَّف البيانات الوصفية للمسار في ملف config.json. ينبغي تحديث الخصائص التالية:

  • language: لغة المسار (مثل "C#"). يجب أن يكون طوله <= 255
  • slug: لغة المسار مكتوبة بحروف صغيرة وبأسلوب kebab-case (مثل "csharp"). يجب أن يكون طوله <= 255
  • blurb: وصف قصير للغة. يجب أن يكون طوله <= 400
  • online_editor: كائن يصف الإعدادات المستخدمة في المحرر على الإنترنت:
    • indent_style: إما "space" أو "tab"
    • indent_size: حجم الإزاحة كعدد صحيح (مثل 4)
    • highlightjs_language: معرّف اللغة الخاص بـ Highlight.js (انظر القائمة الكاملة للمعرّفات). إذا لم يكن هناك دعم لـ Highlight.js، فيمكن حذف هذا الحقل.
  • key_features: السمات الرئيسية للغة، والتي تصف أهم ميزاتها بإيجاز. لمزيد من المعلومات، راجع دليل السمات الرئيسية.
  • tags: حدّد الوسوم التي تنطبق على هذا المسار، مما يتيح البحث عنه في الموقع. لمزيد من المعلومات وقائمة الوسوم المدعومة، راجع دليل الوسوم.