freshman

# Pack de bienvenue NTUST (freshman) Le « Pack de bienvenue NTUST » est un guide open source pour les nouveaux étudiants, maintenu collectivement par les étudiants de l'Université nationale des sciences et technologies de Taïwan (NTUST). Le projet vise à organiser systématiquement les questions et difficultés courantes rencontrées par les nouveaux étudiants concernant la sélection des cours, le logement, la vie quotidienne, etc., et à permettre à tous de contribuer et de corriger le contenu grâce à l'approche open source. ## Contenu principal Le guide couvre quatre domaines principaux : * **Sélection des cours** : De la compréhension du jargon aux techniques pratiques. * **Vie quotidienne** : Informations sur le logement, la restauration, les transports et les clubs. * **Informations** : Utilisation des comptes campus, procédures de paiement, outils recommandés et liens vers les communautés. * **Autres** : Foire aux questions (FAQ) et anecdotes sur NTUST. ## Fonctionnalités clés * **Contenu spécifique par département** : Le site affiche des conseils et informations des étudiants parrains en fonction du département sélectionné par l'utilisateur. * **Calendrier académique** : Synchronise et affiche automatiquement le calendrier académique publié par l'administration. * **Contribution ouverte** : Tout le contenu des articles est en fichiers Markdown purs ; les contributeurs peuvent directement corriger des erreurs ou ajouter des informations via l'interface web de GitHub, réduisant ainsi la barrière à la contribution. ## Architecture technique * **Framework** : Utilisation d'Astro 7 pour la génération de site statique (SSG). * **Gestion du contenu** : Utilisation de Markdown avec des collections de contenu et un schéma strict zod pour une gestion structurée. * **Déploiement** : Hébergé sur Cloudflare Pages. * **Extensions de syntaxe** : Prise en charge d'une syntaxe Markdown spéciale via des directives remark personnalisées et un sérialiseur. ## Développement et contribution Le projet nécessite un environnement Node.js version 22.12 ou supérieure. Les contributeurs doivent suivre les règles des Conventional Commits et nommer leurs branches avec les préfixes `feat/` ou `fix/`. Les modifications de contenu doivent être accompagnées de sources ou d'expériences personnelles, et les données annuelles (comme les montants, tarifs) doivent inclure la date de vérification. Les textes d'interface et le contenu utilisent le chinois traditionnel, tandis que les commentaires de code sont en anglais. ## Licence et avertissement Ce projet est sous licence GNU Affero General Public License v3.0. Il est important de noter que ce projet n'a aucun lien officiel avec l'Université nationale des sciences et technologies de Taïwan ; le contenu est compilé par les étudiants selon leur expérience. Les règlements réels, les montants et les calendriers sont sujets aux annonces officielles de l'université.