From 64eb1be708e7a3a6ab088d786ebc8ba91dd4c71a Mon Sep 17 00:00:00 2001
From: springerspandrel <66639553+springerspandrel@users.noreply.github.com>
Date: Thu, 11 Jul 2024 09:58:17 -0400
Subject: [PATCH 1/3] Improve view templates to show tag children (#8362)

---
 editions/tw5.com/tiddlers/empty-tag-node-template.tid | 11 +++++++++++
 .../tw5.com/tiddlers/system/systemtag-template.tid    | 10 +++++-----
 2 files changed, 16 insertions(+), 5 deletions(-)
 create mode 100644 editions/tw5.com/tiddlers/empty-tag-node-template.tid

diff --git a/editions/tw5.com/tiddlers/empty-tag-node-template.tid b/editions/tw5.com/tiddlers/empty-tag-node-template.tid
new file mode 100644
index 000000000..cbc5864c7
--- /dev/null
+++ b/editions/tw5.com/tiddlers/empty-tag-node-template.tid
@@ -0,0 +1,11 @@
+created: 20240710161501472
+list-after: $:/core/ui/ViewTemplate/body
+modified: 20240710165557977
+tags: $:/tags/ViewTemplate
+title: $:/editions/tw5.com/empty-tag-node-template
+type: 
+
+<$list filter='[<storyTiddler>is[missing]] :filter[tagging[]]'>
+The following tiddlers are tagged with <<tag>>:
+</$list>
+<<list-links filter:"[<storyTiddler>is[missing]tagging[]]" class:"multi-columns">>
\ No newline at end of file
diff --git a/editions/tw5.com/tiddlers/system/systemtag-template.tid b/editions/tw5.com/tiddlers/system/systemtag-template.tid
index 4b0120269..f2d3eee69 100644
--- a/editions/tw5.com/tiddlers/system/systemtag-template.tid
+++ b/editions/tw5.com/tiddlers/system/systemtag-template.tid
@@ -1,19 +1,19 @@
 created: 20220719120233104
 list-after: $:/core/ui/ViewTemplate/body
-modified: 20220719120319922
+modified: 20240710163659672
 tags: $:/tags/ViewTemplate
 title: $:/editions/tw5.com/systemtag-template
 
 <$list filter='[all[current]prefix[SystemTag: ]]'>
-<$let tag={{{ [all[current]removeprefix[SystemTag: ]] }}} >
+<$let thisTag={{{ [all[current]removeprefix[SystemTag: ]] }}} >
 
-<$list filter='[all[tiddlers+shadows]tag<tag>limit[1]]' emptyMessage='(No tiddlers are currently tagged with <<tag>> )'>
+<$list filter='[all[tiddlers+shadows]tag<thisTag>limit[1]]' emptyMessage='(No tiddlers are currently tagged with <<tag>> )'>
 
-The following tiddlers are tagged with <<tag>>
+The following tiddlers are tagged with <<tag $(thisTag)$ >>
 
 <table>
 <tr><th></th><th>caption</th></tr>
-<$list filter='[all[tiddlers+shadows]tag<tag>sort[]]'>
+<$list filter='[all[tiddlers+shadows]tag<thisTag>sort[]]'>
 <tr>
 <td><$link/></td>
 <td><$transclude field="caption"><$transclude field="description"><$view field="title"/></$transclude></$transclude></td>

From bfd06198fb37dbbbfd5ba05a252a2fe3fd85265b Mon Sep 17 00:00:00 2001
From: springerspandrel <66639553+springerspandrel@users.noreply.github.com>
Date: Sat, 13 Jul 2024 07:58:36 -0400
Subject: [PATCH 2/3] Fix problem where view template disappears on interaction
 with tag pill (#8372)

---
 editions/tw5.com/tiddlers/empty-tag-node-template.tid | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/editions/tw5.com/tiddlers/empty-tag-node-template.tid b/editions/tw5.com/tiddlers/empty-tag-node-template.tid
index cbc5864c7..a85a7f8d5 100644
--- a/editions/tw5.com/tiddlers/empty-tag-node-template.tid
+++ b/editions/tw5.com/tiddlers/empty-tag-node-template.tid
@@ -1,11 +1,11 @@
 created: 20240710161501472
 list-after: $:/core/ui/ViewTemplate/body
-modified: 20240710165557977
+modified: 20240713020832439
 tags: $:/tags/ViewTemplate
 title: $:/editions/tw5.com/empty-tag-node-template
 type: 
 
-<$list filter='[<storyTiddler>is[missing]] :filter[tagging[]]'>
+<$list filter='[<storyTiddler>!has[text]] :filter[tagging[]]'>
 The following tiddlers are tagged with <<tag>>:
 </$list>
-<<list-links filter:"[<storyTiddler>is[missing]tagging[]]" class:"multi-columns">>
\ No newline at end of file
+<<list-links filter:"[<storyTiddler>!has[text]tagging[]]" class:"multi-columns">>
\ No newline at end of file

From 67e7fa4b746e99b276a179bbdcd858d25d8fb4c4 Mon Sep 17 00:00:00 2001
From: Mario Pietsch <pmariojo@gmail.com>
Date: Wed, 17 Jul 2024 22:36:54 +0200
Subject: [PATCH 3/3] Improve :sort, sortsub, :sort examples and the railroad
 diagram (#8396)

* Improve :sort, sortsub, :sort examples and the railroad diagram

* Update Sort Filter Run Prefix (Examples).tid

undo changes.
---
 .../tiddlers/filters/sortsub Operator.tid     | 24 +++++++------
 .../Sort Filter Run Prefix (Examples).tid     |  2 +-
 .../filters/syntax/Sort Filter Run Prefix.tid | 34 +++++++++++++++----
 3 files changed, 42 insertions(+), 18 deletions(-)

diff --git a/editions/tw5.com/tiddlers/filters/sortsub Operator.tid b/editions/tw5.com/tiddlers/filters/sortsub Operator.tid
index df7d99cfa..d6c244a07 100644
--- a/editions/tw5.com/tiddlers/filters/sortsub Operator.tid	
+++ b/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">>
diff --git a/editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix (Examples).tid b/editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix (Examples).tid
index 16b9c9711..d16c31d55 100644
--- a/editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix (Examples).tid	
+++ b/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}]">>
\ No newline at end of file
+<<.operator-example 8 "Apple Banana Orange Grapefruit guava DragonFruit Kiwi apple orange :sort:string:caseinsensitive[{!!title}]">>
diff --git a/editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid b/editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid
index e17b88356..7df986274 100644
--- a/editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid	
+++ b/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)]]
\ No newline at end of file