مستخرج المقتطفات

يأخذ مستخرج المقتطفات حلّ الطالب ويستخرج منه أول عشرة أسطر «مثيرة للاهتمام» من الكود. ويُعرض المقتطف المستخرج على صفحات متعددة في الموقع.

افتراضيًا، تُعرض الأسطر العشرة الأولى، مع تجاهل الأسطر الفارغة في البداية. وقد تتضمن هذه الأسطر العشرة أشياء مثل التعليقات، وهي عادةً ليست الخيار الأمثل لعرضها في مقتطف.

تخصيص استخراج المقتطفات

نوصي بأن يخصّص كل مسار استخراج المقتطفات، ولو لإزالة التعليقات من الكود المصدري. لتخصيص استخراج المقتطفات، ستحتاج إلى:

1. أضف ملفًا باسم lib/languages/<track_slug>.txt يضبط استخراج المقتطفات. يمكن لهذا الملف أن يستخدم إما الوضع الأساسي أو الوضع الموسّع. تستخدم معظم المسارات الوضع الموسّع، لأنه يمنح مرونة أكبر.

2. أضف حالة اختبار واحدة أو أكثر إلى دليل tests/<track_slug>/<test_slug>. سيحتاج كل دليل اختبار إلى ملفين:

   1. tests/<track_slug>/<test_slug>/code.<track_extension>: الكود الذي سيُشغَّل عليه مستخرج المقتطفات
   2. tests/<track_slug>/<test_slug>/expected_snippet.<track_extension>: المقتطف المتوقَّع

انظر إلى طلب السحب النموذجي هذا الذي يخصّص استخراج المقتطفات للغة Arturo.