tiddlywiki 5.3.5 → 5.3.6

package/editions/tw5.com/tiddlers/concepts/ExternalImages.tid

@@ -1,5 +1,5 @@
 created: 20140610213500000
-modified: 20140912141341933
+modified: 20241030132047048
 tags: Concepts Features
 title: ExternalImages
 type: text/vnd.tiddlywiki
@@ -32,18 +32,18 @@ Note the image files must be saved before they are externalised. Externalising t
 For an example see the ''externalimages'' build target of the demo ''tw5.com'' wiki:
 
 ```
---savetiddlers [is[image]] images
+--save [is[image]] images
 --setfield [is[image]] _canonical_uri $:/core/templates/canonical-uri-external-image text/plain
 --setfield [is[image]] text "" text/plain
---rendertiddler $:/core/save/all externalimages.html text/plain
+--render $:/core/save/all externalimages.html text/plain
 ```
 
 !! Saving Separate Image Files
 
-The following `--savetiddlers` command can be used to save the images of a wiki into an ''images'' subfolder:
+The following `--save` command (see [[SaveCommand]]) can be used to save the images of a wiki into an ''images'' subfolder:
 
 ```
---savetiddlers [is[image]] images
+--save [is[image]] images
 ```
 
 !! Externalising Image Tiddlers

package/editions/tw5.com/tiddlers/concepts/Macros.tid

@@ -1,6 +1,6 @@
 created: 20140211171341271
-modified: 20230922094937115
-tags: Concepts Reference
+modified: 20240422084520179
+tags: Concepts [[Core Macros]]
 title: Macros
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/concepts/Messages.tid

@@ -1,11 +1,8 @@
 created: 20140226083311937
-modified: 20211117042057208
-tags: Concepts Reference
+modified: 20240422091319082
+tags: Concepts [[Core Messages]]
 title: Messages
 type: text/vnd.tiddlywiki
 
-Widget ''messages'' are generated by  [[Widgets]] in response to user actions.  Messages have a <<.param name>>, an optional primary <<.param parameter>>, and one or more optional named parameters. These messages travel up the widget tree where they are handled by ancestor widgets or the core itself.
+Widget [[messages|Core Messages]] are generated by  [[Widgets]] in response to user actions.  Messages have a <<.param name>>, an optional primary <<.param parameter>>, and one or more optional named parameters. These messages travel up the widget tree where they are handled by ancestor widgets or the core itself.
 
-The following widget messages are implemented by the core:
-
-<<list-links "[tag[Messages]]">>

package/editions/tw5.com/tiddlers/concepts/Railroad Diagrams.tid

@@ -15,4 +15,6 @@ In the example above, a comma appears between each occurrence of the `repeated`
 
 Characters in round boxes are literal, i.e. they denote themselves. A name in a rectangular box denotes a further railroad diagram.
 
+The TW [[Filter Syntax]] documentation makes extensive use of railroad diagrams.
+
 The railroad diagrams in ~TiddlyWiki's documentation are generated with the [[Railroad Plugin]].

package/editions/tw5.com/tiddlers/concepts/TestCaseTiddlers.tid

@@ -1,26 +1,31 @@
-title: TestCaseTiddlers
-modified: 20240507221902644
 created: 20240507221902644
+modified: 20240808020847667
 tags: Concepts
+title: TestCaseTiddlers
+type: text/vnd.tiddlywiki
 
-Test case tiddlers encapsulate one or more tiddlers that can be displayed as a [[test case|TestCaseWidget]]: an independent embedded wiki that can be used for testing or learning purposes.
+Test case tiddlers encapsulate one or more tiddlers that can be displayed as a <<.wlink TestCaseWidget>>: an independent embedded wiki that can be used for testing or learning purposes.
 
 Test case tiddlers are formatted as CompoundTiddlers, allowing them to contain multiple tiddlers packed into one.
 
-Test case tiddlers have the following fields:
+Test case tiddlers have the following ''fields'':
 
 |!Field |!Description |
-|<<.field type>> | Should be set to `text/vnd.tiddlywiki-multiple` |
-|<<.field tags>> | Test cases are tagged [[$:/tags/wiki-test-spec]]. Test cases that intentionally fail are tagged [[$:/tags/wiki-test-spec-failing]] |
+|<<.field type>> |Needs to be set to `text/vnd.tiddlywiki-multiple` |
+|<<.field tags>> |Test cases are tagged [[$:/tags/wiki-test-spec]]. Test cases that intentionally fail are tagged [[$:/tags/wiki-test-spec-failing]] |
 |<<.field description>> |Descriptive heading for the test, intended to make it easy to identify the test |
-|<<.field display-format>> |Optional, defaults to `wikitext`. Set to `plaintext` to cause the output to be rended as plain text |
+|<<.field display-format>> |Optional, defaults to `wikitext`. Set to `plaintext` to cause the output to be rendered as plain text |
+|<<.field import>> |<<.from-version "5.3.6">> A filter string that defines a list of tiddlers to import |
+|<<.field import-compound>> |<<.from-version "5.3.6">> A filter string that defines a list of compound tiddlers to import. See: <<.wlink DataWidget>> widget |
 
-Test case tiddlers with the appropriate tag are shown in $:/ControlPanel
+Test case tiddlers with the appropriate tag are shown in the $:/ControlPanel ''-> Advanced -> Test Cases ''
 
