環境 #
- ubuntu 24.04.2
- hugo 0.145.0
- git 2.43.0
1. 安裝 #
- 安裝hugo
我使用snap來安裝，因為這樣就不用處理依賴跟環境變數的問題，對新手最友善。
sudo snap instsll hugo
hugo version #檢查是否安裝成功
- 安裝git
sudo apt install git #視你的linux發行板而定
2. 開始建立網站 #
hugo new site mywebsite #在當前目錄建立一個mywebsite資料夾
cd mywebsite
git init #初始化一個空的 Git 儲存庫
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
rm hugo.toml
mkdir -p config/_default/
若原本目錄config不存在，則需要加參數-p，否則會報錯
cp ./themes/blowfish/config/_default/*.toml ./config/_default/
nano config/_default/hugo.toml
"# theme = "blowfish" # UNCOMMENT THIS LINE" #這一行取消註解
可以在本機預覽當下網站的畫面
hugo server #在瀏覽器輸入http://localhost:1313/
3. 推送到GitHub，使用GitHub Pages部署 #
mkdir -p .github/workflows
touch .github/workflows/hugo.yaml
touch .nojekyll #一個空文件，因為要使用Hugo，所以要告訴GitHub不要用Jekyll部署
將從官網取得的YAML檔案複製並貼上到剛建立的檔案中hugo.yaml，根據需要更改分支名稱和Hugo版本，檔案在官網的路徑Docs > Host and deploy > Host on GitHub Pages。
要先在GitHub建立儲存庫，必須是公開的，再去設定裡更改要部署的分支。
URL可以替換成SSH
git remote add origin <遠端儲存庫URL> #添加遠端儲存庫
git remote -v #查看已設定的遠端儲存庫
git remote set-url origin <新的遠端儲存庫URL> #修改遠端儲存庫的 URL
git push origin <分支名稱> #推送本地分支到遠端儲存庫
設定正確的話，push之後GitHub就會自動部署。