From: Benny Wu <benzwu@gmail.com>
Date: Tue, 11 Aug 2015 02:33:13 +0000 (+0700)
Subject: Documentation update on Template Where Function for nil
X-Git-Tag: v0.15~214
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=d313bc78;p=brevno-suite%2Fhugo

Documentation update on Template Where Function for nil
---

diff --git a/docs/content/templates/functions.md b/docs/content/templates/functions.md
index cbb288ef..5fe31aaa 100644
--- a/docs/content/templates/functions.md
+++ b/docs/content/templates/functions.md
@@ -265,6 +265,22 @@ Following operators are now available
        {{ .Content }}
     {{ end }}
 
+### Unset field
+Filter only work for set fields. To check whether a field is set or exist, use operand `nil`.
+
+This can be useful to filter a small amount of pages from a large pool. Instead of set field on all pages, you can set field on required pages only.
+
+Only following operators are available for `nil`
+
+- `=`, `==`, `eq`: True if the given field is not set.
+- `!=`, `<>`, `ne`: True if the given field is set.
+
+e.g.
+
+    {{ range where .Data.Pages ".Params.specialpost" "!=" nil }}
+       {{ .Content }}
+    {{ end }}
+
 
 ## Math