tiddlywiki 5.1.21 → 5.2.1

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

@@ -0,0 +1,24 @@
+caption: cycle
+created: 20201118172906835
+modified: 20201118192136472
+op-input: a list of items
+op-output: the input list with the titles specified in the parameter toggled in a cyclical manner
+op-parameter: the <<.op cycle>> operator accepts 1 or 2 parameters, see below for details
+op-purpose: toggle in the input, the titles specified in the first operand in a cyclical manner
+tags: [[Filter Operators]] [[Listops Operators]] [[Order Operators]]
+title: cycle Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">>
+
+The <<.op cycle>> operator requires at least one parameter.
+
+```
+[cycle[<titles>],[step-size]]
+```
+* ''titles'' : a title list to toggle in the input list cyclically. If no title from the parameter is present in the input, the first title is added. If a title from the parameter is present in the input, it is replaced with the next title from the parameter. Note that all titles specified in this parameter should be unique.
+* ''step-size'': (optional). Defaults to 1. Specifies the number of steps in the parameter list to move each time. Can be a negative number.
+
+<$macrocall $name=".tip" _="While the <<.op cycle>> operator interprets its first parameter as a list of titles to cycle through, the [[toggle Operator]] accepts an unlimited number of distinct parameters and offers similar functionality."/>
+
+<<.operator-examples "cycle">>

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

@@ -0,0 +1,14 @@
+caption: deserializers
+created: 20210506115203172
+from-version: 5.2.0
+modified: 20210506130322593
+op-input: ignored
+op-output: the title of each available deserializer
+op-parameter: none
+tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]] 
+title: deserializers Operator
+type: text/vnd.tiddlywiki
+
+<<.tip "You can specify a specific deserializer for a DropzoneWidget to use">>
+
+<<.operator-examples "deserializers">>

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

@@ -0,0 +1,22 @@
+caption: duplicateslugs
+created: 20200509141702846
+modified: 20200509141702846
+op-input: a [[selection of titles|Title Selection]]
+op-output: input titles that yield duplicate slugs
+op-purpose: find titles that yield duplicate slugs
+tags: [[Filter Operators]]
+title: duplicateslugs Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">> The <<.olink slugify>> operator can be used to transform arbitrary tiddler titles into human readable strings suitable for use in URLs or filenames. However, it is possible for multiple different titles to slugify to the same string. The <<.olink duplicateslugs>> operator can be used to display a warning. For example:
+
+<$macrocall $name='wikitext-example-without-html'
+src='<$list filter="[!is[system]duplicateslugs[]limit[1]]" emptyMessage="There are no duplicate slugs">
+The following tiddlers have duplicate slugs:
+
+<ul>
+<$list filter="[!is[system]duplicateslugs[]]">
+<li><$link><$text text=<<currentTiddler>>/></$link></li>
+</$list>
+</ul>
+</$list>'/>

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

@@ -1,5 +1,5 @@
 created: 20140410103123179
-modified: 20170103175939836
+modified: 20191209085901849
 tags: [[Filter Operators]] [[Group Operators]]
 title: each Operator
 type: text/vnd.tiddlywiki
@@ -20,6 +20,6 @@ Each input title is processed in turn. The value of field <<.place F>> in the co
 ;each:value
 :As long as the title is unique it is appended to the output whether or not the corresponding tiddler exists.
 
-If a tiddler does not contain field <<.place F>>, it is treated as if the value of the field were empty.
+Note that if a tiddler does not contain field <<.place F>>, it is treated as if the value of the field were empty. Thus, a filter expression such as `[each[motovun]]` will return one tiddler that doesn't have a `motovun` field, as well as one tiddler with each distinct value of that field, if any. To obtain just the tiddlers that have a non-blank value for the `motovun` field one can use `[each[motovun]has[motovun]]`.
 
 <<.operator-examples "each">>

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

@@ -1,6 +1,6 @@
 caption: enlist
 created: 20170221144241063
-modified: 20190610165246154
+modified: 20210505100241872
 op-input: ignored
 op-neg-input: a [[selection of titles|Title Selection]]
 op-neg-output: those input titles that are <<.em not>> listed in <<.place L>>
