为啥选择Hugo

可能是懒得研究太多，随便看了看几个帖子发现Hugo还算是比较popular的。 很多年前刚玩Github Page的时候有试过Jekyll但是感觉并不太好用。还有个原因是有两年多没写过码了，不敢用太复杂的，简单搭建一个static site随便写写东西就够了。

准备工作

• 基本的Git技能
• 读读Hugo的基本介绍和quick start。以及选择一个你喜欢的theme
• 了解下在Github Page的时候有试过Jekyll怎么host一个网站的。当然你有钱可以选择其他hosting方案。我穷只能用免费的Github Page。

菜鸟五分钟搭建流程

1. 利用选择的主题创建一个repo和hugo site。比如我选择的是这个Hugo Theme Stack主题

1
2
3
4

hugo new site myproject-j
cd myproject-j
git init
git submodule add https://github.com/CaiJimmy/hugo-theme-stack/ themes/hugo-theme-stack

2. 改一些设置: 主要是把exampleSite directory下面的一些config复制到site root directory下面。不懂为啥的话请读读Hugo的基本介绍

3. 在本地localhost上launch site

1
2

hugo
hugo server -D

然后你就能在browser里面去到 http://localhost:1313/ 就看到了！恭喜！

4. 利用Github Action设置自动deploy

我在Github上建了两个repo：一个是Github Page需要的（必须是public repo，我没钱升级Github pro)，还有一个是private repo用来source code。

需要设置的是

1. 设置一个github action的yml文件，可以用这个template。这样每次push之后会把hugo生成的./public那个directory自动push到github page那个repo
2. 建一个有repo权限的github personal token然后放在source code repo的secrets里面。token一般几个月就expire，需要重新generate然后放进secret里面。

之后大致的流程是这样的

1. 本地写完新的post之后git push到source code的private repo
2. github action会把 ./public push到github page的repo
3. 网站myproject-j.github.io会自动更新新内容

一些有用的东西

• 这个Tabler Icon网站找到你喜欢的icon
• 这个git repo可以看到一些sample post
• 这个网站有详细的customize教程
• 这位大神写了很多Hugo很实用的帖子

还有啥问题

当然我肯定标题党了。十分钟应该成功不了（大佬当我没说）。毕竟会有出现各种各样的奇怪的问题。 有问题欢迎在下面给我留言，然后点击网页右下角给我买个咖啡☕️呗