tiddlywiki 5.3.2 → 5.3.4

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 where 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/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: 20231213080637781
+modified: 20240627165458407
 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;
 }

package/editions/tw5.com/tiddlers/howtos/How to embed PDF and other documents.tid

@@ -1,5 +1,5 @@
 created: 20141117000000000
-modified: 20161229175752081
+modified: 20230803051806817
 tags: Learning
 title: How to embed PDF and other documents
 type: text/vnd.tiddlywiki
@@ -24,7 +24,7 @@ This method be OK as long as your PDF is not too big. There can be concerns if y
 
 !!! 2. Embedding with '_canonical_uri'
 
-The other way is to create a tiddler link to the external file. In this method the file is not actually incorporated into your TW5 file, but can be accessed with the `{{My Image File.jpg}}` transclusion syntax just like an embedded file. The location address of the file can also be changed under [[node.js]]. See [[ExternalImages]] for details of using external images with node.js.
+The other way is to create a tiddler link to the external file. In this method the file is not actually incorporated into your TW5 file, but can be accessed with the `{{My Image File.jpg}}` transclusion syntax just like an embedded file. The location address of the file can also be changed under [[Node.js]]. See [[ExternalImages]] for details of using external images with node.js.
 
 Create a tiddler with a field `_canonical_uri`. Put in the local address to the external file. Set the `type` field to `application/pdf`.
 

package/editions/tw5.com/tiddlers/howtos/Setting a page background image.tid

@@ -1,5 +1,5 @@
 created: 20150417155912612
-modified: 20160610082700598
+modified: 20230803044412567
 tags: [[Customise TiddlyWiki]]
 title: Setting a page background image
 type: text/vnd.tiddlywiki
@@ -14,5 +14,5 @@ type: text/vnd.tiddlywiki
 #* ''Cover'' causes the background image to be sized so that it completely covers the page. Some of the image may be clipped
 #* ''Contain'' causes the background image to be sized so that it fits within the page
 
-Note that the palette ''DarkPhotos'' is provided to make the sidebar more readable on dark background images.
+Note that the palette [[DarkPhotos|ColourPalettes]] is provided to make the sidebar more readable on dark background images.
 

package/editions/tw5.com/tiddlers/howtos/Tagging.tid

@@ -1,5 +1,5 @@
 created: 20140904075400000
-modified: 20160612132049797
+modified: 20230803050201458
 tags: [[Working with TiddlyWiki]] Concepts
 title: Tagging
 type: text/vnd.tiddlywiki
@@ -20,7 +20,7 @@ By tagging your tiddlers, you can view, navigate and organise your information i
 
 * You can use [[filters|Filters]] to create lists of tiddlers based on their tags. You can then display any combination of the [[fields|TiddlerFields]] of those tiddlers. For example, you could build a glossary by listing the title and text of all tiddlers tagged ''Glossary''. Such lists can be formatted in any way you wish: e.g. bulleted, numbered or comma-separated.
 
-* There are a number of special ''system tags'' that control the layout of tiddlers and the entire ~TiddlyWiki page. See [[Page and tiddler layout customisation]] for instructions.
+* There are a number of special ''system tags'' that control the layout of tiddlers and the entire ~TiddlyWiki page. See [[Page and tiddler layout customisation|Customising TiddlyWiki's user interface]] for instructions.
 
 There are two more things you can do with tags:
 
@@ -28,7 +28,7 @@ There are two more things you can do with tags:
 
 You can use the <<.icon $:/core/images/tag-button>> [[tag manager|$:/TagManager]], found on the ''Tags'' tab under ''More'' in the sidebar, to change the colour of a tag's pill or add an icon to the pill.
 
-* To change the colour, click the button in the ''Colour'' column to select from a colour picker. Alternatively, click the icon in the ''Info'' column, then type a [[CSS]] colour value in the ''Colour'' field
+* To change the colour, click the button in the ''Colour'' column to select from a colour picker. Alternatively, click the icon in the ''Info'' column, then type a [[CSS|Cascading Style Sheets]] colour value in the ''Colour'' field
 * To change the icon, click the <<.icon $:/core/images/down-arrow>> button in the ''Icon'' column and choose from the list of available icons
 
 ! Change the order in which tags are listed

package/editions/tw5.com/tiddlers/howtos/Using Excise.tid

@@ -1,11 +1,11 @@
 created: 20160810122928198
-modified: 20230505104214168
+modified: 20230803044526608
 tags: [[Editor toolbar]]
 title: Using Excise
 type: text/vnd.tiddlywiki
 
 ! Excise text
-From the EditorToolbar you can export selected text to a new tiddler and insert a [[link|Linking in WikiText]], [[Transclusion]] or [[macro|Macros]] in its place. Click ''Excise text'' (<<.icon $:/core/images/excise>>), input name of the new tiddler, and choose excise method.
+From the [[Editor toolbar]] you can export selected text to a new tiddler and insert a [[link|Linking in WikiText]], [[Transclusion]] or [[macro|Macros]] in its place. Click ''Excise text'' (<<.icon $:/core/images/excise>>), input name of the new tiddler, and choose excise method.
 
 !! How to excise text
 # Highlight the relevant piece of text 

package/editions/tw5.com/tiddlers/images/Open Collective Logo.tid

@@ -1,4 +1,6 @@
-title: Open Collective Logo
+created: 20240621075644739
+modified: 20240621075647009
 tags: picture
+title: Open Collective Logo
 
-<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2" viewBox="0 0 28 28"><path d="M25.509 6.026A13.934 13.934 0 0 1 28 14c0 2.963-.92 5.71-2.491 7.974l-3.626-3.627A8.96 8.96 0 0 0 23 14a8.964 8.964 0 0 0-1.117-4.347l3.626-3.627Z"/><path d="m21.974 2.49-3.627 3.628a9 9 0 1 0 0 15.765l3.627 3.626A13.934 13.934 0 0 1 14 27.999C6.268 28 0 21.733 0 14 0 6.269 6.268 0 14 0c2.963 0 5.711.922 7.974 2.492Z"/></svg>
+<svg style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2" viewBox="0 0 28 28"><path d="M25.509 6.026A13.934 13.934 0 0 1 28 14c0 2.963-.92 5.71-2.491 7.974l-3.626-3.627A8.96 8.96 0 0 0 23 14a8.964 8.964 0 0 0-1.117-4.347l3.626-3.627Z"/><path d="m21.974 2.49-3.627 3.628a9 9 0 1 0 0 15.765l3.627 3.626A13.934 13.934 0 0 1 14 27.999C6.268 28 0 21.733 0 14 0 6.269 6.268 0 14 0c2.963 0 5.711.922 7.974 2.492Z"/></svg>