HUGOHUGO

HUGO

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 su ou sudo

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.