搭建基于 Hexo 和 Git Pages 的个人技术博客

导言

---

搭建一个个人博客需要什么？

一般来说，建立一个网站所必需的要素有以下几个内容：

• 主机（Git Pages）
• 域名（Freenom）
• 内容（Hexo）

Git Pages 是什么？

GitHub Pages is a static site hosting service.
GitHub Pages is designed to host your personal, organization, or project pages directly from a GitHub repository
GitHub Pages 是一个静态网站托管服务。
GitHub Pages 可以从一个 GitHub 仓库来建立个人、组织或者项目页面。

通俗地讲，Git Pages 是 GitHub 提供的一项静态页面托管服务，服务依托于 GitHub 仓库，用户可以利用这项功能，简单、快速的建立个人、组织或项目的静态页面。我们这里就选择 GitHub Pages 作为个人网站的主机，GitHub Pages 的主机服务，提供了一个 username.github.io 的二级域名，采用了 SSL 加密，也可以绑定自己的顶级域名，这里推荐 Freenom，免费提供 .tk/.ml 等后缀的顶级域名。

Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

解决了主机和域名的问题，接下来就需要解决内容的问题，由于 Git Pages 只能支持静态界面，也不支持数据库，所以这里没有办法搭建如 WordPress 之类的博客，Git Pages 本身提供了 Automatic Page Generator 工具，可以生成简单的基础页面，你也可以将自己的静态页面提交到仓库，进行展示。

不过 Hexo 和 Jekyll 为我们提供了一个更为简单的方法，分别基于 Node.js 和 Ruby 开发，可以在本地快速、简单的生成静态网页，我们这里选择 Hexo 作为我们的生成工具。

建立 GitHub Pages 仓库

---

如果你之前没有注册过 GitHub，请先注册一个 GitHub 账号，你的 GitHub 账号就是以后 Git Pages 二级域名的前缀。

登录 GitHub 之后，新建（New）一个仓库（Repository），注意仓库的名字必须是 username.github.io，其中的 username 是你的 GitHub 用户名。

之后，你可以在 Repo 中新建一个 index.html 文件，测试一下是否能够访问 username.github.io，如果能够访问，那么你已经完成了 Git Pages 的建立工作。

index.html 文件：

Hello world!

搭建本地 Hexo 环境

---

Hexo 要求的环境不高，只有以下两项：

• Node.js
• Git

安装 Node.js 和 Git

• 在 Node.js 的官网下载适合系统版本的安装包，这里选择的是 V4.5.0 LTS 版本
• 运行安装包，按照默认设置安装
• 在 Git 官网下载适合系统的安装包，这里下载的是 2.10.0 版本
• 采用默认设置安装 Git
• 打开命令提示符（PowerShell），采用下面的命令测试环境安装情况

npm --version
git --version

如果能够返回版本号，则说明环境安装正常。

安装 Hexo

在 Node.js 环境下安装 Hexo 相当简单，直接在命令提示符（PowerShell）执行下面的命令就可以自动安装：

npm install -g hexo-cli

Hexo 安装完成后，需要在本地建立一个目录，作为 Hexo 初始化和保存文章的根目录，为了更好的备份和同步，建议放在 OneDrive 或 DropBox 的目录，这里以 ~/OneDrive/Hexo/ 目录为例：

# 切换到根目录
cd ~/OneDrive/Hexo
# 初始化Hexo
hexo init

初始化完成后，Hexo 目录的结构如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

其中：

_config.yml
网站的 配置 信息，您可以在此配置大部分的参数。
package.json
应用程序的信息。
scaffolds
模版 文件夹。当您新建文章时，Hexo 会根据 scaffold 来建立文件。
source
资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _(下划线) 的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。
themes
主题 文件夹。Hexo 会根据主题来生成静态页面。

现在，我们就可以尝试在本地测试我们的站点， 更多的配置请参考官方文档：

hexo g
hexo s

打开浏览器，访问 http://localhost:4000 即可看到目前的网站效果，之后也可以用来预览部署之后的网站。

写作和部署

---

开始写作文章

本地 Hexo 环境配置好后，就可以开始写作了，Hexo 中，文章保存在 source/_post/ 文件夹下，默认是 .md 格式的 Markdown 文档，Markdown 编辑器有很多，这里推荐一个开源的 Markdown 编辑器： Typora

写作可以直接在 _post 文件夹新建 .md 文档，也可以使用命令生成文档，需要注意，自行新建的文档需要严格按照指定格式：

hexo new 文章标题

或

---
title: 文章标题
date: 2016-08-24
categories: 文章分类
tags: 
    - 关键词1
    - 关键词2
    - 关键词3
---
正文

将网站部署到 Git Pages

Hexo 可以一键部署到 Git Pages，首先安装 hexo-deployer-git：

npm install hexo-deployer-git --save

之后修改配置文件 _config.yml：

deploy:
 type: git
 repo: <repository url>
 branch: [branch]
 message: [message]

其中：

<repository url> 是你在 GitHub 上建立的仓库的地址，如https://github.com/username/username.github.io
[branch] 是分支名称，一般填 master
[message] 是 commit 信息，默认为 Site updated at {{ now('YYYY-MM-DD HH:mm:ss') }}

之后，在根目录输入以下命令，即可将网站部署到 Git Pages(中途可能会要求输入 GitHub 用户名和密码)：

hexo d -g

进阶

---

安装主题和插件

示例网站 中采用了 IIssNan 开发的 NexT 主题，Hexo 也支持更多的主题和插件，请自行阅读相关文档。

绑定私人域名

• 在 Freenom 注册免费的域名
• ping username.github.io
• 在 Freenom 的后台，将 A 记录解析到上面 ping 出来的 ip 地址上
• 在 /source 目录建立 CNAME 文件，内容为注册的 ip 地址

CDN 加速和 SSL 加密

这里采用了 CloudFlare 提供的 CDN 和 SSL 服务：

• 注册账号
• 按照提示添加站点
• 在 Freenom 后台中，将 Nameserver 服务器改为 CloudFlare 中提供的 NS 地址
• 开启 Flexible SSL
• 开启 Always Online
• 其他设置

参考文档

---

• GitHub Pages
• Hexo