Document new Query.distinct method.

This commit is contained in:
A. Jesse Jiryu Davis 2016-01-10 15:35:37 -05:00
parent 45014ce289
commit a883531bad
1 changed files with 37 additions and 0 deletions

View File

@ -0,0 +1,37 @@
title: distinct
---
summary: Returns the set of unique values for a field.
---
type: method
---
signature: field_name
---
body:
Returns a `set` with all values for `field_name` of all
[Records :ref](../../record/) in this query.
## Example
If your blog posts have a field called `tags`:
```ini
# blog-post.ini
[field.tags]
name = Tags
type = strings
```
You can display all your blog posts' tags with:
```html+jinja
{% set tags = site.query('/blog').distinct('tags') %}
{% if tags %}
<ul>
{% for tag in tags|sort %}
<li>{{ tag }}</li>
{% endfor %}
</ul>
{% endif %}
```