我们提供了一个入门主题模板，以便你快速地创建一个 HB 站点。

安装

一分钟安装 HB 主题。

Hugo 服务器在第一次运行时需要很长的时间以下载模块和处理大量图片，你需要删除无用的图片和提交 resources/images 文件夹以提高构建性能。

克隆仓库

1git clone --depth 1 https://github.com/hbstack/theme blog

1cd blog

其中的 blog 是本地目录名称，请随意修改。

模块路径

首先修改位于 go.mod 的模块路径，将其中的 module github.com/hbstack/theme 替换为你的，如：module github.com/user/repo。

1sed -i -e 's/module\ github.com\/hbstack\/theme/module\ github.com\/user\/repo/' go.mod

推送到远程仓库

提交改动

1git add .
2
3git commit --amend

修改提交信息保存即可，如：First commit。

修改远程仓库

1git remote set-url origin https://github.com/user/repo

推送

1git push origin main

Hugo 模块代理（可选）

如果你在中国大陆没有 VPN，Hugo 模块的下载可能会失败。另请参阅Go 和 Hugo 代理服务器。

安装构建工具

1npm ci

请注意 Go 和 Node.js 是必要条件，详情请参阅构建工具。

启动 Hugo 服务器

于开发模式下预览

1npm run dev

于生产模式下预览

1npm run prod

下一步

• 调整配置和参数，如 baseURL、giscus.* 等。
• 移除不需要的配置、菜单、内容、图片和 GitHub actions（workflows）。
• 创建内容。
• 部署站点。