1.8 KiB
title, description, featureimage, date, lastmod, tags, showauthor, authors
| title | description | featureimage | date | lastmod | tags | showauthor | authors | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Mettre à niveau un site Hugo existant vers Blowfish 3 | Faites passer un site Blowfish existant à la version 3 sans modification incompatible de la configuration. | featured.png | 2026-08-30 | 2026-08-30 |
|
false |
|
{{< lead >}} Blowfish 3 est rétrocompatible. Les sites existants peuvent être mis à niveau sans réécrire leur configuration ni leur contenu. {{< /lead >}}
Avant la mise à niveau
Validez l'état actuel de votre site et assurez-vous que votre version de Hugo est comprise dans la plage déclarée par Blowfish. Si vous avez des fichiers personnalisés dans le répertoire du thème, déplacez-les d'abord dans les répertoires assets/ ou layouts/ de votre site afin que les mises à niveau ne les écrasent pas.
Mettre à niveau votre installation
Module Hugo
Modifiez le chemin du module dans config/_default/module.toml pour inclure /v3, puis actualisez les dépendances :
[[imports]]
path = "github.com/nunocoracao/blowfish/v3"
hugo mod get -u
Sous-module Git
git submodule update --remote --merge
Installation manuelle
Téléchargez la dernière version, remplacez themes/blowfish/ et conservez la configuration de votre site dans config/_default/.
Vérifier le résultat
Exécutez hugo server, vérifiez votre page d'accueil et un article représentatif, puis déployez comme d'habitude. Les nouvelles fonctionnalités de Blowfish 3 sont optionnelles, votre site existant devrait donc s'afficher comme auparavant.
Pour un nouveau site, utilisez plutôt npx blowfish-tools new <site> et suivez le [guide d'installation]({{< ref "docs/installation" >}}).