Mémoire de fin de Master

Titre : DEPNUM

Auteur : Théophile Gervreau-Mercier

Voir le site en local

Lancé la commande :

zola serve

pour voir une version locale dans votre navigateur.

Système de publication

Je pars du principe que je n'ai pas besoin d'expliquer comment cloner un repository git sur ta machine localement, comment lancer des lignes de commandes, installer des paquets sur ton système, etc. Une connaissance de base de Linux est requise.

Pour générer le site, il vous faudra

• zola version 0.19.2
• pandoc pour générer l'EPUB
• rynsc pour l'envoi du site produit aux espaces d'hébergement
• just si vous voulez utiliser le système de build plus avancé.
• le shell bash suffit.

just

À la racine du dossier, il y a un fichier nommé Justfile. Ce fichier contient la recette pour construire le site avec zola puis envoyé grâce à rsync le contenu du dossier public à mes espaces d'hébergement :

• un serveur caddy auto-hébergé, accessible à https://depnum.happyngreen.fr
• un repo pages ici sur codeberg, accessible à https://depnum.codeberg.pages

Pour lancer la création du site, lancez la commande suivante :

just

build.sh

Alternativement, vous pouvez utiliser le script bash build.sh. Vérifiez que vous avez le shell BASH sur votre ordinateur.

Puis lancez le script comme ceci :

bash build.sh

le flag -h permet d'avoir plus de détails sur l'utilisation du script.

Erreur de build

Comme vous n'avez pas la clé SSH pour publier les contenus sur les serveurs appropriés, le script va terminer par une erreur. Cela est dû au fait que rsync utilise ma clé SSH pour envoyer les données aux espaces d'hébergement. Sans elle, les accès sont impossibles pour des raisons de sécurité.