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

H5P Game Map ایک H5P مواد کی قسم ہے جو طلباء کو گیم میپ انٹرفیس سے اپنی مشقیں منتخب کرنے کی اجازت دیتی ہے۔ سپورٹ کی توقعات: README میں کہا گیا ہے کہ یہ مواد کی قسم مخصوص ضروریات کے ساتھ معاہدے کا کام ہے جو دوسرے صارفین کی توقعات سے مطابقت نہیں رکھ سکتا۔ ڈویلپر نے اسے کھلے عام دستیاب کیا تاکہ اسے مفت استعمال کیا جا سکے، لیکن وہ مفت سپورٹ فراہم کرنے، فیچر کی درخواستیں قبول کرنے یا پل ریکویسٹ قبول کرنے کا پابند نہیں ہے؛ وہ اپنی رفتار سے اس پر کام جاری رکھ سکتا ہے۔ دستاویز شدہ تعمیر کا ورک فلو: - ریپوزٹری کو git کے ساتھ کلون کریں اور جس برانچ میں آپ کی دلچسپی ہے اسے چیک آؤٹ کریں۔ - npm install چلائیں تاکہ مطلوبہ ماڈیولز انسٹال ہو جائیں۔ - npm run build چلائیں تاکہ پروجیکٹ کی تعمیر ہو، یا npm run watch چلائیں تاکہ ہر چیز کو مسلسل دوبارہ بنایا جائے جب آپ ترمیم کر رہے ہوں۔ - کوڈ کو پروڈکشن میں ڈالنے سے پہلے ہمیشہ npm run build چلائیں۔ - npm run lint چلائیں تاکہ کوڈنگ اسٹائل گائیڈ کی خلاف ورزیوں کی جانچ کی جا سکے۔ - تعمیر کا عمل ES6 کو پرانے ورژن میں تبدیل کرتا ہے تاکہ پرانے براؤزرز کے ساتھ مطابقت کو بہتر بنایا جا سکے؛ کچھ براؤزرز جو کچھ فنکشنز کو سپورٹ نہیں کرتے ہیں ان کے لیے ایک polyfill کی ضرورت ہوتی ہے۔ - تعمیر کا عمل سورس فائلز کو ایک ڈسٹریبیوشن فائل میں بھی منتقل کرتا ہے اور کوڈ کو minifies کرتا ہے۔ Semantics سائز کا حل: عام H5P انٹیگریشنز mySQL ڈیٹا بیسز کا استعمال کرتے ہیں جن میں h5p_libraries ٹیبل کا semantics فیلڈ text قسم کا ہوتا ہے، جو 64KB تک ڈیٹا رکھتا ہے۔ GameMap کا semantics.json اس حد سے زیادہ ہے، اس لیے پروجیکٹ semantics_src.json کو رکھتا ہے اور اسے minifies کرتا ہے، جس کے لیے npm run build_semantics استعمال ہوتا ہے۔ README میں نوٹ کیا گیا ہے کہ یہ مثالی نہیں ہے کیونکہ اسے semantics میں تبدیلی کے وقت چلانا پڑتا ہے، اور npm run build اور npm run watch بھی minified semantics کی تعمیر کرتے ہیں۔ پیکجنگ: README میں سفارش کی گئی ہے کہ H5P CLI ٹول انسٹال کیا جائے بجائے اس کے کہ ہر چیز کو دستی طور پر زپ کیا جائے، کیونکہ یہ ٹول کئی چیزوں کو خود بخود سنبھالتا ہے۔ سادہ معاملات میں، h5p pack چلانا اور پھر ریپوزٹری ڈائریکٹری اور ایک ٹارگٹ فائل کا نام دینا کافی ہے۔ H5P میں ڈسٹریبیوشن فائلز کے استعمال کے بارے میں مزید معلومات کے لیے، README ایک تعارفی ویڈیو اور h5p.org/library-development پر H5P ڈویلپر گائیڈ کی طرف اشارہ کرتا ہے۔ یہاں فراہم کردہ README میں لائسنس کی شرائط، ورژن کی معلومات، فیچر کی فہرست یا اختتامی صارف کے استعمال کی دستاویزات نہیں ہیں، صرف یہ تعمیر، semantics اور پیکجنگ کے نوٹ ہیں۔