بدء المساهمة في Blockly

‫Blockly هي أداة مفتوحة المصدر، ويتولّى صيانتها بشكل أساسي فريق صغير. نرحّب بمساهمات المطوّرين من خارج الفريق الأساسي، إذ لا يمكننا إنشاء كل ميزة مطلوبة أو إصلاح كل خطأ تم الإبلاغ عنه بدون مساعدة المنتدى. يحتوي هذا القسم على أدلة عامة قد تكون مفيدة لك، خاصةً إذا كنت جديدًا في مجال تطوير البرامج المفتوحة المصدر.

للحصول على معلومات خاصة بـ Blockly يجب قراءتها قبل تقديم مساهمة، راجِع القسمَين المساهمة في Core والمساهمة في الأمثلة.

أي مستودع؟

يحتوي المستودع على جميع الملفات الخاصة بمشروع واحد. يحتوي Blockly على مستودعَين: blockly core وblockly-samples.

Blockly core هو مستودع مكتبة Blockly. استخدِم هذا المستودع إذا أردت إجراء تغيير على السلوك الأساسي في Blockly بطريقة تنطبق على جميع مستخدمي المكتبة.

عينات Blockly هو مستودع للعينات والمكوّنات الإضافية والبرامج التعليمية. استخدِم هذا المستودع إذا كنت تريد إنشاء مكوّن إضافي أو تعديله، أو كتابة برنامج تعليمي، أو إنشاء نموذج أو تعديله.

خطوة بخطوة

في ما يلي الخطوات العامة التي ستتّبعها في كل مرة تجري فيها تغييرًا.

1. ثبِّت Git وNode باتّباع الروابط في قسم الأدوات.
2. إنشاء نسخة طبق الأصل من المستودع ونسخه يوفّر GitHub برنامجًا تعليميًا رائعًا حول إنشاء نسخة طبق الأصل من مستودع. لتطبيق ذلك على Blockly، ما عليك سوى استبدال كل مثيل من octocat/Spoon-Knife بـ RaspberryPiFoundation/blockly أو RaspberryPiFoundation/blockly-samples، وذلك حسب المستودع الذي تريد العمل فيه.
3. مزامنة النسخة المتفرّعة يوفّر GitHub أيضًا برنامجًا تعليميًا حول مزامنة نسخة طبق الأصل.
4. الاطّلاع على الفرع الرئيسي في حزمة Blockly الأساسية، هذا هو فرع develop. في blockly-samples، هذا هو فرع master.
5. ثبِّت التبعيات وأدوات الإنشاء من خلال تنفيذ npm install في الدليل الجذر.
6. أنشئ فرعًا جديدًا من خلال تنفيذ git checkout -b myBranchName في نافذة طرفية. يجب أن يساعدك الاسم في تذكُّر ما تعمل عليه.
7. أدخِل تغييراتك.
8. تحقَّق من صحة التغييرات باتّباع الدليل الخاص بالبيانات الأساسية أو العيّنات.
9. احفظ التغييرات باستخدام git commit -am "fix: My commit message". مزيد من المعلومات عن رسائل عمليات الإيداع
10. ادفع تغييراتك إلى GitHub باستخدام git push origin myBranchName.
11. افتح طلب سحب عندما يصبح الرمز البرمجي جاهزًا. سيراجع أحد أعضاء فريق Blockly التغييرات التي أجريتها ويدمجها في Blockly إذا تمت الموافقة عليها. لمزيد من المعلومات، يُرجى الاطّلاع على عملية مراجعة طلبات السحب.