使用 Hexo 在 GitHub 上搭建个人博客

有很多种方法可以通过使用 GitHub 提供的 GitHub Pages 功能在 GitHub 上搭建个人博客，其中较主流的方法包括使用 Jekyll 或者 Hexo。本文为你介绍使用 Hexo 在 GitHub 上搭建并使用个人博客的过程。

在 GitHub 网页上的操作

创建自己的 GitHub 账号，用户名为username
新建一个仓库，为了可以通过网址username.github.io访问自己的博客，需要将仓库的名字设定为username.github.io
在仓库username.github.io的setting选项卡中，开启 GitHub Pages

至此，在 GitHub 网页上的操作已经部分完成。

在本地主机上的操作

搭建本地 Hexo 博客

按照 Hexo 官网的教程安装 Hexo，在安装 Hexo 之前需要先安装Node.js和Git。然后运行下面的命令安装 Hexo：
所在目录：~/blog/
1
npm install -g hexo-cli % 安装 Hexo

如果运行上述命令没有报错，那么 Hexo 已经安装成功，接着运行以下的命令初始化一个 Blog：

所在目录：~/blog/

1 2	hexo init % 初始化一个 Blog npm install % 安装依赖项

至此 Hexo 已经安装成功，本地会生成一个blog目录。默认的bolg目录结如下：

所在目录：~/blog/

.
├── _config.yml    % 站点配置文件
├── package.json   % 应用程序数据
├── scaffolds      % 模板文件
├── source         % 源文件
|   ├── _drafts    % 草稿
|   └── _posts     % 展示
└── themes         % 存放主题的目录

后期可以通过更改~/blog/_config.yml文件来配置站点信息，此文件被称作站点配置件。

在电脑上运行如下的命令启动一个本地服务：
所在目录：~/blog/
1
hexo server % 运行 Hexo 服务
如果运行上述命令没有报错，则通过浏览器查看http://localhost:4000/会看到一个网页，这就是 Hexo 默认的网页。

Hexo提供了很多的主题供选择，只需要下载你喜欢的主题文件，然后放进theme文件夹内，并修改站点配置文件应用新的主题。主题文件里面也包含一个_config.yml文件，此文件被称作主题配置文件。想要自定义主题，则需要修改主题配置文件。这里需要注意：站点配置文件和主题配置文件虽然文件名都是_config.yml，但其存放位置不一样。本站使用的主题是 NexT。关于主题的配置以及进阶功能的使用，我在文末列出了一些参考文献供你参考。

至此，本地站点已经搭建完毕，接下来需要把本地站点部署到 GitHub 上。

把本地 Hexo 博客部署到 GitHub 上

首先安装 Hexo 的 Git 部署工具：
所在目录：~/blog/
1
npm install hexo-deployer-git --save
更改blog文件夹里面的_config.yml文件的deploy部分：
文件位置：~/blog/_config.yml
1
2
3
4
deploy:
type: git
repo: git@github.com:username/username.github.io.git
branch: master
利用此工具，Hexo 会自动将生成的静态网页部署到 Git 上去。但是真正的部署还需要一个验证的步骤。
在电脑的Git Bash窗口，使用以下命令生成 SSH Key 以设置本地 Git Bash 与 GitHub 账号之间的秘钥：
所在目录：~/blog/
1
ssh-keygen -t rsa -C "youremail@email.com"
在设置密钥之前需要先设置本地 Git Bash，填写自己的用户名和邮箱，如果已经填写则不用。其中youremail_at_email.com是 GitHub 的注册邮箱。运行上述命令后得到了两个文件：id_rsa 和 id_rsa，存放于目录C:\Users\Administrator\.ssh下。
切换到存放秘钥的目录，在电脑的Git Bash窗口，利用以下命令打印出公钥：
所在目录：~/blog/
1
cat id_rsa.pub
(在GitHub网页上执行的操作)复制打印出来的公钥，粘贴到 GitHub 网站的setting->SSH Keys。
运行以下命令生成 Hexo 站点：
所在目录：~/blog/
1
hexo generate % 生成静态站点
运行以下命令部署本地 Hexo 到 GitHub Pages：
所在目录：~/blog/
1
hexo deploy % 部署到GitHub Pages

至此，使用 Hexo 在 GitHub 上搭建个人博客的操作已经完成，通过网址username.github.io就可以访问刚刚搭建的博客

使用博客

使用博客的方法较为简单，毕竟选择使用 Hexo 在 GitHub 上搭建个人博客的原因就是操作简单而且专注于内容。

运行以下命令新建博客：
所在目录：~/blog/
1
hexo new "new-blog" % 新建博客
新建一个题目为new-blog的博客，源文件new-blog.md存放在blog\source\_posts\文件夹下。使用 Markdown 编辑器在new-blog.md里面填写博客内容并排版达到自己期望的效果，保存文件。
运行以下命令以生成站点：
所在目录：~/blog/
1
hexo generate
1. 运行以下命令以部署站点：
所在目录：~/blog/
1
hexo deploy

到这里，关于个人博客的搭建和基础使用部分已经介绍完毕🎉。

—全文完—