一直以来都是用 wordpress。随着 WP 日渐臃肿，以及在喜欢上 Markdown 写作之后，就一直想找个能对 Markdown 支持完美的，轻量级的，并易于版本管理的博客系统。
在这种需求下，Jekyll 落入了视线。
Jekyll 是 GitHub 和 GitCafe 内置支持的静态网页生成引擎，可定制化程度也高。看上去对我们程序猴子这种不折腾会死的物种非常合适，但是经过一段时间的观察和分析后。感觉可能它并不是最佳选择。
然后我看到了 cnfeat 这篇 简明Github Pages与Hexo教程。瞬间就被它吸引了。
选哪个
两个引擎都支持 markdown，都可以利用 git 库进行管理。最终发布的都是静态页面。这一点没什么大的差别。相对而言，Jekyll 发展较早，相对比较成熟，Hexo 是后起之秀，但是发展迅速。
Jelly 是 github 的默认推荐。它的工作方式是把源文件上传至 github 的特定分支，然后 github 在发现有文件更新时，在服务端重新编译生成静态网页自动部署至 master 分支。
Jekyll 的优势是发展比较成熟，因为是官方推荐，支持也比较好。看上去对程序员来说也更加优雅便于折腾。缺点是配置比较复杂，需要遵循一定的规范比如一定要放在 gh-pages 分支。因为是提交源文件在服务端生成，所以在内容发生变化到前端呈现会有一定延迟。
Hexo 的原作者是一名台湾的学生。推出的目的就是为了提供更大的便利，更容易入手，更方便配置。
实际上也是如此，Hexo 从安装、配置、发布都非常简洁。常用的命令记住 n g s d 四个字母就搞定。
Hexo 还有一个决定性的好处，下文说。
总之最后我选择了 Hexo，在代码库中建立一个独立的 hexo 分支用于存放源文件。
双线部署
hexo 可以同步推送到多个git库，比如，在配置文件里这样写：
deploy:
type: git
message: "hexo deploy generated pages"
repo:
github: <github repo url>
gitcafe: <gitcafe repo url>
然后执行部署命令，就可以同步部署到 gitcafe 和 github。
如果用 dnspod 来做实现双线解析，瞬间就可以实现境内境外双线解析镜像。这点非常爽。不过这里有个坑，参见下一节。
坑
这里是一些大坑。估计如果看到Hexo的介绍后，想自己动手试试看的都会遇到。
-
首先，无论部署到GitCafe还是GitHub，都是master分支。
gitcafe-pages, gh-pages 这样的分支是用来给Jekyll在服务端生成静态网站用的。
用hexo生成网站是在本地生成后部署静态页面，这时直接部署到master即可。
-
然后，Hexo 现在最新的版本是3.0
config的设置项有所更改，包结构也有变化。
最坑的是，如果多点部署的话，会报错。看了下应该是 3.0 更新后的bug，在 github Hexo 项目上，已经有人提了issue，看什么时候能解决吧。
3.0 详细的变化可以参考 github 上的文档.
更新: 昨天 git deployer 更新到 0.0.4，修正了该问题。参见作者的说明.
更新方法：编辑 package.json，把 hexo-deployer-git 的版本升级到 0.0.4，然后
npm update. -
迁移自 wordpress
用插件 hexo-migrator-wordpress 即可一键完成。比较郁闷的是，如果原文的标题是中文，那么这里所有的文件名都会被解析成形如 ab-cd-ef-gh-de-ty-ww-rt-as-cd-fg.md 这种形式。原因可以理解，它首先将中文进行编码，然后替换空格最终形成“slug”形式的permalink。但是看着实在很蛋疼。
-
目录（categories）
hexo 支持多目录。但是……
如果你指定了多个目录，比如
[建站心得，流水账]，那么最后呈现出的目录列表可能是这个样子的：建站心得5 流水账5 流水账1 流水账1 流水账1 ...泪奔。所以还是老老实实用单category，结合标签云好啦。
还碰过其他坑，暂时记起来这么多。后面想起来或遇到新坑再更新。
写作工具
当然。你可以直接在简书写，然后复制到 Hexo 源文件目录，这个跨平台。XD
Mac 平台的话，强烈推荐 “Mou”。
最后
详细的 Hexo 安装设置指南就不多说了。 cnfeat 的文章讲得非常详细，即使小白也能按照所列的步骤一步步搭建起自己的一个静态博客。
只是有一点，弄这些玩意儿，翻墙技能还是要有一点的。否则一个 npm 命令都会让你抓狂。
Enjoy it!
(题图来自 Hexo 作者的个人主页。据说可以提高点击率。XD)
