عن المشروع

# حقيبة المبتدئين لجامعة تايوان الوطنية للعلوم والتكنولوجيا (freshman) «حقيبة المبتدئين لجامعة تايوان الوطنية للعلوم والتكنولوجيا» هي دليل مفتوح المصدر للمبتدئين، يُدار بشكل مشترك من قبل طلاب جامعة تايوان الوطنية للعلوم والتكنولوجيا. يهدف المشروع إلى تنظيم الأسئلة والمشكلات الشائعة التي يواجهها المبتدئون في مجالات اختيار المقررات الدراسية، والسكن، والحياة اليومية، وغيرها، بشكل منهجي، ويتيح للجميع المساهمة في المحتوى وتصحيحه من خلال النهج مفتوح المصدر. ## المحتوى الرئيسي يغطي الدليل الجوانب الأربعة التالية: * **اختيار المقررات**: من التعرف على المصطلحات المتخصصة إلى تقنيات عملية. * **الحياة**: يشمل معلومات عن السكن، والطعام، والمواصلات، والأنشطة الطلابية. * **المعلومات**: استخدام الحسابات الجامعية، وعمليات الدفع، وتوصيات الأدوات المفيدة، وروابط المجتمعات. * **أخرى**: الأسئلة الشائعة للمبتدئين (FAQ) ومعلومات طريفة عن الجامعة. ## الميزات الخاصة * **محتوى خاص بالتخصصات**: يمكن للموقع عرض النصائح والمعلومات من الطلاب المباشرين (المرشدين) بناءً على التخصص الذي يختاره المستخدم. * **التقويم الأكاديمي**: مزامنة وعرض التقويم الأكاديمي المستمد من إعلانات الجامعة تلقائيًا. * **المساهمة المفتوحة**: جميع المقالات هي ملفات Markdown نقية، ويمكن للمساهمين تصحيح الأخطاء الإملائية أو إضافة محتوى مباشرة عبر واجهة GitHub على الويب، مما يقلل من حاجز المساهمة. ## البنية التقنية * **الإطار**: استخدام Astro 7 لتوليد المواقع الثابتة (SSG). * **إدارة المحتوى**: استخدام Markdown مع مجموعات المحتوى (content collections) ومخطط zod الصارم (zod strict schema) للإدارة الهيكلية. * **النشر**: الاستضافة على Cloudflare Pages. * **توسيع الصياغة**: دعم صياغات Markdown خاصة عبر remark-directive مخصص و serializer. ## التطوير والمساهمة يتطلب المشروع بيئة Node.js 22.12 أو أحدث. يجب على المساهمين اتباع معايير Conventional Commits، واستخدام بادئات `feat/` أو `fix/` لتسمية الفروع. يجب إرفاق المصادر أو الخبرات الشخصية عند تعديل المحتوى، ويجب تحديد تاريخ التحقق للبيانات السنوية (مثل المبالغ والأسعار). نصوص واجهة المستخدم والمحتوى مكتوبة بالصينية التقليدية، بينما تعليقات الكود البرمجي بالإنجليزية. ## الترخيص وإخلاء المسؤولية هذا المشروع مرخص بموجب GNU Affero General Public License v3.0. يجب ملاحظة أن هذا المشروع لا يتبع رسميًا لجامعة تايوان الوطنية للعلوم والتكنولوجيا، والمحتوى مُعد من قبل الطلاب بناءً على خبراتهم، ويجب دائمًا الرجوع إلى إعلانات الجامعة الرسمية فيما يتعلق باللوائح والمبالغ والجداول الزمنية الفعلية.