hexo是基于Node.js的一款静态博客框架，如果想要搭建博客，不想自己写页面的话可以考虑用hexo，其中有很多的简洁主题可供选择，同时hexo支持markdown语法，编辑文章更加方便，快捷。

注：此篇教程以windows系统为例

一、准备工作

1.1 安装软件

首先，需要安装以下几款软件
1、Gitbash 下载地址
2、Node.js 下载地址
3、Github账号注册地址

1.2 建立博客地址

安装好之后，打开注册好的github，新建一个repositories，名称为username.github.io，username即你自己想要的名称，比如我的是plainnany.github.io，新建好之后打开这个repositories，找到settings（设置），将Github pages那一栏的source改为master branch,就可以生成可以访问的主页地址，你可以把这个地址当做自己的博客地址，当然，土豪朋友可以通过购买域名来作为自己博客的主页。

主页生成之后，需要将自己电脑与github主页”链接起来”，可以用ssh key，也可以每次提交博客的时候手动登录（较麻烦）。本文我们用ssh key。

打开gitbash，输入

1	$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

此命令会生成两个文件，id_rsa(私钥)和id_rsa.pub(公钥)，用记事本或者gitbash自带的vim打开id_rsa.pub，复制文件，打开github->settings->SSH and GPG keys，点击右上角，new ssh keys，title自拟，将复制的内容拷贝到key中，保存即可。

或者也可以在gitbash中运行如下命令

1	$ ssh-copy-id user@host

二、安装配置hexo

2.1 配置文件

打开gitbash，下载安装hexo。

1	$ npm install -g hexo-cli

安装完成可以通过查看hexo版本检查是否安装成功。

$ hexo -v

如果出现版本信息，就说明安装成功。

选择一个合适的文件夹新建站点文件，建议不要选择需要管理员权限才能创建文件（夹）的文件夹，如可以在d盘hexo文件夹内新建站点信息。

进入该文件夹。

1	$ cd d:/hexo

初始化hexo

1	$ hexo init

1	$ npm install

初始化之后，hexo文件内生成如下文件

打开hexo文件内_config.yml文件，hexo/_config.yml
修改网站相关信息

title: inerdstack
subtitle: the stack of it nerds
description: start from zero
author: inerdstack
language: zh-CN
timezone:

运行命令

$ hexo g

$ hexo s

windows可能会跳出防火墙提示，允许即可，之后会提示：

1 2	INFO Start processing INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

浏览器输入http://localhost:4000/ 就可以预览自己的页面了

2.2 更换主题

如果不满意默认的主题，可以在hexo.io选择自己喜欢的主题，如果喜欢默认的主题直接跳过这个步骤即可。

下面以maupassant主题为例。

1	$ git clone https://github.com/tufu9441/maupassant-hexo themes/maupassant

注意，hexo下载主题的时候，在作者的github上查看是否要下载额外的文件，如这款主题作者在github中提到下载主题之外还要额外安装两个文件。

1
2
3

$ git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant
$ npm install hexo-renderer-jade@0.3.0 --save
$ npm install hexo-renderer-sass --save

如果hexo-renderer-sass下载失败，可以安装sass的升级版scss，

1	$ npm install hexo-renderer-scss --save

另外使用代理，不要用淘宝镜像下载，而且sass的安装也不依赖其他的文件，不需要根据报错信息再额外的安装其他的文件（博主就是困到了这里一直下载不成功）。

打开hexo的配置文件_config.yml文件，将theme修改为maupassant，保存后运行如下命令。

1
2
3

$ hexo clean
$ hexo g
$ hexo s

打开localhost:4000，主题更换成功。

注意：如果选择的主题未成功更换，或者在下载相关文件的过程中发生报错，可以通过查看作者github的issue，可能会找到相应的解决办法。

主题相关的内容可以在下载的主题文件中的_config.yml文件进行修改，hexo/themes/maupassant/_config.yml。

三、线上部署

复制github仓库地址，要注意复制仓库的ssh地址，不要复制https地址，否则需要输入用户名和密码。

打开hexo的配置文件_config.yml
hexo/_config.yml
找到deploy，注意冒号后面需要有一个英文空格，如果没有repo与branch就自己写入。

1
2
3

type: git
repo: 刚复制仓库的ssh地址
branch: master

配置完成后，在站点目录安装扩展。

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

安装完成后运行命令。

$ hexo g

$ hexo d

打开 https://你的github账户名.github.io 就可以查看自己的博客了。

四、新建博文

1	$ hexo new "title"

编辑好title文章之后，运行

$ hexo g

$ hexo d

一篇新鲜的博客就出炉啦！

hexo+Github pages搭载博客