freshman

# 臺科新生懶人包 (freshman) 「臺科新生懶人包」ایک اوپن سورس نیو طلبہ گائیڈ ہے جسے نیشنل تائیوان یونیورسٹی آف سائنس اینڈ ٹیکنالوجی کے طلبہ مشترکہ طور پر برقرار رکھتے ہیں۔ اس پروجیکٹ کا مقصد نئے طلبہ کو کورس انتخاب، رہائش، روزمرہ زندگی وغیرہ میں درپیش الجھنوں اور مسائل کو منظم طریقے سے مرتب کرنا ہے، اور اوپن سورس طریقے سے سب کو مواد میں تعاون اور اصلاح کی اجازت دینا ہے۔ ## اہم مواد گائیڈ چار اہم پہلوؤں کا احاطہ کرتی ہے: * **کورس انتخاب**: تکنیکی اصطلاحات کی شناخت سے لے کر عملی مہارتوں تک۔ * **زندگی**: رہائش، کھانے، نقل و حمل اور کلبوں کی معلومات شامل ہیں۔ * **معلومات**: کیمپس اکاؤنٹ کا استعمال، فیس کی ادائیگی کے عمل، مفید ٹولز کی سفارشات اور سوشل لنکس۔ * **دیگر**: نئے طلبہ کے عمومی سوالات (FAQ) اور NTUST کے دلچسپ حقائق۔ ## خصوصیات * **شعبے کے مخصوص مواد**: ویب سائٹ صارف کے منتخب کردہ شعبے کی بنیاد پر سینئر طلبہ کے مشورے اور معلومات دکھاتی ہے۔ * **تعلیمی کیلنڈر**: یونیورسٹی کے اعلانات سے تعلیمی کیلنڈر خودکار طور پر ہم آہنگ اور ظاہر کرتا ہے۔ * **کھلا تعاون**: تمام مضامین خالص Markdown فائلیں ہیں، شراکت دار GitHub ویب انٹرفیس پر براہ راست املا کی اصلاح یا مواد کی تکمیل کر سکتے ہیں، جس سے تعاون کی رکاوٹ کم ہوتی ہے۔ ## تکنیکی ڈھانچہ * **فریم ورک**: جامد ویب سائٹ جنریشن (SSG) کے لیے Astro 7 استعمال کرتا ہے۔ * **مواد کا انتظام**: ساختی انتظام کے لیے Markdown کو content collections اور zod strict schema کے ساتھ استعمال کرتا ہے۔ * **تعیناتی**: Cloudflare Pages پر میزبانی۔ * **نحو کی توسیع**: خصوصی Markdown نحو کے لیے حسب ضرورت remark-directive اور serializer استعمال کرتا ہے۔ ## ترقی اور تعاون پروجیکٹ کے لیے Node.js 22.12 یا اس سے اوپر کا ماحول درکار ہے۔ شراکت داروں کو Conventional Commits معیار پر عمل کرنا ہوگا اور شاخوں کے ناموں میں `feat/` یا `fix/` سابقہ استعمال کرنا ہوگا۔ مواد کی تبدیلیوں کے ساتھ ماخذ یا ذاتی تجربہ منسلک ہونا چاہیے، اور سالانہ ڈیٹا (جیسے رقم، شرح) پر تصدیق کی تاریخ درج ہونی چاہیے۔ UI متن اور مواد روایتی چینی میں ہیں، جبکہ کوڈ کے تبصرے انگریزی میں ہیں۔ ## لائسنس اور دستبرداری یہ پروجیکٹ GNU Affero General Public License v3.0 کے تحت لائسنس یافتہ ہے۔ خاص طور پر نوٹ کریں کہ اس پروجیکٹ کا نیشنل تائیوان یونیورسٹی آف سائنس اینڈ ٹیکنالوجی سے کوئی سرکاری تعلق نہیں ہے، مواد طلبہ کے تجربات کی بنیاد پر مرتب کیا گیا ہے، اور اصل قواعد، رقم اور نظام الاوقات ہمیشہ یونیورسٹی کے اعلانات کے مطابق ہوں گے۔