الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

ابدأ أنشطة OSS الخاصة بك مع برنامج تعليمي ياباني كامل

هذا مشروع ياباني مفتوح المصدر مصمم لجعل من السهل على المبتدئين المشاركة.
اتبع البرنامج التعليمي لتجربة مساهمتك الأولى!

يسعدنا مساعدتك في طلب السحب الأول ✌


مقدمة

هذا المشروع هو برنامج تعليمي ياباني لمساعدتك على تعلم كيفية استخدام Git/Github في الممارسة وكيفية التعاون في المصدر المفتوح!

من هذا؟

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

ما هو الغرض من هذا المشروع؟

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

ما هو المصدر المفتوح في المقام الأول؟

ما هو المصدر المفتوح؟

عندما يكون المشروع مفتوحًا المصدر ، فهذا يعني أنه يمكن لأي شخص استخدامه في نزوة خاصة به ، وتعلمه ، وتعديله ، وتوزيع مشروعك لأي غرض.

في معظم الحالات ، تكون المشاريع المفتوحة المصدر مجانية للمشاركة في التنمية!

المساهمات في المشاريع المصدر المفتوحة
إنها طريقة رائعة لتحسين مهاراتك من خلال التعاون مع المطورين الآخرين.

إذا كنت غير مهتم في المصدر المفتوح وتتساءل عما إذا كنت بحاجة إلى بذل جهد فيه ،
انظر هنا: لماذا تساهم في مفتوح المصدر؟


كيفية المشاركة

دعونا نختبر المساهمات في المشاريع المفتوحة المصدر على الفور!

ماذا علي أن أفعل؟

كمشارك في هذا المشروع ، سنضيف المعلومات التالية إلى ملف المساهمين. 

 "name": "あなたのハンドルネーム",
"github": "あなたのGitHubアカウントのURL",
"favoriteColor": "あなたの好きなカラーコード",
"favoriteEmoji": "あなたの好きな絵文字"

سيتم عرض المعلومات التي تم إدخالها على موقع الويب كرمز للرموز التعبيرية.
لذلك ، في كل مرة يزداد فيها عدد المساهمين ، يصبح الموقع حيويًا!

Emoji-animation.mp4

نريد تقديم مساهمات أولى موقع JA على موقع Pop أكثر مما هو عليه الآن!
من فضلك حاول تحريك يديك

  • حرك يديك الفعلي
    • يثبت:
    • الخطوة 1: شوكة هذا المستودع
    • الخطوة 2: استنساخ للآلة المحلية
    • الخطوة 3: إنشاء فرع عمل
    • الخطوة 4: إجراء تغييرات
    • الخطوة 5: ارتكاب تغييراتك
    • الخطوة 6: ادفع التغييرات
    • الخطوة 7: إنشاء طلب سحب (PR)
    • الخطوة 8: الرد على المراجعات والتعليقات
    • ينهي: ؟
  • المزيد من الخطوات
  • مساهمات أخرى

حرك يديك الفعلي

تصبح مساهما مفتوح المصدر في 8 خطوات بسيطة ؟

  • إذا كنت بحاجة إلى مساعدة ، اسأل في المناقشات!
  • إذا وجدت أي تحسينات على هذا المشروع ، فيرجى إخبارنا من خلال القضايا!

بغض النظر عن مدى صغرنا ، فنحن مرحب بهم؟

يثبت:

  • إذا لم يكن لديك حساب github ، فيرجى إنشاء واحد عن طريق التسجيل.
    • وإذا لزم الأمر ، نوصيك بالقيام برمجي GitHub Hello World للمبتدئين الكامل أولاً.
  • إذا لم يتم تعيين رمز الوصول الذي يحل محل كلمة المرور ، فقد يحدث خطأ في وقت استنساخ.
    • في هذه الحالة ، راجع تكوين رموز الوصول إلى GitHub.

الخطوة 1: شوكة هذا المستودع

  • شوك هذا المستودع من خلال النقر فوق الزر "شوكة" في الزاوية اليمنى العليا من صفحة المشروع (هذه الصفحة) على Github.

  • ثم انقر فوق الزر "إنشاء شوكة".
    • جميع العناصر مثل "اسم المستودع" و "الوصف" و "نسخ الفرع main فقط" على ما يرام كما هي في التنسيق الأصلي!

نصيحة

هذا سيقوم بإنشاء نسخة من هذا المستودع في حساب github الخاص بك؟

الخطوة 2: استنساخ للآلة المحلية

