استخراج‌کننده‌ی قطعه‌کد

Snippet Extractor ارسال دانشجو را می‌گیرد و ده خط کدِ «جالب» اول را از آن استخراج می‌کند. «قطعه‌کد»ی که استخراج می‌شود، در صفحه‌های مختلف وب‌سایت نمایش داده می‌شود.

به‌طور پیش‌فرض، ده خط اول نمایش داده می‌شود و خطوط خالی ابتدایی نادیده گرفته می‌شوند. این ده خط اول ممکن است مواردی مثل توضیحات را در بر بگیرد که معمولاً نمایش دادن‌شان در یک قطعه‌کد مطلوب نیست.

سفارشی‌سازی استخراج قطعه‌کد

پیشنهاد می‌کنیم هر مسیر استخراج قطعه‌کد را سفارشی کند تا دست‌کم توضیحات را از کد منبع حذف کند. برای سفارشی‌سازی استخراج قطعه‌کد، باید این کارها را انجام دهید:

1. یک فایل lib/languages/<track_slug>.txt اضافه کنید که استخراج قطعه‌کد را تنظیم می‌کند. این فایل می‌تواند از حالت پایه یا حالت گسترده استفاده کند. بیشتر مسیرها از حالت گسترده استفاده می‌کنند، چون انعطاف بیشتری می‌دهد.

2. یک یا چند مورد آزمون به پوشه‌ی tests/<track_slug>/<test_slug> اضافه کنید. هر پوشه‌ی آزمون به دو فایل نیاز دارد:

   1. tests/<track_slug>/<test_slug>/code.<track_extension>: کدی که Snippet Extractor روی آن اجرا می‌شود
   2. tests/<track_slug>/<test_slug>/expected_snippet.<track_extension>: قطعه‌کد مورد انتظار

این pull request نمونه را ببینید که استخراج قطعه‌کد را برای زبان Arturo سفارشی می‌کند.