模塊概覽

2023年2月4日 1 分鐘閱讀模塊文檔 tidy clean graph

本文介紹瞭如何安裝、卸載、升級、清理和整頓模塊。

本頁內容

初始化模塊和主題

要使用 Hugo 模塊，你需要先初始化你的模塊和主題。

1hugo mod init example.com/user/blog

example.com/user/blog 爲模塊和主題的模塊路徑，其通常爲倉庫的 URL。

在你的站點上安裝模塊是很簡單的，只需於配置中導入相應的模塊路徑。以 example.com/user/module 爲例。

hugo.toml

1[module]
2[[module.imports]]
3    path = 'example.com/user/module'

hugo.yaml

1module:
2  imports:
3  - path: example.com/user/module

hugo.json

1{
2   "module": {
3      "imports": [
4         {
5            "path": "example.com/user/module"
6         }
7      ]
8   }
9}

安裝完模塊後，你需要重新啓動 Hugo 服務器以完全地加載模塊資源。

模塊的優先級由上至下，我們推薦將新的模塊置於頂部，以避免被其他模塊覆蓋。

要卸載模塊，你需要從配置文件中刪除或註釋模塊，然後執行 hugo mod tidy。

1[[module.import]]
2# path = "example.com/user/module"

1hugo mod tidy

遞歸升級所有模塊：

1hugo mod get -u ./...

更新某個模塊可能的最新版本¹：

1hugo mod get -u example.com/user/module

升級到一個特定的版本¹:

1hugo mod get -u example.com/user/module@v1.0.0

以下命令從 go.mod 和 go.sum 中移除未使用的模塊。

1hugo mod tidy

刪除當前站點的 Hugo 模塊緩存：

1hugo mod clean

你也許對網站導入的模塊和它們的依賴關係感興趣：

1hugo mod graph

1hugo mod graph | grep blog