Files
blowfish/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.zh-cn.md
T
2026-08-30 22:57:42 +01:00

1.4 KiB

title, description, featureimage, date, lastmod, tags, showauthor, authors
title description featureimage date lastmod tags showauthor authors
将现有 Hugo 网站升级到 Blowfish 3 无需进行破坏性配置更改,即可将现有 Blowfish 网站迁移到版本 3。 featured.png 2026-08-30 2026-08-30
blowfish
hugo
migration
v3
false
nunocoracao

{{< lead >}} Blowfish 3 向后兼容。现有网站无需重写配置或内容即可升级。 {{< /lead >}}

升级前准备

提交当前网站的更改,并确保 Hugo 版本处于 Blowfish 声明的支持范围内。如果主题目录中有自定义文件,请先将它们移至网站的 assets/ 或 layouts/ 目录,以免升级时被覆盖。

升级安装方式

Hugo 模块

在 config/_default/module.toml 中更新模块路径以包含 /v3,然后刷新依赖:

[[imports]]
path = "github.com/nunocoracao/blowfish/v3"
hugo mod get -u

Git 子模块

git submodule update --remote --merge

手动安装

下载最新发行版,替换 themes/blowfish/,并将站点级配置保留在 config/_default/ 中。

验证结果

运行 hugo server,检查主页和一篇有代表性的文章,然后照常部署。Blowfish 3 的新功能均为可选功能,因此现有网站应该和之前一样正常渲染。

如果要创建新网站,请使用 npx blowfish-tools new <site> 并按照[安装指南]({{< ref "docs/installation" >}})操作。