前言

前面兩天花了點時間極簡單帶過 Hugo 與挑選自架網站工具的方向，今天來講安裝 Hugo CLI；預計在我鐵人賽發文完賽的那一天，除了(應該)可以完全建置好部落格之外，我還會盡量多講講我其他相關知識與經驗分享，包括遇到過的障礙以及如何排除，寫一點程式去客製化佈景等等。

環境需求

Hugo 是跨平台的，你可以在以下環境中安裝：

• macOS (Darwin) for x64, i386, and ARM architectures
• Windows
• Linux
• OpenBSD
• FreeBSD

或是任何可以跑 go 的機器環境中安裝 Hugo CLI (本篇文章撰寫時我安裝的 Hugo 版本為 v0.74.3)。

Homebrew (macOS or Linux)

我目前是使用 Mac (macOS Catalina) 並透過 Homebrew 安裝 Hugo，平常我都會盡量透過相同的安裝途徑去新增 CLI 相關指令，除非是 brew 還沒有 source (例如 Jeklly)。

如果你本地尚未安裝 Homebrew 可以先到此依照指引安裝，接著執行以下指令安裝 Hugo：

brew install hugo

Chocolatey (Windows)

如果你是使用 Windows 可透過 chocolatey 安裝：

choco install hugo -confirm

或是透過 Scoop 安裝：

scoop install hugo

Hugo 指令測試

安裝完成後，在終端機執行以下指令，若成功輸出版本資訊，表示安裝完成：

hugo version

# output:
# Hugo Static Site Generator v0.74.3/extended darwin/amd64 BuildDate: unknown

Troubleshooting

有些人可能會遇到安裝完成後，無法直接在終端機使用 hugo 正常執行，可能是因為指令軟連結需要手動建立；

cd /usr/local/bin/
ln -s ../Cellar/hugo/{your_version}/bin/hugo hugo

補充一下，每個人的 hugo 秀逗的方式可能不太一樣，本例是建立在你已經知道缺少軟連結的情境下，給出解決方式做參考，指令中提到的路徑要依你本機為主。

之後會比較常用到的指令

輸入 hugo help 列出所有可用指令，這邊稍微帶一下以後會用到哪些比較常用的：

指令 Commands

建立新專案

hugo new

參數 Flags

輸出靜態文件

hugo

本地編譯時，一併連同草稿文件都顯示

hugo server -D

指定佈景名稱

-t, --theme strings

小結

以上是我最近比較常會用到的指令與參數，這邊只是先簡單帶過一下，之後有使用到時會在具體詳述，想知道其他的指令的作用也可自行看一下 help；

接下來開始會聊到如何建置一個新的專案，明天見。

參考連結

• Hugo - Install Hugo