¶ Introduction
Voici un court tutoriel pour apprendre comment mettre à jour la version Extended d'Hugo et le thème DoIt sur une Debian 12 Bookworm.
Je fais ce tutoriel car j'utilise Hugo pour mon blogue permettant ainsi la publication de mes articles.
Pour faire un tour sur mon blogue : https://blogue.tux-hopping.bzh
¶ Qu'est-ce que Hugo ?
Hugo est un des générateurs de sites statiques open-source les plus populaire écrit en go. Il permet ainsi pour une configuration légère de pouvoir créer en toute simplicité des pages internet permettant ainsi de faire des blogues, des sites de documentation, des CV, ...
Il existe 3 versions de Hugo :
| Description | Normal edition | extended edition | extended/deploy edition |
|---|---|---|---|
| Encodez au format WebP lors du traitement des images. Vous pouvez décoder les images WebP avec n'importe quelle édition. | Oui | Oui | Oui |
| Transpile de Sass au CSS en utilisant le transpileur LibSass intégré. Vous pouvez utiliser le transpileur Dart Sass avec n'importe quelle édition. | Non | Oui | Oui |
| Déployez votre site directement sur un bucket Google Cloud Storage, un bucket AWS S3 ou un conteneur Azure Storage. Voir détails. | Non | Non | Oui |
Source Hugo : https://gohugo.io/installation/linux/
TL;DR; Votre thème Hugo vous indiquera s'il nécessite une version Hugo Extended. Pour le théme DoIt, il est nécessaire de l'avoir !
¶ Télécharger Hugo et le thème DoIt
¶ Les pré-requis
Afin de faire toutes les manipulations, il est nécessaire d'avoir wget et git :
sudo apt install wget git
¶ MAJ Hugo
Pour mettre à jour Hugo, nous allons le faire à partir d'un fichier .deb à partir du dépôt GitHub de Hugo :
https://github.com/gohugoio/hugo/tags
Pour la version auquel je fais ma documentation, je vais prendre la version v0.145.0 :
cd ~/
wget https://github.com/gohugoio/hugo/releases/download/v0.145.0/hugo_extended_0.145.0_linux-amd64.deb
Ensuite vérifier si hugo est déjà installer sur votre système via dpkg :
debian@server~$ dpkg --list | grep hugo
ii hugo 0.139.0 amd64 A fast and flexible Static Site Generator written in Go.
Si c'est le cas comme ci-dessus, il suffit de le supprimer :
sudo dpkg -r hugo
Puis installer le paquet .deb précedemment téléchargé :
sudo dpkg -i hugo_extended_0.145.0_linux-amd64.deb
¶ Vérification d'Hugo
Afin de vérifier si Hugo est bel et bien installer, il suffit de faire :
debian@server:~$ hugo version
hugo v0.145.0-666444f0a52132f9fec9f71cf25b441cc6a4f355+extended linux/amd64 BuildDate=2025-02-26T15:41:25Z VendorInfo=gohugoio
Hugo est bien à la version v0.145.0.
¶ ⚠️ - SAUVEGARDE DE VOTRE SITE
AVANT DE TOUCHER VOTRE THÈME HUGO, IL EST TRÈS VIVEMENT RECOMMENDÉ DE SAUVEGARDER VOTRE SITE AFIN DE S'ASSURER AUCUNE PERTE DE DONNÉE LORS DE LA MANIPULATION.
Pour ce faire :
sudo cp /var/www/<votre_site_hugo> ~/<votre_site_hugo>.backup
Vous pouvez éventuellement faire une archive de votre backup :
sudo tar -czvf ~/backup<votre_site_hugo>.tar.gz ~/<votre_site_hugo>.backup
¶ Mise à jour de DoIt
Pour mettre à jour votre thème, il suffit de vous mettre dans votre répertoire de votre site internet et d'effectuer la commande ci-dessous :
cd /var/www/<votre_site_hugo>/
sudo git submodule update --remote --merge
Soit de se rendre sur le dépôt GitHub de DoIt et le clôner directement :
cd /var/www/<votre_site_hugo>/themes/
sudo git clone https://github.com/HEIGE-PCloud/DoIt.git
Ou bien encore de récupérer le .zip du thème :
cd /var/www/<votre_site_hugo>/themes/
sudo wget https://github.com/HEIGE-PCloud/DoIt/archive/refs/tags/v0.4.1.zip
¶ Vérification du fonctionnement
Afin de vérifier que votre thème est bel et bien fonctionnel, il est nécessaire de bien vérifier que votre fichier hugo.toml est bien paramétré avec la bonne version de votre thème DoIt :
Contenu du fichier hugo.toml :
[...]
[params]
# DoIt theme version
version = "0.4.1"
[...]
Quand cela est fait, il suffit de faire la commande sudo hugo dans le répertoire racine de votre site internet :
debian@server:/var/www/<votre_site_hugo>$ sudo hugo
Start building sites …
hugo v0.145.0-666444f0a52132f9fec9f71cf25b441cc6a4f355+extended linux/amd64 BuildDate=2025-02-26T15:41:25Z VendorInfo=gohugoio
| FR
-------------------+------
Pages | 18
Paginator pages | 0
Non-page files | 0
Static files | 113
Processed images | 0
Aliases | 5
Cleaned | 0
Total in 580 ms
¶ Fin
Et voilà ! Désormais vous avez Hugo à la dernière version ainsi que le thème DoIt. 🥳🤯