markdown dungeon

dungeon dungeon ⚔

الزنزانة هي مكان أو سجن يحتجز فيه الناس. عادة ، يمكن العثور عليها تحت الأرض

هذا مثال على التوضيح الريبو لأزواج باستخدام Markdown على Github. في الزنزانة ، يختار القارئ خيار أخذ ويقفز إلى صفحة مناسبة من الغرفة التي تعتمد على اختيارها. إنه تعاوني لأن الغرفة كتبها العديد من المؤلفين.

ابدأ لعبة جديدة

؟ تثبيت

تحتاج إلى تثبيت الغزل.

1. استنساخ الريبو

git clone https://github.com/MakeContributions/markdown-dungeon.git

2. اذهب إلى المجلد

 cd markdown-dungeon

3. تشغيل تثبيت التبعية

yarn

4. إنشاء ملف .env.development في مجلد جذر المشروع ونسخ تنسيق ملف .env.example .
5. لبدء تشغيل خادم التطوير:

yarn start

تأكد من أنك لا تستخدم PowerShell

6. ؟ افتح متصفحك وانتقل إلى http: // localhost: 8000/أو http: // localhost: 8000/___ graphql

الأرضية وتنسيق الغرفة

الطابق عبارة عن مجلد وكل طابق عبارة عن مجموعة من الغرف وكل غرفة عبارة عن ملف Markdown . يتم استخدام روابط القدرة على تخفيض التنقل لأعلى/لأسفل والانتقال إلى غرفة أخرى ، مثل المثال أدناه.

اذهب إلى Github Dungeon

 [ Go to Github dungeon ] ( https://github.com/ ) 

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

1.؟ قم بإجراء تغييرات كبيرة الحجم

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

فيما يلي بعض الأمثلة على التغييرات المناسبة:

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

2. ⛩ بنية الزنزانة

يجب أن يكون الهيكل dungeon-name/floor-number/room-number ، يرجى الاطلاع على التعريفات أدناه لكل متغير:

• Dungeon-Name: هو مجلد يحتوي على رقم أرضي ، يجب أن يفصل كلمات مع اندفاعة (-) ، الأبجدية الرقمية. مثال: Normal-Dungeon-1 .
• رقم الكلمة: هو مجلد يحتوي على رقم الغرفة ، لا يضيف 0 قبل الرقم.

 1, 2, 3 // Compliance

01, 02, A3 // Non-Compliance

• رقم الغرفة: هو ملف تخفيض ، يجب أن يكون اسم الملف في رقمي ، ولكن إذا كان يحتوي على غرف فرعية من الغرفة ، فيمكنك فصل رقم الغرفة مع اندفاعة (-) ، فقد تكون الغرفة الفرعية أبجديًا.

 1, 2, 3-AF, 3-01 // Compliance

01A, 02*A3, A3+F // Non-Compliance

يستقبل المجلد أو اسم الملف فقط جميع أحرف ASCII و DASH (-).

إذا قمت بإنشاء زنزانة جديدة ، فيرجى إضافة Int start لعبة جديدة ، وأضفها على مجلد الصور ، وفي The Dungeon-info.json ، حتى يتمكن القارئ من الذهاب إلى زنزانة الخاص بك وفتحها على الموقع الإلكتروني

إذا كنت ترغب في الحصول على فكرة عن الخيار الذي يؤدي إلى ما يساهم عند المساهمة ، فابحث عن ملف decision_tree.png تحت أي مجلد Dungeon ، والذي يحتوي على عرض رسومي لتلك الزنزانة.

3.؟ استخدم الروابط النسبية

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

4.؟ أطوال الخط

الحفاظ على جميع الخطوط 120 حرفًا أو أقل. خلاف ذلك ، سيكون من الصعب قراءة الملفات الأولية في المتصفح أو في سطر الأوامر ، وسيكون التغييرات أكثر صعوبة في المراجعة.

5.؟ خطوط فارغة بين الخيارات

أدخل خطوط فارغة بين الخيارات المختلفة بحيث يتم فصل الخيارات بصريًا.

رخصة

معهد ماساتشوستس للتكنولوجيا