HUGO est un générateur de sites statiques qui permet de créer des sites web rapidement et en toute sécurité. Dans ce guide, nous allons installer HUGO localement sur un système Arch Linux, avec Node.js et NPM pour les outils front-end. Enfin, nous verrons comment déployer les modifications sur le serveur web à l’aide de rsync.
Information
Ce guide suppose l’existence d’un serveur web déjà configuré pour héberger votre site, par exemple sous /var/www/exemple.fr/public/, comme décrit dans d’autres articles.
Prérequis
- Un système local sous Arch Linux ou une dérivée (comme EndeavourOS ou Manjaro)
- Un nom de domaine
- DNS configuré vers l’adresse IP du serveur
- Un serveur web fonctionnel (NGINX)
- Des droits
suousudo
Préparation
sudo pacman -Syu
Installation de HUGO
sudo pacman -S hugo
hugo version
Installation de Node.js et NPM
sudo pacman -S nodejs npm
node -v
npm -v
Créer un nouveau site HUGO
mkdir -p ~/sites/exemple.fr
cd ~/sites/exemple.fr
hugo new site .
Ajouter un thème :
git init
git submodule add https://github.com/theme/exemple-theme.git themes/exemple-theme
nano config.toml
Ajouter :
theme = "exemple-theme"
Exécuter le site localement
hugo server -D
Visitez http://localhost:1313 pour voir le site.
Générer la version de production
hugo
Les fichiers générés se trouvent dans ./public/.
Transférer avec rsync
rsync -avz --delete ./public/ utilisateur@serveur:/var/www/exemple.fr/public/
Visitez https://exemple.fr pour le consulter en ligne.