Installer et Utiliser des Thèmes
Hypothèses
- Vous avez déjà installé Hugo sur votre machine de développement.
- 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 abordés.
Installer Tous les Thèmes
Vous pouvez installer tous les thèmes Hugo disponibles en clonant tout le 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 racine de theme. 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 :
cd themes
git clone 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
Assurez-vous que vous avez 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 tout ce qui se 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 la CLI 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 themename
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 themename
Fichier config
Si vous avez déjà décidé sur le 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