只需几个步骤即可为你的 Hugo 站点安装 FixIt 主题。
- 在
hugo.toml 中配置默认主题为 FixIt，例如 theme = "FixIt" - 通过以下其中一种方式安装主题
先决条件
Hugo（扩展版）和 Dart Sass 是此主题的必需依赖项。
重要
Dart Sass 用于将主题的 SCSS 转译为 CSS。
尽管不是在所有情况下都需要，但是在使用 Hugo 时通常会使用 Git、Go 和 Node.js。
Git 用于：
Go 用于：
Node.js 用于：
请参考相关文档以获取安装说明：
安装方式
这种方式，只需将 FixIt 主题克隆到 themes 目录中即可。
1
| git clone https://github.com/hugo-fixit/FixIt.git themes/FixIt
|
通过从存储库中拉取最新提交来升级主题。
1
2
| cd themes/FixIt
git pull
|
点击快速创建博客！
github.com/hugo-fixit/hugo-fixit-starter/generate
以这种方式，无需要在 hugo.toml 中配置 theme = "FixIt"。
将 Hugo 模块 用于主题的最简单方法是将其导入配置中。请参阅 使用 Hugo 模块。
初始化 Hugo 模块系统：hugo mod init github.com/<your_user>/<your_project>
导入主题：
1
2
3
4
| [module]
[[module.imports]]
path = "github.com/hugo-fixit/FixIt"
|
要更新或管理版本，你可以使用 hugo mod get 命令。
1
2
3
4
5
6
7
8
| # 更新所有模块
hugo mod get -u
# 更新所有模块及其依赖
hugo mod get -u ./...
# 更新一个模块
hugo mod get -u github.com/hugo-fixit/FixIt
# 获取特定版本（例如 v1.0.0, @latest, @main）
hugo mod get github.com/hugo-fixit/FixIt@v1.0.0
|
| 手动安装 | Git 克隆 | Git 子模块 | Hugo 模块 |
|---|
| 先决条件 | Hugo | Hugo, Git | Hugo, Git | Hugo, Git, Go |
| 是否易于安装？ | ✅ | ✅ | ✅ | ✅ |
| 是否方便升级或降级容易？ | ✔️ | ✔️ | ✅ | ✅ |
| 下载速度如何？ | ❌ | ❌ | ✔️ | ✅ |
| 是否可以自动更新？ | ❌ | ❌ | ✅ | ✅ |
| 是否可以使用最新版本？ | ✅ | ✅ | ✅ | ✅ |
版本管理
FixIt 遵循语义化版本控制。稳定版本以 GitHub Releases 为准，而 main 分支包含开发中的改动和未发布的新功能。
- 对于生产环境，请始终使用带标签的发布版本（例如
v1.0.0）。 main 分支可能包含破坏性更改，不保证稳定性。
使用 Hugo 模块时，锁定到特定版本：
1
| hugo mod get github.com/hugo-fixit/FixIt@v1.0.0
|
使用 Git 子模块时，切换到特定标签：
1
2
| cd themes/FixIt
git checkout v1.0.0
|
CLI
提醒
CLI 假定你事先了解 Hugo 和 FixIt。如果你是 Hugo 或 FixIt 的新手，我们强烈建议你在使用 CLI 之前先阅读 主题文档，不要使用任何脚手架工具。
1
| npx fixit-cli create my-blog
|
FixIt 提供了一个官方 CLI，用于快速搭建 Hugo FixIt 站点骨架。它提供了基于 Git 子模块和 Hugo 模块两种方式来快速搭建 Hugo FixIt 站点，并提供了查看 FixIt 主题最新版本的功能。有关更多详细信息，请参阅 FixIt CLI 文档。
目前支持的模板预设如下：
FixItHugo 主题