## 准备工作
首先下载[nodejs](https://nodejs.org/en/download/),一路next安装即可。验证是否安装成功：
```bash
node -v # 输出 v10.15.1
npm -v # 输出 6.8.0
```
接下来更改npm的安装源，这能大大加快安装包的速度。
```bash
npm get registry # 输出默认源 https://registry.npmjs.org/
npm config set registry http://registry.npm.taobao.org
npm get registry # 输出 http://registry.npm.taobao.org/，说明已更改为淘宝源
```
再运行`npm install hexo-cli -g`。
如果出现`permission error`，不要急着用`sudo npm install hexo-cli -g`，运行命令
`sudo chown -R 'whoami' /usr/local/lib/node_modules`，`'whoami'`即你的用户名，通过`whoami`命令查看。
然后再运行`npm install hexo-cli -g`。
验证是否安装成功，命令行输入`node -v`，输出hexo-cli等众多包即对应的版本则OK。
## 创建本地博文服务
在本地新建你的博客文件夹如`blog_hexo`，进入该文件夹执行下列命令：
```bash
hexo init
npm install
hexo server
```
此时访问[http://localhost:4000](http://localhost:4000)就能打开博文了，`Ctrl+C`关闭服务器。
### 添加新页面
如要添加tags页面，首先运行下面命令
```sh
hexo new page tags
```
这时会在`sources/tags`里面生成`index.md`的文件，打开这个文件编辑，添加`type: tags`，即
```
---
title: tags
date: 2016-11-11 21:40:58
type: tags
---
```
最后再在主题配置文件中，在menu项下，把tags页打开。
```
menu:
home: / || home
archives: /archives/ || archive
tags: /tags/ || tags
```
### emoji支持
Hexo默认是采用hexo-renderer-marked，这个渲染器不支持插件扩展，还有一个支持插件扩展的是 hexo-renderer-markdown-it，可以使用这个渲染引擎来支持emoji表情，具体实现过程如下：
首先进入blog跟目录，执行如下命令
```sh
npm un hexo-renderer-marked --save
npm i hexo-renderer-markdown-it --save
```
再安装emoji插件，执行如下命令
```sh
npm install markdown-it-emoji --save
```
最后再编辑站点配置文件，就是编辑根目录的_config.yml文件，添加如下内容
```yml
# Markdown-it config
## Docs: https://github.com/celsomiranda/hexo-renderer-markdown-it/wiki
markdown:
render:
html: true
xhtmlOut: false
breaks: true
linkify: true
typographer: true
quotes: '“”‘’'
plugins:
- markdown-it-abbr
- markdown-it-footnote
- markdown-it-ins
- markdown-it-sub
- markdown-it-sup
- markdown-it-emoji # add emoji
anchors:
level: 2
collisionSuffix: 'v'
permalink: true
permalinkClass: header-anchor
permalinkSymbol: ¶
```
## 关联github
首先在GitHub中新建`username.github.io`仓库，其中`username`为自己的用户名。
再进入blog_hexo根目录，安装`npm install hexo-deployer-git --save`，然后打开根目录下的_config.yml，拉到最下面, 修改Deployment设置：
```
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: git
repository: https://github.com/username/username.github.io
branch: master
```
再进入根目录执行如下命令
```bash
hexo clean
hexo generate
hexo deploy
```
第一次上传可能会让你输入git的用户名和密码。
如果成功，就可以打开`http://username.github.io`,`username`替换成自己用户名。
## Hexo命令
### 常用命令
```bash
hexo n '文章名' == hexo new '文章名' #新建文章
hexo g == hexo generate #生成静态页
hexo d == hexo deploy #部署发布 #可与hexo g合并为hexo d -g
```
### 服务器
```bash
hexo s == hexo server # Hexo会监视文件变动并自动更新，您无须重启服务器。
hexo s -s #静态模式
hexo s -p 5000 #更改端口
hexo s -i 192.168.1.1 #自定义 ip
```
### 模板
```bash
hexo n '文章名' #新建文章
hexo n page '页面名' #新建页面
hexo n photo '页面名' #新建photo页面
```
## 参考
- [Hexo](https://hexo.io/zh-cn/)
- [awesome-hexo](https://github.com/hexojs/awesome-hexo)
- [Hexo部署github博客](https://blog.csdn.net/zhengyong15984285623/article/details/82380735?utm_source=blogxgwz5)
- [亲测Hexo+Github个人博客搭建](http://blog.51cto.com/13872978/2318972?source=dra)
- [HEXO+Github,搭建属于自己的博客](https://wenlisu.github.io/HEXO+Github%EF%BC%8C%E6%90%AD%E5%BB%BA%E5%B1%9E%E4%BA%8E%E8%87%AA%E5%B7%B1%E7%9A%84%E5%8D%9A%E5%AE%A2.html)
- [搭建Hexo博客进阶篇--API和一些小部件（四）](https://www.jianshu.com/p/57e22584b277)
- [使用hexo+github搭建免费个人博客详细教程](https://www.cnblogs.com/liuxianan/p/build-blog-website-by-hexo-github.html)