Jacman 支持 Hexo 3

发表于   |   分类于   |  

Hexo 的发展很迅速，也很快吸引了一大批忠实用户，随着Hexo 3.0 的推出相信会加速这个进程。Hexo 3.0 是个大更新，更强大的性能，更好用的API，模块化了大部分组件等等。但是对于很多主题来说，出现了不兼容的情况，最常见的是 style.css 生成错误，比如 Pacman 系列主题。

随着很多用户在 Github 上、邮件上、论坛上问我有关主题不能用的问题，我都回复降级至 2.8.3。 但这毕竟不是一个解决办法，于是挤出点时间，将 Jacman 支持到 Hexo 3.0。

主要原因出在 source/css/_base/variable.styl中有两行代码：

root = hexo-config("root")

//highlight
highlight = hexo-config("highlight.enable")

关键是highlight = hexo-config("highlight.enable")，hexo-config 方法会去 theme 主题下的 _config.yml 中查找参数中的配置项。当 stylus 找不到二级属性时会报错，导致style.css生成失败（我在windows下会出现这个问题，mac下未重现）。因此两种办法都可以：1. 删除该行 2. 在 theme 主题下的_config.yml中添加highlight。

同理，root 属性是在博客根目录配置文件下设置的，在主题配置文件中未配置，所以root = hexo-config("root")获取到的值会是空。这会导致用户头像等url路径的错误。最简单的修改方法是 root = "../"，其他地方均不用修改。

至此，Jacman 已支持 Hexo 3.0 。Have a nice day !

Update

感谢 @狸狸园上草 的反馈，tags 和 categories 在分类或标签数为0时也会显示出来。已修复此 BUG。

另外 Hexo 3.0 目前默认并未安装 deployer 和 feed 插件。如果你使用 GitHub 或者 GitCafe ，使用如下命令安装部署插件：

$ npm install hexo-deployer-git --save

如果你发现 RSS 不可用，说明 feed 插件也没安装，使用如下命令 ：

$ npm install hexo-generator-feed --save

并在 _config.yml 中配置：

feed:
  type: atom       #feed 类型 (atom/rss2)
  path: atom.xml   #rss 路径
  limit: 20        #在 rss 中最多生成的文章数(0显示所有)

PS:有任何关于 Hexo 的问题，欢迎来 Hexo 中文社区 咨询。