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 中文社区 咨询。