Hexo搭建Github个人博客

建立自己的github.io

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

配置git账号

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

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

配置github账号的SSH key

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

生成ssh公钥

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

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

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

1
$ cat ~/.ssh/id_rsa.pub

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

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

Hexo安装

安装Node.js

1
brew install node

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

安装Hexo

1
$ npm install -g hexo-cli

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

hexo简单使用

创建工程

1
$ hexo init myblog

创建新工程,名字就叫 myblog

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

修改配置

对(_config.yml)文件进行修改,主要更改点为 titleauthorurl 等。

git绑定

修改(_config.yml)中的 deploy ,将 type 更改为 git ,同时补充 repositorybranch 信息, branchmaster

github.io 这个仓库进行绑定,工程发布后,会将运行文件提交到 github.io 上,这样就可以通过 github.io 来访问博客了。

创建博文

1
$ hexo new myblog

新建一个名叫myblog的博文。

生成静态文件

1
$ hexo generate

该命令可简写为

1
$ hexo g

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

本地预览

1
$ hexo server

可简写为

1
$ hexo s

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

部署网站

1
$ hexo deploy

可简写为

1
$ hexo d

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

清理缓存

1
$ hexo clean

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

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

hexo更换主题

修改主题

我们只需要在hexo的主题官网上挑选一个自己喜欢的主题,然后将其克隆到工程的thmes目录下,修改工程配置文件_config.yml,将theme修改成theme目录下的主题即可。

主题配置

hexo的主题配置,可参见其主题使用文档。

使用hexo写博客

创建博文

1
$ hexo new myblog

生成静态文件并发布

1
$ hexo g -d

上次更新 2018-08-10