freshman

# 臺科新生懶人包 (freshman) 「臺科新生懶人包」は、国立台湾科技大学の学生が共同で維持するオープンソースの新入生向けガイドです。このプロジェクトは、新入生が履修登録、宿舎、日常生活などで直面する疑問や問題を体系的に整理し、オープンソース方式で誰もが内容に貢献・修正できるようにすることを目的としています。 ## 主な内容 ガイドは以下の4つの側面をカバーしています： * **履修登録**：専門用語の理解から実践的なテクニックまで。 * **生活**：宿舎、食事、交通、サークル情報を含む。 * **情報**：キャンパスアカウントの利用、支払い手続き、便利なツールの紹介、コミュニティリンク。 * **その他**：新入生のよくある質問（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でライセンスされています。特に注意すべき点として、このプロジェクトは国立台湾科技大学とは公式な関連がなく、内容は学生が経験に基づいて整理したものであり、実際の規定、金額、スケジュールはすべて学校の公式発表が優先されます。