安裝

Categories:
Tags:

環境需求

說明 版本
hugo 0.75.0 以上，需要安裝 extended 版本

使用 homebrew 安裝的 hugo 預設為 extended 版本

安裝套件

npm install -g hugo-extended
npm install -g autoprefixer
npm install -g postcss-cli
npm install -g postcss

使用 theme 方式安裝 docsy

在自己原有的專案將 docsy 用子模組的方式載入安裝至 themes/docsy

hugo new site myproject
cd myproject
git init
git submodule add https://github.com/google/docsy.git themes/docsy

設定 config.toml

theme = "docsy"

更新 docsy 模組的子模組 submodule

因為 docsy 也有自己的子模組，所以若將原有的 docsy 用成子模組安裝成主題時，必須要再更新子模組的子模組，才可以順利執行

git submodule update --init --recursive

在 docsy 的目錄可以看到 .gitmodules 檔案有子模組的設定

[submodule "assets/vendor/bootstrap"]
	path = assets/vendor/bootstrap
	url = https://github.com/twbs/bootstrap.git
[submodule "assets/vendor/Font-Awesome"]
	path = assets/vendor/Font-Awesome
	url = https://github.com/FortAwesome/Font-Awesome.git

錯誤處理

在安裝過程中有出現以下的訊息，可能的原因有 2 個

  1. hugo 沒有安裝 extended 版本
  2. docsy 沒有安裝子模組
hugo server -D
Start building sites …
Built in 70 ms
Error: Error building site: TOCSS: failed to transform "scss/main.scss" (text/x-scss): SCSS processing failed: file "stdin", line 6, col 1: File to import not found or unreadable: ../vendor/bootstrap/scss/bootstrap.

參考資料