Site web Hadoly

Le site web de Hadoly accessible via https://www.hadoly.fr consiste en une page web ainsi que les images, les styles CSS et le Javascript (Foundation, Modernizr, JQuery). Ce contenu est stocké sur le dépôt Git spécifique de tavernier, nommé hadoly_web dans /var/git

Son contenu et sa mise à jour sont gérés par Git.

Un hook Git copie le contenu poussé sur le dépôt (via git push...) directement dans le dossier servi par nginx.

Le contenu du site est donc une copie du dossier www/ du dépôt Git.

La page index.html du site web Hadoly contenue dans le dossier Git www/ est générée à partir des fichiers content/index_desc.md et content/index_panels.md ainsi que des fichiers templates content/template/base.html, content/template/header.html et content/template/index.html.

Par conséquent afin de modifier le contenu de la page web, il faut éditer les fichiers content/index_desc.md et content/index_panels.md puis regénérer la page www/index.html (et moins probablement les fichiers templates, voire même dans www/ hormis www/index.html).

La regénération du contenu de www/ peut se faire automatiquement avec la commande make clean all à la racine du dépôt. Il lancera le content/Makefile qui à son tour exécutera le script `content/generate_page.py*.

Il faudra bien penser à commiter les fichiers modifiés dans www/ et content/ avant de pousser vers le dépôt. Une fois poussé, le site web sera mis à jour.

Les étapes de mise à jour du site oueb sont les suivantes :

• récupérer le dépôt

Nous considérerons que vous avez votre clé ssh pour l'utilisateur git sur tavernier (/var/git) et que votre fichier de configuration ssh en local contient le host tavernier.

$ git clone tavernier:hadoly_web
$ cd hadoly_web

ou si déjà présent le mettre à jour :

$ cd hadoly_web
$ git pull origin master

• modifier le contenu

Modifiez les fichiers content/index_desc.md et content/index_panels.md (éventuellement les fichiers de content/template/, voire ceux du dossier www/ hormis www/index.html).

$ vim content/index_desc.md content/index_panels.md

• générer la page web et remplacer l'ancienne

La commande make va générer la nouvelle version de index.html et écraser l'ancienne version se trouvant dans le dossier www/.

$ make
make -C content
make[1] : on entre dans le répertoire « /home/user/hadoly_web/content »
mkdir -p build
./generate_page.py index.html > build/index.html
make[1] : on quitte le répertoire « /home/user/hadoly_web/content »
cp -f content/build/index.html www/

• commiter les changements

$ git add www/index.html content/index_desc.md content/index_panels.md
$ git commit -m "message décrivant la mise à jour"

• mise à jour du site web

Le site web sera mis à jour automatiquement sur le serveur avec le contenu du dossier www/ (et donc entre-autres le fichier index.html) après la synchronisation du dépôt distant.

$ git push origin master

Voilà le contenu du site oueb à jour !