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