版本升级

如何升级 HugoBlox 到最新版本

页面目录

本文档介绍如何安全地升级 HugoBlox。

检查当前版本

# 查看当前 Hugo 版本
hugo version

# 查看模块版本
hugo mod graph

升级步骤

1. 备份站点

# 创建备份
cp -r my-site my-site-backup

# 或者使用 Git
git add .
git commit -m "chore: 升级前备份"

2. 更新模块

# 更新所有依赖
hugo mod get -u

# 或更新到特定版本
hugo mod get github.com/HugoBlox/hugo-blox-theme@v0.3.0

3. 清理并重新构建

# 清理缓存
hugo mod clean
hugo mod get

# 重新构建
hugo --gc --minify

破坏性变更

升级前请查看 CHANGELOG 了解破坏性变更。

常见迁移

配置迁移

# 旧版本
params:
  color_theme: "forest"

# 新版本
params:
  appearance:
    theme_day: "forest"

布局迁移

# 旧路径
layouts/partials/header.html

# 新路径
layouts/partials/components/header.html

回滚

如果升级出现问题：

# 回滚到之前版本
hugo mod get github.com/HugoBlox/hugo-blox-theme@v0.2.0
hugo mod tidy

验证升级

# 启动开发服务器检查
hugo server -D

# 检查构建输出
hugo --minify

下一步