1
0
forked from ti-nuage/site
This commit is contained in:
David Soulayrol 2023-11-11 23:29:00 +01:00
parent 86bc5e3d4f
commit 6eea7a7d7b

View File

@ -5,7 +5,7 @@ Le site de l'association doit décrire ses missions et fournir un aperçu des se
## Génération du site
Le site est créé à l'aide du logiciel libre [MetalSmith](http://www.metalsmith.io). Il s'agit d'un outil de tansformation de fichiers qui permet en particulier la génération de sites statiques. L'intérêt de tels sites est leur facilité de déploiement, le peu d'usage qu'ils font en terme de ressources et leur robustesse. L'inconvénient est la nécessité de connaître quelques rudiments sur l'usage d'une ligne de comande pour re-générer et re-déployer le site à chaque modification.
Le site est créé à l'aide du logiciel libre [MetalSmith](http://www.metalsmith.io). Il s'agit d'un outil de transformation de fichiers qui permet en particulier la génération de sites statiques. L'intérêt de tels sites est leur facilité de déploiement, le peu d'usage qu'ils font en terme de ressources et leur robustesse. L'inconvénient est la nécessité de connaître quelques rudiments sur l'usage d'une ligne de commande pour régénérer et redéployer le site à chaque modification.
### Préparation des sources
@ -15,7 +15,7 @@ Les sources peuvent être téléchargées depuis le dépôt **Gitea** ou bien co
git clone https://apps.ti-nuage.fr/gitea/ti-nuage/site.git
Le projet s'appuie sur un certain nombre de dépendances, utiles au developpement ou à la génération du site lui-même. Pour installer ces dépendances :
Le projet s'appuie sur un certain nombre de dépendances, utiles au développement ou à la génération du site lui-même. Pour installer ces dépendances :
npm install
@ -26,13 +26,13 @@ Le script `package.json` comprend une série de commandes utiles au développeme
- pour générer le site : `npm run build`,
- pour le servir localement et le tester sur son navigateur : `npm run server`.
La liste des dommandes existantes est disponible avec `npm run`. Il est possible d'obtenir davantage d'informations en cas de problème avec la variable d'environnement `DEBUG`. Par exemple :
La liste des commandes existantes est disponible avec `npm run`. Il est possible d'obtenir davantage d'informations en cas de problème avec la variable d'environnement `DEBUG`. Par exemple :
DEBUG=metalsmith* npm run build
## Structure
Le site de l'association est essentiellement composé de pages statiques. Les billets d'actualité et les comptes-rendus de réunion sont eux-même générés ou assemblés avec le reste des pages du site.
Le site de l'association est essentiellement composé de pages statiques. Les billets d'actualité et les comptes-rendus de réunion sont eux-mêmes générés ou assemblés avec le reste des pages du site.
Cependant, afin d'être réactif, l'affichage des événements du calendrier partagé de l'association est effectué depuis le navigateur. Si le navigateur dispose d'un support Javascript actif, alors :