freshman

# 臺科新生懶人包 (freshman) 「臺科新生懶人包」是一份由國立臺灣科技大學學生共同維護的開源新生指南。專案旨在將新生在選課、住宿、日常生活等方面常遇到的困惑與問題進行系統性整理，並透過開源方式讓所有人都能貢獻與修正內容。 ## 主要內容 指南涵蓋以下四大面向： * **選課**：從專有名詞認識到實戰技巧。 * **生活**：包含住宿、餐飲、交通及社團資訊。 * **資訊**：校園帳號使用、繳費流程、好用工具推薦及社群連結。 * **其他**：新生常見問題（FAQ）與臺科冷知識。 ## 特色功能 * **系別專屬內容**：網站能根據使用者選擇的系別，顯示直屬學長姐的建議與資訊。 * **學年行事曆**：自動同步並展示取自校方公告的學年行事曆。 * **開放貢獻**：所有文章內容均為純 Markdown 檔案，貢獻者可直接在 GitHub 網頁端進行錯字修正或內容補充，降低貢獻門檻。 ## 技術架構 * **框架**：使用 Astro 7 進行靜態網站生成（SSG）。 * **內容管理**：採用 Markdown 搭配 content collections 與 zod strict schema 進行結構化管理。 * **部署**：託管於 Cloudflare Pages。 * **語法擴充**：透過自定義 remark-directive 與 serializer 支援特殊的 Markdown 語法。 ## 開發與貢獻 專案要求 Node.js 22.12 以上環境。貢獻者需遵循 Conventional Commits 規範，並使用 `feat/` 或 `fix/` 前綴命名分支。內容修改需附上來源或親身經驗，且年度性資料（如金額、費率）需標明查證日期。UI 文案與內容使用繁體中文，程式碼註解則使用英文。 ## 授權與免責 本專案採用 GNU Affero General Public License v3.0 授權。需特別注意的是，此專案與國立臺灣科技大學無官方關聯，內容由學生依經驗整理，實際規定、金額與時程一律以校方公告為準。