用Hugo搭建博客并部署到GitHub Pages
用Hugo搭建博客并部署到GitHub Pages
之前担心过现有博客平台（如博客园，CSDN）突然倒闭了，博文特别是插图来不及备份；也考虑过自建博客可以更随意，因此有了自建博客的打算。花了两天时间，走了一些弯路，有一些经验总结：
-
做事情一定要搞清楚需求，掂量自己的实力。原本我只是想做一个备份，那么本地写好markdown，存好插图，再同步到博客园就行了，没有必要费力建博客搭网站。虽然Hexo和Hugo都有很多模板供选择，但如果要彻底改造成自己喜欢的样子，还得好好研究琢磨。对于没有任何HTML经验的我，这种工作量远远超过了我的预期。
-
不要沦为工具的努力。就像斟酌linux还是windows好一样，纠结自建博客和使用博客平台对我来说没太大意义。因为我的目的还是写作，博客也是服务于写作的。既然自建博客的收益并不能完全覆盖我的需求（可能还要支配大量的经历调bug），那么我就应该果断放弃。
-
Hugo非常非常快，但中文文档和博客少，而且旧模板和新Hugo的兼容性也不好；Hexo中文文档和博客特别多，模板也不错，但是稍微麻烦一点，而且慢得多。
最后，我就简单地用Hugo搭建了一个个人CV（简历）网站。下面记录一下流程：
1. 本地搭建
1.1 安装Hugo
- 到Hugo官方GitHub仓库，下载最新的win64安装包。解压到
D:\hugo。 - 配置环境变量：
此电脑->属性->高级系统设置->环境变量->系统变量->Path->编辑->新建->D:\hugo。
1.2 创建站点
在命令行中运行hugo new site G:/RyanXing，即创建了一个名为RyanXing的文件夹，作为Hugo站点。
1.3 新建页面和文章
进入该文件夹：
-
新建页面：
hugo new links.md该文件自动出现在
content/links.md。 -
创建文章：
hugo new post/myfirst.md其自动出现在
content/post/myfirst.md。放在post目录是为了方便聚合页面。注意要把draft一行去掉。draft意思是草稿，即在生成时不出现。
1.4 使用主题
在Hugo Themes选择喜欢的主题。有适合简历的，也有适合博客的。
要根据主题提供的README进行后续操作。假设选择Minos。根据说明文档，执行：
cd themes/
git clone --depth 1 https://github.com/carsonip/hugo-theme-minos
然后在根目录的config.toml中设置该主题为默认主题即可（添加该行）：
theme = "hugo-theme-minos"
1.5 修改配置文件
我们现在继续修改根目录的config.toml。
baseurl = "https://ryanxingql.github.io/"
languageCode = "zh-CN"
title = "RyanXing's CV"
paginate = 10
theme = "hugo-theme-minos"
1.6 预览
在根目录执行：hugo server。此时生成的是静态文件，真的很快。只要server不关，会一直监控文件变化，自动生成静态文件。
我们可以看到命令行提示Web Server is available at ...。在浏览器输入http://localhost:1313。
一定要记得去掉正文的draft，否则不显示。
2. 部署
在GitHub上创建一个仓库，名为RyanXingQL.github.io。注意命名规范。
在根目录执行：hugo。
此时，所有的静态页面都会生成到public目录。执行以下命令：
cd public
git init
git remote add origin git@github.com:RyanXingQL/RyanXingQL.github.io.git
git add -A
git commit -m "first commit"
git push -u origin master
浏览器输入https://ryanxingql.github.io/，刷新一下就能看到啦。Hugo非常快。
如果要搭博客，后期要考虑的事情就多了。比如评论系统，各种装饰插件等。
