Github Pages部署个人博客（Hexo篇）

前言

想在Github上搭建一个个人博客，在网上找了不少的文章，但有的是使用的旧版本，有的语焉不详，最后还是磕磕绊绊地搭起来了，因此写了这篇文章，对自己踩过的坑进行一个总结。水平有限，还请见谅。

博客地址：传送门

系统环境

• Windows 10 教育版
• Node.js v8.7.0
• Npm v5.4.2
• Git v2.13.0

在GitHub上创建Github Pages项目

1. 创建新仓库

Github Pages分为两类，用户或组织主页，项目主页。
+ 创建用户或组织主页，只需创建一个名称为{yourusername}.github.io的新仓库即可。这边的yourusername填写自己的用户名。Github会识别并自动将该仓库设为Github Pages。用户主页是唯一的，填其他名称只会被当成普通项目。
+ 创建项目主页。先新建一个仓库，名称随意，或是使用原有的仓库都可以。在项目主页 -> Settings -> Options -> Github Pages中，将Source选项置为master branch，然后Save，这个项目就变成一个Github Pages项目了。

2. 分支管理

Github Pages会自动部署静态网页文件，而上一步是将master分支作为部署的默认分支。

Github Pages部署分支设置中，可以有三种设置：
+ master 分支
+ master 分支下的/doc文件夹
+ gh-pages 分支

其中gh-pages分支的选项需要创建这个分支才会显示出来。

我个人是这样设置分支的：
新建一个blog-src分支用来管理Hexo的源代码，
gh-pages分支用来管理Hexo生成的静态网页文件，即部署到Github Pages上的文件，
master分支保留（个人习惯）。
你也可以另开一个项目用来管理Hexo源代码的版本。

安装Hexo

统一说明一下以下的代码示例，<>中的是必填参数，[]中的是选填参数。

1. 安装Hexo

npm install -g hexo-cli

2. 生成Hexo项目

在你想创建博客的文件夹中初始化Hexo。

hexo init [projectname]

如果带了项目名称，会生成一个带有该名称的文件夹；如果没带参数，则必须在空文件夹下运行，不然会报错。

3. 拉取Github项目到本地

git clone https://github.com/yourusername/yourprojectname.git

然后把之前生成的Hexo项目文件夹下的内容全部复制过来。关于Git的使用请自行掌握，因为贴Git的代码很容易引起各种各样的错误。最后把项目push到blog-src分支上（换成你自己的源码分支）。

使用Hexo

1. 常用命令

• hexo generate [-d]
• hexo serve [-p port]
• hexo deploy [-g]

Hexo命令大多可以缩写，如hexo serve --port 5000可以缩写成hexo s -p 5000。

更多命令和参数可参阅