在Windows使用Hugo在Github架設網站

注意！以下內容均在Win 10環境下操作，其他作業系統的操作方式並不相同。

安裝Chocolatey

Chocolatey是Windows下的軟件管理器，很多軟件都能直接安裝。
在Win 10安裝Chocolatey有兩種方式：

使用Powershell安裝

在Win 10左下角的搜尋輸入powershell就能找到Windows PowerShell。
記得以系統管理員身份執行。

1

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

使用命令提示字元 / 命令提示符

在Win 10左下角的搜尋輸入cmd打開命令提示字元。
記得以系統管理員身份執行。

1

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

安裝Git與Hugo

安裝完Chocolatey之後，接下來的安裝就很方便，直接重新開啟PowerShell，輸入：

1

choco install git.install

1

choco install hugo

有些較為複雜的Hugo主題會使用Sass/SCSS，此時必須要再安裝Hugo的擴展。

1

choco install hugo-extended

Hugo建立網站

通過cd指令到你要建站的目錄，然後輸入：

1

hugo new site <你的網站名稱>

安裝主題

進到網站根目錄，在Hugo Theme挑選喜歡的主題，不同主題安裝方法略有差異。
基本設置如下：

1
2


git init
git submodule add <主題網址.git> themes/<主題名稱>

主題設置與測試

關於設置主題的部分，每個主題都有自己的一套配置方法，詳見各主題的網站與github。以下為大多數主題的基本設置：

進入theme/主題資料夾/exampleSite（不是所有主題都有exampleSite這個資料夾）
在exampleSite找到config.toml複製一份至根目錄。
為方便測試，可以把content資料夾也複製到根目錄。

進階設置

部分主題需要到theme/主題資料夾複製Static與Layout的內容或整個資料夾至根目錄才能正常顯示。

測試

透過下面的指令會啟動本地端的網站，在網址列輸入localhost:1313/即可預覽。

1
2
3


hugo server
// 若之後的修改要完全刷新預覽可以改成
hugo server --disableFastRender

網站發佈到Github

網站發佈

透過指令下面的指令會生成一個public的資料夾，這個資料夾就是要發佈到Github的內容。

1

hugo

網站發佈前要先把config.toml的baseURL與manifest.json的start_url換成Github使用的網址，確保網站的各項參數能關聯到正確的地址。

Push到Github

先移動到public資料夾，輸入指令：

1
2
3
4


git init
git add .
git commit -m "init"
git push origin master