Installer et Utiliser des Thèmes

Hypothèses

1. Vous avez déjà installé Hugo sur votre machine de développement.
2. Vous avez installé git sur votre machine et vous êtes à l’aise avec un usage basique de git.

Installer des Thèmes

Les thèmes apportés par la communauté sur themes.gohugo.io sont hébergés dans un dépôt centralisé GitHub. Le dépôt “Hugo Themes” sur https://github.com/gohugoio/hugoThemes est vraiment un méta-référentiel qui contient des indications sur un ensemble de thèmes construits par la communauté.

Installer Tous les Thèmes

Vous pouvez installer tous les thèmes Hugo disponibles en clonant la totalité du dépôt Hugo Theme sur GitHub à partir de votre répertoire de travail. Selon votre connexion internet, le téléchargement de tous les thèmes peut prendre un certain temps.

git clone --depth 1 --recursive https://github.com/gohugoio/hugoThemes.git themes

Avant d’utiliser un thème, retirez le dossier .git dans ce dossier theme racine. Autrement, cela provoquera des problèmes si vous déployez en utilisant Git.

Installer un Thème Unique

Déplacez-vous dans le répertoire themes et téléchargez un thème en remplaçant URL_TO_THEME par l’URL du référentiel de thèmes :

cd themes
git clone URL_TO_THEME

L’exemple suivant montre comment utiliser le thème “Hyde”, qui a sa source hébergée sur https://github.com/spf13/hyde :

Alternativement, vous pouvez télécharger le thème en tant que fichier .zip, décompressez le contenu du thème, puis déplacez la source décompressée dans votre répertoirethemes.

Placement du Thème

Vérifiez d’avoir bien installé les thèmes que vous souhaitez utiliser dans le dossier / themes. C’est le répertoire par défaut utilisé par Hugo. Hugo est capable de modifier le répertoire des thèmes via la variable themesDir dans la configuration de votre site, mais cela n’est pas recommandé.

Utiliser les Thèmes

Hugo applique d’abord le thème décidé et applique ensuite tout ce qui s’y trouve dans le répertoire local. Cela permet une personnalisation plus facile tout en conservant la compatibilité avec la version en amont du thème. Pour en savoir plus, allez sur personnaliser les thèmes.

Ligne de Commande

Il existe deux approches différentes pour utiliser un thème avec votre site Web Hugo : via l’interface de ligne de commande Hugo ou dans le fichier de configuration.

Pour changer un thème via la CLI Hugo, vous pouvez passer le flag -t lors de la construction de votre site :

hugo -t nomtheme

Vous voudrez sans doute ajouter le thème lors de l’exécution du serveur local Hugo, surtout si vous comptez personnaliser le thème :

hugo server -t nomtheme

Fichier config

Si vous avez déjà décidé du thème de votre site et que vous ne voulez pas jouer avec la ligne de commande, vous pouvez ajouter le thème directement à votre fichier de configuration du site :

theme: nomtheme