-Some payload tiddlers are set aside for special purposes:
+Some ''payload ''tiddlers are set aside for special purposes:
 
 |!Tiddler |!Description |
 |''Narrative'' |Narrative description of the test, intended to explain the purpose and operation of the test |
 |''Output'' |The tiddler that produces the test output |
 |''~ExpectedResult'' |HTML of expected result of rendering the ''Output'' tiddler |
-|''Description'' |Set to the text of the <<.field description>> field |
+|''Description'' |Set to the text of the <<.field description>> field, if the field exists |
+
+Also see: TestCaseWidget, DataWidget

package/editions/tw5.com/tiddlers/customising/Alternative page layouts.tid

@@ -1,5 +1,5 @@
 created: 20201123172925848
-modified: 20240627060629394
+modified: 20240801020629394
 tags: [[Customise TiddlyWiki]]
 title: Alternative page layouts
 type: text/vnd.tiddlywiki
@@ -23,9 +23,8 @@ This alternative page template can either be a tweaked and modified version of t
 tc-page-container tc-language-$(languageTitle)$ your-plugin-name-container
 \end
 \procedure redirected-navigate-actions()
-  <$action-setfield $tiddler="$:/layout" text="" $timestamp="no">
-    <$action-navigate $to=<<event-navigateTo>> $scroll="yes" />
-  </$action-setfield>
+  <$action-setfield $tiddler="$:/layout" text="" $timestamp="no" />
+  <$action-navigate $to=<<event-navigateTo>> $scroll="yes" />
 \end
 
 <$navigator story="$:/StoryList" history="$:/HistoryList" openLinkFromInsideRiver={{$:/config/Navigation/openLinkFromInsideRiver}} openLinkFromOutsideRiver={{$:/config/Navigation/openLinkFromOutsideRiver}} relinkOnRename={{$:/config/RelinkOnRename}}>

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

@@ -1,6 +1,10 @@
-created: 201308281853
-modified: 201308281853
+created: 20130828185300000
+modified: 20240923162029767
 tags: Definitions
 title: CamelCase
 
-CamelCase is formed by taking a phrase, capitalising the initial letter of each word, and smashing the words together to form a portmanteau word. Most wikis use CamelCase to signal phrases that should automatically become links.
+CamelCase is formed by taking a phrase, capitalising the initial letter of each word, and smashing the words together to form a portmanteau word. Traditionally most wikis including ~TiddlyWiki use CamelCase to signal phrases that should automatically become links.
+
+You can also [[disable CamelCase linking in TiddlyWiki|How to turn off camel case linking]] if you want.
+
+<<.from-version 5.3.0>> ~CamelCase is disabled by default in new wikis.

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,7 +4,7 @@ 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]]
@@ -15,6 +15,7 @@ I'm the original inventor of TiddlyWiki. You can hire me through [[Federatial]],
 
 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/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/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/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/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/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/functions/Functions.tid

@@ -1,6 +1,6 @@
 created: 20221009124003601
-modified: 20230419103154328
-tags: Concepts Reference
+modified: 20240422084850412
+tags: Concepts [[Core Functions]]
 title: Functions
 type: text/vnd.tiddlywiki
 
@@ -11,17 +11,17 @@ type: text/vnd.tiddlywiki
 Functions are usually defined with the [[Pragma: \function]]:
 
 ```
-\function my-function(parameter:"2")
-[<parameter>multiply[1.5]]
+\function myfun(param:"2")
+[<param>multiply[1.5]]
 \end
 ```
 
 Functions can be invoked in several ways:
 
-* Directly transclude functions with the syntax `<<myfn param:"value">>`
-* Assign functions to widget attributes with the syntax `<div class=<<myfn param:"value">>>`
-* Invoke functions via the [[function Operator]] with the syntax `[function[myfn],[value],...]`
-* Directly invoke functions whose names contain a period as custom filter operators with the syntax `[my.fn[value]]` or `[.myfn[value]]`
+* Directly transclude functions with the syntax `<<myfun param:"value">>`
+* Assign functions to widget attributes with the syntax `<div class=<<myfun param:"value">>>`
+* Invoke functions via the [[function Operator]] with the syntax `[function[myfun],[value],...]`
+* Directly invoke functions whose names contain a period as custom filter operators with the syntax `[my.fun[value]]` or `[.myfun[value]]`
 
 !! How Functions Work
 

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

@@ -1,6 +1,6 @@
 created: 20131129090249275
 modified: 20220819041016415
-tags: [[Working with TiddlyWiki]]
+tags: [[Working with TiddlyWiki]] Welcome
 title: GettingStarted
 type: text/vnd.tiddlywiki
 
@@ -12,4 +12,4 @@ The next step is to choose a method for saving changes. There's a wide variety o
 
 <<.warning "Don't attempt to use the browser ''File''/''Save'' menu option to save changes (it doesn't work)">><br/><br/>
 
-{{Saving}}
+{{Saving}}

package/editions/tw5.com/tiddlers/hellothere/Find Out More.tid

@@ -0,0 +1,16 @@
+color: #880
+created: 20241009150347613
+icon: $:/core/images/help
+modified: 20241115170824144
+tags: Welcome
+title: Find Out More
+type: text/vnd.tiddlywiki
+
+Resources to help you learn more about ~TiddlyWiki and its community.
+
+<div class="tc-cards">
+<$list filter="[tag[HelloThumbnail]]">
+<$macrocall $name="flex-card" captionField="caption" descriptionField="text"/>
+</$list>
+</div>
+