从Jekyll迁移到Hexo

以前，我用jeykll时，每个文件名字如下：

2012-11-19-this-is-a-post.md

对应的url为

http://reverland.org/2012/11/19/this-is-a-post/

或者可以是

http://reverland.org/2012/11/19/this-is-a-post
http://reverland.org/2012/11/19/this-is-a-post/index.html

首先，要把hexo也改成这样的，在=_config.yml=中：

new_post_name: :year-:month-:day-:title.md # File name of new posts
permalink: :category/:year/:month/:day/:title/

但，还是有问题，具体可以参照我提的issue，hexo如果看你的文件名是这样：

2014-06-12-.md

会生成这样的url

2015/11/13/2014-06-12.html

显然这不是我们想要的。

我们通过将=node_modules/hexo-util/lib/permalink.js=第28行由

return '(.+?)';

更改为

return '(.*?)';

可以实现以前的jekyll风格。

如果你现在用的是hexo版本=3.1.0=，如果文件是：

可能会遇到生成这种url链接：

http://reverland.org/2014/06/12//index.html
http://reverland.org/2014/06/12//

在github中hexo已经不会有这个问题了，可以参见 hexo/helper/url\_for的

return path.replace(/\/{2,}/g, '/');

来进行修改，如果你用的不是git版本的hexo。

我之后还碰到个问题，hexo中的分类是大小写敏感的，jekyll也是，但jekyll在url中会统一变成小写而hexo则不会，这竟然造成了我迁移后的一些链接失效。修正方法也很简单，通过=sed=将所有大写的=category=项都替换成对应的小写版本。

sed -i 's/^category: Life/category: life/g' source/_posts/*.md  # 我只有Life分类莫名写成了大写

这样，确保了和jekyll之前所有链接一致，然而，发现还是有disqus的评论消失了，检查链接并没有差异，暂时不知为什么。如果有谁能指教下请告诉我。

jekyll中，除了我用四个空格作为编码块区域缩进设定，还广泛使用了jekyll所特有的记法进行代码高亮。

{% highlight python %}
def sum(a, b):
    return a + b;
{% endhighlight %}

{% highlight cl%}
(cdr,
  (add,
    1, 1))
{% endhighlight %}

另外，我的每个文件里还有些jekyll特定命令来加入统计和评论什么的。这是当年从Skydark那里画虎不成留下的各种dirty　hack的结果。

{% include JB/setup %}

可以这样转换掉

sed -i 's/{%[[:space:]]highlight[[:space:]]\(.*\)[[:space:]]*%\}/```\1/g' source/_posts/*.md  # 注意有空格和没空格
sed -i 's/{%[[:space:]]endhighlight[[:space:]]%\}/```/g' source/_posts/*.md
sed -i 's/{%[[:space:]]include JB\/setup[[:space:]]%\}//g source/_posts/*.md'

接着有些特殊的文件会解析报错，因为hexo用nunjunks来渲染，如果文本中有={{ }}=或者={% %}=会出错。我发现如果是缩进四格的代码标记或者```会出错，但如果用另一种标记法 `````则没关系。

实在不行，我们可以用html实体编码。

<code>&#97;&#98;&#99;</code>

我试着用pandoc转换了下，发现几个问题：

1. 会将metadata错误地转换
2. 莫名的在行或特殊符号后面加反斜杠
3. 不能很好处理jekyll的代码高亮标记法

我写了些脚本辅助手工更改为markdown格式。话说这些sed代码还都是之前尝试往pelican上迁移时写的辅助脚本，虽然从来没有迁移到pelican平台上。

# 删除和转换jeykll特定标记
sed -i 's/{%[[:space:]]include JB\/setup[[:space:]]%\}//g' source/_posts/*.textile
sed -i 's/{%[[:space:]]highlight[[:space:]]\(.*\)[[:space:]]*%\}/```\1/g' source/_posts/*.textile
sed -i 's/{%[[:space:]]endhighlight[[:space:]]%\}/```/g' source/_posts/*.textile

# textile标记到markdown的转换
# 列表
sed -i 's/^* /- /g' source/_posts/*.textile
sed -i 's/^# /- /g' source/_posts/*.textile
# 标题
sed -i 's/^h1./#/g' source/_posts/*.textile
sed -i 's/^h2./##/g' source/_posts/*.textile
sed -i 's/^h3./###/g' source/_posts/*.textile
sed -i 's/^h4./####/g' source/_posts/*.textile
sed -i 's/^h5./#####/g' source/_posts/*.textile
# 脚注
sed -i 's/^fn\([[:digit:]]\)\./[\^\1]:/g' source/*.textile
sed -i 's/\[\([[:digit:]]*\)\]/[\^\1]/g' source/*.textile
# 默认的markdown解析并不支持脚注
# 如果需要，参考这里替换默认markdown解析，https://github.com/celsomiranda/hexo-renderer-markdown-it　
# 可惜这个引擎中，```块就不能正常解析{{ }}这种东西了
# 不知道那个pandoc后端的怎样。

# 链接
sed -i 's/"\([^"]*\)"\([h|\/].*\)/[\1](\2)/g' source/*.textile
sed -i 's/"\([^"]*\)"\([^h\/].*\)/[\1][\2]/g' source/*.textile


# 最后把后缀改了，hexo不会处理后缀是textile的文件
for file in source/_posts/*.textile; do
cp $file source/_posts/`basename $file .textile`.md
done

当然，最好脚本辅助，手工确认。

另外，有这么个东西hexo render pandoc来替换hexo的渲染引擎，就能顺便支持textile。值得一试和研究，也许里头就用到对文档元数据或者跳过指定行数的转换吧。没有细看。话说，还看到[@CodeFalling](http://codefalling.com/2015/11/15/new-version-of-hexo-renderer-org/)使用emacs来做org渲染后端，hexo的灵活性可见一斑。