ما هو GitHub؟

GitHub هو موقع ويب يستضيف مستودعات Git. يقوم بتخزين المشروع عبر الإنترنت بحيث يعمل الجميع على نفس النسخة، ويضيف الأشياء التي ليس لدى Git نفسه رأي بشأنها: تتبع المشكلات، ومراجعة التعليمات البرمجية، وطلبات السحب.

مصدر هذا الموقع موجود في Mordhau-Community/Unofficial-Mordhau-Document. كل صفحة تقرأها هنا هي ملف Markdown في هذا المستودع.

إذا لم يكن الفرق بين Git وGitHub واضحًا بعد، فاقرأ ما هو جيت؟ أولاً.

الحصول على حساب

مجانا. قم بالتسجيل في github.com باستخدام عنوان بريد إلكتروني واسم مستخدم - اسم المستخدم عام ويظهر في كل ما تساهم به، لذا اختر واحدًا يسعدك أن تُعرف به.

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

شوكة، فرع، طلب سحب

هذا هو سير العمل الذي يعمل عليه الموقع بالكامل، وهو نفسه في كل مكان على GitHub.

1. شوكة

ليس لديك إذن بالدفع مباشرة إلى المستودع الرئيسي، وهذا أمر متعمد. يؤدي النقر فوق Fork إلى منحك نسختك الكاملة ضمن حسابك الخاص والتي يمكنك فعل ما تريد به.

2. قم بإجراء التغييرات

إما في المتصفح، أو عن طريق استنساخ الشوكة الخاصة بك والعمل محليًا. ضعها على فرع بدلاً من وضعها مباشرة على main.

3. فتح طلب سحب

طلب السحب هو طلب لسحب التغييرات إلى المستودع الأصلي. GitHubيعرض بالضبط ما قمت بتغييره، سطرًا تلو الآخر، ويمنح الجميع مكانًا لمناقشته قبل دمج أي شيء.

اكتب وصفًا يوضح ما قمت بتغييره ولماذا. إذا تم إصلاح مشكلة، فاذكر رقم المشكلة - كتابة Fixes #42 تغلق هذه المشكلة تلقائيًا بمجرد دمج طلب السحب.

4. الرد على المراجعة

سوف يقرأها شخص ما. قد يطلبون التغييرات. ادفع التزامًا آخر إلى نفس الفرع وسيتم تحديث طلب السحب من تلقاء نفسه - ولا تفتح فرعًا جديدًا.

بمجرد الموافقة عليه ودمجه، تقوم Netlify بإعادة بناء الموقع ويصبح التغيير الذي قمت به مباشرًا في غضون بضع دقائق.

التحرير بدون أي من ذلك

بالنسبة لخطأ مطبعي، لا تحتاج إلى تفرع أي شيء. تحتوي كل صفحة هنا على رابط تعديل هذه الصفحة في الأسفل. فهو يفتح محرر GitHub على هذا الملف بالضبط، وعندما تقوم بالحفظ، يقوم GitHub بصمت بإجراء الشوكة وطلب السحب نيابةً عنك.

المشكلات

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

ابحث في المشكلات الموجودة أولاً. ربما قام شخص ما برفعه بالفعل.

مراقبة المستودع

سيرسل لك الزر مراقبة الموجود أعلى المستودع بريدًا إلكترونيًا عند حدوث أشياء. مخصص → المشكلات عادةً ما يكون الإعداد الصحيح إذا كنت تريد المساعدة ولكنك لا تريد الحصول على إشعار لكل التزام.

تعلم المزيد

GitHub أسرع جيد حقًا ويستغرق حوالي خمسة عشر دقيقة. تحتوي GitHub Skills أيضًا على دورة Introduction to GitHub المجانية التي ترشدك خلال فتح طلب سحب حقيقي.