مساهمتك الأولى في مستودع Git

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

هذا المشروع مستوحى من مشروع مشابه على Github، أردنا فقط إنشاء نسخة أصغر وأبسط باللغة العربية فقط

إذا لم يكن لديك git على جهازك، يمكنك تحميله من هنا

قم بعمل fork لهذا المشروع

اضغط على زر fork الموجود أعلى هذه الصفحة على على اليمين، سيؤدي ذلك إلى إنشاء نسخة من هذا المشروع على حسابك الخاص في github

اسستنسخ هذا المشروع على جهازك الخاص

انقر على زر clone ثم اختر copy to clipboard سيؤدي ذلك لنسخ رابط المستودع

افتح الطرفية الأوامر (command line Terminal) واكتب الكود لتال:

git clone " الرابط الذي نسخته من الخطوة السابقة"

قم باستبدال النص بين الأقواس بالرابط الذي نسخته من الخطوة السابقة

هكذا سيكون شكل الأمر

git clone https://github.com/"حسابك"/WEBia-first-contributors.git

حيث سيكون حسابك موجود في الرابط، يليه اسم المشروع. هذا الأمر سينسخ محتويات المشروع على جهازك لتمكن من التعديل عليه بحرية

إنشاء فرع - Create Branch

انتقل إلى المجلد الذي يحتوي على المشروع على جهازك

cd webia-first-contributors

الآن قم بانشاء فرع عن طريق الأمر التالي

git checkout -b "اضف اسمك"

اجعل اسم الفرع الفرع بنفس اسمك، مثلاً:

git checkout -b "Eiyad-Ziyadah"

يمكنك طبعاً عمل فرع باستخدام VS Code بدون المحطة الطرفية لكن يفضل استعمالها على الأقل في البداية لتتعود على استخدامها

اجراء التعديلات على المشروع

الآن قم بفتح الملف "Contributors.md" في محرر النصوص المفضل لديك وأضف اسمك ثم احفظ الملف. بعد ذلك اذهب إلى الطرفية واكتب الأمر هذاgit status هذا الأمر سيظهر لك التغيرات التي حدثت في المشروع.

لإضافة هذه التغييرات قم بإضافتها عن طريق هذا الأمر git add

git add Contributors.md

الآن قم باتمام التغييرات باستخدام الأمر git commit

git commit -m "Add <اسمك> to Contributors list"

استبدل كلمة "اسمك" باسمك :)، مثال:

git commit -m "Add Eiyad Ziyadah to Contributors list"

ارفع التغييرات إلى مستودع github على حسابك

ارفع التغييرات باستخدام الأمر git push

git push origin "اسم الفرع الجديد"

مثال:

git push origin "ُEiyad-Ziyadah"

بذلك قمت بنسخ المشروع إلى حسابك، ثم استنساخه من حسابك إلى جهازك، ثم قمت بعمل فرع جديد وقمت بتغييرفي ملف وقمت بدفع التغيير إلى المستودع في حسابك الآن ستقوم بطلب مرادعة لهذه التعديلات، وسنقوم بمراجعته، سنستقبل الطلب منك ونقوم مراجعتها ودمجها في المشروع لاأصلي. اتبع التعليمات التالية لعمل ذلك:

سلم التغييرات للمراجعة

في صفحة مشروعك، يوجد زر compare & pull request، اضغط على هذا الزر

والآن سلم الطلب للمراجعة

بعد المراجعة سوف أقوم بدمج تغيرراتك إلى الفرع الرئيس في المشروع. سيتم تنبيهك عن طريق البريد الإلكتروني بذلك.

ملاحظة: الفرع الرئيسي للمستودع على مشروعك لن يحتوي على التغييرات ، ستحتاج إلى مزامنة المشروع الموجود على حسابك مع المشروع الأصلي بعد تلقي البريد الإلكتروني اتبع الخطوات التالية لمزامنة الفرع الرئيسي لمشروعك مع المشروع الأصلي

على جهازك، افتح المحطة الطرفية وانتقل إلى الفرع الرئيسي main

git checkout main

استخدم هذا الأمر لإخبار git أن هناك نسخة أخرى من هذا المشروع

git remote add upstream https://github.com/eziyadah/WEBiA-First-Contributors.git

بهذه الطريقة نخبر git أن هناك نسخة أخرى من هذا المشروع في هذا الرابط ونسميها upstream بعد الموافقة على تغييراتك وتلقي البريد الإلكتروني، قم بسحب النسخة الجديدة من الشروع عن طريق أمر fetch

git fetch upstream

بذلك يقوم git بسحب التغييرات من المستودع الأصلي الذي حددناه في الخطوة السابقة

الآن، قم بدمج التحديثات الجديدة من فرع المشروع الأصلي إلى فرعك الرئيسي

git rebase upstream/main

أخيراً، قم برفع التغييرات لفرعك الرئيسي

git push origin main