安装

我们提供了一个入门主题模板,以便你快速地创建一个 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

下一步

  • 调整配置和参数,如 baseURLgiscus.* 等。
  • 移除不需要的配置、菜单、内容、图片和 GitHub actions(workflows)。
  • 创建内容
  • 部署站点