基于hexo和github搭建个人博客

安装步骤

在本地新建一个目录名叫hexo（名字自己可以任意取，主要是存放搭建博客过程中需要用到的文件）。

安装 nodejs

我的机器是mint-mate18,之前用apt安装过nodejs，感觉不太好用，所以我都是直接下载官方编译好的代码来安装node的，官网可用node 64位下载地址，32位下载地址。直接下载后解压node-v8.7.0-linux-x64.tar.xz,因为是xz文件，所以解压命令跟一般tar解压命令不太一样，这里的解压命令是：tar xJvf node-v8.7.0-linux-x64.tar.xz。
解压后进入node/node-v8.7.0-linux-x64/bin目录，创建hexo和npm的软链接，这个目录下还有一个npx不知道是做什么用的，目前用不到就先不用管，创建软链接的目的是方便在Terminal中使用hexo和npm这两个工具。创建软链接的命令如下：

1 2	ln -s /home/jiao/hexo/node/node-v8.7.0-linux-x64/bin/node /usr/bin/node ln -s /home/jiao/hexo/node/node-v8.7.0-linux-x64/bin/npm /usr/bin/npm

创建完链接就可以直接在终端中使用node命令和npm命令了。这里面的/home/jiao/hexo/node是我存放node-v8.7.0-linux-x64的目录，要根据实际情况修改成本机存放node-v8.7.0-linux-x64目录的路径。
关于nodejs的作用以及node命令的用处，我觉得官网说的是最权威的了，npm命令是nodejs的包管理器，后面的hexo的安装需要借助npm安装。
node官网

安装 npm（cnpm）

通过上面的创建软链接，我们已经安装了npm，这里推荐使用cnpm，cnpm是淘宝源的npm的替代命令，在国内更稳定点。
cnpm安装方法：

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

如果遇到权限问题就在前面加上sudo：

1	sudo npm install -g cnpm --registry=https://registry.npm.taobao.org

将cnpm加入系统环境变量目录/usr/bin目录中

1	sudo ln -s /home/jiao/hexo/node/node-v8.7.0-linux-x64/bin/node /usr/bin/cnpm

如果还是不成功可以参考这里。

安装 hexo

安装完node和cnpm，接下来就需要安装hexo了，可以直接使用cnpm安装hexo，安装命令如下：

1
2
3

sudo cnpm install hexo-cli -g
sudo cnpm install hexo-server --save
sudo cnpm install hexo-deployer-git --save

安装完成后在终端输入hexo，如果有hexo用法提示，则代表安装成功。
此处输入图片的描述

在github创建个人博客项目

这部分比较简单，只有一点需要特别注意，就是github项目名一定要写成XXX.github.io，读者可以参考『这里』创建自己的gihub博客项目。

配置hexo

到这里，需要安装的基本上都安装完了，下面就是对hexo的配置和一些必要的工具的安装。
手动创建一个文件夹blog，然后进入blog目录执行：hexo init，这里hexo会创建一个静态页面项目到本地。
可以使用hexo s命令部署到本地，然后在浏览器输入http://localhost:4000/就可以看到一个静态的页面了。
退出后在当前目录下配置_config.yml文件，在文件的最下面修改配置为：

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git #这里是部署的方式选用git
  #repo: https://github.com/jiaoqiyuan/Blog.git
  repo: git@github.com:jiaoqiyuan/jiaoqiyuan.github.io #这里填写之前创建的github项目的地址。
  branch: master

这样修改完成后就可以上传本地项目到github上了，使用

hexo g -d

命令生成新的静态页面并上传到服务端。

部署

github pages是个免费的静态站点，我们可以将自己的博客免费托管到上面，当然你也可以自己购买云服务器进行部署。

创建github pages

根据你的github账号创建一个仓库，但是这个用于静态托管博客的仓库是有格式限制的，它的名字必须是yourname.github.io，其他跟正常仓库创建一样就行。
github pages

本地电脑(hexo)配置github pages

hexo的安装上面已经介绍，接下来就是使用hexo创建本地博客环境的过程，在终端创建使用如下命令：

1
2
3

hexo init yourblogname
cd yourblogname
cnpm install

然后打开yourblogname目录下的_config.yml文件，将type自该改为git，repo改为你刚才创建的github pages仓库的地址，branck字段改为master。

然后终端输入：

hexo s

就可以开启本地服务，在浏览器输入：

1	http://localhost:4000

就可以预览本地创建的静态页面了。
ok！到此就基本成功了。

发布

到目前为止，项目在本地已经搭建起来，但是还没有跟github pages联系起来，其实刚才我们已经配置了github pages的地址，只不过还没有上传到服务端，在终端使用一下命令发布博客到服务端：

1
2
3

hexo clean    //清除本地缓存
hexo g        //生成本地发布的文件夹
hexo d        //发布到github pages上

或者：

1 2	hexo clean hexo g -d

二者等效。

后记

至此，基于github pages已经搭建起我们的博客网站了，只要访问：https://github.com/yourname/yourname.github.io，就可以访问了。

还有一些优化的功能：

主题设置
申请自己的域名绑定博客地址

…………
其他还有很多好玩的等待你去探索！

2018-04-09
北京
晴