Note | 用Hugo搭建博客并部署到GitHub Pages

用Hugo搭建博客并部署到GitHub Pages

• 用Hugo搭建博客并部署到GitHub Pages
  • 1. 本地搭建
    • 1.1 安装Hugo
    • 1.2 创建站点
    • 1.3 新建页面和文章
    • 1.4 使用主题
    • 1.5 修改配置文件
    • 1.6 预览
  • 2. 部署

之前担心过现有博客平台（如博客园，CSDN）突然倒闭了，博文特别是插图来不及备份；也考虑过自建博客可以更随意，因此有了自建博客的打算。花了两天时间，走了一些弯路，有一些经验总结：

1. 做事情一定要搞清楚需求，掂量自己的实力。原本我只是想做一个备份，那么本地写好markdown，存好插图，再同步到博客园就行了，没有必要费力建博客搭网站。虽然Hexo和Hugo都有很多模板供选择，但如果要彻底改造成自己喜欢的样子，还得好好研究琢磨。对于没有任何HTML经验的我，这种工作量远远超过了我的预期。

2. 不要沦为工具的努力。就像斟酌linux还是windows好一样，纠结自建博客和使用博客平台对我来说没太大意义。因为我的目的还是写作，博客也是服务于写作的。既然自建博客的收益并不能完全覆盖我的需求（可能还要支配大量的经历调bug），那么我就应该果断放弃。

3. Hugo非常非常快，但中文文档和博客少，而且旧模板和新Hugo的兼容性也不好；Hexo中文文档和博客特别多，模板也不错，但是稍微麻烦一点，而且慢得多。

最后，我就简单地用Hugo搭建了一个个人CV（简历）网站。下面记录一下流程：

1. 本地搭建

1.1 安装Hugo

1. 到Hugo官方GitHub仓库，下载最新的win64安装包。解压到D:\hugo。
2. 配置环境变量：此电脑->属性->高级系统设置->环境变量->系统变量->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非常快。

如果要搭博客，后期要考虑的事情就多了。比如评论系统，各种装饰插件等。