freshman

# Ленивый пакет первокурсника NTUST (freshman) «Ленивый пакет первокурсника NTUST» — это открытое руководство для первокурсников, совместно поддерживаемое студентами Национального тайваньского университета науки и технологий (NTUST). Цель проекта — систематизировать частые вопросы и трудности, с которыми сталкиваются новички при выборе курсов, проживании и в повседневной жизни, а также позволить каждому вносить вклад и исправлять содержание через открытый исходный код. ## Основное содержание Руководство охватывает четыре основных направления: * **Выбор курсов**: от знакомства с терминами до практических советов. * **Жизнь**: включает информацию о проживании, питании, транспорте и клубах. * **Информация**: использование университетских аккаунтов, процесс оплаты, полезные инструменты и ссылки на сообщества. * **Прочее**: частые вопросы новичков (FAQ) и малоизвестные факты о NTUST. ## Особенности * **Контент по специальностям**: сайт отображает советы и информацию от старшекурсников в зависимости от выбранной пользователем специальности. * **Академический календарь**: автоматически синхронизирует и показывает календарь на учебный год из официальных объявлений университета. * **Открытый вклад**: все статьи написаны в виде чистых Markdown-файлов, поэтому участники могут напрямую исправлять опечатки или дополнять содержание через веб-интерфейс GitHub, что снижает порог входа. ## Техническая архитектура * **Фреймворк**: используется Astro 7 для генерации статического сайта (SSG). * **Управление контентом**: Markdown с content collections и строгой схемой zod для структурированного управления. * **Развертывание**: размещается на Cloudflare Pages. * **Расширение синтаксиса**: поддержка специального синтаксиса Markdown через пользовательские remark-directive и сериализатор. ## Разработка и вклад Для проекта требуется Node.js версии 22.12 или выше. Участники должны следовать правилам Conventional Commits и использовать префиксы `feat/` или `fix/` для именования веток. Изменения контента должны сопровождаться источниками или личным опытом, а годовые данные (например, суммы, тарифы) должны содержать дату проверки. Тексты интерфейса и контент написаны на традиционном китайском, а комментарии в коде — на английском. ## Лицензия и отказ от ответственности Проект распространяется под лицензией GNU Affero General Public License v3.0. Важно отметить, что проект не имеет официальной связи с Национальным тайваньским университетом науки и технологий; содержание составлено студентами на основе их опыта, и фактические правила, суммы и сроки всегда определяются официальными объявлениями университета.