tiddlywiki 5.3.3 → 5.3.5

package/editions/tw5.com/tiddlers/filters/syntax/Filter Step.tid

@@ -1,23 +1,35 @@
 created: 20150124182127000
-modified: 20201103111044922
-tags: [[Filter Syntax]]
+modified: 20230710074414361
+tags: [[Filter Run]]
 title: Filter Step
 type: text/vnd.tiddlywiki
 
+A <<.def "filter step">> represents a single operation within a <<.def "filter run">>.
+
+In programming terms, it is akin to a function call to which the step's input is passed as a parameter. A step's output is a [[title selection|Title Selection]] that contributes to a [[filter run|Filter Run]] and hence to the entire [[filter expression|Filter Expression]] that contains it.
+
 <$railroad text="""
+\start none
+\end none
 [:"!"]
-[: [[operator|"Filter Operators"]] [:":" suffix] ]
-[[parameter|"Filter Parameter"]]
+( / "if omitted, defaults to: title" /|:
+( - | :[[operator|"Filter Operators"]] )
+{ [:":" [[suffix|"Filter Operators"]] ] } )
+{ [[parameter|"Filter Parameter"]] + "," }
 """/>
 
-A <<.def step>> represents a single operation within a [[filter|Filter Syntax]].
-
-In programming terms, it is akin to a function call to which [[the step's input|Filter Run]] is passed as an implicit parameter. A step's output is a [[selection|Title Selection]] that contributes to a [[run|Filter Run]] and hence to the entire [[filter expression|Filter Expression]] that contains it.
+The step's <<.def operator>> is drawn from a list of predefined keywoards which are known as [[filter operators|Filter Operators]].
 
-The step's <<.def operator>> is drawn from a list of [[predefined keywords|Filter Operators]], which can be extended by plugins. Any unrecognised operator is treated as if it was the suffix to the <<.olink field>> operator. If a step's operator is omitted altogether, it defaults to `title`.
+Many steps require an explicit <<.def parameter>>, that further defines what the step is to do. 
 
 The <<.def suffix>> is additional text, often the name of a [[field|TiddlerFields]], that extends the meaning of certain operators.
 
-Many steps require an explicit <<.def parameter>> value, also known as an <<.def operand>>, that further defines what the step is to do. 
+If a step's <<.def operator>> and <<.def suffix>> are //omitted// altogether, it defaults to the [[title|title Operator]] operator.
+
+<<.from-version "5.1.23">> Some steps accept multiple <<.def parameter>>s which are separated by a `,` character.
+
+Any unrecognised operator is treated as if it was the suffix to the <<.olink field>> operator. 
+
+Filter operators can be extended by plugins.
 
-<<.from-version "5.1.23">> Some steps accept multiple parameters which are separated by a ` , ` character.
+{{Selection Constructors}}

package/editions/tw5.com/tiddlers/filters/syntax/Filter Syntax.tid

@@ -1,18 +1,24 @@
 created: 20140210141217955
-modified: 20150124184229000
+list: [[Filter Expression]] [[Filter Run]] [[Filter Step]] [[Filter Parameter]] [[Filter Whitespace]]
+modified: 20230710074340943
 tags: Filters
 title: Filter Syntax
 type: text/vnd.tiddlywiki
-list: [[Filter Expression]] [[Filter Run]] [[Filter Step]] [[Filter Parameter]] [[Filter Whitespace]]
 
 <<.preamble """[[Filters]] follow a grammar that is presented here, using [[railroad diagrams|Railroad Diagrams]], for those who find formal syntax descriptions helpful. However, you can [[learn to write filters|Introduction to filter notation]] without needing to understand this group of tiddlers.""">>
 
-A <<.def filter>> is a pipeline for transforming an <<.def input>> into an <<.def output>>. Both the input and the output are [[ordered sets of titles|Title Selection]] of things like tiddlers and fields.
+A <<.def filter>> is a pipeline for transforming an <<.def input>> into an <<.def output>>. Both the input and the output are [[ordered sets of titles|Title Selection]] of tiddlers and fields.
 
-Filters are [[expressions|Filter Expression]] constructed from smaller building blocks, called [[runs|Filter Run]] and [[steps|Filter Step]], each of which also transforms an input to an output.
+Filters are ''expressions'' constructed from smaller building blocks, called ''runs'', which are built using ''steps''. Eeach of which also transforms an input to an output.
 
 A filter starts with an empty output. Its runs are processed from left to right, progressively modifying the output.
 
-Here are details of the various building blocks involved:
+The "Filter Syntax" description starts with:
+
+<$railroad text="""
+\start double
+\end double
+[[<"Filter Expression">|"Filter Expression"]]
+"""/>
 
-<<list-links "[tag[Filter Syntax]]">>
+<<.tip "The railroad boxes as the one above can be used to navigate">>

package/editions/tw5.com/tiddlers/filters/syntax/Filter Whitespace.tid

@@ -1,11 +1,13 @@
 created: 20150124182304000
-modified: 20150125105243000
-tags: [[Filter Syntax]]
+modified: 20230710074447240
+tags: [[Filter Expression]]
 title: Filter Whitespace
 type: text/vnd.tiddlywiki
 
 <$railroad text="""
+\start none
+\end none
 {( "space" | "tab" | "linefeed" | "return" | "vertical tab" | "formfeed" )}
 """/>
 
-Whitespace characters can appear between each [[run|Filter Run]] of a [[filter expression|Filter Expression]].
+Whitespace characters can appear between each run of a [[filter expression|Filter Expression]].

package/editions/tw5.com/tiddlers/filters/syntax/Interchangeable Filter Run Prefixes.tid

@@ -0,0 +1,44 @@
+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`.

package/editions/tw5.com/tiddlers/filters/syntax/Intersection Filter Run Prefix (Examples).tid

@@ -1,6 +1,6 @@
 created: 20211128212902292
-modified: 20211128233320674
-tags: [[Filter Syntax]] [[Filter Run Prefix Examples]] [[Intersection Filter Run Prefix]]
+modified: 20230305125354209
+tags: [[Intersection Filter Run Prefix]]
 title: Intersection Filter Run Prefix (Examples)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/filters/syntax/Intersection Filter Run Prefix.tid

@@ -1,15 +1,20 @@
 created: 20211128212902292
-modified: 20211128212904721
-tags: [[Filter Syntax]] [[Filter Run Prefix]]
+from-version: 5.1.23
+modified: 20230710073322863
+rp-input: all titles from previous filter runs
+rp-output: the titles that are present in both the result of this filter run and the output from previous runs
+rp-purpose: find the intersection of titles from previous runs with titles in this filter
+tags: [[Named Filter Run Prefix]]
 title: Intersection Filter Run Prefix
 type: text/vnd.tiddlywiki
 
-<<.from-version "5.1.23">>
-
-|''purpose'' |find the intersection of titles from previous runs with titles in this filter run |
-|''input'' |all titles from previous filter runs |
-|''output''|the titles that are present in both the result of this filter run and the output from previous runs |
+<$railroad text="""
+\start none
+\end none
+( ":intersection" | - )
+[[run|"Filter Run"]]
+"""/>
 
 The filter output from previous runs is set aside. The `:intersection` filter run is started with all tiddler titles as input. Once this latest filter run has completed, the latest output is compared to the set-aside output. A new output is produced that contains only titles that appeared in both the set-aside output and the latest output.
 
-[[Examples|Intersection Filter Run Prefix (Examples)]]
+[[Intersection Filter Run Prefix (Examples)]]

package/editions/tw5.com/tiddlers/filters/syntax/Map Filter Run Prefix (Examples).tid

@@ -1,6 +1,6 @@
 created: 20210618134753828
-modified: 20220724162340642
-tags: [[Filter Syntax]] [[Filter Run Prefix Examples]] [[Map Filter Run Prefix]]
+modified: 20230305125405422
+tags: [[Map Filter Run Prefix]]
 title: Map Filter Run Prefix (Examples)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/filters/syntax/Map Filter Run Prefix.tid

@@ -1,28 +1,33 @@
 created: 20210618133745003
-modified: 20220720190146771
-tags: [[Filter Syntax]] [[Filter Run Prefix]]
+from-version: 5.2.0
+modified: 20240312202834547
+rp-input: the filter output of all previous runs so far
+rp-output: the input titles as modified by the result of this filter run
+rp-purpose: modify input titles by the result of evaluating this filter run for each item
+rp-suffix: <<.from-version "5.2.3">> <<.value flat>> to return all results from the filter run, or omit (default) to return only the first result
+tags: [[Named Filter Run Prefix]]
 title: Map Filter Run Prefix
 type: text/vnd.tiddlywiki
 
-<<.from-version "5.2.0">>
-
-|''purpose'' |modify input titles by the result of evaluating this filter run for each item |
-|''input'' |all titles from previous filter runs |
-|''suffix''|<<.from-version "5.2.3">> `flat` to return all results from the filter run, If omitted (default), only the first result is returned.|
-|''output''|the input titles as modified by the result of this filter run |
+<$railroad text="""
+\start none
+\end none
+( ":map" (: ":flat" | - ) | - )
+[[run|"Filter Run"]]
+"""/>
 
 Each input title from previous runs is passed to this run in turn. The filter run transforms the input titles and the output of this run replaces the input title. For example, the filter run `[get[caption]else{!!title}]` replaces each input title with its caption field, unless the field does not exist in which case the title is preserved.
 
-Note that within the filter run, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits filter runs like `:map[{!!price}multiply{!!cost}]` to be used for computation. The value of currentTiddler outside the run is available in the variable "..currentTiddler".
+Note that within the filter run, the <<.var currentTiddler>> variable is set to the title of the tiddler being processed. This permits filter runs like `:map[{!!price}multiply{!!cost}]` to be used for computation.
 
 The following variables are available within the filter run:
 
-* ''currentTiddler'' - the input title
-* ''..currentTiddler'' - the value of the variable `currentTiddler` outside the filter run.
-* ''index'' - <<.from-version "5.2.1">> the numeric index of the current list item (with zero being the first item in the list).
-* ''revIndex'' - <<.from-version "5.2.1">> the reverse numeric index of the current list item (with zero being the last item in the list).
-* ''length'' - <<.from-version "5.2.1">> the total length of the input list.
+* <<.var currentTiddler>> - the input title
+* <<.var ..currentTiddler>> - the value of the variable `currentTiddler` outside the filter run.
+* <<.var index>> - <<.from-version "5.2.1">> the numeric index of the current list item (with zero being the first item in the list).
+* <<.var revIndex>> - <<.from-version "5.2.1">> the reverse numeric index of the current list item (with zero being the last item in the list).
+* <<.var length>> - <<.from-version "5.2.1">> the total length of the input list.
 
-Filter runs used with the `:map` prefix should return at least the same number of items that they are passed. Any missing entries will be treated as an empty string. In particular, when retrieving the value of a field with the [[get Operator]] it is helpful to guard against a missing field value using the [[else Operator]]. For example `[get[myfield]else[default-value]...`.
+Filter runs used with the `:map` prefix should return at least the same number of items that they are passed. Input titles for which the filter run returns no output are replaced by an empty string. In particular, when retrieving the value of a field with the [[get Operator]] it is helpful to guard against a missing field value using the [[else Operator]]. For example `[get[myfield]else[default-value]...`.
 
-[[Examples|Map Filter Run Prefix (Examples)]]
+[[Map Filter Run Prefix (Examples)]]

package/editions/tw5.com/tiddlers/filters/syntax/Named Filter Run Prefix.tid

@@ -1,10 +1,36 @@
 created: 20201214044413473
-modified: 20211118025845599
-tags: [[Filter Syntax]]
+modified: 20230711090833212
+tags: [[Filter Run Prefix]]
 title: Named Filter Run Prefix
+type: text/vnd.tiddlywiki
 
-<$set name="prefixlist" filter="""[all[shadows+tiddlers]has[module-type]module-type[filterrunprefix]trim:prefix[$:/core/modules/filterrunprefixes/]trim:suffix[.js]addprefix["]addsuffix["]join[|]addprefix[(]addsuffix[)]]""">
-<$railroad text=<<prefixlist>>/>
-</$set>
+In <<.from-version "5.1.23">> the named filter run prefixes were implemented. `:cascade`, `:map` and `:sort` have been added later as shown in the diagrams.
 
-A named filter run prefix can precede any [[run|Filter Run]] of a [[filter expression|Filter Expression]] in place of a single-character prefix (`+`, `-` and so on). To create a new filter run prefix, create a [[Javascript module|Modules]] with a [[module-type|ModuleType]] of `filterrunprefix`.
+A named filter run prefix can precede any [[run|Filter Run]] of a [[filter expression|Filter Expression]] in place of a [[shortcut run prefix|Shortcut Filter Run Prefix]].
+
+<$railroad text="""
+\start none
+\end none
+(
+[[<":all"> |"All Filter Run Prefix"]] |
+[[<":and"> |"And Filter Run Prefix"]] |
+[[<":cascade">  /"v5.2.1"/  |"Cascade Filter Run Prefix"]] |
+[[<":else"> |"Else Filter Run Prefix"]] |
+[[<":except"> |"Except Filter Run Prefix"]] |
+[[<":filter"> |"Filter Filter Run Prefix"]] |
+[[<":intersection"> |"Intersection Filter Run Prefix"]] |
+[[<":map">  /"v5.2.0"/ |"Map Filter Run Prefix"]] |
+[[<":or"> |"Or Filter Run Prefix"]] |
+[[<":reduce"> |"Reduce Filter Run Prefix"]] |
+[[<":sort">  /"v5.2.0"/ |"Sort Filter Run Prefix"]] |
+[[<":then">  /"v5.3.0"/ |"Then Filter Run Prefix"]]) [[run|"Filter Run"]]
+"""/>
+
+
+<<.tip "Compare named filter run prefix `:filter` with [[filter Operator]] which applies a subfilter to every input title, removing the titles that return an empty result from the subfilter">>
+
+<<.tip "Compare named filter run prefix `:reduce` with [[reduce Operator]] which is used to used to flatten a list of items down to a single item by repeatedly applying a subfilter">> 
+
+<<.tip """Within the filter runs prefixed with `:reduce`, `:sort`, `:map` and `:filter`, the <<.var currentTiddler>> variable is set to the title of the tiddler being processed.<br>The value of currentTiddler outside the subfilter is available in the variable <<.var "..currentTiddler">> <<.from-version "5.2.0">>""" >>
+
+Also see: [[Interchangeable Filter Run Prefixes]]

package/editions/tw5.com/tiddlers/filters/syntax/Or Filter Run Prefix.tid

@@ -0,0 +1,18 @@
+created: 20230318135743766
+from-version: 5.1.23
+modified: 20230322140708372
+rp-input: all titles from previous filter runs
+rp-output: output titles are [[dominantly appended|Dominant Append]] to the output of previous filter runs
+rp-purpose: de-duplicated union of tiddler sets
+tags: [[Named Filter Run Prefix]]
+title: Or Filter Run Prefix
+type: text/vnd.tiddlywiki
+
+<$railroad text="""
+\start none
+\end none
+( ":or" | - )
+[[run|"Filter Run Prefix"]]
+"""/>
+
+The :or prefix is equivalent to using no prefix at all. See `run` at [[Shortcut Filter Run Prefix]]

package/editions/tw5.com/tiddlers/filters/syntax/Reduce Filter Run Prefix (Examples).tid

@@ -1,6 +1,6 @@
 created: 20211124151912931
-modified: 20211124160747921
-tags: [[Filter Syntax]] [[Reduce Filter Run Prefix]] [[Filter Run Prefix Examples]]
+modified: 20230305125430544
+tags: [[Reduce Filter Run Prefix]]
 title: Reduce Filter Run Prefix (Examples)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/filters/syntax/Reduce Filter Run Prefix.tid

@@ -1,25 +1,34 @@
 created: 20211124151912931
-modified: 20211124170117511
-tags: [[Filter Syntax]] [[Filter Run Prefix]]
+from-version: 5.1.23
+modified: 20230710073305239
+rp-input: the filter output of all previous runs so far
+rp-output: the accumulated single item
+rp-purpose: replaces all filter output so far with a single item by repeatedly applying a filter run to each input title
+tags: [[Named Filter Run Prefix]]
 title: Reduce Filter Run Prefix
 type: text/vnd.tiddlywiki
 
-<<.from-version "5.1.23">>
 
-|''purpose'' |replaces all filter output so far with a single item by repeatedly applying a filter run to each input title |
-|''input'' |all titles from previous filter runs |
-|''output''|the accumulated single item |
+<$railroad text="""
+\start none
+\end none
+( ":reduce" | - )
+[[run|"Filter Run"]]
+"""/>
 
-Each input title from previous runs is passed to this run in turn. The result of each previous call to this run is made available in the next call via the variable named "accumulator". The result of the last call to this run is returned as the output.  A typical use is to add up the values in a given field of each input title.
+
+Each input title from previous runs is passed to this run in turn. The result of each previous call to this run is made available in the next call via the variable named <<.var accumulator>>. The result of the last call to this run is returned as the output.  A typical use is to add up the values in a given field of each input title.
+
+Replaces all filter output so far with a single item by repeatedly applying a formula, as described above, to each input title.
 
 The following variables are available within the filter run:
 
-* ''accumulator'' - the result of the previous filter run
-* ''currentTiddler'' - the input title
-* ''..currentTiddler'' - the value of the variable `currentTiddler` outside the filter run. <<.from-version "5.2.0">>
-* ''index'' - the numeric index of the current list item (with zero being the first item in the list)
-* ''revIndex'' - the reverse numeric index of the current list item (with zero being the last item in the list)
-* ''length'' - the total length of the input list
+* <<.var accumulator>> - the result of the previous filter run
+* <<.var currentTiddler>> - the input title
+* <<.var ..currentTiddler>> - the value of the variable `currentTiddler` outside the filter run. <<.from-version "5.2.0">>
+* <<.var index>> - the numeric index of the current list item (with zero being the first item in the list)
+* <<.var revIndex>> - the reverse numeric index of the current list item (with zero being the last item in the list)
+* <<.var length>> - the total length of the input list
 
 <<.tip "Compare named filter run prefix `:reduce` with [[reduce Operator]] which is used to flatten a list of items down to a single item by repeatedly applying a subfilter.">> 
 
@@ -35,4 +44,4 @@ is equivalent to:
 [tag[shopping]reduce<num-items>]
 ```
 
-[[Examples|Reduce Filter Run Prefix (Examples)]]
+[[Reduce Filter Run Prefix (Examples)]]

package/editions/tw5.com/tiddlers/filters/syntax/Shortcut Filter Run Prefixes.tid

@@ -0,0 +1,29 @@
+created: 20230305131705188
+modified: 20230710074438655
+tags: [[Filter Run Prefix]]
+title: Shortcut Filter Run Prefix
+type: text/vnd.tiddlywiki
+
+Shortcut prefixes are commonly used by advanced users because they are fast to type but they are harder to read by less experienced users. That's why [[named prefixes|Named Filter Run Prefix]] have been created, which are more verbose. Shortcut and named filter run prefixes are interchangeable as shown in the table below.
+
+<$railroad text="""
+\start none
+\end none
+(-|:"+"|"-"|"~"|"=")
+[[run|"Filter Run"]]
+"""/>
+
+If a run has:
+
+* no prefix, its output titles are [[dominantly appended|Dominant Append]] to the filter's output
+
+* the prefix `+`, it receives the filter output so far as its input; its output then <<.em "replaces">> all filter output so far and forms the input for the next run
+
+* the prefix `-`, output titles are <<.em removed>> from the filter's output (if such tiddlers exist)
+
+* the prefix `~`, if the filter output so far is an empty list then the output titles of the run are [[dominantly appended|Dominant Append]] to the filter's output. If the filter output so far is not an empty list then the run is ignored. <<.from-version "5.1.18">>
+
+* the prefix `=`, output titles are appended to the filter's output without de-duplication. <<.from-version "5.1.20">> 
+
+
+{{Interchangeable Filter Run Prefixes}}

package/editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix (Examples).tid

@@ -1,6 +1,6 @@
 created: 20210428074912172
-modified: 20210428085746041
-tags: [[Filter Syntax]] [[Sort Filter Run Prefix]] [[Filter Run Prefix Examples]]
+modified: 20230315165343329
+tags: [[Sort Filter Run Prefix]]
 title: Sort Filter Run Prefix (Examples)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid

@@ -1,19 +1,26 @@
 created: 20210428083929749
-modified: 20210522162628946
-tags: [[Filter Syntax]] [[Filter Run Prefix]]
+from-version: 5.2.0
+modified: 20240312203002082
+rp-input: the filter output of all previous runs so far
+rp-output: output titles replace the output of previous filter runs
+rp-purpose: sort the input titles by the result of evaluating this filter run for each item
+rp-suffix: the <<.op :sort>> filter run prefix uses a rich suffix, see below for details
+tags: [[Named Filter Run Prefix]]
 title: Sort Filter Run Prefix
 type: text/vnd.tiddlywiki
 
-<<.from-version "5.2.0">>
-
-|''purpose'' |sort the input titles by the result of evaluating this filter run for each item |
-|''input'' |all titles from previous filter runs |
-|''suffix'' |the `:sort` filter run prefix uses a rich suffix, see below for details |
-|''output''|the sorted result of previous filter runs |
+<$railroad text="""
+\start none
+\end none
+( ( ":sort" ) 
+( : ":string" | ":alphanumeric" | ":number" | ":integer" | ":version" | ":date" )
+( : ":casesensitive" /"required for string and alphanumeric"/ | ":caseinsensitive" /"required for string and alphanumeric"/  | ":reverse" /"optional"/ | - ) | - )
+[[run|"Filter Run"]]
+"""/>
 
 Each input title from previous runs is passed to this run in turn. The filter run transforms the input titles into the form needed for sorting. For example, the filter run `[length[]]` transforms each input title in to the number representing its length, and thus sorts the input titles according to their length.
 
-Note that within the filter run, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits filter runs like `:sort:number[{!!value}divide{!!cost}]` to be used for computation. The value of currentTiddler outside the run is available in the variable "..currentTiddler".
+Note that within the filter run, the <<.var currentTiddler>> variable is set to the title of the tiddler being processed. This permits filter runs like `:sort:number[{!!value}divide{!!cost}]` to be used for computation. The value of <<.var currentTiddler>> outside the run is available in the variable <<.var "..currentTiddler">>.
 
 The `:sort` filter run prefix uses an extended syntax that allows for multiple suffixes, some of which are required:
 

package/editions/tw5.com/tiddlers/filters/syntax/then Filter Run Prefix.tid

@@ -1,45 +1,14 @@
 created: 20210618133745003
 from-version: 5.3.0
-modified: 20230506172920710
+modified: 20230710074225410
 rp-input: <<.olink all>> tiddler titles
 rp-output: the output of this filter run replaces the output of previous runs unless it is an empty list (see below)
 rp-purpose: replace any input to this filter run with its output, only evaluating the run when there is any input
 search: 
-tags: [[Filter Run Prefix]] [[Filter Syntax]]
+tags: [[Named Filter Run Prefix]]
 title: Then Filter Run Prefix
 type: text/vnd.tiddlywiki
 
-\define .op-row()
-<$macrocall $name=".if"
-	cond="""$(op-body)$"""
-	then="""<tr><th align="left">$(op-head)$</th><td><<.op-place>>$(op-body)$</td></tr>"""
-	else=""/>
-\end
-
-<$list filter="[all[current]has[from-version]]" variable="listItem">
-	<$macrocall $name=".from-version" version={{!!from-version}}/>
-</$list>
-<$let op-head="" op-body="" op-name="">
-	<table class="doc-table">
-		<!-- purpose -->
-		<$let op-head="purpose" op-body={{!!rp-purpose}}>
-			<<.op-row>>
-		</$let>
-		<!-- input -->
-		<$let op-head="[[input|Filter Expression]]" op-body={{!!rp-input}}>
-			<<.op-row>>
-		</$let>
-		<!-- suffix -->
-		<$let op-head="suffix" op-body={{!!rp-suffix}} op-name={{!!rp-suffix-name}}>
-			<<.op-row>>
-		</$let>
-		<!-- output -->
-		<$let op-head="output" op-body={{!!rp-output}}>
-			<<.op-row>>
-		</$let>
-	</table>
-</$let>
-
 <$railroad text="""
 \start none
 \end none
@@ -47,8 +16,6 @@ type: text/vnd.tiddlywiki
 [[run|"Filter Run"]]
 """/>
 
-!Introduction
-
 The <<.op :then>> filter run prefix is used to replace the result of all previous filter runs with its output.
 
 If the result of all previous runs is an empty list, the <<.op :then>> prefixed filter run is not evaluated.
@@ -67,5 +34,5 @@ The major difference between the <<.op then>> operator and a <<.op :then>> prefi
 |^<<.operator-example m1-1 "[tag[WikiText]] :then[[true]]">>|^<<.operator-example m1-2 "[tag[WikiText]then[true]]">><p>To make them equivalent, additional filter steps may be added:</p> <<.operator-example m1-3 "[tag[WikiText]count[]compare:number:gt[0]then[true]]">>|
 
 
-! [[Examples|Then Filter Run Prefix (Examples)]]
+[[Then Filter Run Prefix (Examples)]]
 

package/editions/tw5.com/tiddlers/filters/toggle Operator.tid

@@ -4,7 +4,7 @@ modified: 20201118192155504
 op-input: a list of items
 op-output: the input list with the title specified in the parameter toggled
 op-parameter: the <<.op toggle>> operator accepts 1 or more parameters, see below for details
-op-purpose: toggle the title specified in the operand in the input
+op-purpose: toggle the title specified in the parameter in the input
 tags: [[Filter Operators]] [[Listops Operators]] [[Order Operators]]
 title: toggle Operator
 type: text/vnd.tiddlywiki
@@ -19,7 +19,7 @@ The <<.op toggle>> operator requires at least one parameter and can accept addit
 * ''title1'' : a title to toggle in the input list. If it is already present, it is removed. Otherwise, it is added.
 * ''title2'': (optional). When the second parameter is provided, the operator toggles between the two values in the input list. If neither is present, the first parameter takes precedence is added to the list.
 
-With more than two parameters, the <<.op toggle>> behaves similar to the [[cycle|cycle Operator]] and can be used to cycle through a list of values. Note that all operands should be unique.
+With more than two parameters, the <<.op toggle>> behaves similar to the [[cycle|cycle Operator]] and can be used to cycle through a list of values. Note that all parameters should be unique.
 
 <$macrocall $name=".tip" _="While the <<.op cycle>> operator interprets its first parameter as a list of titles to cycle through and offers similar functionality, the <<.op toggle>> operator accepts an unlimited number of distinct parameters."/>
 

package/editions/tw5.com/tiddlers/filters/transcludes.tid

@@ -0,0 +1,14 @@
+caption: transcludes
+created: 20211002204500000
+modified: 20240610085927867
+op-input: a [[selection of titles|Title Selection]]
+op-output: the titles which the input tiddlers [[hard-transclude|Hard and Soft Transclusions]]
+op-parameter: none
+op-purpose: find the titles transcluded by each input title
+tags: [[Filter Operators]] [[Common Operators]]
+title: transcludes Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version 5.3.4>> Each input title is processed in turn. The corresponding tiddler's list of transclusions is generated, in the order in which they appear in the tiddler's text, and [[dominantly appended|Dominant Append]] to the operator's overall output.
+
+<<.operator-examples "transcludes">>

package/editions/tw5.com/tiddlers/filters/unique.tid

@@ -1,4 +1,6 @@
 caption: unique
+created: 20240709151018238
+modified: 20240709151336906
 op-input: a list of items
 op-output: a list of unique items
 op-parameter: ignored
@@ -7,4 +9,6 @@ tags: [[Filter Operators]] [[Order Operators]] [[Listops Operators]]
 title: unique Operator
 type: text/vnd.tiddlywiki
 
+<<.note """Unlike the default <<.link "Dominant Append" "Dominant Append">> handling of duplication, the effect of <<.op unique>> is to retain only the <<.em earliest>> instance among duplicated values.""">>
+
 <<.operator-examples "unique">>

package/editions/tw5.com/tiddlers/gettingstarted/GettingStarted - Firefox.tid

@@ -1,10 +1,11 @@
 caption: Firefox
 created: 20140811170425199
-modified: 20211114031651878
+modified: 20230803213024843
 tags: GettingStarted
 title: GettingStarted - Firefox
 type: text/vnd.tiddlywiki
 
-Firefox provides the best user experience for using TiddlyWiki with the TiddlyFox browser extension.
+Firefox provides the best user experience for using TiddlyWiki with the following browser extensions:
+<<list-links filter:"[tag[Firefox]delivery[Browser Extension]] -[[Saving with TiddlyFox]]">>
 
-{{Saving with TiddlyFox}}
+{{Saving with FireFox}}

package/editions/tw5.com/tiddlers/hellothere/HelloThere.tid

@@ -1,6 +1,6 @@
 created: 20130822170200000
 list: [[A Gentle Guide to TiddlyWiki]] [[Discover TiddlyWiki]] [[Some of the things you can do with TiddlyWiki]] [[Ten reasons to switch to TiddlyWiki]] Examples [[What happened to the original TiddlyWiki?]]
-modified: 20231223102201587
+modified: 20240710115948992
 tags: TableOfContents
 title: HelloThere
 type: text/vnd.tiddlywiki

package/editions/tw5.com/tiddlers/howtos/Concatenating text and variables using macro substitution.tid

@@ -4,10 +4,16 @@ tags: Learning
 title: Concatenating text and variables using macro substitution
 type: text/vnd.tiddlywiki
 
+!! Important
+
 <<.from-version "5.3.0">> It is recommended to use [[substituted attributes|Substituted Attribute Values]] or the [[substitute filter operator|substitute Operator]] to concatenate text and variables.
 
 It's a frequent use case in ~TiddlyWiki that you will want to put the results of variables together with various bits of strings of text. This process in some programming languages is often referred to as "concatenating" text.
 
+---
+
+!! What is Wrong
+
 You might, for instance want to set up a template for your customer database, where links will automatically refer to additional contact information about your customer. Inside your tiddler, you might try something like this:
 
 <<.bad-example "`[[Additional Info|<<currentTiddler>>-Contact]]`">>

package/editions/tw5.com/tiddlers/howtos/Custom_data-styles.tid

@@ -1,9 +1,11 @@
-created: 201804111739
-modified: 201804111739
+created: 20180411173900000
+modified: 20230803050721827
 tags: data-tags-styles [[How to apply custom styles]] $:/tags/Stylesheet
 title: Custom data-styles
 type: text/vnd.tiddlywiki
 
+\rules only filteredtranscludeinline transcludeinline macrodef macrocallinline html
+
 [data-tiddler-title="Custom styles by data-tiddler-title"] {
   border: 1px solid blue;
 }