tommy351/hexo — pull request #465 by chenall (2014-01-25 10:53:03+00:00)
Title: add helper plugins `list_posts`,`get_posts`

使用这两个可以很方便的获取符合条件的文章.

默认参数如下:

```js
{
count: 6, //要获取的文章数量
orderby: 'date', //排序依据, 'random' ,代表随机排序.
order: -1, //正反排序, -1 反向,,其它正向.
tags: '', // 包含标签
categories: '', //包含分类
ulClass: '',
liClass: '',
class: 'list-group',//ulClass和liClass如果省略时该参数有效,ulClass = class,liClass= class + '-item';
}
```
### 包含标签和包含分类说明:

若设置了`tags`参数,只要文章的标签有其中之一该文章就会被列出来.
分类的和标签一样.

注: 为了使用方便,有经过特殊处理,标签和分类查找是不区分大小写的.所以`grub4dos`和`GRUB4DOS`是一样的

### 简单应用例子

1. 获取最近更新的8个贴子列表
```
list_posts({count:8,orderby: "updated",order:-1}
```
2. 获取最近更新的并且有带标签'GRUB4DOS'的贴子
```
list_posts({count:8,orderby: "updated",order:-1,tags: 'GRUB4DOS'}
```
3. 在主题中使用,可以根据文章的标签查找相关贴子 #437
```
list_posts({tags: item.tags})
```
4. 获取随机贴子列表
```
list_posts({orderby: 'random'})
```

注: 参数可以组合使用,这样很方便提取特定的文章..

以上是list_posts的功能,主要是返回一个网页可显示的列表.

如果你还需要自己处理,这时可以使用`get_posts`

如下,可以获取到包含标签`grub4dos`的所有文章.

```
var posts = get_posts({tags: 'GRUB4DOS'''});
posts.forEach(function(post){
...
})
```