使用Hugo搭建自己的博客并通过GitHub Pages部署

前言

由于前一段时间学习了Golang，在家查阅相关资料的时候发现了Hugo这个用Go语言编写的静态网站生成器，根据网站的介绍它有着速度快，易用，可配置程度高等特点，而且文章依赖于Markdown生成，非常适合作为博客、文档、个人简历这类型的网站，于是我准备用Hugo搭建一个属于自己的博客，并将之前写的文章都搬运过来，最后通过GitHub Pages部署，一起开始吧！

使用Hugo搭建博客

安装

Mac和Linux可以直接用Homebrew安装

1

brew install hugo

Windows在github上下载解压后安装，

此外Hugo官方还提供了多种安装方式，选择自己喜欢的即可

安装完毕后，可以通过查询Hugo版本验证是否安装成功

1

hugo version

创建新站点

1

hugo new site SilenceBlog

创建成功图片

添加并配置主题

Hugo收录的主题非常多，可以在主题库中寻找自己喜欢的

从GitHub下载主题到站点存放主题的目录中：

1

git clone https://github.com/dillonzq/LoveIt.git SilenceBlog/themes/LoveIt

将主题添加到站点的配置文件中：

1

echo theme = \"LoveIt\" >> config.toml

查看主题官方文档，并根据自己的情况进行配置

添加一篇文章并在本地查看效果

可以在content/posts/下手动创建一个Markdown文件，但是需要我们手动输入所有内容。也可以直接通过new命令来创建文章，创建好的文章已经存在相应的模板内容

1

hugo new posts/firstpost.md

输入完后会提是我们创建成功和文章所在的位置

接下来可以打开这个文件进行编辑，当我们编辑完毕保存退出后，可以启动Hugo服务器查看效果

1

hugo server -D

启动后我们可以看到，本次启动的一些信息

在浏览器中打开http://localhost:1313/即可查看效果，并且效果是实时更新的，会随着对站点博客的操作自动更新相应的效果

最后当我们完成博客内容想对博客部署的时候可以通过hugo命令进行建立静态页面

1

hugo -d 文件路径

通过GitHub Pages部署

什么是GitHub Pages

GitHub Pages 是一种静态网站托管服务，它可以直接从 GitHub 上的仓库中获取 HTML、CSS 和 JavaScript 文件，并通过构建过程选择性地运行这些文件，然后发布一个网站。

上面我们通过hugo -D命令正是将站点生成一个静态网站，可以完美配合GitHub Pages进行部署

部署方式

1.首先我们要创建一个Github 仓库，仓库名必须是<user>.github.io的形式，如果是组织则为<organization>.github.io。仓库的可见性必须是Public。

2.接下来进入仓库的设置页对GitHub Pages进行配置，找到GitHub Pages所在的位置，按下图配置好分支和站点存放路径即可

3.配置完毕后，把仓库克隆下来，使用hugo -D 路径将站点生成的静态文件存放在配置文件中选择的路径下即可。最后将文件提交上去就可以打开对应域名进行查看了。

出现问题的解决方案

当我们将文件提交上去之后打开对应域名发现并没有我们想要的内容时可以通过查看提交记录查看错误原因，点击Deatils可以找到具体位置的具体错误

还可以在GitHub Pages的设置出找到错误原因