Merge pull request #49 from ajdavis/query-distinct-documentation

Document new Query.distinct method.
This commit is contained in:
Armin Ronacher 2016-01-11 13:49:55 +01:00
commit fbfe6b4809
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 %}
```