Set up a blog using Hugo

本文紀錄如何用Hugo建立blog，並部署到GitHub Pages。

安裝Hugo

brew install hugo

建立site

hugo new site <site-name>

選定theme

cd <site-name>
git init
git submodule add <theme-git-repo-url> themes/<theme-name>

例如：

cd <site-name>
git init
git submodule add https://github.com/xianmin/hugo-theme-jane.git themes/jane

拷貝主題的預設config和範例文章

cp themes/jane/exampleSite/config.toml ./
cp -r themes/jane/exampleSite/content ./

建立文章

文章在content/posts裡面。

新增文章輸入：

hugo new posts/my-first-post.md

在本地觀看

hugo server -D

D flag解釋：

-D, --buildDrafts include content marked as draft

Build static pages

hugo -D

Depoly

1. 在GitHub建立兩個repositories。一個名為<site-name>另一個為<USERNAME>.github.io

2. 把生成的site（public）加入submodule

   git submodule add -b main https://github.com/<USERNAME>/<USERNAME>.github.io.git public

參考

https://dev.to/zaracooper/create-your-developer-portfolio-using-hugo-and-github-pages-35en

https://gohugo.io/getting-started/quick-start/

https://github.com/xianmin/hugo-theme-jane