shithub: hugo

Download patch

ref: d313bc78a478f9457ce8b496ede0b231e6b4d0f1
parent: 29c9a40a8d5defbe69c38e9997313ce27df55eaf
author: Benny Wu <[email protected]>
date: Tue Aug 11 05:33:13 EDT 2015

Documentation update on Template Where Function for nil

--- a/docs/content/templates/functions.md
+++ b/docs/content/templates/functions.md
@@ -265,6 +265,22 @@
        {{ .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