Hexo是时下比较流行的博客框架,有比较丰富的主题和插件支持。Github为用户提供了GitHub Pages,空间免费稳定,用来搭建一个博客是非常合适的。

下面介绍一下如何使用GitHub+Hexo搭建一个属于自己的博客。

安装Node.js

搭建Node.js运行环境。安装Node.js

安装Git

搭建Git环境。安装Git

安装Hexo

Node环境搭好后,就可以用npm安装Hexo了。

1
2
3
4
5
6
$ npm install -g hexo-cli   // 全局安装hexo-cli
$ hexo init my-blog // 创建一个hexo框架
$ cd my-blog // 进入目录
$ npm install // 安装依赖包
$ hexo generate // 生成静态文件(结果文件)
$ hexo server // 启动本地服务,可以通过http://localhost:4000/ 访问

其中,新建的框架目录如下

1
2
3
4
5
6
7
|—— _config.yml             // 网站的配置信息
|—— package.json // 项目包信息
|—— scaffolds // 模板文件夹,Hexo根据scaffold中的模板来新建文件
|—— source // 存放用户资源的地方
| |—— _drafts // 存放草稿
| |—— _posts // 存放文章
|—— themes // 主题文件夹

在使用框架时,会常用到以下几个命令:

1
2
3
4
5
$ hexo generate  // 简写:hexo g,生成静态文件,会在当前目录下生成一个public文件夹
$ hexo server // 简写:hexo s,启动本地服务,用于博客的预览
$ hexo deploy // 简写:hexo d,部署到远程(如GitHub,可以在_config.yml中配置)
$ hexo new post-name // 简写:hexo n post-name, 新建文章
$ hexo new page page-name //简写:hexo n page page-name,新建页面

还有常用的组合命令:

1
2
$ hexo d -g                 // 生成和部署
$ hexo s -g // 生成和预览

草稿命令:

1
2
3
$ hexo new draft <title>        // 新建草稿,存放在source/_drafts
$ hexo publish post <title> // 发布草稿为文章,文章转移到source/_posts
$ hexo s -g --drafts // 显示草稿

设置Hexo主题

1
2
$ hexo clean
$ git clone https://github.com/LouisBarranqueiro/hexo-theme-tranquilpeak.git themes/tranquilpeak

然后修改Hexo目录下的_config.yml配置文件中的theme属性,将其设置为transquilpeak。

重新启动服务,就可以看到最新的主题了。

有的主题在GitHub上不是最终的主题文件夹,需要经过编译生成。具体的以主题项目中的说明为准。
这里举例的tranquilpeak主题就是需要下载一个zip包来获得。

部署到GitHub Pages

前面有说过,GitHub Pages用于介绍托管在GitHub的项目的,每个帐号只能创建一个repository来存放GitHub Pages,而且仓库名称必须是username/username.github.io,这是固定的命名约定。

创建后,可以通过http://username.github.io来访问个人主页。

GitHub Pages中个人主页的内容是在master分支下的。

部署Hexo到GitHub Pages指的就是将hexo -g 生成的静态文件推送到GitHub Pages对应的仓库中。

Hexo提供了hexo-deployer-git工具,可以帮助部署Hexo到很多平台

1
$ npm install hexo-deployer-git --save

修改_config.yml中的配置:

1
2
3
4
deploy:
type: git
repo: https://github.com/yanyinhong/yanyinhong.github.io.git
branch: master

然后执行命令:

1
$ hexo d

参考文章

手把手教你使用Hexo + Github Pages搭建个人独立博客