rhymus

القافية

مشروع لعبة قافية مفتوحة المصدر مصمم للمطورين الجدد والمساهمين لأول مرة.

أخبار

اعتبارًا من 22 يناير ، أصبح فرع master-vue الآن جاهزًا للمساهمات! يمكنك استخدام الفرع master الحالي كنموذج لكيفية تطوير تطبيق VUE. المدرجة في مشروع VUE هي اختبارات الوحدة (باستخدام Jest) و Vuex (لإدارة الدولة).

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

بصفتي مطور VUE محترف ، سأشارك بشكل خاص في المساهمات وأي أسئلة تدور حول فرع master-vue ، لذلك لا تتردد في طلب المشورة وتقديم هذه PRS!

طريقة اللعب

Rhymus هي لعبة مفتوحة المصدر ستعرض البطاقات مع جمل عليها. سيكون لكل جملة كلمة واحدة لا معنى لها ولكن القوافي مع كلمة تفعل. على سبيل المثال ، "لدي ضباب حيوان أليف." -> الإجابة: "الكلب". يمنحك المؤقت 30 ثانية لإكمال أكبر عدد ممكن.

تصميم

هذا المشروع سوف يمر عبر مرحلتين . الأول سيكون بناءًا أوليًا باستخدام الواجهة الخلفية للعقدة و HTML و CSS و JS الأمامي. للبناء الأول ، لن يكون هناك تطبيق React/Redux.

بمجرد اكتمال البناء الأول وإكمال الميزات ، سيتم إنشاء فرعين جديدين يتم فيه إعادة بناء المشروع باستخدام React و Vue .

مساهمات

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

• تحرير ReadMe
• إنشاء ملفات جديدة لهيكل المشروع
• إعادة هيكلة المشروع للامتثال لأفضل الممارسات
• ترميز أي من الواجهة الأمامية أو الخلفية
• ملفات اختبار الترميز
• تقديم تصميم بديل
• اقتراح ممارسات أفضل لإدارة جيثب (بما في ذلك إرشادات المساهمة)

إرشادات المساهمة

عند المساهمة ، يرجى استخدام الإرشادات التالية:

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

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

دليل كامل للمبتدئين

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

1. انقر فوق شوكة في الجزء العلوي الأيمن لإنشاء نسخة من هذا المستودع.
2. على افتراض أنك قمت بتثبيت Gitbash ، انقر بزر الماوس الأيمن فوق مجلد المستندات الخاص بك (حيث تقوم بتخزين مجلدات المشروع) وفتح في Gitbash.
3. اكتب git clone https://[email protected]/username/rhymus .
4. افتح هذا المجلد في IDE الخاص بك (مثل Visual Studio Code).
5. في المحطة الخاصة بك (افتح من الجزء العلوي المنسدلة في Terminal في VS Code) ، اكتب git checkout -b add-puzzle .
6. على اليسار ، افتح مجلد SRC ثم مجلد JS و Opengles.js .
7. اتبع النمط الذي تراه هناك وإنشاء لغز قافية جديد وحفظ التغييرات الخاصة بك.
8. في المحطة الخاصة بك ، اكتب git commit -m "added new puzzle" .
9. في المحطة الخاصة بك ، اكتب في git remote add origin https://[email protected]/username/rhymus .
10. في المحطة الخاصة بك ، اكتب git push origin add-puzzle .
11. في GitHub ، انتقل إلى مستودعك وحدد فرع Add-Puzzle .
12. انقر على زر طلب السحب الجديد وقم بملء ذلك.

منتهي!

لكن انتظر ، ماذا حدث للتو؟

1. أنشأ Forking نسخة من المستودع تحت حساب GitHub الخاص بك. 2 - 3) باستخدام Gitbash ، يمكنك وضع نسخة من هذا المستودع على جهازك المحلي حيث يمكنك فتح وتحرير جميع الملفات. الاستنساخ فقط يجعل نسخة دقيقة من المستودع يشير عنوان URL إلى. 4 - 5) فتحت المجلد وأنشأت فرعًا جديدًا. ينتقل Checkout إلى فرع جديد ، ويعني -B أنه سيقوم بإنشاء الفرع الجديد. 6 - 7) أضفت لغزًا جديدًا يتبع النمط ، نأمل!
2. لقد ارتكبت حفظك! هذا يعني أنك تم حفظها رسميًا وحصلت على تغييراتك جاهزة للدفع إلى مستودعك رسميًا. يشير -M إلى رسالة مرتبطة بالالتزام حتى تتمكن أنت والآخرين من رؤية ما يدور حوله الالتزام.
3. لقد أضفت جهاز تحكم عن بعد! هذا مكان ستدفعه بانتظام. ستقوم بإضافة جهاز تحكم عن بعد واحد فقط ، ثم تعطيه لقبًا (عادةً ما يكون أصلًا) يمكنك استخدامه بدلاً من كتابة عنوان URL الطويل في كل مرة.
4. لقد دفعت من حفظ المحلية إلى مستودعك على فرع الإضافات! التزامك هو رسميا في مستودعك عبر الإنترنت! 11 - 12) لقد قدمت طلب سحب ، وهو طلب للمستودع الأصلي (هذا واحد) لقبول التغييرات الخاصة بك في القاعدة!

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

إذا كنت تشعر بالجرأة ، فقم بإجراء المزيد من التغييرات ، والرابطة ، والدفع ، والعلاقات العامة!

عن المؤلف

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