1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-06-16 10:29:54 +00:00

Revise filter terminology: constructors and modifiers

This commit is contained in:
Astrid Elocson 2015-01-29 13:40:18 +00:00
parent a5d54a0ada
commit 9a7bda28e9
9 changed files with 22 additions and 22 deletions

View File

@ -1,13 +1,13 @@
created: 20150117204109000
modified: 20150124185709000
modified: 20150129133830000
tags: Concepts
title: Absolute Operators
title: Selection Constructors
type: text/vnd.tiddlywiki
The output of a [[filter|Filters]] step depends on its [[operator|Filter Operators]]:
* Most operators perform <<.def relative>> to their input. They examine each input title in turn and filter out any that don't match. Such steps narrow down the output of a run.
* Most operators derive their output from their input. For example, many of them output a subset of their input, and thus truly live up to the name of <<.word filters>>, narrowing down the overall output of the containing [[run|Filter Run]]. These operators are called <<.def "selection modifiers">>.
* <<.def Absolute>> operators ignore their input and generate an independent output instead.
* A few operators ignore their input and generate an independent output instead. These are called <<.def "selection constructors">>: they construct an entirely new [[selection|Title Selection]].
A good example of an absolute operator is <<.olink title>>. The output of `[title[A]title[B]]` is just <<.tid B>>. But the <<.olink field>> operator is relative, so `[title[A]field:title[B]` outputs nothing at all.
A good example of a constructor is <<.olink title>>. The output of `[title[A]title[B]]` is just <<.tid B>>. But the <<.olink field>> operator is a modifier, so `[title[A]field:title[B]` outputs nothing at all.

View File

@ -1,5 +1,5 @@
created: 20140410103123179
modified: 20150124200331000
modified: 20150129133657000
tags: Concepts Filters
title: Filter Operators
type: text/vnd.tiddlywiki
@ -39,4 +39,4 @@ The following table lists all the core operators. The commonest ones are checkma
A typical step is written as `[operator[parameter]]`, although not all of the operators need a [[parameter|Filter Parameter]].
Most steps process the [[selection of titles|Title Selection]] that are supplied as their input, but a few are [[absolute|Absolute Operators]]. For the exact rules, see [[Filter Syntax]].
Most steps process the [[selection of titles|Title Selection]] that are supplied as their input, but a few [[construct an entirely new selection|Selection Constructors]] instead. For the exact rules, see [[Filter Syntax]].

View File

@ -1,6 +1,6 @@
created: 20140410103123179
modified: 20150124200847000
tags: [[Filter Operators]] [[Common Operators]] [[Absolute Operators]]
modified: 20150129133636000
tags: [[Filter Operators]] [[Common Operators]] [[Selection Constructors]]
title: all Operator
type: text/vnd.tiddlywiki
caption: all

View File

@ -1,6 +1,6 @@
created: 20140410103123179
modified: 20150124155303000
tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]]
modified: 20150129133643000
tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]]
title: commands Operator
type: text/vnd.tiddlywiki
caption: commands

View File

@ -1,6 +1,6 @@
created: 20150111145738451
modified: 20150124150912000
tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]]
modified: 20150129133647000
tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]]
title: editions Operator
type: text/vnd.tiddlywiki
caption: editions

View File

@ -1,6 +1,6 @@
created: 20140410103123179
modified: 20150124203324000
tags: [[Filter Operators]] [[Field Operators]] [[Absolute Operators]] [[Negatable Operators]]
modified: 20150129133705000
tags: [[Filter Operators]] [[Field Operators]] [[Selection Constructors]] [[Negatable Operators]]
title: list Operator
type: text/vnd.tiddlywiki
caption: list

View File

@ -1,6 +1,6 @@
created: 20140410103123179
modified: 20150124170640000
tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]]
modified: 20150129133709000
tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]]
title: moduletypes Operator
type: text/vnd.tiddlywiki
caption: moduletypes

View File

@ -1,5 +1,5 @@
created: 20150124182117000
modified: 20150124190233000
modified: 20150129133716000
tags: [[Filter Syntax]]
title: Filter Run
type: text/vnd.tiddlywiki
@ -19,7 +19,7 @@ A <<.def run>> consists of [[steps|Filter Step]], and it outputs a [[selection|T
The steps are processed from left to right. The input to the first step is same as the input to the run. For each subsequent step, the input is the output of the previous step.
{{Absolute Operators}}
{{Selection Constructors}}
The lower three options in the diagram match syntax like `HelloThere`, `"HelloThere"`, `'HelloThere'` and `"Filter Operators"`. They are short for `[title[...]]`.

View File

@ -1,6 +1,6 @@
created: 20140410103123179
modified: 20150124192051000
tags: [[Filter Operators]] [[Common Operators]] [[Absolute Operators]] [[Negatable Operators]]
modified: 20150129133732000
tags: [[Filter Operators]] [[Common Operators]] [[Selection Constructors]] [[Negatable Operators]]
title: title Operator
type: text/vnd.tiddlywiki
caption: title
@ -17,6 +17,6 @@ negationOutput="the input, but with tiddler <<.place t>> filtered out if it exis
`[title[An Example]]` can be shortened to `[[An Example]]`, because <<.op title>> is the default filter operator.
<<.op title>> is an [[absolute operator|Absolute Operators]] (except in the form `!title`), but <<.olink2 "field:title" field>> is relative.
<<.op title>> is a [[constructor|Selection Constructors]] (except in the form `!title`), but <<.olink2 "field:title" field>> is a [[modifier|Selection Constructors]].
<<.operator-examples "title">>