Aller au contenu

Étiquette: Hugo Clarity

Déployer un site web statique Hugo sur Github Pages

# Dernière mise à jour : 01/11/2023 #

Le site que vous consultez est constitué d’un site web statique Hugo hébergé sur Github :

Github fournit la possibilité d’exposer un site web statique pour chaque dépôt public du compte. Il suffit d’avoir :

  • Du html+css dans le dépôt ;
  • La fonctionnalité Github Pages activée.

Le code statique de chaque dépôt sera alors accessible à l’url : https://MONLOGINGITHUB.github.io/MONDEPOT/

Hugo quand à lui est un générateur de sites web statiques : On écrit des pages en markdown, on lance Hugo, et il génère tout le html et la structure de site que Github exposera.

Mémo des modifications du thème hugo-clarity

Ce site est construit en combinant Hugo + Github Pages. J’utilise le thème hugo-clarity. Ce post récapitule les configurations et modifications que j’y ai apporté.

Le thème hugo-clarity demande pas mal de conf. Plutôt que partir de zéro j’ai suivi le conseil que donne sa doc d’install et je suis parti du examplesite/ fourni dans le thème, que j’ai ensuite modifié.

documents non-utilisés

Suppression des exemples en portugais

rm ./config/_default/menus/menu.pt.toml
rm ./content/about.pt.md

Suppression des pages exemples dans ./content

rm ./content/archives.md
rm ./content/homepage/about.md
rm ./content/homepage/work.md
rm ./content/post/* # exemples de pages
rm ./static/images/* # images non utilisées

Modification des fichiers de conf

Modification de _./config/default/config.toml

Modifié :