StudentHelp
1.0.0
شارك في Hacktoberfest 2022 من خلال المساهمة في هذا المشروع الصديق للمبتدئين. اندمج PRS الخاص بك اليوم!؟ ✅؟
غالبًا ما يكون الطالب غير مدركين ويغيبون عن بعض الفواصل العظيمة حقًا؟ كان يمكن أن يساعدهم ذلك في توسيع نطاق حياتهم المهنية؟ . هدفي هو جمع معلومات حول كل أوفورتونات ممكنة ، سواء كان ذلك برنامجًا للطلاب مثل Github Campus Expert ، أو برنامج Microsoft Learn Student Ambassador أو نوع من التدريب الداخلي أو hackathons أو برنامج شيوعي مثل Hacktoberfest نفسه. هذا هو المكان الذي سأحتاج إلى مساعدتك؟
إنه احتفال لمدة شهر من 1 أكتوبر إلى 31 أكتوبر الذي قدمه مجتمع Digital Ocean و Dev Community مع Github لإشراك الأشخاص في مفتوح المصدر. يمكنك إنشاء طلب السحب الأول إلى أي مستودع عام على Github والمساهمة في مجتمع مطور المصدر المفتوح.
للتأهل للحصول على قميص Hacktoberfest الرسمي Limited Edition ، يجب عليك التسجيل هنا ورفع أربعة طلبات سحب (PRS) بين 1-31 أكتوبر ، 2022 (في أي منطقة زمنية). يمكن تقديم PRS إلى أي مستودع عام على Github ، وليس فقط القضايا التي تحمل علامات Hacktoberfest. هذا العام ، فإن أول 40،000 مشارك يكملون التحدي سوف يكسبون قميصًا؟ أو يمكنك اختيار زراعة شجرة؟ لك.
يمكنك متابعة الخطوات التوجيهية التالية للمساهمة في مستودعنا. يوصى بقراءة المساهمة. md لفهم إرشادات المساهمة.
بادئ ذي بدء "الشوكة" المستودع.
لجعل نسختك المحلية الخاصة من المستودع ترغب في المساهمة ، دعنا أولاً نفتح نافذة طرفية.
سنستخدم أمر git clone جنبًا إلى جنب مع عنوان URL الذي يشير إلى شوكة المستودع.
سيكون عنوان URL هذا مشابهًا لعنوان URL أعلاه ، إلا أنه سينتهي الآن بـ .git . في مثال Cloud_haiku أعلاه ، سيبدو عنوان URL هكذا:
https://github.com/your-username/studenthelp.git
يمكنك بدلاً من ذلك نسخ عنوان URL باستخدام زر "استنساخ أو تنزيل" الأخضر من صفحة المستودع الخاص بك الذي قمت به فقط من صفحة المستودع الأصلي. بمجرد النقر فوق الزر ، ستتمكن من نسخ عنوان URL بالنقر فوق زر Binder بجوار عنوان URL:
بمجرد أن يكون لدينا عنوان URL ، نحن على استعداد لاستنساخ المستودع. للقيام بذلك ، سنجمع أمر git clone مع عنوان URL للمستودع من سطر الأوامر في نافذة طرفية:
git clone https://github.com/your-username/StudentHelp.git
لإنشاء فرعك ، من نافذة الطرفية ، قم بتغيير الدليل الخاص بك بحيث تعمل في دليل المستودع. تأكد من استخدام الاسم الفعلي للمستودع (أي الطالب) للتغيير إلى هذا الدليل.
cd StudentHelp
الآن ، سنقوم بإنشاء فرعنا الجديد مع أمر git branch . تأكد من تسميته بشكل وصفي حتى يفهم الآخرون في المشروع ما تعمل عليه.
git branch new-branch
الآن بعد إنشاء فرعنا الجديد ، يمكننا التبديل للتأكد من أننا نعمل على هذا الفرع باستخدام أمر GIT Checkout:
git checkout new-branch
بمجرد إدخال الأمر git checkout ، ستتلقى الإخراج التالي:
Output:
Switched to branch 'new-branch'
في هذه المرحلة ، يمكنك الآن تعديل الملفات الموجودة أو إضافة ملفات جديدة إلى المشروع على فرعك.
كل ما عليك فعله هو تعيين هذا المستودع على نظام YouT المحلي ثم فتح مجلد INDEX.HTML. سترى أقسامًا محددة حيث تضيف بشكل متتابع أسفل العلامة في علامة
هذا إلى حد كبير ، هذا كل ما عليك فعله. الآن ادفع التغييرات الخاصة بك وإنشاء طلب سحب ، قم بدمج PRS الخاص بك اليوم. تحقق من قسم المشكلات لمزيد من المشكلات (إن كان متاحًا)
بمجرد تعديل الملفات الموجودة أو إضافة ملفات جديدة إلى المشروع ، يمكنك إضافتها إلى مستودعك المحلي ، والذي يمكنك القيام به مع أمر git add . دعنا نضيف علامة -A لإضافة جميع التغييرات التي أجريناها:
git add -A
أو
git add .
بعد ذلك ، سنرغب في تسجيل التغييرات التي أجريناها على المستودع من خلال أمر الالتزام GIT.
تعد رسالة الالتزام جانبًا مهمًا لمساهمة الكود الخاصة بك ؛ إنه يساعد المساهمين الآخرين على فهم التغيير الذي أجريته تمامًا ، ولماذا صنعته ، ومدى أهمية ذلك. بالإضافة إلى ذلك ، توفر الرسائل الالتزام سجلًا تاريخيًا للتغييرات في المشروع بشكل عام ، مما يساعد المساهمين في المستقبل على طول الطريق.
إذا كان لديك رسالة قصيرة جدًا ، فيمكنك تسجيل ذلك مع علم -m والرسالة في عروض الأسعار:
مثال:
git commit -m "Updated Readme.md"
في هذه المرحلة ، يمكنك استخدام الأمر git push لدفع التغييرات إلى الفرع الحالي لمستودعك المتشعب:
مثال:
git push --set-upstream origin new-branch
أثناء عملك في مشروع إلى جانب المساهمين الآخرين ، من المهم بالنسبة لك أن تبقي مستودعك المحلي محدثًا مع المشروع لأنك لا ترغب في تقديم طلب سحب للحصول على تعارضات. للحفاظ على نسختك المحلية من قاعدة التعليمات البرمجية ، ستحتاج إلى مزامنة التغييرات.
سنذهب أولاً إلى تكوين جهاز تحكم عن بعد للشوكة ، ثم مزامنة الشوكة.
بعد ذلك ، سيتعين عليك تحديد مستودع جديد عن بُعد عن بُعد بالنسبة لنا للمزامنة مع الشوكة. سيكون هذا هو المستودع الأصلي الذي شوهته. سيكون عليك القيام بذلك باستخدام أمر git remote add .
git remote add upstream https://github.com/souvikrajsingh/StudentHelp.git
في هذا المثال ، فإن upstream هو الاسم القصير الذي قمنا بتوفيره للمستودع البعيد لأنه من حيث GIT ، يشير "Upstream" إلى المستودع الذي استنسخته. إذا كنت ترغب في إضافة مؤشر بعيد إلى مستودع أحد المتعاونين ، فقد ترغب في توفير اسم المستخدم لهذا المتعاون أو لقب قصير لـ ShortName.
بمجرد تكوين جهاز تحكم عن بعد يشير إلى المستودع المنبع والأصلي على Github ، فأنت مستعد لمزامنة شوكة المستودع للحفاظ على تحديثه.
لمزامنة شوكة ، من دليل مستودعك المحلي في نافذة طرفية ، سيتعين عليك استخدام أمر git fetch لجلب الفروع إلى جانب ارتباطات كل منهما من مستودع المنبع. نظرًا لأنك استخدمت اسم "Upstream" القصير للإشارة إلى مستودع المنبع ، فسوف يتعين عليك نقل ذلك إلى الأمر:
git fetch upstream
قم بالتبديل إلى الفرع الرئيسي المحلي لمستودعنا:
git checkout master
سيتعين عليك الآن دمج أي تغييرات تم إجراؤها في فرع Master الأصلي للمستودع الأصلي ، والتي ستصل إليها من خلال فرعك المحلي/Master ، مع فرعك الرئيسي المحلي:
git merge upstream/master
