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