Le site Web Centralassociation sert d’agrégateur de liens pour les Centraliens : sur cette même page sont centralisés les liens vers les réseaux sociaux et autres sites de chaque association de l'école.
La page principale est générée automatiquement par un script Python (3.9) et utilise la librairie Jinja2 pour automatiser l'écriture du html. Une documentation complète de la librairie est disponible sur le site officiel. Cependant, notre projet emploie uniquement les fonctionnalités de base.
Le choix d'une génération automatique s'explique par la redondance du code HTML de la page et dans l'ambition de faire un projet clair, facilement compréhensible et modifiable.
Pour faire bref :
- Les différents liens, leurs noms et descriptions sont écrits au format
YAMLdans le fichier assos_links.yaml. - Le script Python
build.pylit le fichier YAML et construit la page HTML à partir de celui-ci. - Le fichier final est enregistré dans le dossier
./distaux côtés des feuilles de styles CSS et des images.
Afin de faciliter la gestion l'adaptabilité de la page en fonction des thèmes et des différentes résolutions d'écrans, la feuille de style de la page est générée avec tailwind.
Pour mettre à jours le site, clonez le projet sur votre PC.
git clone https://github.com/aeecleclair/Centralassociation.gitDéplacez-vous dans le dossier du projet
cd ./centralassociationModifiez le fichier assos_links.yaml à votre guise.
Pour construire la page il faut exécuter le script Python. Assurez-vous d'avoir Python3.9 où supérieur installé avec la librairie Jinja2 et PyYAML. L'utilisation d'un environnement virtuel avec Poetry permet d'installer ces éléments.
Pour modifier le style de la page, assurez vous d'avoir installé tailwind via npm, il vous suffit alors de modifier les élements de style dans le fichier src/index.html, puis de générer la nouvelle feuille de style avec
npx tailwindcss -i ./src/input.css -o ./src/assets/stylesheet.css --minifyou
npm run devqui s'occupera également de la compilation.
Avec Poetry :
poetry run python ./build.pySinon simplement,
python ./build.pyRécupérer le résultat dans le dossier ./dist