يمكنك أيضًا تحرير الملف على Github ،
انسخ مستودع متشعب إلى جهازك المحلي للحصول على تجربة سير عمل أكثر عمومية.

  • على Github ، انتقل إلى صفحة مستودع Forked ، انقر فوق الزر "رمز" الأخضر ونسخ عنوان URL HTTPS.
    • يجب أن يبدو عنوان URL الخاص بك مثل هذا: https://github.com/<あなたのアカウント名>/first-contributions-ja.github.io.git

  • افتح محطة وانتقل إلى الدليل حيث تريد استنساخ المستودع.
    • على سبيل المثال ، إذا كنت ترغب في تحديد الوجهة المستنسخة على سطح المكتب ، فيمكنك استخدام الأمر التالي: 
     cd desktop
  • استخدم الأمر التالي لاستنساخ المستودع المتشعب إلى جهازك المحلي: 
     git clone 先ほどコピーしたクローンURL

نصيحة

يتيح ذلك نسخ المستودع إلى جهازك المحلي والعمل في البيئة المحلية

الخطوة 3: إنشاء فرع عمل

  • انتقل إلى دليل المستودع مع الأمر التالي: 

     cd first-contributions-ja.github.io

  • قم بتثبيت الحزم اللازمة لهذا المشروع مع الأمر التالي: 

     npm install

    ملاحظة: ما هو تثبيت NPM؟ ❓❓

    مع تثبيت Node.js ، قم بتشغيل أمر npm install لتثبيت المكتبات المطلوبة لهذا المشروع بكميات كبيرة.

    ما يمكنك القيام به بعد تثبيت npm install

    • ابدأ الخادم المحلي وتحقق من العرض في المتصفح
      • بعد تنفيذ الأمر npm run dev ، انقر فوق عنوان URL الذي يبدو أنه يؤكد
    • فحص الكود التلقائي وتشكيله عند الالتزام
      • يتم تشغيله باستخدام مكتبة تسمى Husky
      • يتم تشغيله تلقائيًا ، لذلك ليست هناك حاجة لتنفيذ أي أوامر أو القيام بأي عمل

    لمزيد من المعلومات حول أمر npm install ، يرجى الاطلاع هنا!

    ؟ ملاحظة) إذا لم يتم تثبيت Node.js على جهازك المحلي ، فإن أمر npm install سيؤدي إلى خطأ.

    في هذه الحالة ، هناك طريقتان للتعامل معها .

    • تخطي إجراء npm install .
      • بدون هذا الإجراء ، يمكنك الحصول على الحد الأدنى من تجربة المساهمة ، لذلك إذا كان الأمر صعبًا ، فيمكنك تخطيه.
      • أود أن أعرف للرجوع عدد الأشخاص الذين سيتعثرون هنا ، لذلك سيكون من المفيد للغاية أن تتمكن من الإبلاغ في طلب السحب مثل " npm install لم ينجح".
    • تثبيت node.js.
      • للحصول على تعليمات التثبيت ، يرجى الرجوع إلى الموقع التالي:
      • node.js الموقع الرسمي / كيفية تثبيت node.js (macOS) progate / كيفية تثبيت node.js (Windows) progate
      • إذا كنت تريد معرفة المزيد عن node.js ، فما هي node.js؟ لماذا يستخدمه الجميع؟ يرجى الرجوع إلى Qiita.
      • إذا كنت مهتمًا بتطوير الويب/JavaScript ، أوصي باستخدام هذه الفرصة لتثبيتها؟

  • بعد ذلك ، قم بإنشاء فرع جديد لفصل عملك عن الفرع main لمشروعك.
    • يمكنك استخدام الأمر التالي: git switch -c <ブランチ名>
    • أسماء الفروع هي أسماء ذات معنى مرتبطة بالعمل الذي توشه على القيام به. لذلك يبدو هكذا: 
     git switch -c add-yourname
    • ؟ملحوظة )
    • لا تنس أن تحل محل yourname بمقبضك
    • يرجى إدخال اسم الفرع في أحرف أبجدية رقمية نصف عرض بدون هيراجانا أو كانجي أو مساحات بيضاء.
      • : Ogino Chihiro ، Ogino Chihiro
    • مثال: 
     git switch -c add-oginochihiro


نصيحة

هذا يجعلك مستعدًا لإجراء تغييرات دون التأثير بشكل مباشر على مستودع المشروع main ؟

