منصوبے کے بارے میں

VIM Master ایک انٹرایکٹو، براؤزر پر مبنی گیم ہے جو Vim سیکھنے کے لیے بنائی گئی ہے۔ دستاویزات پڑھنے کے بجائے، کھلاڑی ایک نقلی ایڈیٹر ماحول میں مختصر، مرکوز اسباق مکمل کرتے ہیں، جن میں بتدریج مشکل اور گیمیفیکیشن عناصر جیسے XP، کمبوز، اچیومنٹس اور بیجز شامل ہیں۔ README میں بیان کردہ اہم خصوصیات: - نقلی Vim ایڈیٹر میں انٹرایکٹو سیکھنا۔ - گیمیفیکیشن: XP، کمبوز، اچیومنٹس اور بیجز۔ - JSON پر مبنی مواد انجن: ہر سبق ایک خود مختار JSON فائل ہے۔ - پریکٹس ایرینا، وقت کی حد کے ساتھ رفتار اور درستگی کے چیلنجز کے لیے۔ - چیٹ موڈ، ایک قابل رسائی کمانڈ ریفرنس۔ - مقامی سیو، بیجز اور XP کے لیے، امپورٹ/ایکسپورٹ سپورٹ کے ساتھ۔ مقامی طور پر چلانے کے لیے ریپوزٹری کلون کرنا، npm کے ساتھ ڈیپنڈنسیز انسٹال کرنا، چیک اسکرپٹ چلانا اور ڈیولپمنٹ سرور شروع کرنا ضروری ہے۔ گیم Vite کے ذریعے پیش کی جاتی ہے، عام طور پر http://localhost:5173/ پر۔ آرکیٹیکچر: V3 سے پروجیکٹ ایک مواد پلیٹ فارم آرکیٹیکچر استعمال کرتا ہے۔ انجن مواد استعمال کرتا ہے، اسباق کو ہارڈ کوڈ نہیں کرتا۔ اسباق content/lessons/*.json میں رہتے ہیں، اور ایک بلڈ مرحلہ (npm run build:content) انہیں content/index.json میں مرتب کرتا ہے، جسے انجن پڑھتا ہے۔ ریپوزٹری کو content (اسباق اور اسکیما)، docs (کمیونٹی گائیڈز، آرکیٹیکچر، اصول)، js (انجن، پروگریس سسٹم، UI اجزاء) اور tests میں منظم کیا گیا ہے۔ ٹیسٹنگ اور توثیق: پروجیکٹ چار حصوں کی حکمت عملی بیان کرتا ہے۔ ایک کنٹریکٹ سویٹ JSON اسباق کو سخت اسکیما کے خلاف جانچتا ہے۔ ایک گولڈن سویٹ سبق کے حل صف سے عین کلیدی پریسز انجن کے ذریعے چلاتا ہے اور حتمی ایڈیٹر حالت کو targetContent کے خلاف چیک کرتا ہے۔ ایک ریگریشن سویٹ پہلے سے طے شدہ بگز سے بچاتا ہے، اور ایک یونٹ سویٹ اندرونی حالت منطق اور مددگاروں کی تصدیق کرتا ہے۔ یہ سب npm run check کے ساتھ چلائے جا سکتے ہیں۔ شراکت: آرکیٹیکچر کا مقصد شراکت داروں کو انجن کو سمجھے بغیر اسباق شامل کرنے کی اجازت دینا ہے۔ ایک سبق شامل کرنے کے لیے ایک موجودہ JSON فائل کاپی کرنا، متن میں ترمیم کرنا اور پل ریکویسٹ کھولنا بیان کیا گیا ہے، جس کے لیے docs/community/contributing-a-lesson.md میں ایک مخصوص گائیڈ موجود ہے۔ روڈ میپ آئٹمز میں مکمل شدہ JSON سے چلنے والی مواد منتقلی، ٹیسٹنگ سویٹس، دستاویزات اور گیمیفیکیشن کے ساتھ کمیونٹی الفا، جاری V3 UX پالش (پہلی بار صارف کا تجربہ، کم سے کم UI، کم علمی بوجھ)، اور ایک منصوبہ بند عوامی بیٹا شامل ہیں۔ پروجیکٹ MIT لائسنس کے تحت جاری کیا گیا ہے۔