Hexo搭建Github个人博客

建立自己的github.io

建立自己的github.io，这个跟创建普通的github仓库一样，只是仓库的名字叫xxx.github.io。

配置git账号

如果本地已安装SourceTree并已使用github账号下载过项目，则请忽略。

$ git config --global user.name "Your name"
$ git config --global user.email xxx@email.com``

配置github账号的SSH key

如果本地已安装SourceTree并已使用github账号下载过项目，则请忽略。

生成ssh公钥

$ ssh-keygen -t rsa -c "xxx@xxx.com"

三次回车即可生成ssh key，对于存放目录，可以使用默认，也可在默认的基础上添加自定义目录。个人倾向于自定义目录。

查看public key，并把它添加到github公钥中

$ cat ~/.ssh/id_rsa.pub

将#号后的内容拷贝到 Github 公钥中并保存即可。

具体可参考Github官网的配置，或参考码云关于ssh key的配置

Hexo安装

安装Node.js

brew install node

由于hexo的运行，依赖于Node.js，所以在安装hexo前，请先安装Node.js。

安装Hexo

$ npm install -g hexo-cli

Hexo的具体安装可参见其官网。

hexo简单使用

创建工程

$ hexo init myblog

创建新工程，名字就叫 myblog 。

创建新工程后，里面会有一堆的文件。其中(_config.yml)文件为工程配置文件，这里面包含了整个工程的运行配置，我们待会会对其进行修改。

修改配置 && git绑定

对(_config.yml)文件进行修改， 主要更改点为 title 、 author 、 url、deploy 等。

title: myblog
author: Tom
url: https://xianzhiding.github.io
...
deploy:
  type: git
  repo: git@github.com:xianzhiding/xianzhiding.github.io.git
  branch: master

创建博文

$ hexo new myblog

新建一个名叫myblog的博文。

生成静态文件

$ hexo generate

该命令可简写为

$ hexo g

此命令执行后，会在工程里生成一个public文件夹，这个文件夹里的文件，包含了整个静态网站运行的所有文件。这些文件，会在我们部署网站的时候，提交到我们创建的github.io仓库里。

本地预览

$ hexo server

可简写为

$ hexo s

启动本地服务环境后，可在浏览器中输入http://localhost:4000/预览工程的运行。

部署网站

$ hexo deploy

可简写为

$ hexo d

若前面已配置过_config.yml中的Deployment，则执行部署后，会将public里的内容提交到我们的github.io中。大约5~10分钟，就可以通过github.io访问到自己的静态网站了。

清理缓存

$ hexo clean

在某些情况下（尤其是更改主题后），肯能出现站点运行异常，可执行此命令。

需要注意的是：若清空了缓存，则站点需要重新生成静态文件并发布。