mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-06-17 10:59:55 +00:00
a49436160d
* Improve Filter Syntax documentaion / navigation * update links and missing diagrams * rename legacy prefix to shortcut prefix * Update editions/tw5.com/tiddlers/filters/Filter Operators.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/And Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/Cascade Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/And Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * add most changes a suggested by yaisog * fix copy / paste from-version * replace operand with parameter in the docs * fix typo * fix typos and improve railroad diagrams consistency * move "new from version" info for filter run prefixes below the table * fix typo transclusion and substitution * Move Filters tiddler to the top level in the TOC * wip-breadcrumbs * breadcrumbs & breadcrumbsList macro final * remove files that do not belong to this PR * restore release banner * add simple / story mode to breadcrumbs * .breadcrumbs macro update comments * new breadcrumbs CSS, woks with small screens * make CSS configurable using hidden-settings * improve CSS fro small screens * remove the initial: recursiveParentTag macro * improve location info for breadcrumbs nav. add "alt-text" for Edge ::after element * breadcrumbs add mode=field * bc add initial docs * breadcrumbsField will also respect the story ordering * add configurable global filterMode setting * improve arrow CSS for browser zooming * add bc links use bc-caption if caption field is non-empty * breadcrumbs improve comments * breadcrumbs aria-lable uses caption if there is one * breadcrumbs improve documentation * breadcrumbs improve docs for sort param * fix showArrows docs * remove .bc-link aria-label .. it's not needed if caption is resolved properly * use subfilter instead of enlist to evaluate the "excluded" variable. Be consistent with toc-macros * remove breadcrumbs macros - they have their own PR now * resolve conflict * add back doc-macros tiddler * integrate :then filter run prefix * remove .breadcrumbs macros and their config tiddlers * fix typos as requested --------- Co-authored-by: yaisog <m@rcuswinter.de>
45 lines
2.0 KiB
Plaintext
45 lines
2.0 KiB
Plaintext
created: 20230316151518640
|
|
modified: 20230327130626715
|
|
tags: [[Filter Run Prefix]]
|
|
title: Interchangeable Filter Run Prefixes
|
|
type: text/vnd.tiddlywiki
|
|
|
|
!! Interchangeable Filter Run Prefixes
|
|
|
|
In technical / logical terms:
|
|
|
|
|!Run |!Equivalent named prefix |!Interpretation |!Output |
|
|
|`[run]` |`:or[run]` |de-duplicated union of sets |... OR run |
|
|
|`+[run]` |`:and[run]` |accumulation of filter steps |... AND run |
|
|
|`-[run]` |`:except[run]` |difference of sets |... AND NOT run |
|
|
|`~[run]` |`:else[run]` |else |... ELSE run |
|
|
|`=[run]` |`:all[run]` |union of sets without de-duplication |... OR run |
|
|
|
|
The input of a run is normally a list of all the non-[[shadow|ShadowTiddlers]] tiddler titles in the wiki (in no particular order).<br>But the `+` prefix can change this:
|
|
|
|
|Prefix|Input|h
|
|
|`-`, `~`, `=`, `:intersection` or none| <$link to="all Operator">`[all[]]`</$link> tiddler titles, unless otherwise determined by the first [[filter operator|Filter Operators]]|
|
|
|`+`, `:filter`, `:map`, `:reduce`,`:sort` |the filter output of all previous runs so far|
|
|
|
|
Precisely because of varying inputs, be aware that both prefixes `-` and `+` do not behave inverse to one another!
|
|
|
|
For example, in both of the following, `$:/baz` will only be removed if it actually exists:
|
|
|
|
* <$link to="is Operator"> `foo bar $:/baz -[is[system]]`</$link>
|
|
* <$link to="prefix Operator">`foo bar $:/baz -[prefix[$:/]]`</$link>
|
|
|
|
To understand why, consider the input for both final runs with their `-` prefix.
|
|
|
|
In order to remove `$:/baz` in any case, existing or not, simply use the `+` prefix with [[negated filter operators|Filter Operators]]:
|
|
|
|
* <$link to="is Operator">`foo bar $:/baz +[!is[system]]`</$link>
|
|
* <$link to="prefix Operator">`foo bar $:/baz +[!prefix[$:/]]`</$link>
|
|
|
|
!! Difference between + and intersection
|
|
|
|
For the difference between `+` and `:intersection`, see [[Intersection Filter Run Prefix (Examples)]].
|
|
|
|
!! For Developers
|
|
|
|
To create a new filter run prefix, create a [[Javascript module|Modules]] with a [[module-type|ModuleType]] of `filterrunprefix`.
|