本文將介紹如何正確地升級主題版本。

版本§

在升級之前，需要先了解下什麽是版本。除了 Releases 列出的相對穩定的版本外，你還可以使用某個分支，如：master、develop 等，甚至還可以選擇某個 commit。

本文將使用 [version] 占位符代表版本，請自行替換為要安裝的版本即可。

額外的依賴§

如果你打算添加額外的依賴，則需要將其定義在 package.hugo.json，而非 package.json。 這是因為 hugo mod npm pack 總是會覆蓋 package.json，其合併了主題的 package.hugo.json 和你站點的 package.hugo.json。

升級§

請根據安裝方式的不同選擇對應的升級步驟：Git Submodule 和 Hugo Module。

請註意，不管使用的是哪種安裝方式，你最後總是需要通過 hugo mod npm pack 和 npm install 拉取並安裝依賴。

Git Submodule§

1$ cd themes/hugo-theme-bootstrap
2$ git fetch
3$ git checkout [version]
4$ cd ../../
5$ hugo mod npm pack
6$ npm update
7$ git add themes/hugo-theme-bootstrap package.hugo.json package.json package-lock.json
8$ git commit -m 'Bump theme to [version]'
  • git fetch 獲取主題倉庫最新的分支和標簽信息。
  • git checkout [version] 切換到 [version] 版本。
  • hugo mod npm pack 和 npm update 拉取並安裝主題最新的依賴。

Hugo Module§

1$ hugo mod get github.com/razonyang/hugo-theme-bootstrap@[version]
2$ hugo mod tidy
3$ hugo mod npm pack
4$ npm update
5$ git add go.mod go.sum package.hugo.json package.json package-lock.json
6$ git commit -m 'Bump theme to [version]'
  • hugo mod tidy 清理多余的依賴。
  • hugo mod npm pack 和 npm update 拉取並安裝主題最新的依賴。