安装主题

只需几个步骤即可为你的 Hugo 站点安装 FixIt 主题。

1. 在 hugo.toml 中配置默认主题为 FixIt，例如 theme = "FixIt"
2. 通过以下其中一种方式安装主题

先决条件

由于 Hugo 提供的便利性，Hugo 可能是此主题的唯一依赖项。

尽管不是在所有情况下都需要，但是在使用 Hugo 时通常会使用 Git、Go、Dart Sass 和 Node.js。

Git 用于：

• 从源代码构建 Hugo
• 使用 Hugo 模块 功能
• 将主题安装为 Git 子模块
• 从本地 Git 存储库访问 提交信息
• 使用 CloudCannon、Cloudflare Pages、GitHub Pages、GitLab Pages 和 Netlify 等服务托管你的站点

Go 用于：

• 从源代码构建 Hugo
• 使用 Hugo 模块功能

Dart Sass 用于在使用 Sass 语言的最新功能时将 Sass 转译为 CSS。

Node.js 用于：

• 使用 FixIt CLI
• 使用一些自动化工具，例如 atomic-algolia

请参考相关文档以获取安装说明：

• Hugo（扩展版，v0.112.0 或更高版本）
• Git
• Go
• Dart Sass（尚未使用）
• Node.js（v16.0.0 或更高版本）

手动安装

你可以下载主题的 最新版本  .zip 文件 并将其解压到 themes 目录中。

要升级主题，请用新主题替换旧主题。

Git 克隆

这种方式，只需将 FixIt 主题克隆到 themes 目录中即可。

1

git clone https://github.com/hugo-fixit/FixIt.git themes/FixIt

通过从存储库中拉取最新提交来升级主题。

1
2

cd themes/FixIt
git pull

Git 子模块

在当前目录中初始化一个空的 Git 存储库。

1

git init

将 FixIt 添加到你的项目中，作为一个 Git 子模块 存储在 themes 目录中的。

1

git submodule add https://github.com/hugo-fixit/FixIt.git themes/FixIt

要使用 dev 分支上的版本，可以使用以下命令：

1
2
3
4

git submodule add -b dev https://github.com/hugo-fixit/FixIt.git themes/FixIt

# 或者，将子模块分支从 `master` 切换到 `dev`：
git submodule set-branch -b dev themes/FixIt

使用以下命令升级主题：

1

git submodule update --remote --merge themes/FixIt

Hugo 模块

将 Hugo 模块 用于主题的最简单方法是将其导入配置中。请参阅 使用 Hugo 模块。

1. 初始化 Hugo 模块系统：hugo mod init github.com/<your_user>/<your_project>

2. 导入主题：

   1 2 3

   [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
# 获取特定版本（例如 v0.3.2, @latest, @master, @dev）
hugo mod get github.com/hugo-fixit/FixIt@v0.3.2

CLI

FixIt 提供了一个官方 CLI，用于快速搭建 Hugo FixIt 站点骨架。它提供了基于 Git 子模块和 Hugo 模块两种方式来快速搭建 Hugo FixIt 站点，并提供了查看 FixIt 主题最新版本的功能。有关更多详细信息，请参阅 FixIt CLI 文档。

1
2

npm install -g fixit-cli
fixit create my-blog

比较