@@ -14,7 +14,7 @@ tags: [[Filter Operators]] [[Field Operators]] [[Selection Constructors]] [[Nega
 title: enlist Operator
 type: text/vnd.tiddlywiki
 
-<<.tip " Literal filter operands cannot contain square brackets but you can work around the issue by using a variable:">>
+<<.tip """Literal filter operands cannot contain square brackets but you can work around the issue by using a variable. ''Learn more at:'' [[SetWidget]] documentation under the heading "Filtered List Variable Assignment" """>>
 
 ```
 <$set name="myList" value="first [[second with a space]] third">
@@ -22,5 +22,4 @@ type: text/vnd.tiddlywiki
 ...
 ```
 
-
 <<.operator-examples "enlist">>

package/editions/tw5.com/tiddlers/filters/enlist-input Operator.tid

@@ -0,0 +1,31 @@
+caption: enlist-input
+created: 20201102215459192
+modified: 20201102221854719
+op-input: a [[selection of titles|Title Selection]]
+op-output: the titles stored as a [[title list|Title List]] in each input title
+op-purpose: select titles by interpreting each input title as a [[title list|Title List]]
+op-suffix: `dedupe` (the default) to remove duplicates, `raw` to leave duplicates untouched
+op-suffix-name: D
+tags: [[Filter Operators]] [[String Operators]]
+title: enlist-input Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">>
+
+<<.tip " Compare with [[enlist|enlist Operator]] operator that interprets its operand as a title list">>
+
+```
+<$vars days={{{ [[Days of the Week]get[list]] }}}>
+
+{{{ [enlist<days>] }}}
+
+</$vars>
+```
+
+is equivalent to:
+
+```
+{{{ [[Days of the Week]get[list]enlist-input[]] }}}
+```
+
+<<.operator-examples "enlist-input">>

package/editions/tw5.com/tiddlers/filters/examples/Brownies.tid

@@ -0,0 +1,9 @@
+created: 20201004145650743
+modified: 20201006181234412
+price: 4.99
+quantity: 1
+tags: shopping
+title: Brownies
+type: text/vnd.tiddlywiki
+
+//This is a sample shopping list item for the [[Shopping List Example]]//

package/editions/tw5.com/tiddlers/filters/examples/Chick Peas.tid

@@ -0,0 +1,9 @@
+created: 20201004145612358
+modified: 20201006181232439
+price: 1.32
+quantity: 5
+tags: shopping
+title: Chick Peas
+type: text/vnd.tiddlywiki
+
+//This is a sample shopping list item for the [[Shopping List Example]]//

package/editions/tw5.com/tiddlers/filters/examples/How to remove stop words.tid

@@ -0,0 +1,28 @@
+created: 20201118094513209
+modified: 20201118103414384
+tags: [[Operator Examples]] [[search-replace Operator]] [[sortsub Operator]]
+title: How to remove stop words
+type: text/vnd.tiddlywiki
+
+\define book-list()
+[[A Tale of Two Cities]]
+[[The Dice Man]]
+[[A New Kind of Science]]
+[[The Recursive Universe]]
+[[Great Expectations]]
+[[Animal Farm]]
+\end
+
+\define compare-without-stopwords()
+[<currentTiddler>search-replace:i:regexp[^The |A ],[]]
+\end
+
+You can use the [[search-replace Operator]] in combination with the [[sortsub Operator]] to ignore stop words like "A" and "The" at the beginning of titles when sorting. (Note for example that "A Tale of Two Cities" sorts under "T" rather than "A")
+<<.operator-example 6 "[enlist<book-list>sortsub<compare-without-stopwords>]">>
+
+You can also customise the listing so that "A Tale of Two Cities" is listed as "Tale of Two Cities, A" but still links to the correct tiddler.
+<<wikitext-example-without-html """<ul>
+<$list filter="[enlist<book-list>sortsub<compare-without-stopwords>]">
+<li><$link><$text text={{{[<currentTiddler>search-replace:i:regexp[(^The |A )(.*)],[$2, $1]]}}}/></$link></li>
+</$list>
+</ul>""">>

package/editions/tw5.com/tiddlers/filters/examples/Milk.tid

@@ -0,0 +1,9 @@
+created: 20201004145636906
+modified: 20201006181233518
+price: 0.46
+quantity: 12
+tags: shopping
+title: Milk
+type: text/vnd.tiddlywiki
+
+//This is a sample shopping list item for the [[Shopping List Example]]//

package/editions/tw5.com/tiddlers/filters/examples/Rice Pudding.tid

@@ -0,0 +1,9 @@
+created: 20201004145502135
+modified: 20201006181230956
+price: 2.66
+quantity: 4
+tags: shopping
+title: Rice Pudding
+type: text/vnd.tiddlywiki
+
+//This is a sample shopping list item for the [[Shopping List Example]]//

package/editions/tw5.com/tiddlers/filters/examples/acos Operator (Examples).tid

@@ -0,0 +1,7 @@
+created: 20211020142658214
+modified: 20211020142724786
+tags: [[acos Operator]] [[Operator Examples]]
+title: acos Operator (Examples)
+
+<<.operator-example 1 "[[2]acos[]]">>
+<<.operator-example 2 "=1 =2 =3 =4 +[acos[]]">>

package/editions/tw5.com/tiddlers/filters/examples/allbefore.tid

@@ -8,3 +8,4 @@ type: text/vnd.tiddlywiki
 
 <<.operator-example 1 "[list[Days of the Week]allbefore[Wednesday]]">>
 <<.operator-example 2 "[list[Days of the Week]allbefore:include[Wednesday]]">>
+<<.operator-example 3 "A B C D E +[allbefore:include[C]count[]]">>

package/editions/tw5.com/tiddlers/filters/examples/asin Operator (Examples).tid

@@ -0,0 +1,7 @@
+created: 20211020142731829
+modified: 20211020142758974
+tags: [[Operator Examples]] [[asin Operator]]
+title: asin Operator (Examples)
+
+<<.operator-example 1 "[[2]asin[]]">>
+<<.operator-example 2 "=1 =2 =3 =4 +[asin[]]">>

package/editions/tw5.com/tiddlers/filters/examples/atan Operator (Examples).tid

@@ -0,0 +1,7 @@
+created: 20211020141113826
+modified: 20211020141329661
+tags: [[atan2 Operator]] [[Operator Examples]]
+title: atan Operator (Examples)
+
+<<.operator-example 1 "[[2]atan[]]">>
+<<.operator-example 2 "=1 =2 =3 =4 +[atan[]]">>

package/editions/tw5.com/tiddlers/filters/examples/atan2 Operator (Examples).tid

@@ -0,0 +1,7 @@
+created: 20211020140733724
+modified: 20211020140827194
+tags: [[atan2 Operator]] [[Operator Examples]]
+title: atan2 Operator (Examples)
+
+<<.operator-example 1 "[[2]atan2[5]]">>
+<<.operator-example 2 "=1 =2 =3 =4 +[atan2[4]]">>

package/editions/tw5.com/tiddlers/filters/examples/average Operator (Examples).tid

@@ -0,0 +1,10 @@
+created: 20210426130837644
+modified: 20210426131553546
+tags: [[Operator Examples]] [[average Operator]]
+title: average Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "=1 =3 =4 =5 +[average[]]">>
+
+Note that if there is no input the operator returns `NaN`
+<<.operator-example 2 "[tag[NotATiddler]get[price]] +[average[]]">>

package/editions/tw5.com/tiddlers/filters/examples/charcode.tid

@@ -0,0 +1,7 @@
+created: 20210622214849214
+modified: 20210622214849214
+tags: [[charcode Operator]] [[Operator Examples]]
+title: charcode Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "[charcode[65]match[A]]">>

package/editions/tw5.com/tiddlers/filters/examples/compare Operator (Examples).tid

@@ -0,0 +1,11 @@
+created: 20200412212935849
+modified: 20200412212935849
+tags: [[compare Operator]] [[Operator Examples]]
+title: compare Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "[[20200101]compare:date:gt[201912311852]]" "compares two partial dates">>
+<<.operator-example 2 "[[202001011852]compare:integer:gt[20191231]]" "compares the same two strings as integers">>
+<<.operator-example 3 "[list[Days of the Week]compare:string:gt[M]compare:string:lt[W]]">>
+<<.operator-example 4 "[[v5.1.23-prerelease]compare:version:gt[v5.1.22]]">>
+<<.operator-example 5 "[[1]compare:number:gt[2]then[yes]else[no]]">>

package/editions/tw5.com/tiddlers/filters/examples/cos Operator (Examples).tid

@@ -0,0 +1,7 @@
+created: 20211020142042072
+modified: 20211020142110929
+tags: [[Operator Examples]] [[cos Operator]]
+title: cos Operator (Examples)
+
+<<.operator-example 1 "[[2]cos[]]">>
+<<.operator-example 2 "=1 =2 =3 =4 +[cos[]]">>

package/editions/tw5.com/tiddlers/filters/examples/cycle Operator (Examples).tid

@@ -0,0 +1,21 @@
+created: 20201118174250896
+modified: 20201118175415868
+tags: [[Operator Examples]] [[cycle Operator]]
+title: cycle Operator (Examples)
+type: text/vnd.tiddlywiki
+
+Cycle through a list of values to add as a tag:
+
+```
+<$action-listops $tiddler="target" $tags="+[cycle[todo soon now maybe done ]]" />
+```
+
+Cycle through a list of values to add as a tag, in reverse order:
+
+```
+<$action-listops $tiddler="target" $tags="+[cycle[todo soon now maybe done ],[-1]]" />
+```
+
+<<.using-days-of-week>>
+<<.operator-example 1 """[list[Days of the Week]first[]] +[cycle{Days of the Week!!list}]""">>
+<<.operator-example 2 """[list[Days of the Week]first[]] +[cycle{Days of the Week!!list},[2]]""">>

package/editions/tw5.com/tiddlers/filters/examples/deserializers Operator (Examples).tid

@@ -0,0 +1,7 @@
+created: 20210506115345021
+modified: 20210506115402052
+tags: [[Operator Examples]] [[deserializer Operator]]
+title: deserializers Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "[deserializers[]]">>

package/editions/tw5.com/tiddlers/filters/examples/enlist-input Operator (Examples).tid

@@ -0,0 +1,12 @@
+created: 20201102220519567
+modified: 20201103090622475
+tags: [[enlist-input Operator]] [[Operator Examples]]
+title: enlist-input Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "[[Days of the Week]get[list]enlist-input[]]">>
+Contrast with: <<.operator-example 2 "[[Days of the Week]get[list]]">>
+<<.operator-example 3 "'HelloThere GettingStarted [[Customise TiddlyWiki]]' +[enlist-input[]]">>
+Contrast with: <<.operator-example 4 "'HelloThere GettingStarted [[Customise TiddlyWiki]]'">>
+<<.operator-example 5 "'HelloThere HelloThere GettingStarted [[Customise TiddlyWiki]]' +[enlist-input:raw[]]">>
+Contrast with: <<.operator-example 6 "'HelloThere HelloThere GettingStarted [[Customise TiddlyWiki]]' +[enlist-input[]]">>

package/editions/tw5.com/tiddlers/filters/examples/fields.tid

@@ -1,8 +1,12 @@
 created: 20150118134611000
-modified: 20150118183206000
+modified: 20200129165627964
 tags: [[fields Operator]] [[Operator Examples]]
 title: fields Operator (Examples)
 type: text/vnd.tiddlywiki
 
 <<.operator-example 1 "[[HelloThere]fields[]]" "fields of HelloThere">>
-<<.operator-example 2 "[tag[Common Operators]fields[]]" "fields of all tiddlers tagged as [[Common Operators]]">>
+<<.operator-example 2 "[[HelloThere]fields:include[list title text non-existing]]" """fields of HelloThere using a "short list" of fields. Fields are only shown, if they exist""">>
+<<.operator-example 3 "[[HelloThere]fields:include[list title text]sortby[title list text]]" "fields of HelloThere special sorting">>
+<<.operator-example 4 "[[HelloThere]fields:exclude[list title text]]" "fields of HelloThere using the exclude suffix">>
+<<.operator-example 5 "[[HelloThere]fields[]] -list -title -text" "fields of HelloThere, using several filter runs instead of exclude suffix">>
+<<.operator-example 6 "[tag[Common Operators]fields[]]" "fields of all tiddlers tagged as [[Common Operators]]">>

package/editions/tw5.com/tiddlers/filters/examples/filter Operator (Examples).tid

@@ -0,0 +1,23 @@
+created: 20201004141030951
+modified: 20201004143326056
+tags: [[Operator Examples]] [[filter Operator]]
+title: filter Operator (Examples)
+type: text/vnd.tiddlywiki
+
+\define larger-than-1k() [get[text]length[]compare:integer:gteq[1000]]
+\define smaller-than-2k() [get[text]length[]compare:integer:lteq[2000]]
+\define contains-missing-links() [links[]!is[shadow]is[missing]]
+\define display-variable(name)
+''<$text text=<<__name__>>/>'': <code><$text text={{{ [<__name__>getvariable[]] }}}/></code>
+\end
+
+These examples use the following predefined variables:
+
+* <<display-variable larger-than-1k>>
+* <<display-variable smaller-than-2k>>
+* <<display-variable contains-missing-links>>
+
+<<.operator-example 1 "[tag[HelloThere]filter<larger-than-1k>]">>
+<<.operator-example 2 "[tag[HelloThere]filter<smaller-than-2k>]">>
+<<.operator-example 3 "[tag[HelloThere]filter<larger-than-1k>filter<smaller-than-2k>]">>
+<<.operator-example 4 "[tag[Features]filter<contains-missing-links>]">>

package/editions/tw5.com/tiddlers/filters/examples/fixed Operator (Examples).tid

@@ -6,3 +6,4 @@ type: text/vnd.tiddlywiki
 
 <<.operator-example 1 "10.123456789 +[fixed[5]]">>
 <<.operator-example 2 "[[355]divide[113]fixed[7]]">>
+<<.operator-example 3 "[[1]divide[2]fixed[3]]">>

package/editions/tw5.com/tiddlers/filters/examples/format Operator (Examples).tid

@@ -0,0 +1,31 @@
+created: 20201020102735123
+modified: 20210524044020645
+tags: [[Operator Examples]] [[format Operator]]
+title: format Operator (Examples)
+type: text/vnd.tiddlywiki
+
+These examples use the tiddler HelloThere.
+
+Created date with no format string specified:
+<<.operator-example 1 "[[HelloThere]get[created]format:date[]]">>
+
+Created date with a format string supplied as operator parameter:
+<<.operator-example 2 "[[HelloThere]get[created]format:date[DDth MMM YYYY]]">>
+
+Modified date shown as a relative date:
+<<.operator-example 3 "[[HelloThere]get[modified]format:relativedate[]]">>
+
+A tiddler title with spaces formatted as a title list:
+<<.operator-example 4 """[[Hello There]format:titlelist[]]""">>
+
+All tiddler titles tagged with <<tag TableOfContents>> formatted as a title list :
+<<.operator-example 5 """[tag[TableOfContents]format:titlelist[]]""">>
+
+<<.tip "To create a string to save a [[title list|Title List]] into a list field, use `format:titlelist[]` with the [[join operator|join Operator]]">>
+<<.operator-example 6 """[tag[TableOfContents]format:titlelist[]join[ ]]""">>
+For example, to save titles tagged `TableOfContents` to the titles field of the tiddler [[format titlelist test]]:
+
+<$macrocall $name='wikitext-example-without-html'
+src='<$button> test
+<$action-setfield $tiddler="format titlelist test" titles={{{ [tag[TableOfContents]format:titlelist[]join[ ]] }}}/>
+</$button>'/>

package/editions/tw5.com/tiddlers/filters/examples/has.tid

@@ -8,4 +8,6 @@ type: text/vnd.tiddlywiki
 <<.operator-example 1 "[has[color]]">>
 <<.operator-example 2 "[tag[Concepts]!has[modified]]">>
 <<.operator-example 3 "[has:field[emptyfield]]">>
-<<.operator-example 4 "[all[current]!has:field[doesntexist]]">>
+<<.operator-example 4 "[all[current]!has:field[doesntexist]]">>
+<<.operator-example 5 "[all[tiddlers+shadows]has:index[foreground]]">>
+<<.operator-example 6 "[all[current]!has:index[doesntexist]]">>

package/editions/tw5.com/tiddlers/filters/examples/jsonstringify Operator (Examples).tid

@@ -5,3 +5,5 @@ title: jsonstringify Operator (Examples)
 type: text/vnd.tiddlywiki
 
 <<.operator-example 1 """[[Title with "double quotes" and single ' and \backslash]] +[jsonstringify[]]""">>
+<<.operator-example 2 """[[Accents and emojis -> äñøßπ ⌛🎄🍪🍓 without suffix]] +[jsonstringify[]]""">>
+<<.operator-example 3 """[[Accents and emojis -> äñøßπ ⌛🎄🍪🍓 with rawunicode suffix]] +[jsonstringify:rawunicode[]]""">>

package/editions/tw5.com/tiddlers/filters/examples/log Operator (Examples).tid

@@ -0,0 +1,14 @@
+created: 20201120041503515
+modified: 20201120042024813
+tags: [[Operator Examples]] [[log Operator]]
+title: log Operator (Examples)
+type: text/vnd.tiddlywiki
+
+Logarithm of `8` with base `2`:
+<<.operator-example 1 "[[8]log[2]]">>
+
+Logarithm of `100` with base `10`:
+<<.operator-example 2 "[[100]log[10]]">>
+
+Natural logarithm of 10 (base `e`), equivalent to `ln(10)` in mathematics:
+<<.operator-example 3 "[[10]log[]]">>

package/editions/tw5.com/tiddlers/filters/examples/lookup Operator (Examples).tid

@@ -1,5 +1,6 @@
 created: 20170907144257037
-modified: 20170907144559822
+modified: 20211118025451349
+tags: [[Operator Examples]]
 title: lookup Operator (Examples)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/filters/examples/match Operator (Examples).tid

@@ -5,4 +5,4 @@ title: match Operator (Examples)
 type: text/vnd.tiddlywiki
 
 <<.operator-example 1 "a b c +[match[b]]">>
-<<.operator-example 1 "[match[HelloThere]]">>
+<<.operator-example 2 "[match[HelloThere]]">>

package/editions/tw5.com/tiddlers/filters/examples/median Operator (Examples).tid

@@ -0,0 +1,10 @@
+created: 20210426131042769
+modified: 20210426131553560
+tags: [[Operator Examples]] [[median Operator]]
+title: median Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "=1 =3 =4 =5 +[median[]]">>
+
+Note that if there is no input the operator returns `NaN`
+<<.operator-example 2 "[title[NotATiddler]get[price]] +[median[]]">>

package/editions/tw5.com/tiddlers/filters/examples/moduleproperty Operator (Examples).tid

@@ -0,0 +1,11 @@
+created: 20210919201407838
+modified: 20210919201738739
+tags: [[moduleproperty Operator]] [[Operator Examples]]
+title: moduleproperty Operator (Examples)
+type: text/vnd.tiddlywiki
+
+Get the name of the macro in the module `$:/core/modules/macros/qualify.js`:
+<<.operator-example 1 "[[$:/core/modules/macros/qualify.js]moduleproperty[name]]">>
+
+For all macro modules retrieve their name module properties:
+<<.operator-example 2 "[[macro]modules[]moduleproperty[name]]">>

package/editions/tw5.com/tiddlers/filters/examples/modules.tid

@@ -1,7 +1,10 @@
 created: 20150123221510000
-modified: 20150123221534000
+modified: 20210919201037087
 tags: [[modules Operator]] [[Operator Examples]]
 title: modules Operator (Examples)
 type: text/vnd.tiddlywiki
 
 <<.operator-example 1 "[[filteroperator]modules[]]">>
+
+Get the title of the macro module which a `property` name with value `version`:
+<<.operator-example 2 "[[macro]modules[name],[version]]">>

package/editions/tw5.com/tiddlers/filters/examples/pad Operator (Examples).tid

@@ -0,0 +1,13 @@
+created: 20201129174833980
+modified: 20201129180011580
+tags: [[Operator Examples]] [[pad Operator]]
+title: pad Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 """[[2]pad[3]]""">>
+
+<<.operator-example 2 """[[2]pad[3],[a]]""">>
+
+<<.operator-example 3 """[[12]pad[9],[abc]]""">>
+
+<<.operator-example 4 """[[12]pad:suffix[9],[abc]]""">>

package/editions/tw5.com/tiddlers/filters/examples/power Operator (Examples).tid

@@ -0,0 +1,8 @@
+created: 20201120040913073
+modified: 20201120041513726
+tags: [[Operator Examples]] [[power Operator]]
+title: power Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "[[3]power[3]]">>
+<<.operator-example 2 "9 +[power[2]]">>

package/editions/tw5.com/tiddlers/filters/examples/reduce Operator (Examples).tid

@@ -0,0 +1,38 @@
+created: 20201004154413968
+modified: 20201204131137081
+tags: [[Operator Examples]] [[reduce Operator]]
+title: reduce Operator (Examples)
+type: text/vnd.tiddlywiki
+
+\define add-price() [get[price]multiply{!!quantity}add<accumulator>]
+\define num-items() [get[quantity]add<accumulator>]
+\define join-with-commas() [<index>compare:number:gt[0]then<accumulator>addsuffix[, ]addsuffix<currentTiddler>else<currentTiddler>]
+\define multiply-input() [multiply<accumulator>]
+\define display-variable(name)
+''<$text text=<<__name__>>/>'': <code><$text text={{{ [<__name__>getvariable[]] }}}/></code>
+\end
+
+These examples use the following predefined variables:
+
+* <<display-variable add-price>>
+* <<display-variable num-items>>
+* <<display-variable join-with-commas>>
+* <<display-variable multiply-input>>
+
+They also use the following data tiddlers:
+
+<ul>
+<$list filter="[tag[shopping]!has[draft.of]]">
+<li>
+''<$link><$text text=<<currentTiddler>>/></$link>'' quantity: <$text text={{!!quantity}}/>,  price: <$text text={{!!price}}/>
+</li>
+</$list>
+</ul>
+
+<<.operator-example 1 "[tag[shopping]reduce<num-items>]">>
+<<.operator-example 2 "[tag[shopping]reduce<add-price>]">>
+<<.operator-example 3 "[tag[shopping]reduce<join-with-commas>]" "Uses `<index>` to act differently on the first item than the rest">>
+<<.operator-example 4 "[tag[non-existent]reduce<add-price>]" "Empty input produces empty output">>
+<<.operator-example 5 "[tag[non-existent]reduce<add-price>else[0]]" "Use `else` to ensure output if input was empty">>
+<<.operator-example 6 "=1 =2 =3 +[reduce<multiply-input>]" "Empty initial value is treated as 0 by mathematical operators">>
+<<.operator-example 7 "=1 =2 =3 +[reduce<multiply-input>,[1]]" "Setting initial value is sometimes necessary for correct results">>

package/editions/tw5.com/tiddlers/filters/examples/search-replace Operator (Examples).tid

@@ -0,0 +1,38 @@
+created: 20201107112846692
+modified: 20211101125225197
+tags: [[Operator Examples]] [[search-replace Operator]]
+title: search-replace Operator (Examples)
+type: text/vnd.tiddlywiki
+
+\define myregexp() e|o
+
+\define myregexp2() ^(?!Unlike).*$
+
+\define names() (\w+)\s(\w+)
+
+Replace one string with another:
+<<.operator-example 1 """[[The quick brown fox jumps over the lazy dog]search-replace[dog],[cat]]""">>
+
+Replace all matches of a regular expression:
+
+`\define myregexp() e|o`
+<<.operator-example 2 """[[Hello There]search-replace:g:regexp<myregexp>,[]]""">>
+
+Replace all matches of a string irrespective of case:
+<<.operator-example 3 """[[Hello There]search-replace:gi[H],[]]""">>
+
+You can also use regular expression capture groups in the replacement string:
+`\define names() (\w+)\s(\w+)`
+<<.operator-example 4 """[[John Smith]search-replace::regexp<names>,[$2,$1]]""" >>
+
+You can reference the portion of the input that matches the regular expression with `$&`:
+<<.operator-example 5 """[[John Smith]search-replace::regexp[John .*],[His name is $&]]""">>
+
+<<.operator-example 6 """[[This is an exciting feature]search-replace::regexp[exciting],[amazing and $&]]""">>
+
+To replace everything but a match using a regular expression and the ''multiline'' (m) flag:
+`\define myregexp2() ^(?!Unlike).*$`
+<<.operator-example 7 """[[HelloThere]get[text]search-replace:gm:regexp<myregexp2>,[]]""">>
+
+
+{{How to remove stop words}}

package/editions/tw5.com/tiddlers/filters/examples/sin Operator (Examples).tid

@@ -0,0 +1,7 @@
+created: 20211020142121129
+modified: 20211020142146276
+tags: [[Operator Examples]] [[sin Operator]]
+title: sin Operator (Examples)
+
+<<.operator-example 1 "[[2]sin[]]">>
+<<.operator-example 2 "=1 =2 =3 =4 +[sin[]]">>