freshman

#臺科新生懶人包 (freshman) 「臺科新生懶人包」 राष्ट्रीय ताइवान प्रौद्योगिकी विश्वविद्यालय के छात्रों द्वारा साझा रूप से बनाए रखा गया एक खुला स्रोत नवागंतुक गाइड है। इस परियोजना का उद्देश्य नए छात्रों द्वारा कोर्स चयन, आवास, दैनिक जीवन आदि में सामना की जाने वाली सामान्य उलझनों और समस्याओं को व्यवस्थित रूप से संकलित करना है, और खुले स्रोत के माध्यम से सभी को सामग्री में योगदान और सुधार करने की अनुमति देना है। ## मुख्य सामग्री गाइड निम्नलिखित चार पहलुओं को शामिल करता है: * **कोर्स चयन**: विशेष शब्दों की पहचान से लेकर व्यावहारिक तकनीकों तक। * **जीवन**: आवास, भोजन, परिवहन और क्लब जानकारी शामिल है। * **सूचना**: परिसर खाता उपयोग, भुगतान प्रक्रिया, उपयोगी उपकरण अनुशंसाएँ और सामुदायिक लिंक। * **अन्य**: नए छात्रों के सामान्य प्रश्न (FAQ) और ताइवान प्रौद्योगिकी विश्वविद्यालय की रोचक जानकारी। ## विशेषताएँ * **विभाग-विशिष्ट सामग्री**: वेबसाइट उपयोगकर्ता द्वारा चुने गए विभाग के आधार पर सीधे वरिष्ठ छात्रों के सुझाव और जानकारी प्रदर्शित करती है। * **शैक्षणिक कैलेंडर**: स्कूल की घोषणाओं से लिए गए शैक्षणिक कैलेंडर को स्वचालित रूप से सिंक और प्रदर्शित करता है। * **खुला योगदान**: सभी लेख सामग्री शुद्ध 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 के तहत लाइसेंस प्राप्त है। विशेष रूप से ध्यान दें कि यह परियोजना राष्ट्रीय ताइवान प्रौद्योगिकी विश्वविद्यालय से आधिकारिक रूप से संबद्ध नहीं है; सामग्री छात्रों द्वारा अनुभव के आधार पर संकलित की गई है, और वास्तविक नियम, राशि और समय-सारणी हमेशा स्कूल की आधिकारिक घोषणाओं के अनुसार होते हैं।