الخطوة 4: إجراء تغييرات

  • للبدء ، افتح المجلد المستنسخ في محرر الكود المفضل لديك ، مثل VSCode.
    • قبل إجراء أي تغييرات ، تأكد من العمل مع الفرع الذي أنشأته في الخطوة السابقة!
    • يمكنك التحقق من الفرع الحالي مع الأمر التالي: 
     git status
  • الآن دعونا نجري تغييرات على ملف المساهمين.
    • انسخ والصق الرمز التالي في "نهاية القائمة" في ملف المساهمين. json: 
     ,
{
  "name": "あなたのハンドルネーム",
  "github": "あなたのGitHubアカウントのURL",
  "favoriteColor": "あなたの好きなカラーコード",
  "favoriteEmoji": "あなたの好きな絵文字"
}

  • ثم استبدل محتويات النص الذي تم لصقه بالمحتوى الخاص بك.
    • ؟ يرجى الرجوع إلى الموقع التالي: قائمة الرموز التعبيرية ، القاموس الأساسي ، الألوان التقليدية اليابانية
    • على سبيل المثال ، إذا استبدلت كل شيء ، فسيبدو هكذا: 
     <!-- 変更後 -->
  ~~
  },
  {
    "name": "oginochihiro",
    "github": "https://github.com/first-contributions-ja",
    "favoriteColor": "#ffffff",
    "favoriteEmoji": "?"
  }
]

الخطوة 5: ارتكاب التغييرات

  • ارجع إلى المحطة واستخدم الأمر التالي لارتكاب التغييرات في المستودع المحلي:
    • لا تنس أن تحل محل yourname باسم المقبض الخاص بك. 
     git add .
git commit -m "yournameをコントリビューターに追加"

نصيحة

سيؤدي هذا إلى تسجيل أي تغييرات تقوم بها على ملف المساهمين.

الخطوة 6: ادفع التغييرات

  • ادفع التغييرات في مستودع مستودع عن بُعد المتشعب: 
     git push origin HEAD

نصيحة

هذا سيسمح للالتزامات التي ذكرتها سابقًا (التغييرات المحلية) لمستودعك عن بُعد على Github؟

الخطوة 7: إنشاء طلب سحب (PR)

  • انتقل إلى صفحة مستودع Remote Forked على Github ( https://github.com/あなたのアカウント/first-contributions-ja.github.io ).
  • انقر فوق الزر "مقارنة وسحب الطلب" في الأعلى.

  • ثم ، بعد تأكيد ما يلي ، انقر فوق الزر "إنشاء سحب طلب".
    • لتكون آمنًا فقط ، تأكد من أنك تتجه من فرع add-yourname لمستودعك إلى الفرع main للرسوم الأولى-JS!
    • يظل العنوان بمثابة مدخلات أولية ، والوصف فارغ!

نصيحة

هذا سيطلب أن تنعكس أي تغييرات أجريت من قبل Forking في المستودع الذي تتفرج إليه؟

الخطوة 8: الرد على المراجعات والتعليقات

سيتم مراجعة العلاقات العامة الخاصة بك (تأكيد) من قبل المشروع المشروع.

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

سيتم إجراء معظم المراجعات في غضون 24 ساعة ، ولكن قد يكون هناك تأخير لعدة أيام. من فضلك انتظر بصبر ☕

ينهي:؟

  • بمجرد الموافقة على طلب السحب ، سيتم دمج أي تغييرات تقوم بإجراءها في المشروع الرئيسي.

شكرا لك على عملك الشاق!
وشكرا على وقتك وجهدك للمساهمة في المساهمات الأولى JA! !


المزيد من الخطوات

مهم

إذا وجدت هذا المشروع مفيدًا ، فاضغط على زر النجوم من أعلى الصفحة!
أيضا ، شارك مع متابعيك ومعارفك لنشر هذا المشروع!

لقد تعلمت كيفية المساهمة في مشاريع مفتوحة المصدر!

  • انظر إلى الوراء إلى العمل الذي قمت به وحافظ على معرفتك في مكانه.
    • لقد أكملت للتو سير العمل القياسي الذي تواجهه غالبًا كمساهم: اقرأ الوثائق → شوكة → قم بإجراء تغييرات → سحب !
  • المساهمات الأولى JA هي مشروع مفتوح المصدر ، بحيث يمكنك المساهمة بطريقة مختلفة عن البرنامج التعليمي أعلاه.
    • يرجى إعلامنا برأيك في هذا المشروع في المناقشات؟
    • إذا كنت مهتمًا ، تحقق من مساهمات أخرى.
  • يرجى أيضا المساهمة في مشاريع أخرى مفتوحة المصدر!
    • تحقق من موضوعات المبتدئين على Github (المصمم الأول والقضية الجيدة الأولى)!
    • إذا كان لديك مستودع تريد المساهمة فيه ، فابحث عن المشكلات المسمى " العدد الأول الجيد ".
    • يمثل هذا عمومًا مشكلة للمبتدئين الذين يعانون من جدد في مشاريع محددة أو مفتوح المصدر نفسه!

مساهمات أخرى

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

رخصة

هذا المشروع مرخص بموجب ترخيص معهد ماساتشوستس للتكنولوجيا.

شكر وتقدير

يتضمن هذا المشروع مسامير أولية ومساهمة في هذا المشروع.
يتأثر بمشروع رائع مفتوح المصدر مصمم للمبتدئين.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل