Personnaliser un Thème
Voici les concepts clés pour la personnalisation d’un site Hugo avec des thèmes. Hugo vous permet de compléter ou remplacer tout modèle de thème ou fichier statique par des fichiers dans votre répertoire de travail.
Remplacer les Fichiers Statiques
Il y a des moments où vous souhaitez inclure des actifs statiques qui diffèrent des versions du même élément livré avec un thème.
Par exemple, un thème peut utiliser jQuery 1.8 à l’emplacement suivant :
/themes/<THEME>/static/js/jquery.min.js
Vous souhaitez remplacer la version de jQuery qui est livrée avec le thème par le jquery-3.1.1.js plus récent.
La façon la plus simple de le faire est de remplacer le fichier par un fichier du même nom dans le même chemin relatif à la racine de votre projet. Par conséquent, modifiez jquery-3.1.1.js vers jquery.min.js afin qu’il soit identique à la version du thème et placez le fichier ici :
/static/js/jquery.min.js
Remplacer les Fichiers de Modèle
Chaque fois que Hugo recherche un modèle correspondant, il vérifiera d’abord le répertoire de travail avant de regarder dans le répertoire des thèmes. Si vous souhaitez modifier un modèle, créez simplement ce modèle dans votre répertoire local layouts.
La commande de recherche de modèle explique les règles que Hugo utilise pour déterminer quel modèle utiliser pour un contenu donné. Lisez et comprenez ces règles avec attention.
Ceci est particulièrement utile lorsque le créateur du thème a utilisé des modèles partiels. Ces modèles partiels sont parfaits pour une injection facile dans le thème avec une maintenance minimale pour assurer une compatibilité future.
Par exemple:
/themes/<THEME>/layouts/_default/single.html
serait remplacé par
/layouts/_default/single.html
Remplacer les archétypes
Si l’archétype livré avec le thème pour un type de contenu donné (ou tous les types de contenu) ne correspond pas à la façon dont vous utilisez le thème, n’hésitez pas à le copier dans votre dossier `/archetypes’ et à y apporter des modifications comme bon vous semble .