架設 Hugo 起手式
- 環境： Mac OS Sequoia 15.3
- Terminal: iTerm2
安裝 Hugo
brew install hugo
HUGO 指令測試
安裝完成後，在 Terminal 輸入以下指令，確認是否安裝成功。
hugo version
建立新 Blog
hugo new site blog
建立新文章
為了方便管理，我會將文章放在 posts 資料夾中。
hugo new posts/2025/2025.md
啟動 HUGO 伺服器
-D 參數可以讓草稿文章也顯示在網頁上。
hugo server -D
開啟 http://localhost:1313/ 即可看到 Hugo 預設的網頁。
安裝佈景主題
進入 Hugo Themes 選擇一個喜歡的主題，將它加入到 Blog 中。 這邊選擇 PaperMod 主題。 透過官方推薦的將 submodule 加入到專案中。
git init
git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
git submodule update --init --recursive # needed when you reclone your repo (submodules may not get cloned automatically)
修改 hugo.toml
# 新增 theme
theme = 'PaperMod'
Local Build 出可以部署的檔案
## --gc: 執行完後清除 cache
## --minify: 壓縮檔案
hugo --gc --minify
部署到 Github Pages
在 Github 上建立一個新的 Repository，名稱為 {你的 Github id 名稱}.github.io。
## Git init
git branch -M main
## 新增 remote
git remote add origin https://github.com/{你的Github id 名稱}/{你的 Github id 名稱}.github.io.git
## 將檔案加入到 git
git add .
git commit -m "Hugo 首次 commit"
## 將檔案推到 Github
git push -u origin main
接著進入 https://{你的 Github id 名稱}.github.io 即可看到你的 Blog。