From d49495ab73453ad949334910fbf17c0d5d1071fb Mon Sep 17 00:00:00 2001 From: Jermolene Date: Mon, 28 Apr 2014 12:54:34 +0100 Subject: [PATCH] Add docs for "field" filter operator Fixes #588 --- .../tiddlers/filters/FilterOperator field.tid | 15 +++++---------- 1 file changed, 5 insertions(+), 10 deletions(-) diff --git a/editions/tw5.com/tiddlers/filters/FilterOperator field.tid b/editions/tw5.com/tiddlers/filters/FilterOperator field.tid index 130eb2247..95f1a4ca6 100644 --- a/editions/tw5.com/tiddlers/filters/FilterOperator field.tid +++ b/editions/tw5.com/tiddlers/filters/FilterOperator field.tid @@ -4,17 +4,12 @@ tags: filters commonfilters title: FilterOperator: field type: text/vnd.tiddlywiki -The ''field'' filter operator filters the current list to leave only the first tiddler that has a distinct value for a specified date field. +The ''field'' filter operator filters the current list according to whether a field matches a specified value. -For example: +The operand is the value to match, and the suffix is used to identify the field. For example: |!Filter String |!Description | -|`[eachday[created]]` |Returns a list of the first tiddler created on each distinct day | +|`[field:modifier[JeremyRuston]]` |Returns a list of the tiddlers created by `JeremyRuston | +|`[modifier[JeremyRuston]]` |Returns a list of the tiddlers created by `JeremyRuston | -The ''eachday'' operator can be used to group tiddlers. For example, the following wiki text creates a list of the number of tiddlers that were modified on each day: - -<$list filter="[!is[system]eachday[modified]!sort[modified]]"> - -<$view field="modified" format="date" template="DD MMM YYYY"/>: <$count filter="[sameday{!!modified}]"/> modifications - - +Note that if an unknown filter operator `[unknown[xxx]]` is encountered it is interpreted as `[field:unknown[xxx]]`.