tiddlywiki 5.3.5 → 5.3.7

package/editions/tw5.com/tiddlers/definitions/Definitions.tid

@@ -1,10 +1,10 @@
 color: #7bb95d
-created: 201308251451
-modified: 201308251451
-title: Definitions
+created: 20130825145100000
+modified: 20250104111522881
 tags: Reference
+title: Definitions
 type: text/vnd.tiddlywiki
 
 These are definitions of technical words and phrases used in this documentation. (As distinct from the [[Concepts]] that make up TiddlyWiki itself).
 
-<<list-links "[tag[Definitions]]">>
+<<list-links "[tag[Definitions]]" class:"multi-columns">>

package/editions/tw5.com/tiddlers/definitions/GitHub.tid

@@ -8,7 +8,7 @@ GitHub is a hosting service for distributed projects that use git as their versi
 
 The code and documentation of TiddlyWiki is hosted on ~GitHub at:
 
-https://github.com/Jermolene/TiddlyWiki5
+https://github.com/TiddlyWiki/TiddlyWiki5
 
 ~GitHub also offer a free web hosting service called [[GitHub Pages|https://pages.github.com/]] that can be used directly from the single file configuration. See [[Saving to a Git service]].
 

package/editions/tw5.com/tiddlers/definitions/Intertwingled Innovations.tid

@@ -0,0 +1,9 @@
+created: 20240726184622817
+modified: 20240726184622817
+tags: Definitions
+title: Intertwingled Innovations
+type: text/vnd.tiddlywiki
+
+Intertwingled Innovations Limited is the company through which [[JeremyRuston]] performs commercial consultancy work helping companies and individuals release the business value of TiddlyWiki.
+
+See https://intertwingledinnovations.com/ for more information.

package/editions/tw5.com/tiddlers/definitions/JeremyRuston.tid

@@ -4,17 +4,16 @@ tags: Definitions
 title: JeremyRuston
 type: text/vnd.tiddlywiki
 
-I'm the original inventor of TiddlyWiki. You can hire me through [[Federatial]], and find me on these services:
+I'm the original inventor of TiddlyWiki. You can hire me through [[Intertwingled Innovations]], and find me on these services:
 
 * jeremy (at) jermolene (dot) com
 * [[Jermolene on GitHub|https://github.com/Jermolene]]
-* [[Jermolene on GitTip|https://www.gittip.com/Jermolene/]], a micropayment service
-* [[@Jermolene on Twitter|http://twitter.com/#!/jermolene]]
 * [[Jermy on LinkedIn|http://www.linkedin.com/in/jermy]]
 * [[Jermy on Flickr|http://www.flickr.com/photos/jermy/]]
 
 Further information:
 
+* A recording of the [[keynote I gave at QCon London in April 2024|https://www.infoq.com/presentations/bbc-micro/]], and the [[discussion on talk.tiddlywiki.org|https://talk.tiddlywiki.org/t/recording-of-jeremys-keynote-at-qcon-london-april-2024/10505]]. The talk mixes some nostalgia about my teenage activities with the BBC Micro with thoughts on the development of the software industry and insights gained from working with TiddlyWiki
 * An [[interview with me in The Inquirer|http://www.theinquirer.net/inquirer/feature/2105529/bt-software-engineer-tells-telco-source]] by Wendy Grossman
 * A [[hilarious interview with me|https://www.youtube.com/watch?v=auyIhw8MTmQ]] from British television in 1983
 * Here's a video of a presentation I did in 2007 called [["How to Start an Open Source Project"|http://vimeo.com/856110]].

package/editions/tw5.com/tiddlers/definitions/TiddlyFox.tid

@@ -1,21 +1,9 @@
 created: 20130825161100000
-modified: 20230803051056946
+modified: 20241006202631647
 tags: Definitions
 title: TiddlyFox
 type: text/vnd.tiddlywiki
 
-<<.deprecated-since "FireFox 57" "Saving">>
-
-TiddlyFox is an extension for older versions of Firefox that allows standalone TiddlyWiki files to save their changes directly to the file system. TiddlyFox works on both desktop and smartphone versions of <a href="https://www.mozilla.org/en-US/firefox/">Firefox</a>. See [[Saving with TiddlyFox]] or [[Saving with TiddlyFox on Android]] for detailed instructions.
+TiddlyFox was an extension for older versions of Firefox that allowed standalone TiddlyWiki files to save their changes directly to the file system.
 
 TiddlyFox is now obsolete due to its incompatibility with the latest versions of Firefox - see [[TiddlyFox Apocalypse]]. There are many alternatives to TiddlyFox, but none that work in precisely the same way -- see GettingStarted for details.
-
-TiddlyFox can be downloaded from the Mozilla Addons site:
-
-https://addons.mozilla.org/en-GB/firefox/addon/tiddlyfox/
-
-<<<
-You can also install the latest development version of TiddlyFox direct from GitHub:
-
-https://github.com/TiddlyWiki/TiddlyFox/raw/master/tiddlyfox.xpi
-<<<

package/editions/tw5.com/tiddlers/definitions/TiddlyWeb.tid

@@ -15,5 +15,5 @@ TiddlyWeb can be used to host TiddlyWiki and TiddlyWiki5 wikis, making the indiv
 Other implementations of the API include:
 
 * [[TiddlyWiki App Engine Server|https://github.com/rsc/tiddly]], a 300-line Go implementation from Russ Cox
-* [[TiddlyWiki 5 server module|https://github.com/Jermolene/TiddlyWiki5/blob/master/core/modules/commands/server.js]], the bare-bones subset of the API implemented in TiddlyWiki version 5 for Node.js
+* [[TiddlyWiki 5 server module|https://github.com/TiddlyWiki/TiddlyWiki5/blob/master/core/modules/commands/server.js]], the bare-bones subset of the API implemented in TiddlyWiki version 5 for Node.js
 * [[tiddly-wiki-server|https://github.com/nathanielknight/tiddly-wiki-server]], an implementation based on Rust and SQLite

package/editions/tw5.com/tiddlers/definitions/Tiddlyhost.tid

@@ -1,12 +1,11 @@
-title: Tiddlyhost
-tags: Definitions
 created: 20230410105035569
 modified: 20230410105035569
+tags: Definitions
+title: Tiddlyhost
+type: text/vnd.tiddlywiki
 
 <span style="float:right;">[img width=140 [Tiddlyhost Logo]]</span>
 
 [[Tiddlyhost.com|https://tiddlyhost.com/]] is a hosting service for TiddlyWiki created by Simon Baird. Once you sign up and confirm your email you can create "sites", (i.e. ~TiddlyWikis), with support for online saving. Sites can be private or public, and you can optionally list them on the taggable and searchable [[Tiddlyhost Hub|https://tiddlyhost.com/hub]] where they'll be discoverable by others.
 
 Unlike [[TiddlySpot|Saving on TiddlySpot]], [[Tiddlyhost|https://tiddlyhost.com]] is secure, open source, and has proper support for TiddlyWiki5. It also allows uploading existing ~TiddlyWiki files, supports TiddlyWikiClassic, and lets you claim ownership of your ~TiddlySpot sites. For more information see the [[FAQ|https://github.com/simonbaird/tiddlyhost/wiki/FAQ]] and the [[About|https://tiddlyhost.com/about]] page.
-
-<div style="clear: both;"/>

package/editions/tw5.com/tiddlers/definitions/WordJoiner.tid

@@ -0,0 +1,9 @@
+created: 20240726074915230
+modified: 20240726075106830
+tags: Definitions
+title: WordJoiner
+type: text/vnd.tiddlywiki
+
+>The word joiner (WJ) is a Unicode format character which is used to indicate that line breaking should not occur at its position. It does not affect the formation of ligatures or cursive joining and is ignored for the purpose of text segmentation. It is encoded since Unicode version 3.2 (released in 2002) as U+2060 WORD JOINER (`⁠`). 
+>
+>https://en.wikipedia.org/wiki/Word_joiner

package/editions/tw5.com/tiddlers/definitions/Xememex.tid

@@ -1,14 +1,13 @@
-title: Xememex
-tags: Definitions
 created: 20230410105035569
 modified: 20230410105035569
+tags: Definitions
+title: Xememex
+type: text/vnd.tiddlywiki
 
 <span style="float:right;">[img width=340 [Xememex Logo]]</span>
 
-Xememex is a multiuser TiddlyWiki from [[Federatial]]. It allows large groups of people to work together on intertwingled wikis that can share content. It is implemented as a serverless application on Amazon Web Services.
+Xememex is a multiuser TiddlyWiki from [[Intertwingled Innovations]]. It allows large groups of people to work together on intertwingled wikis that can share content. It is implemented as a serverless application on Amazon Web Services.
 
 The largest customer implementation has hundreds of online wikis with thousands of users. See https://manuals.annafreud.org/
 
-Xememex is currently only available under commercial terms from Federatial. Contact [[Jeremy Ruston at Federatial|mailto:jeremy@federatial.com]] for more details.
-
-<div style="clear: both;"/>
+Xememex is currently only available under commercial terms from Intertwingled Innovations. Contact [[Jeremy Ruston at Intertwingled Innovations|mailto:jeremy@intertwingledinnovations.com]] for more details.

package/editions/tw5.com/tiddlers/demonstrations/GroupedLists.tid

@@ -1,18 +1,18 @@
-title: GroupedLists
-tags: ListWidget Lists
 created: 20150106180000000
-modified: 20150221230117000
+modified: 20241204085601176
+tags: ListWidget Lists
+title: GroupedLists
 
 The following sidebar tabs give examples of grouped lists created by nesting.
 
-!! Types Tab
+!! [[Types Tab|$:/core/ui/MoreSideBar/Types]]
 
-For the [[Types|$:/core/ui/MoreSideBar/Types]] tab, the outer list filter as shown below selects each discrete value found in the `type` field. The inner list filter selects all the (non-system) tiddlers with that type.
+For the "Types Tab", the outer list filter as shown below selects each discrete value found in the `type` field. The inner list filter selects all the (non-system) tiddlers with that type.
 
 <<tw-code "$:/core/ui/MoreSideBar/Types">>
 
-!! Recent Tab
+!! [[Recent Tab|$:/core/ui/SideBar/Recent]]
 
-The list in the [[Recent|$:/core/ui/SideBar/Recent]] tab is generated using the <<.mlink timeline>> macro. Here, the outer list filter selects each discrete day found in the `modified` field, while the inner list filter selects all the tiddlers dated the same day in the `modified` field.
+The list in the "Recent Tab" is generated using the <<.mlink timeline>> macro. Here, the outer list filter selects each discrete day found in the `modified` field, while the inner list filter selects all the tiddlers dated the same day in the `modified` field.
 
-<<tw-code-link "$:/core/macros/timeline">>
+<<tw-code "$:/core/macros/timeline">>

package/editions/tw5.com/tiddlers/demonstrations/SampleAlert.tid

@@ -0,0 +1,9 @@
+component: demo
+created: 20160107230134172
+modified: 20160107230134172
+title: SampleAlert
+type: text/vnd.tiddlywiki
+
+This is a demonstration alert.
+
+Note that the trashcan icon deletes the tiddler containing this alert. You can also remove it by opening the tiddler SampleAlert and editing it to remove the tag [[$:/tags/Alert]].

package/editions/tw5.com/tiddlers/empty-tag-node-template.tid

@@ -0,0 +1,12 @@
+created: 20240710161501472
+list-after: 
+modified: 20240719201317702
+tags: $:/tags/ViewTemplate
+title: $:/editions/tw5.com/empty-tag-node-template
+type: 
+
+<%if [<storyTiddler>!has[text]!has[tags]tagging[]] %>
+The following tiddlers are tagged with <<tag>>:
+
+<<list-links filter:"[<storyTiddler>!has[text]!has[tags]tagging[]]" class:"multi-columns">>
+<%endif%>

package/editions/tw5.com/tiddlers/features/Future Proof.tid

@@ -4,12 +4,12 @@ tags: Features
 title: Future Proof
 type: text/vnd.tiddlywiki
 
-From [[Network World|http://www.networkworld.com/article/3028098/open-source-tools/tiddlywiki-a-free-open-source-wiki-revisited.html]] magazine in January 2016:
+From [[Network World|https://www.networkworld.com/article/947618/tiddlywiki-a-free-open-source-wiki-revisited.html]] magazine in January 2016:
 
 <<<
-Way back in the mists of time (actually, January 2009) I [[wrote|http://www.networkworld.com/article/2272104/applications/an-amazing-free-microwiki.html]] about a really cool tool called TiddlyWiki, a “non-linear personal web notebook”. Fast forward to today and I just had an out of body experience: Completely by accident I found a TiddlyWiki that I started when I wrote that piece and it still works!
+Way back in the mists of time (actually, January 2009) I [[wrote|http://www.networkworld.com/article/2272104/applications/an-amazing-free-microwiki.html]] about a really cool tool called ~TiddlyWiki, a “non-linear personal web notebook”. Fast forward to today and I just had an out of body experience: Completely by accident I found a ~TiddlyWiki that I started when I wrote that piece and it still works!
 
-Finding code that works flawlessly after just two or three years is magical enough but after seven years?! And given that TiddlyWiki is written as a single page Web application and considering how different browsers are now than they were in 2009, the fact that the old version of TiddlyWiki still works is not short of miraculous.
+Finding code that works flawlessly after just two or three years is magical enough but after seven years?! And given that ~TiddlyWiki is written as a single page Web application and considering how different browsers are now than they were in 2009, the fact that the old version of ~TiddlyWiki still works is not short of miraculous.
 <<<
 
 TiddlyWiki is designed with the long term needs of its users in mind. Because it is OpenSource and needs no infrastructure, we can be confident that all we'll need to access a ~TiddlyWiki file even in the far future is an ordinary HTML browser. If you're starting to use ~TiddlyWiki at the beginning of your career you can be confident that it will carry you through to retirement.

package/editions/tw5.com/tiddlers/filters/Filter Operators.tid

@@ -1,6 +1,6 @@
 breadcrumbs: [[Filter Step]]
 created: 20140410103123179
-modified: 20230410114132501
+modified: 20250302200615061
 tags: Filters
 title: Filter Operators
 type: text/vnd.tiddlywiki
@@ -21,7 +21,7 @@ type: text/vnd.tiddlywiki
 
 A <<.def "filter operator">> is a predefined keyword attached to an individual step of a [[filter|Filters]]. It defines the particular action of that step.
 
-''Important:'' In general, each first [[filter step|Filter Step]] of a [[filter run|Filter Run]] not given any input titles receives the output of <$link to="all Operator">[all[tiddlers]]</$link> as its input.
+<<.tip """In general, each first [[filter step|Filter Step]] of a [[filter run|Filter Run]] not given any input titles receives the output of <$link to="all Operator">''[all[tiddlers]]''</$link> as its input.""" title:"Important">>
 
 
 ''Table legend:''

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

@@ -1,15 +1,15 @@
+caption: compare
 created: 20200412181551706
 modified: 20200412181551706
+op-input: a [[selection of titles|Title Selection]]
+op-neg-output: those input titles <<.em not>> matching the specified comparison
+op-output: those input titles matching the specified comparison
+op-parameter: the value to compare
+op-purpose: filter the input by comparing each item against the parameter
+op-suffix: the <<.op compare>> operator uses a rich suffix, see below for details
 tags: [[Filter Operators]] [[Mathematics Operators]] [[String Operators]] [[Negatable Operators]]
 title: compare Operator
 type: text/vnd.tiddlywiki
-caption: compare
-op-purpose: filter the input by comparing each item against the parameter
-op-input: a [[selection of titles|Title Selection]]
-op-suffix: the <<.op compare>> operator uses a rich suffix, see below for details
-op-parameter: the value to compare
-op-output: those input titles matching the specified comparison
-op-neg-output: those input titles <<.em not>> matching the specified comparison
 
 <<.from-version "5.1.22">>The <<.op compare>> filter allows numerical, string and date comparisons to be performed.
 
@@ -21,7 +21,7 @@ The <<.op compare>> operator uses an extended syntax to specify all the options:
 
 The ''type'' can be:
 
-* "number" - invalid numbers are interpreted as zero
+* "number" - (default) invalid numbers are interpreted as zero
 * "integer" - invalid integers are interpreted as zero
 * "string"
 * "date" - invalid dates are interpreted as 1st January 1970
@@ -43,7 +43,7 @@ For example:
 ```
 [[2]compare:number:eq[3]] returns nothing
 [[2]compare:number:lt[3]] returns "2"
-[[2]compare:number:eq[2]] returns "2"
+[[2]compare::eq[2]] returns "2"
 ```
 
 Note that several of the variants of the <<.op compare>> operator are synonyms for existing operators, and are provided in the interests of consistency. For example, `compare:string:eq[x]` is a synonym for `match[x]`.

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

@@ -0,0 +1,10 @@
+created: 20240831025944330
+modified: 20240831041423075
+tags: [[decodebase64 Operator]] [[Operator Examples]]
+title: decodebase64 Operator (Examples)
+
+<<.operator-example 1 "[[dGVzdA==]decodebase64[]]">>
+
+<<.operator-example 2 "[[8J+Yjg==]decodebase64[]]">>
+
+<<.operator-example 3 "[[8J-Yjg==]decodebase64:urlsafe[]]">>

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

@@ -1,14 +1,16 @@
 caption: decodebase64
+created: 20240831034919913
+from-version: 5.2.6
+modified: 20240831034931703
 op-input: a [[selection of titles|Title Selection]]
 op-output: the input with base 64 decoding applied
-op-suffix: optional: `binary` to produce binary output, `urlsafe` for URL-safe input
 op-parameter: 
 op-parameter-name: 
-op-purpose: apply base 64 decoding to a string
+op-purpose: apply [[base 64|Base64]] decoding to a string
+op-suffix: optional: `binary` to produce binary output, `urlsafe` for URL-safe input
 tags: [[Filter Operators]] [[String Operators]]
 title: decodebase64 Operator
 type: text/vnd.tiddlywiki
-from-version: 5.2.6
 
 See Mozilla Developer Network for details of [[base 64 encoding|https://developer.mozilla.org/en-US/docs/Glossary/Base64]]. TiddlyWiki uses [[library code from @nijikokun|https://gist.github.com/Nijikokun/5192472]] to handle the conversion.
 

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

@@ -1,15 +1,15 @@
-created: 20140410103123179
-modified: 20191209085901849
-tags: [[Filter Operators]] [[Group Operators]]
-title: each Operator
-type: text/vnd.tiddlywiki
 caption: each
-op-purpose: select one of each group of input titles by field
+created: 20140410103123179
+modified: 20241204090042816
 op-input: a [[selection of titles|Title Selection]]
-op-suffix: optionally, `list-item` or `value`
+op-output: a selection containing the first input title encountered for each distinct value of field <<.place F>>
 op-parameter: the name of a [[field|TiddlerFields]], defaulting to <<.field title>>
 op-parameter-name: F
-op-output: a selection containing the first input title encountered for each distinct value of field <<.place F>>
+op-purpose: select one of each group of input titles by field
+op-suffix: optionally, `list-item` or `value`
+tags: [[Filter Operators]] [[Group Operators]]
+title: each Operator
+type: text/vnd.tiddlywiki
 
 Each input title is processed in turn. The value of field <<.place F>> in the corresponding tiddler is examined.
 
@@ -22,4 +22,6 @@ Each input title is processed in turn. The value of field <<.place F>> in the co
 
 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]]`.
 
+<<.note"""For an example of using the <<.op each>> operator to generate a two-tier list of groups and members, see [[GroupedLists]].""">>
+
 <<.operator-examples "each">>

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

@@ -13,3 +13,7 @@ type: text/vnd.tiddlywiki
 <<.from-version "5.1.20">> See [[Conditional Operators]] for an overview.
 
 <<.operator-examples "else">>
+
+Also see: [[then Operator]] | [[Then Filter Run Prefix]] and [[Else Filter Run Prefix]]
+
+

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

@@ -0,0 +1,10 @@
+created: 20240831025156306
+modified: 20240831041537886
+tags: [[encodebase64 Operator]] [[Operator Examples]]
+title: encodebase64 Operator (Examples)
+
+<<.operator-example 1 "[[test]encodebase64[]]">>
+
+<<.operator-example 2 "[[😎]encodebase64[]]">>
+
+<<.operator-example 3 "[[😎]encodebase64:urlsafe[]]">>

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

@@ -1,14 +1,16 @@
 caption: encodebase64
+created: 20240831034955575
+from-version: 5.2.6
+modified: 20240831035003716
 op-input: a [[selection of titles|Title Selection]]
 op-output: the input with base 64 encoding applied
-op-suffix: optional: `binary` to treat input as binary data, `urlsafe` for URL-safe output
 op-parameter: 
 op-parameter-name: 
-op-purpose: apply base 64 encoding to a string
+op-purpose: apply [[base 64|Base64]] encoding to a string
+op-suffix: optional: `binary` to treat input as binary data, `urlsafe` for URL-safe output
 tags: [[Filter Operators]] [[String Operators]]
 title: encodebase64 Operator
 type: text/vnd.tiddlywiki
-from-version: 5.2.6
 
 See Mozilla Developer Network for details of [[base 64 encoding|https://developer.mozilla.org/en-US/docs/Glossary/Base64]]. TiddlyWiki uses [[library code from @nijikokun|https://gist.github.com/Nijikokun/5192472]] to handle the conversion.
 

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

@@ -9,3 +9,4 @@ type: text/vnd.tiddlywiki
 <<.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]]">>
+<<.operator-example 6 "[[-2]compare::lt[-1]]">>

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

@@ -1,5 +1,5 @@
 created: 20150118134611000
-modified: 20150118183152000
+modified: 20241204085904594
 tags: [[each Operator]] [[Operator Examples]]
 title: each Operator (Examples)
 type: text/vnd.tiddlywiki
@@ -9,5 +9,3 @@ type: text/vnd.tiddlywiki
 <<.operator-example 3 "[each:list-item[list]]" "all tiddlers listed anywhere in the core list field">>
 <<.operator-example 4 "[[Non existing]] [[GettingStarted]] +[each:value[]]" "Compare this to `+[each[]]` below">>
 <<.operator-example 5 "[[Non existing]] [[GettingStarted]] +[each[]]" "Compare this to `+[each:value[]]` above">>
-
-For an example of using the <<.op each>> operator to generate a two-tier list of groups and members, see [[GroupedLists]].

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

@@ -1,16 +1,16 @@
-created: 20140410103123179
-modified: 20211115092315020
-tags: [[Filter Operators]] [[Field Operators]] [[Selection Constructors]] [[Negatable Operators]]
-title: list Operator
-type: text/vnd.tiddlywiki
 caption: list
-op-purpose: select titles via a list field
+created: 20140410103123179
+modified: 20240811083650364
 op-input: ignored
 op-neg-input: a [[selection of titles|Title Selection]]
-op-parameter: a [[reference|TextReference]] to a [[field|TiddlerFields]] or [[property|DataTiddlers]] of a particular tiddler
-op-parameter-name: R
-op-output: the titles stored as a [[title list|Title List]] at <<.place R>>
 op-neg-output: those input titles that are <<.em not>> mentioned at <<.place R>>
+op-output: the titles stored as a [[title list|Title List]] at <<.place R>>
+op-parameter: a [[reference|TextReference]] to a [[field|TiddlerFields]] or [[index|DataTiddlers]] of a particular tiddler
+op-parameter-name: R
+op-purpose: select titles via a list field
+tags: [[Filter Operators]] [[Field Operators]] [[Selection Constructors]] [[Negatable Operators]]
+title: list Operator
+type: text/vnd.tiddlywiki
 
 <<.place R>> can reference either a field or a property. See [[TextReference]] for the syntax.
 

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

@@ -1,6 +1,6 @@
 caption: sortsub
 created: 20200424160155182
-modified: 20210522162521222
+modified: 20240717115735166
 op-input: a [[selection of titles|Title Selection]]
 op-neg-output: the input, sorted into reverse order by the result of evaluating subfilter <<.param S>>
 op-output: the input, sorted into ascending order by the result of evaluating subfilter <<.param S>>
@@ -15,19 +15,23 @@ type: text/vnd.tiddlywiki
 
 Each item in the list of input titles is passed to the subfilter in turn. The subfilter transforms the input titles into the form needed for sorting. For example, the subfilter `[length[]]` transforms each input title in the number representing its length, and thus sorts the input titles according to their length.
 
-Note that within the subfilter, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits subfilters like `[{!!value}divide{!!cost}]` to be used for computation. 
+Note that within the subfilter <<.place S>>, the <<.var currentTiddler>> variable is set to the title of the tiddler being processed. This permits subfilters like `[{!!value}divide{!!cost}]` to be used for computation. 
 
-The value of currentTiddler outside the subfilter is available in the variable "..currentTiddler". <<.from-version "5.2.0">>
+The value of <<.var currentTiddler>> outside the subfilter is available in the variable <<.var ..currentTiddler>>. <<.from-version "5.2.0">>
 
 The suffix <<.place T>> determines how the items are compared and can be:
 
-* "string" (the default)
-* "number" - invalid numbers are interpreted as zero
-* "integer" - invalid integers are interpreted as zero
-* "date" - invalid dates are interpreted as 1st January 1970
-* "version" - invalid versions are interpreted as "v0.0.0"
-* "alphanumeric" - treat items as alphanumerics <<.from-version "5.2.0">>
+* ''string'' (the default)
+* ''number'' - invalid numbers are interpreted as zero
+* ''integer'' - invalid integers are interpreted as zero
+* ''date'' - invalid dates are interpreted as 1st January 1970
+* ''version'' - invalid versions are interpreted as "v0.0.0"
+* ''alphanumeric'' - treat items as alphanumerics <<.from-version "5.2.0">>
 
-Note that subfilters should return the same number of items that they are passed. Any missing entries will be treated as zero or the 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]...`.
+<<.tip """Note that subfilters <<.place S>> ''should return the same number of items that they are passed''. In particular, when retrieving the value of a field with the <<.olink get>> operator it is helpful to guard against a missing field value using the <<.olink else>> operator. For example `...[get[myfield]else[default-value]]`.<br><br>
+
+Any ''missing'' entries will be treated as ''zero'' or the ''empty string''.""">>
+
+Also see: [[Sort Filter Run Prefix]]
 
 <<.operator-examples "sortsub">>

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

@@ -15,4 +15,6 @@ type: text/vnd.tiddlywiki
 [[run|"Filter Run"]]
 """/>
 
-This prefix has a [[Shortcut Filter Run Prefix]] symbol `~run`
+This prefix has a [[Shortcut Filter Run Prefix]] symbol `~run`
+
+Also see: [[Then Filter Run Prefix]] | [[then Operator]] and [[else Operator]]

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

@@ -30,4 +30,4 @@ Sort as text with case sensitivity:
 <<.operator-example 7 "Apple Banana Orange Grapefruit guava DragonFruit Kiwi apple orange  :sort:string:casesensitive[{!!title}]">>
 
 Sort as text ignoring case:
-<<.operator-example 8 "Apple Banana Orange Grapefruit guava DragonFruit Kiwi apple orange :sort:string:caseinsensitive[{!!title}]">>
+<<.operator-example 8 "Apple Banana Orange Grapefruit guava DragonFruit Kiwi apple orange :sort:string:caseinsensitive[{!!title}]">>

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

@@ -1,10 +1,11 @@
 created: 20210428083929749
 from-version: 5.2.0
-modified: 20240312203002082
+modified: 20240717120111427
 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
+rp-suffix: the :sort filter run prefix uses a rich suffix, see below for details
+rp-suffix-name: S
 tags: [[Named Filter Run Prefix]]
 title: Sort Filter Run Prefix
 type: text/vnd.tiddlywiki
@@ -12,9 +13,19 @@ type: text/vnd.tiddlywiki
 <$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"/ | - ) | - )
+( ":sort" ) 
+( ":" ) 
+( : "string" | "alphanumeric" | "number" | "integer" | "version" | "date" )
+( ":" ) 
+{
+	(
+		(
+			( : "caseinsensitive" /"required for string and alphanumeric"/ | "casesensitive" /"required for string and alphanumeric"/)
+			| "reverse" /"optional"/ 
+		)
+	)
+	+","
+}
 [[run|"Filter Run"]]
 """/>
 
@@ -22,7 +33,7 @@ Each input title from previous runs is passed to this run in turn. The filter ru
 
 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:
+The `:sort` <<.place S>> filter run prefix uses an extended syntax that allows for multiple suffixes, some of which are required:
 
 ```
 :sort:<type>:<flaglist>[...filter run...]
@@ -30,10 +41,19 @@ The `:sort` filter run prefix uses an extended syntax that allows for multiple s
 ```
 
 * ''type'': Required. Determines how the items are compared and can be any of: ''string'', ''alphanumeric'', ''number'', ''integer'', ''version'' or ''date''.
+
 * ''flaglist'': comma separated list of the following flags:
+
 ** ''casesensitive'' or ''caseinsensitive'' (required for types `string` and `alphanumeric`).
+*** defaults to: //caseinsensitive// if the flag is missing.
+*** for clarity this parameter should be always defined.
+
 ** ''reverse'' to invert the order of the filter run (optional).
 
-Note that filter runs used with the `:sort` prefix should return the same number of items that they are passed. Any missing entries will be treated as zero or the 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]...`.
+<<.tip """Note that filter runs used with the `:sort` prefix ''should return the same number of items that they are passed''. 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]]`.<br><br>
+
+Any ''missing'' entries will be treated as ''zero'' or the ''empty string''.""">>
+
+Also see: <<.olink sortsub>> Operator
 
 [[Examples|Sort Filter Run Prefix (Examples)]]

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

@@ -36,3 +36,5 @@ The major difference between the <<.op then>> operator and a <<.op :then>> prefi
 
 [[Then Filter Run Prefix (Examples)]]
 
+Also see: [[Else Filter Run Prefix]] | [[then Operator]] and [[else Operator]]
+

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

@@ -15,3 +15,5 @@ type: text/vnd.tiddlywiki
 <<.tip "The [[Then Filter Run Prefix]] has a similar purpose to the <<.op then>> operator. See its documentation for a comparison of usage.">>
 
 <<.operator-examples "then">>
+
+Also see: [[else Operator]] | [[Then Filter Run Prefix]] and [[Else Filter Run Prefix]]