前段时间计划使用hugo搭建一个中英双语的博客网站，遇到了各种各样的坑，心力交瘁。突发奇想，可不可以直接使用他人配置好的Hugo，于是就有了这个博客和这篇文章。

感谢叶寻的博客

本地安装

1

git clone --recurse-submodules https://github.com/CyrusYip/cyrusyip-blog.git

换成自己的favicon

利用 https://realfavicongenerator.net/ 将头像做成favicon，然后放到static目录里

修改标题、作者等

修改config.toml中相应的字段

评论系统

disqus配置（评论配置）

注册disqus账号，新建一个网站 将 config.toml 中的相关配置修改为disqus中自己的 shortname ：

1

disqusShortname = "star5o"

注意：需要在disqus中将自己的域名添加到收信任列表，见官方网站

utteranc

首先必须在 github 上进行安装 utterances，访问 utterances应用程序 然后点击 Install 按钮进行安装。 在这里可以选择可以关联的存储库，只选择博客所在的仓库 YaKaiLi/YaKaiLi.github.io 。

然后将配置文件config.toml中params.utteranc的repo参数修改为博客仓库名称，如YaKaiLi/YaKaiLi.github.io

发布并托管到Github

修改配置文件

参见Hugo官方文档,配置Hugo将网页生成在名为docs的子目录中，然后直接push到master branch。这样就可以让Github Pages加载我们想要托管的docs子目录中的网页。

在config.toml中添加如下一行配置，使得生成的网页默认保存在docs子目录下：

1

echo "publishDir = 'docs'" >> config.toml

自此运行hugo命令后生成的网页文件将保存在/docs子目录下。

发布并托管到Github

上传到Github之前，先在Github中添加一个空白repository，仓库名为：username.github.io，注意不要添加如README，.gitignore等文档。由此得到Github中该repository的网址：https://github.com/YaKaiLi/YaKaiLi.github.io.git

复制该网址后，在本地网站文档根目录中初始化git：

1
2
3
4
5

git init
git add .
git commit -m "first commit"
git remote add origin https://github.com/YaKaiLi/YaKaiLi.github.io.git
git push -u origin master

至此所有源文档就都push到Github上了。然而此时Github对待这些源文档跟其他任何普通的repository中的代码并没有任何不同，并不会将docs子目录中的网页托管在Github Pages上。

将所有文档push到Github的master branch，进入Github对应repository的Settings标签菜单，在Pages选项的Source栏选择master branch /docs folder:

配置个人域名

以本站为例，设置的个人域名为www.gnn.ac.cn

hugo配置

在本地仓库docs子目录中需要添加一个名为CNAME的文档 然后回到网站目录进行git同步

1
2
3

git add .
git commit -m "commit"
git push -u origin master

域名解析

在域名解释时，添加CNAME记录（用于将一个域名映射到另一个域名）。 主机记录栏填www，记录值那栏填yakaili.github.io

新建文章

1

hugo new content/zh-cn/post/test.md