Choisir et télécharger thème avec Hugo

Pour pouvoir choisir, installer et utiliser un thème avec Hugo, vous devrez d’abord vous assurer que Git soit installé. Hugo utilise Git comme gestionnaire de modules afin de télécharger et d’installer un thème depuis Github où d’autre site d’hébergement de projet git.

Vérifier la présence de GIT

Vous pouvez vérifier si git est présent sur votre ordinateur à l’aide de cette commande :

git version

Si vous obtenez une erreur, alors vous devrez installer git.

Choisir un thème

Vous pouvez choisir un thème sur le site officiel de Hugo. Une fois votre thème choisi, le lien « download » vous mènera vers le dépôt GitHub concerné.

Installer un thème

Afin d’obtenir l’URL de ce dépôt, une fois dans le dépôt du thème choisi, cliquez sur le bouton « code » afin de copier l’URL du dépôt se trouvant sous l’onglet « HTTPS ».

Par exemple, pour le thème « ananke » nous obtenons l’URL suivante :

https://github.com/theNewDynamic/gohugo-theme-ananke

Dans ce cas, pour installer un thème avec git, on utilisera la commande « submodule » avec L’URL ciblée.

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke themes/ananke

Activer un thème

Une fois installé, vous devrez activer votre thème afin que Hugo comprenne quel thème utiliser pour votre site. Pour ce faire, insérez la ligne :

theme='ananke'

dans le fichier config.toml présent à la racine de votre site.

Se documenter

Il faut comprendre que chaque thème sa propre logique de fonctionnement et donc sa propre documentation. C’est pourquoi il est très important de se documenter sur le thème utilisé.

Vous pouvez la documentation propre à chaque thème sur le dépôt du thème ou vous avez obtenu L’URL de téléchargement.