العمل محليًا

تعرّف على كيفية حل التمارين على جهازك

يتيح لك حل التمارين على جهازك المحلي كتابة كل الكود في بيئة مألوفة لديك.

تثبيت واجهة سطر الأوامر

لحل تمرين على جهازك المحلي، عليك أولًا تثبيت واجهة سطر الأوامر الخاصة بـ Exercism وإعدادها باستخدام هذه التعليمات.

الإعداد

عليك أن تخبر واجهة سطر الأوامر بمن أنت حتى نتمكن من تنزيل الملفات بشكل صحيح. يمكنك إيجاد الرمز المميز الخاص بك في صفحة الإعدادات. ثم يمكنك إعداد واجهة سطر الأوامر بالأمر التالي، مع استبدال <your-api-token> بالقيمة الموجودة في صفحة الإعدادات:

exercism configure --token=<your-api-token>

تنزيل التمرين

بعد التثبيت، يمكنك استخدام واجهة سطر الأوامر لتنزيل التمرين إلى جهازك المحلي بالأمر التالي (مع استبدال <exercise-slug> و<track-slug> بالقيم المناسبة:

exercism download --exercise=<exercise-slug> --track=<track-slug>

لا داعي لحفظ بنية هذا الأمر، فصفحة التمرين تعرض الأمر المناسب لذلك التمرين.

بمجرد انتهاء أمر التنزيل، ستُنزَّل ملفات التمرين إلى جهازك المحلي.

حل التمرين

الهدف من كل تمرين هو إنشاء تنفيذ يجتاز جميع الاختبارات. ويُعرف هذا التنفيذ باسم حل.

لمساعدتك في ذلك، يحتوي كل تمرين على الملفات التالية:

  • README.md: التعليمات التي تشرح ما هو المطلوب منك
  • HELP.md: معلومات عن كيفية تشغيل الاختبارات وكيفية الحصول على المساعدة عندما تتعثر
  • HINTS.md (اختياري): تلميحات تساعدك على حل التمرين
  • ملف (ملفات) الاختبار: تحتوي على الاختبارات التي تتحقق من صحة حلك
  • ملف (ملفات) البداية: توفّر نقطة انطلاق تساعدك على البدء في بناء تنفيذك

وحسب المسار، قد توجد ملفات أخرى تتطلبها أدوات المسار لتشغيل الاختبارات.

إرسال الحل

بمجرد أن يجتاز حلك جميع الاختبارات، يمكنك إرساله بالأمر التالي:

exercism submit <implementation_file_paths>

سيرفع هذا الأمر حلك إلى موقع Exercism ويطبع رابط صفحة الحل.

ومرة أخرى، لا داعي لحفظ هذا الأمر، فملف HELP.md الخاص بالتمرين يعرض الأمر الصحيح.

يمكنك إرسال حل غير مكتمل، مما يتيح لك:

  • أن ترى كيف أكمل آخرون التمرين
  • أن تطلب المساعدة من مرشد

وظائف أخرى في واجهة سطر الأوامر

عرض جميع الأوامر

شغّل الأمر الفرعي help للحصول على القائمة الكاملة للأوامر المتاحة.

exercism help

استكشاف الأخطاء وإصلاحها

تأكد من أنك تستخدم أحدث إصدار.

تحقق من الإصدار الذي تستخدمه:

exercism version

قارن إصدارك بأحدث إصدار منشور، وقم بالترقية إن لم يكن إصدارك هو الأحدث.

بعد الترقية، تحقق من الإصدار مرة أخرى. إن لم يتغير الإصدار، فتأكد من أنك تشغّل الملف التنفيذي المحدَّث.

which exercism

إذا واجهت مشكلة بعد ذلك، فافتح بلاغًا في exercism/cli على GitHub مع مخرجات أمر troubleshoot.

exercism troubleshoot

يمكنك فتح بلاغات على متتبع البلاغات الخاص بنا وسيحاول المجتمع مساعدتك. يرجى التأكد من أنك أكملت الجولة التفاعلية قبل فتح أي بلاغ.