github是搭建静态博客的一件多快好省的利器，非常经济实惠，非常程序员。

目前，有很多现成的工具可以帮助我们很轻松的完成这件事情。在这些工具的选择上，我比较挑剔两点：

  1. 工具的安装、配置及日常操作是否简易；
  2. 配套的主题是否有中意可用的。

第一个挑剔点主要基于：懒！不想花过多时间研究和记忆这个，最好拿来即用；第二个挑剔点主要基于我对前端不老熟的，主题改起来费劲。尝试过jekyll、hexo和hugo三种在github上搭建静态博客的工具。感觉jekyll配置太复杂，hugo主题太少且没有中意的，所以最后选择了hexo。

hexo是一台湾同胞研发的一款基本于nodejs的github静态博客创建和日常操作工具（https://hexo.io/）。利用hexo搭建一个高可用的github静态博客，原理和过程是：在github上创建一个以自己名字（比如是xxx）开头项目：xxx.github.io（github会对这个项目提供web支持，即可以通过浏览器访问），在本地生成博客（文章、样式等），将本地生成的博客推送到xxx.github.io上。要点无外乎：安装必要工具、创建github远程博客、使用hexo生成本地博客、使用hexo将本地博客的内容推送到github远程博客、使用hexo将本地博客的源文件备份到github库，以便在多个电脑上操作。以下是我本次搭建这个博客的流水帐记要：

以上软件版本都用最新就好。前几天为调试pomelo代码，把node-v5.7.1-x64.msi卸了，装了一个node-v0.10.13-x64.msi，回过头来再用hexo命令，发现不能用了，说node版本太低。如果习惯用命令行操作git的话，不装TortoiseGit也行，反正我是不习惯。

  • 创建github远程博客

github用户名是xxx，就创建一个xxx.github.io的项目。项目创建好之后，再顺便建一个backup分支，用于备份博客源文件（不是之后有把本地博客推送到github上的步骤吗？为什么这里还要建分支用于备份？——这是因为推送本地博客到github上，并不是推送的源文件，而是根据源文件生成的博客显示内容，所以为保证多电脑使用，要有备份源文件步骤，这里先建好backup分支）。

github上创建backup分支

  • 生成本地博客

node有一套自己的包管理工具，叫npm（装node的时候已自动装好），只要把工具和包上传到npm服务器上，就可以用npm的命令下载到本地安装使用了，跟maven远程仓库差不多。hexo及其配套的一些工具都已上传到了npm服务器，按照hexo官方文档（https://hexo.io/zh-cn/docs//）上的步骤，非常容易地就能创建一个本地博客：

1
2
3
4
5
6
7
$ cd e:                          #-- 命令行进入本地磁盘e盘
$ npm install hexo-cli@1.0.1 -g  #-- 通过npm命令安装hexo-cli（怕换版本有问题，这里指定了当前最新版本1.0.1）
$ hexo init xxx.github.io        #-- 通过hexo命令生成本地博客项目
$ cd xxx.github.io               #-- 进入本地博客目录
$ npm install                    #-- 通过npm命令安装项目依赖
$ hexo g                         #-- 通过hexo命令将本地博客项目源文件转化为博客文件（每回修改源文件，都得运行这个命令）
$ hexo s -p5000                  #-- 通过hexo命令启动本地博客，用于测试

此时，本地博客就创建好并启动起来了，可以通过http://localhost:5000访问了。按理说运行hexo s就行了，不用加端口号（-p5000），它就可以启动一个监听4000端口的web服务，但是我这儿不行。看了下我的hexo的版本是3.2.0 released，网上有人说hexo在3.0之后改动挺大，分出了很多模块，要单独安装（比如git模块，不装不能推送到github远程库，那既然这样，为什么不默认安装呢？），这种情况要装server模块才能解决。但是我发现，在生成本的博客的时候，默认已经安装了这个模块，我又重新安装了一回，还不行，好在现在这种运行方法也不麻烦，多加一个端口号就行了，所以先这样吧。

关于本地博客的具体配置项，可以参考上述hexo官方文档或百度，主要是修改博客根目录下的_config.yml文件，这里就不详细介绍每一项了（我也没仔细看）。比较关键的是修改语言和主题：

  1. 将语言修改为中文：修改_config.yml文件中的language: zh-CN
  2. 下载和替换maupassant主题：

下载：在本地xxx.github.io目录下：

1
2
3
$ git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant  #-- 通过git命令下载
$ npm install hexo-renderer-jade --save                                        #-- 安装主题必要插件
$ npm install hexo-renderer-sass --save                                        #-- 安装主题必要插件

--save参数应该是起到把这个依赖保存在依赖的配置文件（博客根目录下的package.json文件）中的作用吧，所以只需运行一次，以后执行npm install就行了，不用单独下载这个依赖了，因为执行npm install命令就会自动下载package.json文件中配置的所有依赖。

替换：修改_config.yml文件中的theme: maupassant。

1
2
$ hexo g         #-- 转化
$ hexo s -p5000  #-- 启动

此时再访问http://localhost:5000，验证主题是否有变化。

关于maupassant主题的配置项，可以参考主题作者的博客：https://www.haomwei.com/technology/maupassant-hexo.html，主要是修改本地博客根目录下themes/maupassant/_config.yml文件。

  • 将本地博客的内容推送到github远程博客

在_config.yml文件中配置（如果没有，就在最后添加）：

1
2
3
4
deploy:
	type: git
	repository: git@github.com:xxx/xxx.github.io.git
	branch: master

！这里一定要用ssh仓库地址（git@），我用https的没成功。

