يستند هذا البرنامج التعليمي لـ GitHub بكل حب إلى [DjangoGirls How To برنامج تعليمي للمساهمة] (https://github.com/DjangoGirls/tutorial) والذي هو متاح تحت رخصة المشاع الإبداعي نَسب المُصنَّف - بالمثل 4.0.
في هذا البرنامج التعليمي، سنستخدم مستودع مستودع [الحقيبة الموجزة] (https://github.com/beeware/briefcase) كأساس للروابط والمراجع.
الشروع في العمل والمتطلبات الأساسية
للمساهمة في برنامج BeeWare، يلزم توفر ما يلي للبدء:
- [حساب [حساب GitHub] (https://github.com)
- في حالة التعديلات المعقدة الإلمام ب أساسيات سطر أوامر Git الأساسيات أو الإلمام ب أساسيات سطر أوامر Git أو الإلمام باستخدام تطبيق (ويندوز وماك) لدفع تعديلاتك التي أجريتها على حاسوبك إلى GitHub.
فورك المستودع
أولاً، قم بتوسيع [الحقيبة] (https://github.com/beeware/briefcase) إلى حسابك الشخصي على GitHub:
<img src="/contributing/first-time/github/fork.png" class="img-fluid" بديل="زر شوكة" />
تحرير الوثائق
تغييرات بسيطة
للتغييرات البسيطة مثل تصحيحات الأخطاء المطبعية يمكنك استخدام GitHub عبر الإنترنت على الإنترنت:
- افتح صفحة الشوكة المحلية على GitHub,
- انتقل إلى ملف README.rst في أي فصل,
- اضغط على أيقونة تحرير (قلم)
ويمكنك تحرير الفصل مباشرةً على موقع github.com.
<img src="/contributing/first-time/github/edit.png" class="img-fluid" بديل="زر تحرير" />
تُستخدم صيغة RST لتحرير الصفحات الفردية للوثائق.
ملاحظة
قد لا تعكس لقطة الشاشة أعلاه ما هو موجود حاليًا في مستودع GitHub. سيتغير المستودع المباشر من وقت لآخر. ومع ذلك، تظل عملية إرسال طلبات السحب كما هي.
احفظ تغييراتك وأنشئ طلب سحب كما هو موضح أدناه.
كود جديد وتغييرات معقدة
لإضافة شيفرة جديدة أو توسيع فئات أو تغييرات معقدة، تحتاج إلى الحصول على نسخة من الشيفرة إلى حاسوبك المحلي.
إمّا أن تستخدم تطبيق GitHub لنظام التشغيل الخاص بك (المذكور أعلاه) أو سطر الأوامر 'git' للحصول على المستودع محليًا. يمكنك الحصول على المستودع من الصفحة الأولى لمستودع GitHub الخاص بك:
استنساخ git clone git@github.com:yourusername/briefcase.git
بعد ذلك، أنشئ فرعًا لتوضع فيه تغييراتك الجديدة. من المفيد أن تسمي الفرع بشيء مرتبط بالتغييرات التي ستجريها.
GIT checkout -b update_documentation
قم بإجراء أي تغييرات في التعليمات البرمجية، وتأكد من اختبارها وحفظها محلياً.
ثم التزم بالتغييرات باستخدام 'git' وادفع التغييرات إلى مستودع البعيد إلى مستودع GitHub الخاص بك.
مثال على ذلك:
حالة git $
في الفرع update_documentation
الملفات غير المتعقبة:
(استخدم "git add <file>..." لتضمين ما سيتم الالتزام به)
README.rst
git add README.rst
$ git commit -m "تحديث وثائق README.rst للحقيبة الموجزة"
[update_documentation fe36152] تمت إضافة لقطة شاشة لكتاب gitbook
تم تغيير 1 ملف، 0 إدراج (+)، 0 حذف (-)
وضع الإنشاء 100644 README.rst
$ git push
عد الكائنات: 11، تم
ضغط دلتا باستخدام ما يصل إلى 8 خيوط.
ضغط الكائنات: 100٪ (5/5)، تم.
كتابة الكائنات: 100٪ (5/5)، 266.37 كيلوبايت | 0 بايت/ثانية، تم.
المجموع 5 (دلتا 1)، إعادة الاستخدام 0 (دلتا 0)
إلى git@github.com:yourusername/briefcase.git
b37ca59..fe36152 تحديث_التوثيق -> تحديث_التوثيق
تقديم طلب سحب
بعد الانتهاء من التغييرات الخاصة بك تحتاج إلى إنشاء [طلب سحب طلب] (https://help.github.com/articles/about-pull-requests/) على GitHub. ستتلقى BeeWare إشعارًا بشأن طلب السحب، وستقوم بمراجعة التغييرات، واقتراح أي تصحيحات إذا لزم الأمر ثم سحب التغييرات الخاصة بك إلى الإصدار الرئيسي.
في مستودعك الخاص على GitHub اضغط على مقارنة وسحب طلب
املأ المعلومات لماذا يتم إجراء هذا التغيير. يمكن للمراجع أن يرى تفاصيل التغيير الفعلي، لذلك لا تحتاج إلى تكرار محتوى التغيير.
ثم اضغط على إنشاء طلب سحب.
ستُعلمك رسائل GitHub الإلكترونية بعملية المتابعة.