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