不靠谱颜论
使用Hugo将GitHub仓库快速改造成内容网站
2019-12-17 22:53
本文共约 915 字
预计阅读时间约 3 分钟
参加极客时间《左耳听风》专栏的每周学习打卡活动ARTS已经第13周了。
我一直在使用GitHub仓库做打卡记录。如今内容越来越多，想要查找过去学过的内容进行复习，感觉越来越不方便了，急需弄几个索引出来。
同时，因为我通常在本地编辑，都完成后，才用git push推到GitHub上，内容预览也不太方便。最近改变了自己的个人网站，打算采用同样的技术（Hugo + simple-style Theme）来做一次架构升级，并使用GitHub Pages完成最终版本的对外发布。
以下是相应的操作过程，供参考（使用时应根据情况做些微调）：
1. 初始化Hugo站点：
由于我是在已有仓库上建站，所以采用：
1$ hugo new site . --force如果是全新的，则可以直接：
1$ hugo new site my-site-name # 这里可以将“my-site-name”更换为其他名字
2$ cd my-site-name/2. 选择风格：
这里我选择我自己设计的simple-style风格：
1$ git submodule add https://github.com/yanlinlin82/simple-style themes/simple-style也可以从这里去另外找一个其他风格：https://themes.gohugo.io/
3. 配置config.toml
详细配置项，可参见：https://gohugo.io/getting-started/configuration/
这里我写的配置如下：
1baseURL = "http://yanlinlin82.github.io/ARTS-Weekly/"
2title = "颜林林的“左耳听风ARTS”打卡记录"
3theme = "simple-style"
4paginate = 20
5
6[permalinks]
7post = "/:slug/"
8page = "/:slug/"
9
10[[menu.main]]
11weight = 10
12name = "目录"
13url = "/"
14
15[[menu.main]]
16weight = 90
17name = "关于"
18url = "/about/"4. 将已有内容移入发帖目录
1$ mkdir content/posts/
2$ mv week*.md content/posts/同时修改每个文件，将标题部分从原来的
1# 左耳听风ARTS第一周（2019年9月23日~29日）改成如下格式（同时加上日期和时间）：
1---
2title: ARTS第一周（2019年9月23日~29日）
3date: 2019-09-29T22:11:09+0800
4---5. 增加一个“关于”页面
1$ vi content/about.md将原来在README中的活动说明写入该页面。头部也参考上述格式。
6. 预览站点
1$ hugo server7. 发布站点
1$ hugo # 编译站点
2$ rsync -avP public/ docs/ # 将站点发布结果完全同步到docs目录中，方便配置GitHub Pages
3$ echo public/ >> .gitignore # 在git中忽略public目录
4$ git add docs/ # 将docs（发布结果）加入git管理最后git commit后，将其推送到GitHub。
8. 配置GitHub Pages
进入该github仓库的设置页面，启用Pages功能，并设置到展示master的docs/目录。