Hexo过滤文章
简介
带过滤功能的Hexo首页生成器插件。在官方的首页生成器基础上添加了过滤指定分类/标签的功能。比如,在首页只显示指定分类下面的文章列表。 除此之外,它还在指定的目录下生成指定类型的文章,比如在web目录下生成Web相关的文章。
安装
hexo-generator-index2可以完全替代官方的hexo-generator-index,所以安装之后,先卸载官方的插件,不然会引起一些冲突。
npm unnstall hexo-generator-index --save
npm install hexo-generator-index2 --save
选项
index2 generator是否包含官方的hexo-generator-index,默认true(包含)
index2_include_index: true # defult is true
index2_generator:
- layout: 'archive' # use existing archive layout
path: 'web' # output to web folder: http://127.0.0.1:4000/web/
per_page: 10
order_by: -date
include:
- category Web # include article which category is Web
exclude:
- tag Hexo # exclude article which tag is Hexo
- layout: 'index' # use existing index layout
path: '' # output to root directory: http://127.0.0.1:4000/
index: true # Set whether index, results is_home() is true or not
- **per_page**: 每页显示的帖子. (0 = 禁用分页)
- **order_by**: 排序 Posts. (默认情况下按日期降序排序)
- **layout**: 设置 layout, 默认为 `index`
- **path**: 输出路径, 如果路径是 `''`, 表示输出到根目录 (http://127.0.0.1:4000/ )
- **index**: Home index or not, if `true` and the path is `''`, same to offical [hexo-generator-index](https://github.com/hexojs/hexo-generator-index)
- **include**: 帖子过滤器包括选项
- **exclude**: 帖子过滤器排除选项
除了include和exclude,其它如per_page和order_by都是原有的官方首页生成器选项,不必更改。
Include/exclude
选项格式为属性 值
(注意,属性与值中间有个英文的空格),可选的属性有:
- category: 文章分类 - tag: 文章标签 - path: 文章源路径
填坑
- 正如安装时所说,index和index2不能同时存在;
- 配置时注意
include
和exclude
两个选项,它们的属性最好保留,这样只需要在需要过滤掉的文章里添加tag: hide
参考文章:过滤插件-Git