Dans cet article, je vais vous expliquer comment créer un site statique avec Hugo, un générateur de sites rapide et moderne, puis comment le publier gratuitement avec GitHub Pages.

Prérequis

  • Installer Hugo
  • Avoir un compte GitHub
  • Git installé sur votre machine

Étapes de création

  1. Créer un nouveau site Hugo :
hugo new site mon-site
cd mon-site
  1. Ajouter un thème :

Ici j’utilise PaperMod, un thème simple et moderne.

git init
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
  1. Configurer le fichier config.toml
    Ajouter au moins :
baseURL = "https://votre-utilisateur.github.io/"
languageCode = "fr-fr"
title = "Mon site Hugo"
theme = "PaperMod"
  1. Créer du contenu

Par exemple un premier article :

hugo new posts/mon-premier-article.md
  1. Lancer un serveur local pour voir le site :
hugo server -D

Déploiement sur GitHub Pages

  1. Générer les fichiers statiques :
hugo -D
  1. Initialiser un dépôt dans le dossier public (où Hugo génère le site) :
cd public
git init
git remote add origin git@github.com:votre-utilisateur/votre-repo.git
git checkout -b gh-pages
git add .
git commit -m "Déploiement initial"
git push -f origin gh-pages
  1. Configurer GitHub Pages dans les paramètres du dépôt :
    Choisir la branche gh-pages comme source du site.

Conclusion

Avec Hugo et GitHub Pages, il est très simple et rapide de créer et héberger un site statique performant et gratuit.