在本地xxx.github.io目录下：

1
2
$ npm install hexo-deployer-git --save  #-- 通过npm命令安装hexo的git模块
$ hexo d                                #-- 通过hexo命令将本地博客内容推送到github远程博客

hexo d命令如果执行不成功的话，应该是ssh的问题，需要在本地生成公钥，上传到github服务器中的ssh keys列表中，百度可解决，这里不赘述。

等几分钟，浏览器访问http://xxx.github.io，验证推送是否生效。

  • 将本地博客的源文件备份到github库

github备份源文件非常重要。一是源文件丢了，生成的静态页面不好往回“反编译”，费时；二是程序员，单位三台电脑，家里两台电脑，抓起哪个来用哪个，用U盘来回来去倒，费事。hexo并没有提供备份源文件的命令，之前一直为这个事儿苦恼，也试过用百度云盘什么的同步，但终究太low。最后的解决方案是：在github博客项目里建一个backup分支，用于存放必要的博客源文件。

具体配置如下：

github上xxx.github.io库的backup分支之前已经建好，详见前文。如果事先没有建好的话，也可以此时创建，只是要比事先建好多一个步骤：清空分支代码。

用TortoiseGit或命令行下载仓库：https://github.com/xxx/xxx.github.io.git，并切换到backup分支（因为本地已经生成了一个xxx.github.io文件夹，此时执行这个命令又会生成一个同样名称的文件夹，会冲突，所以可以在另外的目录执行这个命令，或者将本地的文件夹改个名称，比如：xxx.github.io.local）。然后将本地文件夹中的必要文件拷贝到下载下来的文件夹里，包括：scaffolds、source、themes、_config.yml、.gitignore、package.json。是的，只有这几个文件是必要的，其它的都是生成的，没有必要备份。

如果没有.gitignore文件，就新建一个。内容如下：

1
2
3
4
5
6
7
.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/

然后提交就可以了。

好了，博客的搭建到这儿就完成了。之后就是日常使用了，也是一些流水帐：

在一台新电脑或目录里（已安装必要工具）：

用TortoiseGit或命令行下载仓库：https://github.com/xxx/xxx.github.io.git，并切换到backup分支。在刚生成的本地xxx.github.io目录下：

1
2
$ npm install hexo-cli@1.0.1 -g  #-- 安装hexo（一般只需运行一次，如果因为卸载行等原因找不到hexo命令了，就再执行一次）
$ npm install                    #-- 安装package.json文件中配置的所有依赖（一般只需运行一次，有问题就再执行一次）

本地博客根目录下的package.json文件的所有内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "hexo": {
    "version": "3.2.0"
  },
  "dependencies": {
    "hexo": "^3.2.0",
    "hexo-deployer-git": "^0.1.0",
    "hexo-generator-archive": "^0.1.4",
    "hexo-generator-category": "^0.1.3",
    "hexo-generator-index": "^0.2.0",
    "hexo-generator-tag": "^0.2.0",
    "hexo-git-backup": "^0.1.2",
    "hexo-renderer-ejs": "^0.2.0",
    "hexo-renderer-jade": "^0.3.0",
    "hexo-renderer-marked": "^0.2.10",
    "hexo-renderer-sass": "^0.2.0",
    "hexo-renderer-stylus": "^0.3.1",
    "hexo-server": "^0.2.0"
  }
}

这样，就可以在新电脑上写博客了。日常操作如下：

1
2
3
4
5
6
$ hexo n '文章标题' #-- 新建文章。文件建在xxx.github.io/source目录下，想编辑或修改，在这里找
$ hexo g            #-- 将编辑的源文件转化成博客文件
$ hexo s -p5000     #-- 启动本地博客服务器，监听5000端口
$ hexo d            #-- 发布本地博客到github远程博客
$ git commit        #-- git本地提交（可用TortoiseGit执行）
$ git push          #-- git推送备份（可用TortoiseGit执行）

总结：

  1. 总体来说挺简单的；
  2. hexo在3.0之后改变这么大！那么在之后4.0、5.0、…、100.0的版本中，改变会不会更大？基于这个担心，在安装hexo-cli的时候指定了版本号（1.0.1），这种担心和做法对不对？
  3. Now!

补充：

最近发现，github上发布的博客文章不会被百度收录，原因是github认为百度爬虫是流氓，给禁了。网上没有很好的解决方案。最好的方法是：将博客文章推送到多个地址（github和coding）。各种命令和日常操作都不变，只是改下配置就行了，这样最多快好省了。

首先在https://coding.net/上创建帐户并新建一个项目xxx（项目名随意，不用像github一样非得命名成xxx.github.io，因为coding支持给项目定义域名）。创建帐户的时候最好和github用同样的邮箱，这样用一个ssh公钥就行了。

然后配置coding的ssh访问：上传公钥并测试，不会操作就百度下。

修改本地博客根目录下的_config.yml文件的deploy配置项：

1
2
3
4
deploy:
	type: git
	git@github.com:xxx/xxx.github.io.git,master
	coding: git@git.coding.net:xxx/xxx.git,master

这样，在执行hexo d的时候，就会把本地博客同时发布到github和coding两个远程博客上了。

最后，需要配置一下coding博客。在coding项目上，选择“演示”，里面有修改域名，可以自定义成自己喜欢的域名。最重要的是下面的“编译部署”项的“高级选项里”，要选“HTML”，其它默认这好了。点击“一键部署”，项目会启动起来。

coding演示

到此，coding项目应该可以访问了，它会被百度收录，被搜索到了。