用 hexo 和 github 搭建静态博客系统

许多人都希望自己有一个博客，但有时会觉得要搭个博客很繁琐，需要各种各样的环境，其中不知道还会出现什么错误信息，如果你曾经或者现在正有这样的想法，只要你跟着这篇文章动手起来，很快就能让你快速拥有自己的博客网站，记录生活的点滴。

环境准备

Git
NodeJs

配置github

有一个github 账号
建立一个与你用户名对应的仓库，eg: yourUserName.github.io
配置ssh-key

安装hexo

安装
```
# npm install -g hexo-cli
```
初始化Hexo 在你的PC上建立一个文件夹 <folder>
```
# hexo init <folder>
# cd <folder>
# npm install
```
启动服务
```
# hexo server
[info] Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.
```
这样在本地就能看到你的blog了, 这样就能在本地调试你的blog了

本地调试

   # hexo new "newPost" 新建文章
   # vim newPost.md  编辑文章
   # hexo new page "pageName" #新建页面
   # hexo generate #生成静态页面至public目录
   # hexo server #启动本地服务，进行文章预览调试

配置并发布

新建一篇文章

# hexo new "My New Post"  //会在目录下生成 source\_posts\My-New-Post.md

可以用 markdown 语法来编写你的文章

配置_config.yml 找到下面的内容
```
  ...

  # Deployment
  ## Docs: http://hexo.io/docs/deployment.html
  deploy:
    type:
```
把它们修改为
```
  ...
  # Deployment
  ## Docs: http://hexo.io/docs/deployment.html
  deploy:
    type: git
    repository: [email protected]:yourUserName/yourUserName.github.io.git
    branch: master
```
注意： repository: 必须是SSH形式的url eg: [email protected]:yourUserName/yourUserName.github.io.git 而不能是HTTPS形式的url https://github.com/yourUserName/yourUserName.github.io.git，否则会出现错误如果你是为一个项目制作网站，那么需要把branch设置为gh-pages。
发布
```
# hexo deploy
```

添加自定义域名解释

把域名用CNAME的方法解析到 yourUserName.github.io.git.
在source文件夹里添加CNAME文件并添加你自己的域名
```
xxx.yyy.zzz
```

日常部署步骤

  # hexo clean
  # hexo generate
  # hexo deploy

添加“Fork me on Github” ribbon

打开这个ribbon 把a 标签的代码粘贴到 themes\next\layout\layout.xxx 中，放置在最后，标签</body>之前即可，记得修改你的github 地址

常见错误

执行 hexo deploy 后,出现 error deployer not found:github 的错误

hexo 更新到3.0之后，deploy的type 的github需要改成git, 接着 npm install hexo-deployer-git --save 改了之后执行，然后再部署