وقتی رویکرد، مقاله یا تمرین تازهای اضافه میکنید، باید فایلهایی با اسمهایی بسیار خاص بسازید.
این کار همچنین نیازمند افزودن یا بهروزرسانی فایلهای پیکربندی است.
با دستور create، configlet میتواند همهی این کارها را بهجای شما انجام دهد.
کاربرد
از دستور create میتوان برای ساخت فایلهای لازم جهت افزودن رویکرد، مقاله یا تمرین تازه استفاده کرد. این دستور همچنین میتواند فایلهای پیکربندی را تغییر دهد.
configlet [global-options] create [command-options]
Options for create:
--approach <slug> The slug of the approach
--article <slug> The slug of the article
--practice-exercise <slug> The slug of the practice exercise
--concept-exercise <slug> The slug of the concept exercise
-e, --exercise <slug> Only operate on this exercise
-o, --offline Do not update the cached 'problem-specifications' data
ساخت تمرین عملی
مستندات افزودن تمرین عملی دستورالعملهای مفصلی برای افزودن تمرین عملی دارد.
ساخت تمرین مفهومی
برای ساخت تمرین مفهومی، باید slug آن را مشخص کنید:
configlet create --concept-exercise bird-watcher
این کار فایلهای لازم تمرین مفهومی را، همانطور که در مستندات تمرینهای مفهومی آمده است، میسازد.
البته این فقط نخستین گام در ساخت تمرین است.
پس از آن باید:
- افزودن
tests به فایل tests
- افزودن یک پیادهسازی نمونه
- مشخص کردن محتوای فایل اولیه
- نوشتن مقدمه در
.docs/introduction.md
- نوشتن دستورالعملها در
.docs/instructions.md
- در فایل
.meta/config.json تمرین:
- افزودن اسم کاربری GitHub نویسندگان تمرین به کلید
authors
- در فایل
config.json مسیر:
- بررسی/بهروزرسانی سختی تمرین
- افزودن مفهومها به کلید
concepts
- افزودن مفهومها به کلید
prerequisites
ساخت رویکرد
برای ساخت فایلهای یک رویکرد، باید slug رویکرد و تمرین مربوط به آن را مشخص کنید:
configlet create --approach recursion --exercise collatz-conjecture
این کار فایلهای لازم رویکرد را، همانطور که در مستندات رویکردها آمده است، میسازد.
ساخت مقاله
برای ساخت فایلهای یک مقاله، باید slug مقاله و تمرین مربوط به آن را مشخص کنید:
configlet create --article performance --exercise collatz-conjecture
این کار فایلهای لازم مقاله را، همانطور که در مستندات مقالهها آمده است، میسازد.
