GitHub Pages + Hexo 搭建个人博客网站

前言

无论是不是程序员，拥有一个由自己搭建的个人网站总归是一件值得肯定和尝试的事情。

本站基于 GitHub Pages + Hexo 搭建，并采用了简洁优雅的 Keep 主题。

操作系统环境为Win 10。

环境配置

• 一个可用的GitHub账号，新建仓库以使用免费的 GitHub Pages 服务，将个人网站挂载到上面，这样就可以不用自己租云服务器啦。

• Git：下载最新版即可。Git 可以将本地代码仓库与 GitHub 远程代码仓库连接起来，便于进行代码提交和版本控制。

• Node.js：下载LTS稳定最新版。npm 是随同 Node.js 一起安装的包管理工具，安装 hexo 框架需要使用 npm。

搭建步骤

1. 利用 npm 安装 hexo 框架

推荐使用 git bash （模拟 Linux 环境）来执行命令。

TIPS

若 npm 下载速度缓慢，可考虑安装淘宝的 cnpm 国内镜像：

npm install -g cnpm --registry=http://registry.npm.taobao.org

cnpm install -g hexo-cli #安装hexo框架

2. 利用 hexo 初始化博客

mkdir blog	#创建blog目录
cd blog	 #进入blog目录
hexo init 	#生成博客 初始化博客
hexo s	#启动本地博客服务

本地博客访问地址一般为：localhost:4000

若访问后显示 hexo 博客默认页面，则说明 hexo 已成功初始化博客。

3. 新建 username.github.io 仓库

在 GitHub 新建仓库，如图所示，其它选项保持默认即可：

WARNING

图中"xxx"处请填入自己的 GitHub 用户名，比如笔者的用户名为 jamieshui，则仓库名应取名为 jamieshui.github.io，否则 GitHub Pages 服务不生效。

复制自己的仓库链接，推荐使用 HTTPS，因为 SSH 会有连接认证，比较麻烦：

4. 将站点部署到 GitHub Pages 上

修改 blog 根目录下的 _config.yml 配置文件，找到 deploy 配置项，按图所示填入相关信息，在 repo 项填入自己的仓库链接：

保存后返回 blog 根目录进一步部署：

hexo clean #清理
hexo g #生成
hexo d	#部署到Github仓库里

WARNING

若 hexo d 有问题，请先设置你的 git 信息：

git config --global user.email "xxx"  #你的GitHub账号注册邮箱
git config --global user.name "xxx"  #你的GitHub用户名

然后通过访问 username.github.io 域名地址即可查看你的博客了。

5. 更改博客主题

在 blog 根目录下克隆 Keep 主题仓库：

git clone https://github.com/XPoet/hexo-theme-keep themes/keep

安装完成后，在 blog 根目录下的 _config.yml配置文件中将 theme设置为keep：

theme: keep

Keep 主题文件的具体配置请参考 Keep 主题官方文档：「https://keep-docs.xpoet.cn/usage-tutorial/configuration-guide.html」

配置完成后通过 hexo clean、hexo g、hexo d一波三连即可重新部署查看啦。

6. 绑定个人域名

推荐在阿里云购买域名（腾讯云的域名在解析时会跳转DNSPod平台，莫名的卡，操作不顺，不知是我的问题，还是一种普遍现象），实名验证后（需要等待一段时间）即可进行域名解析：

域名解析也需要一定时间，打把游戏回来一般基本OK了。

然后进行域名绑定。在 blog 根目录下的 source 文件夹中新建 CNAME 文件，里面写上自己的域名，笔者的是blog.jamieshui.ink，保存后重新部署到 GitHub 上。

在 username.github.io 仓库的 settings 中找到 Custom domain，确保与 CNAME 文件中的域名保持一致。

等待一段时间后即可通过新域名访问自己的博客了。(￣▽￣)／

参考资料

1. EasyHexo: 「https://easyhexo.com/」
2. 手把手教你从0开始搭建自己的个人博客 |无坑版视频教程| hexo: 「https://www.bilibili.com/video/BV1Yb411a7ty」
3. hexo-theme-keep: 「https://keep-docs.xpoet.cn/」