在GitHub上建立一個自己的部落格

安裝Hugo

Hugo是一個產生靜態網頁的工具，靜態網頁就可以直接部署到Gihub上面建立一個屬於自己的網站

mac直接用homebrew安裝

brew install hugo

Ubuntu安裝的方式

snap install hugo

curl -OL https://github.com/gohugoio/hugo/releases/download/v0.87.0/hugo_0.87.0_Linux-64bit.deb
sudo dpkg -i hugo_0.87.0_Linux-64bit.deb

先建立一個空的網站

hugo new site <blog-name>

當前目錄底下會產生一個<blog-name>名稱的資料夾

blog
|-- archetypes
|   `-- default.md
|-- config.toml
|-- content
|-- data
|-- layouts
|-- static
`-- themes

接著到官方的主題展示區，下載自己喜歡的主題，複製到themes底下

git clone https://github.com/panr/hugo-theme-hello-friend.git ./themes/hello-friend

接著需要設定根目錄的config.toml一般來說可以在下載資料夾內可以找到config.toml，把內容複製貼上即可

:::info 要注意config.toml的theme名稱要和剛剛下載到的資料夾名稱相同 :::

baseurl = "/"
languageCode = "en-us"
theme = "hello-friend"
paginate = 5

設定好就可以跑Hugo內建的Server來看結果

hugo server

這樣就可以看到安裝的主題了，但還因為還沒有新增文章所以空空的

有兩種方式可以新增文章

hugo new post/my-test-post.md

:::warning 記得要改my-test-post.md裡面的draft，要設成false才會看得到文章 :::

回到網頁上就可以看到文章了！而剛剛run的Hugo Server會自動更新內容，所以在寫文章的時候不用一直重開Server滿方便的

Hugo有支援disqus留言板的功能，需要在layout/partials/comments.html加上以下內容

{{ template "_internal/disqus.html" . }}

然後到根目錄的設定檔config.toml加上你的disqus shortname

baseurl = "/"
languageCode = "en-us"
theme = "hello-friend"
paginate = 5
disqusShortname = "xxxxxx"

重新啟動Hugo Server，到任一篇文章的最下方，有看到這樣的提示就完成了!

同樣到根目錄的設定檔config.toml加上追蹤ID

baseurl = "/"
languageCode = "en-us"
theme = "hello-friend"
paginate = 5
disqusShortname = "xxxxxx"
googleAnalytics = "UA-xxxxxxxx-x"

再來就是使用hugo指令產生網站，可以看到多出來一個的Public資料夾而最後就是要把這個資料夾push到GitHub上面去

hugo

在GitHub上建一個Repository，名稱要是<User-Name>.github.io，然後把剛剛的public資料夾，push到這個Repository，GitHub會自動Host這個Repository所以在網址列輸入以下網址，就可以看到你的網站成功部屬到GitHub Page

https://<User-Name>.github.io

後續可以再加上gihub action自動build到github page，有興趣可以參考這篇[3]