用Github&Hugo建立靜態Blog

程式設計師寫blog再常見不過，好處多多不再贅述，但如何從0開始架出一個blog?

我看了很多教學有各種高級的自動部署、netlify後台等等，照做時卻老是在一些關鍵點卡住。我這個土路雖然蠢笨但確實能做出東西，同樣新手可以試試。

安裝Chocolatey //程式安裝器，讓你從終端裝各種東西很方便

https://chocolatey.org/install
到這個網址，官方提供很多方法安裝，非常簡單快速一行搞定

安裝hugo，有些佈景主題要用到加強版(extended)

choco install hugo -confirm
choco install hugo-extended -confirm

hugo new site <資料夾名稱> //建立一個root，相當於你個人網站的原始資料母巢
挑主題，到https://themes.gohugo.io/

套用主題，範例

 cd <資料夾名稱>
 git init
 git submodule add https://github.com/AmazingRise/hugo-theme-diary.git themes/diary

依照主題的說明文件修改根目錄下的config.toml 注意，config.toml中的第一項baseURL網址不要有"https://www.ooxx"，否則會造成一些未知的BUG。正確網址應為"https://你的username.github.io/"
到content/post/下開始寫一篇blog
開啟本地預覽，指令hugo server -F //防止時差問題用-F
隨意一個地方開啟網址http://localhost:1313/ 看看網站
網站沒問題就打包，指令hugo，會在root資料夾下多出一個public資料夾，裡面就是一個完整的網站準備丟去網路上發布
去gitHub建一個Repository(倉庫)，名稱強制為你的username.github.io
下載GitHub Desktop客戶端，可以把他理解成一個雲端，我要把本地public資料夾的內容透過它丟去gitHub上剛剛建的那個Repository(倉庫)裡，之後就能透過網站提供的gitPage功能實現個人網站的搭建
在gitHub網頁點進創建的username.github.io專案，右上角綠色"Code"點開，用桌面程式開啟
程式開啟後他會要你選擇一個本地的位置去連結該倉庫，直接連結到root/public下看似方便但會導致一些麻煩&錯誤，菜雞如我是放在根目錄同級的位置，姑且稱這個資料夾叫雲端
把根目錄下public/裡面的內容copy一份到剛剛建立的雲端資料夾
此時回到GitHub Desktop客戶端它會說檢測到本地有新東西準備要上傳，左下角Summary填一個描述(隨意填但必要，他就是讓你描述一下這批上傳的動作，以後冤有頭債有主)，然後點Commit to main，至此一切準備就緒
到右邊點第一次叫publish之類，後面那個按鍵會變成push origin，即是把資料正式上傳到網路上
等個幾秒後到"https://username.github.io/“看看成果
之後要更新就是content/post/下建立新的.md，寫完內容然後hugo打包之後push

上次修改於 2021-09-09