安裝

我們提供了一個入門主題模板,以便你快速地創建一個 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)。
  • 創建內容
  • 部署站點