tiddlywiki 5.2.2 → 5.2.3

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

@@ -1,9 +1,10 @@
 created: 20141228094500000
-modified: 20180305111822713
+modified: 20220427171020974
 tags: Concepts
 title: DictionaryTiddlers
+type: text/vnd.tiddlywiki
 
-A dictionary tiddler is a [[data tiddler|DataTiddlers]] containing a simple list of `name: value` pairs.
+A dictionary tiddler is a kind of [[data tiddler|DataTiddlers]] that contains a simple list of `name: value` pairs.
 
 Its [[ContentType]] is `application/x-tiddler-dictionary`.
 

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

@@ -1,10 +1,11 @@
 created: 20141228094500000
-modified: 20150221152956000
+modified: 20220427171219408
 tags: Concepts
 title: JSONTiddlers
+type: text/vnd.tiddlywiki
 
-A JSON tiddler is a [[data tiddler|DataTiddlers]] containing a [[JSON|JavaScript Object Notation]] structure in its `text` field.
+A JSON tiddler is a [[data tiddler|DataTiddlers]] containing a [[JSON|JavaScript Object Notation]] structure in its `text` field. See [[JSON in TiddlyWiki]] for an overview.
 
 Its [[ContentType]] is `application/json`.
 
-The [[history list|$:/HistoryList]] is a good example of a JSON tiddler.
+The [[history list|$:/HistoryList]] is an of a JSON tiddler.

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

@@ -10,3 +10,10 @@ A ''Keyboard Shortcut Tiddler'' is made of three parts:
 If the [[Keyboard Shortcut Descriptor]] has the form `((my-shortcut))` it's a ''reference'' to a ''configuration Tiddler'' that stores the corresponding [[Keyboard Shortcut|KeyboardShortcuts]]
 
 In order to make a ''shortcut'' editable through the <<.controlpanel-tab KeyboardShortcuts>> Tab in the $:/ControlPanel it's sufficient to create a tiddler `$:/config/ShortcutInfo/my-shortcut`, where the ''suffix'' is the ''reference'' used for the [[Keyboard Shortcut|KeyboardShortcuts]]
+
+!! Notes on wiki navigation
+
+If you want to create keyboard shortcuts for navigation, there are two things to keep in mind:
+
+ * If your shortcut uses ''Ctrl'', you need to include `$scroll="yes"` in the [[ActionNavigateWidget's|ActionNavigateWidget]] attributes otherwise the action will be ignored.
+ * The actions need to be wrapped in [[NavigatorWidget]] like in this [[New Tiddler keyboard shortcut|$:/core/ui/KeyboardShortcuts/new-tiddler]].

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

@@ -1,5 +1,5 @@
 created: 20140211171341271
-modified: 20220128112317724
+modified: 20220505082754270
 tags: Concepts Reference
 title: Macros
 type: text/vnd.tiddlywiki
@@ -18,7 +18,11 @@ Within a snippet itself, the only markup detected is `$name$` (a placeholder for
 
 The <<.mlink dumpvariables>> macro lists all variables (including macros) that are available at that position in the widget tree.
 
-An <<.wlink ImportVariablesWidget>> widget can be used to copy macro definitions to another branch of the [[widget tree|Widgets]]. ~TiddlyWiki uses this technique internally to implement global macros -- namely any macros defined in tiddlers with the <<.tag $:/tags/Macro>> tag. (The tag <<.tag $:/tags/Macro/View>> is used to define macros that should only be available within the main view template and the preview panel).
+An <<.wlink ImportVariablesWidget>> widget can be used to copy macro definitions to another branch of the [[widget tree|Widgets]]. ~TiddlyWiki uses this technique internally to implement global macros -- namely any macros defined in tiddlers with the <<.tag $:/tags/Macro>> tag.
+
+The tag <<.tag $:/tags/Macro/View>> is used to define macros that should only be available within the main view template and the preview panel.
+
+The tag <<.tag $:/tags/Macro/View/Body>> is used to define macros that should only be available within the main view template body and the preview panel.
 
 For maximum flexibility, macros can also be <<.js-macro-link "written as JavaScript modules">>.
 

package/editions/tw5.com/tiddlers/concepts/Order of Tagged Tiddlers.tid

@@ -1,5 +1,5 @@
 created: 20150124125646000
-modified: 20211127140005352
+modified: 20220729141540007
 tags: Tagging
 title: Order of Tagged Tiddlers
 type: text/vnd.tiddlywiki
@@ -13,6 +13,8 @@ When ~TiddlyWiki generates a list of the tiddlers that have a particular tag (e.
 
 # In each remaining tiddler <<.place T>>, look for a <<.field list-after>> field. If this has a tiddler title as its value, place tiddler <<.place T>> just <<.em after>> that one.
 
+#* As a special case, if the field exists but its value is empty, place <<.place T>> at the very end of the list.
+
 # If any tiddlers still remain, place them at the end of the list in ascending alphabetical order of title. The difference between capital and lowercase letters is ignored.
 
 The ordering of tiddlers with a particular tag can be directly modified using drag and drop within a tag pill dropdown. The underlying [[list-tagged-draggable Macro]] can also be used elsewhere.

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

@@ -1,5 +1,5 @@
 created: 20130822080600000
-list: [[SystemTag: $:/tags/AboveStory]] [[SystemTag: $:/tags/AdvancedSearch]] [[SystemTag: $:/tags/AdvancedSearch/FilterButton]] [[SystemTag: $:/tags/Alert]] [[SystemTag: $:/tags/BelowStory]] [[SystemTag: $:/tags/ControlPanel]] [[SystemTag: $:/tags/ControlPanel/Advanced]] [[SystemTag: $:/tags/ControlPanel/Appearance]] [[SystemTag: $:/tags/ControlPanel/Info]] [[SystemTag: $:/tags/ControlPanel/Saving]] [[SystemTag: $:/tags/ControlPanel/Settings]] [[SystemTag: $:/tags/ControlPanel/Toolbars]] [[SystemTag: $:/tags/EditorTools]] [[SystemTag: $:/tags/EditorToolbar]] [[SystemTag: $:/tags/EditPreview]] [[SystemTag: $:/tags/EditTemplate]] [[SystemTag: $:/tags/EditToolbar]] [[SystemTag: $:/tags/Exporter]] [[SystemTag: $:/tags/Filter]] [[SystemTag: $:/tags/Image]] [[SystemTag: $:/tags/ImportPreview]] [[SystemTag: $:/tags/KeyboardShortcut]] [[SystemTag: $:/tags/Layout]] [[SystemTag: $:/tags/Macro]] [[SystemTag: $:/tags/Macro/View]] [[SystemTag: $:/tags/Manager/ItemMain]] [[SystemTag: $:/tags/Manager/ItemSidebar]] [[SystemTag: $:/tags/MoreSideBar]] [[SystemTag: $:/tags/MoreSideBar/Plugins]] [[SystemTag: $:/tags/PageControls]] [[SystemTag: $:/tags/PageTemplate]] [[SystemTag: $:/tags/Palette]] [[SystemTag: $:/tags/PluginLibrary]] [[SystemTag: $:/tags/RawMarkup]] [[SystemTag: $:/tags/RawMarkupWikified]] [[SystemTag: $:/tags/RawMarkupWikified/BottomBody]] [[SystemTag: $:/tags/RawMarkupWikified/TopBody]] [[SystemTag: $:/tags/RawMarkupWikified/TopHead]] [[SystemTag: $:/tags/RawStaticContent]] [[SystemTag: $:/tags/RemoteAssetInfo]] [[SystemTag: $:/tags/SearchResults]] [[SystemTag: $:/tags/ServerConnection]] [[SystemTag: $:/tags/SideBar]] [[SystemTag: $:/tags/SideBarSegment]] [[SystemTag: $:/tags/StartupAction]] [[SystemTag: $:/tags/StartupAction/Browser]] [[SystemTag: $:/tags/StartupAction/Node]] [[SystemTag: $:/tags/Stylesheet]] [[SystemTag: $:/tags/TagDropdown]] [[SystemTag: $:/tags/TextEditor/Snippet]] [[SystemTag: $:/tags/TiddlerInfo]] [[SystemTag: $:/tags/TiddlerInfo/Advanced]] [[SystemTag: $:/tags/TiddlerInfoSegment]] [[SystemTag: $:/tags/ToolbarButtonStyle]] [[SystemTag: $:/tags/TopLeftBar]] [[SystemTag: $:/tags/TopRightBar]] [[SystemTag: $:/tags/ViewTemplate]] [[SystemTag: $:/tags/ViewToolbar]]
+list: [[SystemTag: $:/tags/AboveStory]] [[SystemTag: $:/tags/AdvancedSearch]] [[SystemTag: $:/tags/AdvancedSearch/FilterButton]] [[SystemTag: $:/tags/Alert]] [[SystemTag: $:/tags/BelowStory]] [[SystemTag: $:/tags/ControlPanel]] [[SystemTag: $:/tags/ControlPanel/Advanced]] [[SystemTag: $:/tags/ControlPanel/Appearance]] [[SystemTag: $:/tags/ControlPanel/Info]] [[SystemTag: $:/tags/ControlPanel/Saving]] [[SystemTag: $:/tags/ControlPanel/Settings]] [[SystemTag: $:/tags/ControlPanel/Toolbars]] [[SystemTag: $:/tags/EditorTools]] [[SystemTag: $:/tags/EditorToolbar]] [[SystemTag: $:/tags/EditPreview]] [[SystemTag: $:/tags/EditTemplate]] [[SystemTag: $:/tags/EditToolbar]] [[SystemTag: $:/tags/Exporter]] [[SystemTag: $:/tags/Filter]] [[SystemTag: $:/tags/Image]] [[SystemTag: $:/tags/ImportPreview]] [[SystemTag: $:/tags/KeyboardShortcut]] [[SystemTag: $:/tags/Layout]] [[SystemTag: $:/tags/Macro]] [[SystemTag: $:/tags/Macro/View]] [[SystemTag: $:/tags/Macro/View/Body]] [[SystemTag: $:/tags/Manager/ItemMain]] [[SystemTag: $:/tags/Manager/ItemSidebar]] [[SystemTag: $:/tags/MoreSideBar]] [[SystemTag: $:/tags/MoreSideBar/Plugins]] [[SystemTag: $:/tags/PageControls]] [[SystemTag: $:/tags/PageTemplate]] [[SystemTag: $:/tags/Palette]] [[SystemTag: $:/tags/PluginLibrary]] [[SystemTag: $:/tags/RawMarkup]] [[SystemTag: $:/tags/RawMarkupWikified]] [[SystemTag: $:/tags/RawMarkupWikified/BottomBody]] [[SystemTag: $:/tags/RawMarkupWikified/TopBody]] [[SystemTag: $:/tags/RawMarkupWikified/TopHead]] [[SystemTag: $:/tags/RawStaticContent]] [[SystemTag: $:/tags/RemoteAssetInfo]] [[SystemTag: $:/tags/SearchResults]] [[SystemTag: $:/tags/ServerConnection]] [[SystemTag: $:/tags/SideBar]] [[SystemTag: $:/tags/SideBarSegment]] [[SystemTag: $:/tags/StartupAction]] [[SystemTag: $:/tags/StartupAction/Browser]] [[SystemTag: $:/tags/StartupAction/Node]] [[SystemTag: $:/tags/Stylesheet]] [[SystemTag: $:/tags/TagDropdown]] [[SystemTag: $:/tags/TextEditor/Snippet]] [[SystemTag: $:/tags/TiddlerInfo]] [[SystemTag: $:/tags/TiddlerInfo/Advanced]] [[SystemTag: $:/tags/TiddlerInfoSegment]] [[SystemTag: $:/tags/ToolbarButtonStyle]] [[SystemTag: $:/tags/TopLeftBar]] [[SystemTag: $:/tags/TopRightBar]] [[SystemTag: $:/tags/ViewTemplate]] [[SystemTag: $:/tags/ViewToolbar]]
 modified: 20210519160636964
 tags: Reference Concepts
 title: SystemTags

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

@@ -1,7 +1,9 @@
-created: 201308252136
-modified: 201308252136
+created: 20130825213600000
+modified: 20220613145033713
 tags: Concepts
 title: TiddlyWiki5
 type: text/vnd.tiddlywiki
 
 ~TiddlyWiki5 is a reboot of TiddlyWiki for the next 25 years. It is a complete interactive wiki in JavaScript that can be run in the browser or on the server under [[Node.js]].
+
+The ~TiddlyWiki repository can be found at GitHub.

package/editions/tw5.com/tiddlers/concepts/Title List.tid

@@ -1,7 +1,8 @@
 created: 20150117152418000
-modified: 20150124205659000
+modified: 20220523075540462
 tags: Concepts
 title: Title List
+type: text/vnd.tiddlywiki
 
 A <<.def "title list">> is a line of text that presents one or more tiddler titles, strung together with a space between each one and the next.
 
@@ -12,3 +13,5 @@ If a title <<.em contains>> a space, it needs double square brackets around it:
 Title lists are used in various places, including PermaLinks and the ListField.
 
 They are in fact the simplest case of a [[filter|Filters]], and are thus a way of expressing a [[selection of titles|Title Selection]].
+
+<<.warning """The [[Title List]] format cannot reliably represent items that contain certain specific character sequences such as `]] `. Thus it should not be used where there is a possibility of such sequences occurring.""">>

package/editions/tw5.com/tiddlers/customising/Customising TiddlyWiki's user interface.tid

@@ -62,7 +62,7 @@ Cascades provide a means to select one of multiple values based on flexible, ext
 For example, the core uses the template $:/core/ui/ViewTemplate to display tiddlers in view mode, and $:/core/ui/EditTemplate to display tiddlers in edit mode. A cascade is used to choose which template to use for a particular tiddler:
 
 # If the tiddler is a draft, then use $:/core/ui/EditTemplate
-# Otherwise, use $:/core/ui/EditTemplate
+# Otherwise, use $:/core/ui/ViewTemplate
 
 The list of conditions is defined via a special tag, making it possible to insert additional conditions anywhere in the list.
 
@@ -70,6 +70,6 @@ For example, a plugin might add a special template $:/plugins/example/map-templa
 
 # If the tiddler is a draft, then use $:/core/ui/EditTemplate
 # @@background: yellow; If the tiddler is tagged $:/tags/Map, then use $:/plugins/example/map-template@@
-# Otherwise, use $:/core/ui/EditTemplate
+# Otherwise, use $:/core/ui/ViewTemplate
 
 See [[Cascades]] for more details.

package/editions/tw5.com/tiddlers/definitions/JavaScript Object Notation.tid

@@ -1,11 +1,7 @@
 created: 20150221152904000
-modified: 20150221181720000
+modified: 20220427170920772
 tags: Definitions
 title: JavaScript Object Notation
 type: text/vnd.tiddlywiki
 
-<<.dlink-ex JSON "https://en.wikipedia.org/wiki/JSON">> is a standard plain-text format used for modelling hierarchical structures of objects that contain named fields.
-
-DataTiddlers can have JSON content.
-
-The <<.mlink jsontiddlers>> macro returns tiddler content in JSON format.
+<<.dlink-ex JSON "https://en.wikipedia.org/wiki/JSON">> is a standard plain-text format used for modelling hierarchical structures of objects that contain named fields. See [[JSON in TiddlyWiki]] for an overview.

package/editions/tw5.com/tiddlers/definitions/Node.js.tid

@@ -1,13 +1,15 @@
 created: 20131129094739786
-modified: 20140211195455541
+modified: 20220612091858504
 tags: Definitions
 title: Node.js
 type: text/vnd.tiddlywiki
 
-''Node.js'' is a downloadable application for your PC, Mac or Linux computer that lets it run JavaScript applications. Unlike ~JavaScript applications running in a web browser, Node.js code has full access to the file system and other resources of the computer, enabling it to perform the roles that have traditionally been the preserve of languages like Java, PHP and Python. See http://nodejs.org for more details.
+''Node.js'' is a downloadable application for your PC, Mac or Linux computer that lets it run JavaScript applications. Unlike ~JavaScript applications running in a web browser, Node.js code has full access to the file system and other resources of the computer, enabling it to perform the roles that have traditionally been the preserve of languages like Java, PHP and Python. 
 
 For ~TiddlyWiki, Node.js means that we can have a single code base that can run in the browser or on the server, giving great flexibility in how it is used.
 
 For end users, Node.js is no more complicated to install than a web browser, but unlocks powerful capabilities such as the ability to run ~TiddlyWiki as a web server that you can connect to from other devices.
 
-See [[TiddlyWiki on Node.js]] for more details.
+''Node.js'' is a ''trademark'' of the ~OpenJS Foundation. See: https://nodejs.org fore more details.
+
+[[TiddlyWiki on Node.js]] will give an overview about the possibilities using a client-server configuration.

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

@@ -14,6 +14,6 @@ TiddlyDesktop is an app for working with TiddlyWiki files (both TiddlyWikiClassi
 
 TiddlyDesktop is based on the OpenSource project [[NW.js]]. The source is on GitHub:
 
-https://github.com/Jermolene/TiddlyDesktop/
+https://github.com/TiddlyWiki/TiddlyDesktop/
 
 See [[TiddlyDesktop Releases]] and [[How to Customize TiddlyDesktop]]

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

@@ -15,5 +15,6 @@ 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
+* [[tiddly-wiki-server|https://github.com/nathanielknight/tiddly-wiki-server]], an implementation based on Rust and SQLite
 
 As of early 2017, none is currently as complete as TiddlyWeb itself.

package/editions/tw5.com/tiddlers/demonstrations/CustomStoryTiddlerTemplateDemo.tid/Styles.tid

@@ -1,6 +1,5 @@
 title: $:/_tw5.com/CustomStoryTiddlerTemplateDemo/Styles
 tags: $:/tags/Stylesheet
-code-body: yes
 
 .tc-custom-tiddler-template {
 	border: 3px solid <<colour muted-foreground>>;

package/editions/tw5.com/tiddlers/features/JSON in TiddlyWiki.tid

@@ -0,0 +1,69 @@
+title: JSON in TiddlyWiki
+tags: Features
+type: text/vnd.tiddlywiki
+created: 20220427174702859
+modified: 20220427174702859
+
+!! Introduction
+
+JSON (~JavaScript Object Notation) is a standardised text representation for data structures that is widely used for the storage and transfer of data.
+
+JSON is used in several different contexts in TiddlyWiki. For example:
+
+* Tiddlers are represented as JSON data within TiddlyWiki HTML files
+* Groups of tiddlers can be [[exported|How to export tiddlers]] and [[imported|Importing Tiddlers]] as JSON files
+* Plugin tiddlers store their constituent shadow tiddlers as JSON data
+* The client-server configuration uses [[JSON messages|TiddlyWeb JSON tiddler format]] to communicate between the client and the server
+* Arbitrary JSON data within DataTiddlers can be processed and manipulated using a set of filter operators and action widgets
+
+!! About JSON
+
+The technical description of JSON at the official website https://json.org/ is terse. Here we summarise the main features.
+
+JSON supports two basic data structures:
+
+''Arrays'' are lists of items. The items are identified by their numeric index (starting at zero)
+
+An example of an array is:
+
+```json
+["one","two","three\"four"]
+```
+
+Note the following features of arrays:
+
+* The array is signified by square brackets surrounding the list of items
+* Each item is a string in double quotes. Double quotes can be included within the strings by preceding them with a backslash (`\`)
+* The items are separated by commas
+
+''Objects'' are collections of name/value pairs. Each item is a value that is identified by a unique name
+
+An example of an object is:
+
+```json
+{
+  "first": "This is the first value",
+  "second": "This is the second value",
+  "third": "This is the third value"
+}
+```
+
+Note the following features of objects:
+
+* The object is signified by curly braces surrounding the list of name/value pairs
+* Each name/value pair consists of the name in double quotes, a colon, and then the value
+* The name/value pairs are separated by commas
+
+The examples above all show string values. JSON actually supports several different types of value. Any of these types can be used as a value:
+
+* String values, as shown above
+* Numeric values, represented as signed decimals such as `1`, `3.14`. Exponential notation can also be used e.g. `-1E10`
+* Boolean values, represented by the keywords `true` and `false`
+* The special value `null`, which is often used to represent data that is missing or incomplete
+* Objects and arrays are also values, allowing complex nested structures to be represented
+
+!! Working with Data Tiddlers
+
+* [[Reading data from JSON tiddlers]]
+* [[Constructing JSON tiddlers]]
+* [[Modifying JSON tiddlers]]

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

@@ -1,11 +1,13 @@
 created: 20190206140446821
-modified: 20210417090408263
+modified: 20220330133748666
 tags: Filters
 title: Mathematics Operators
 type: text/vnd.tiddlywiki
 
 <<.from-version "5.1.20">>The mathematics filter operators allow numerical calculations to be performed within filters.
 
+! Using mathematics operators
+
 The mathematics operators interpret their arguments as numbers according to the following rules:
 
 * Any non-numeric characters after a valid number are ignored (e.g. `28px` is interpreted as the number 28)
@@ -28,7 +30,10 @@ The mathematics operators take three different forms:
 ** <<.inline-operator-example "=1 =2 =3 =4 +[product[]]">>
 ** <<.inline-operator-example "=1 =2 =3 =4 +[average[]]">>
 
-Operators can be combined:
+
+! Operations Combination
+
+Operations can be combined by concatenating them while merging the inner `][` characters.
 
 * <<.inline-operator-example "[[355]divide[113]fixed[5]]">>
 * <<.inline-operator-example "[range[100]sum[]divide[100]]">>
@@ -41,4 +46,19 @@ src="""<$set name="number-of-tiddlers" value={{{ [tag[HelloThere]count[]] }}}>
 Average length of <$text text=<<number-of-tiddlers>>/> tiddlers tagged <<tag "HelloThere">>: <$text text={{{ [tag[HelloThere]get[text]length[]sum[]divide<number-of-tiddlers>fixed[3]] }}}/>
 </$set>""" />
 
-<<list-links "[tag[Mathematics Operators]]">>
+! Mathematics Operators list
+
+<table>
+<tr>
+<th align="left">Operator</th>
+<th align="left">Purpose</th>
+</tr>
+<$list filter="[tag[Mathematics Operators]sort[caption]]">
+<tr>
+<td><$link>{{!!caption}}</$link></td>
+<td>{{!!op-purpose}}</td>
+</tr>
+</$list>
+</table>
+
+

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

@@ -0,0 +1,28 @@
+created: 20220223004441865
+modified: 20220223004441865
+tags: [[Operator Examples]] [[insertafter Operator]]
+title: insertafter Operator (Examples)
+type: text/vnd.tiddlywiki
+
+\define after-title() Friday
+\define missing-title() Yesterday
+\define display-variable(name)
+''<$text text=<<__name__>>/>'': <code><$text text={{{ [<__name__>getvariable[]] }}}/></code>
+\end
+
+These examples use the following predefined variables:
+
+* <<display-variable after-title>>
+* <<display-variable missing-title>>
+
+<<.operator-example 1 """[list[Days of the Week]insertafter[Today]]""">>
+
+<<.operator-example 2 """[list[Days of the Week]insertafter[Today],[Tuesday]]""">>
+
+<<.operator-example 3 """[list[Days of the Week]insertafter[Today],<after-title>]""">>
+
+<<.operator-example 4 """[list[Days of the Week]insertafter:after-title[Today]]""">>
+
+<<.operator-example 5 """[list[Days of the Week]insertafter[Today],<missing-title>]""">>
+
+<<.operator-example 6 """[list[Days of the Week]insertafter:missing-title[Today]]""">>

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

@@ -1,6 +1,6 @@
 caption: format
 created: 20201020100834443
-modified: 20210524090002126
+modified: 20220523075550449
 op-input: a [[selection of titles|Title Selection]]
 op-output: input strings formatted according to the specified suffix <<.place B>>
 op-parameter: optional format string for the formats
@@ -21,4 +21,6 @@ The suffix <<.place B>> is one of the following supported string formats:
 |^`relativedate` |The input string is interpreted as a UTC date and displayed as the interval from the present instant. Any operator parameters are ignored. |
 |^`titlelist` |<<.from-version "5.2.0">>The input string wrapped in double square brackets if it contains a space. Appropriate for use in a [[title list|Title List]]. |
 
+<<.warning """The [[Title List]] format cannot reliably represent items that contain certain specific character sequences such as `]] `. Thus it should not be used where there is a possibility of such sequences occurring.""">>
+
 <<.operator-examples "format">>

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

@@ -0,0 +1,35 @@
+caption: insertafter
+created: 20170406090122441
+modified: 20220223004441865
+op-input: a [[selection of titles|Title Selection]]
+op-output: the input tiddler list with the new entry inserted
+op-parameter: the <<.op insertafter>> operator accepts 1 or 2 parameters, see below for details
+op-purpose: insert an item <<.place T>> into a list immediately after an item <<.place A>>
+op-suffix: (optional) the name of a variable containing the title of the tiddler after which this one should be inserted
+tags: [[Filter Operators]] [[Order Operators]] [[Listops Operators]]
+title: insertafter Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.3">>
+
+The <<.op insertafter>> operator requires at least one parameter which specifies the title to insert into the input list. A second parameter can be used to specify the title after which the new title should be inserted.
+
+A suffix can also be used to specify <<.place A>>, the title after which the new title should be inserted, but this form is deprecated. Instead, the two-parameter form is recommended. If the two-parameter form is used, the suffixes ''start'' and ''end'' can be used to specify where the item should be inserted if <<.place A>> is not found.
+
+```
+insertafter:<after-title-variable>[<title>]
+insertafter:<missing-location>[<title>],[<after-title>]
+```
+
+* ''title'' : a title <<.place T>> to insert in the input list.
+* ''after-title'' : (optional). Insert <<.place T>> after this title <<.place A>> in the input list.
+* ''after-title-variable'' : (optional). The name of a variable specifying <<.place A>> instead of the `after-title` parameter.
+* ''missing-location'' : (optional). Either `start` or `end`: where to insert <<.place T>> if <<.place A>> is not found in the list.
+
+If the item <<.place A>> isn't present in the input list then the new item is inserted at the end of the list. <<.from-version "5.2.3">> The suffixes ''start'' and ''end'' can be spedified to control where the new item is inserted when <<.place A>> is not found. The suffix ''end'' is the default, inserting the new item at the end of the list. The suffix ''start'' will cause the new item to be inserted at the start of the list when <<.place A>> is not found.
+
+<<.tip "Either [[parameter|Filter Parameter]] can be a string, a text reference or a variable">>
+
+<<.tip "If <<.place A>> is specified as both a suffix and a parameter, the parameter takes precedence">>
+
+<<.operator-examples "insertafter">>

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

@@ -5,7 +5,7 @@ op-input: a [[selection of titles|Title Selection]]
 op-output: the input tiddler list with the new entry inserted
 op-parameter: <<.from-version "5.2.2">> the <<.op insertbefore>> operator accepts 1 or 2 parameters, see below for details
 op-purpose: insert an item <<.place T>> into a list immediately before an item <<.place B>>
-op-suffix: (optional) the name of a variable containing the title of the tiddler before which this one should be inserted
+op-suffix: <<.from-version "5.2.3">> (optional) the name of a variable containing the title of the tiddler before which this one should be inserted
 tags: [[Filter Operators]] [[Order Operators]] [[Listops Operators]]
 title: insertbefore Operator
 type: text/vnd.tiddlywiki
@@ -14,15 +14,21 @@ type: text/vnd.tiddlywiki
 
 The <<.op insertbefore>> operator requires at least one parameter which specifies the title to insert into the input list. A second parameter can be used to specify the title before which the new title should be inserted.
 
+<<.from-version "5.2.3">>
+
+Using the suffix to specify <<.place B>>, the title before which the new title should be inserted, is deprecated. Instead, the two-parameter form is recommended. If the two-parameter form is used, the suffixes ''start'' and ''end'' can be used to specify where the item should be inserted if <<.place B>> is not found.
+
 ```
-insertbefore:<before-title-variable>[<title>],[<before-title>]
+insertbefore:<before-title-variable>[<title>]
+insertbefore:<missing-location>[<title>],[<before-title>]
 ```
 
 * ''title'' : a title <<.place T>> to insert in the input list.
 * ''before-title'' : (optional). Insert <<.place T>> before this title <<.place B>> in the input list.
 * ''before-title-variable'' : (optional). The name of a variable specifying <<.place B>> instead of the `before-title` parameter.
+* ''missing-location'' : (optional). Either `start` or `end`: where to insert <<.place T>> if <<.place B>> is not found in the list.
 
-If the item <<.place B>> isn't present in the input list then the new item is inserted at the end of the list.
+If the item <<.place B>> isn't present in the input list then the new item is inserted at the end of the list. <<.from-version "5.2.3">> The suffixes ''start'' and ''end'' can be spedified to control where the new item is inserted when <<.place B>> is not found. The suffix ''end'' is the default, inserting the new item at the end of the list. The suffix ''start'' will cause the new item to be inserted at the start of the list when <<.place B>> is not found.
 
 <<.tip "Either [[parameter|Filter Parameter]] can be a string, a text reference or a variable">>
 

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

@@ -1,5 +1,5 @@
 created: 20210618134753828
-modified: 20211125152755859
+modified: 20220724162340642
 tags: [[Filter Syntax]] [[Filter Run Prefix Examples]] [[Map Filter Run Prefix]]
 title: Map Filter Run Prefix (Examples)
 type: text/vnd.tiddlywiki
@@ -15,12 +15,30 @@ For each title in a shopping list, calculate the total cost of purchasing each i
 
 <<.operator-example 2 "[tag[shopping]] :map[get[quantity]else[0]multiply{!!price}]">>
 
+Get the tags of all tiddlers tagged `Widget:`
+
+<<.operator-example 3 "[tag[Widgets]] :map:flat[tagging[]] :and[!is[blank]unique[]]">>
+<<.tip "Without the `flat` suffix the `:map` filter run only returns the first result for each input title">>
+
+!! Comparison between `:map` with and without the `flat` suffix
+
+The `:map` filter run will return at least as many outputs as given in the input.  By default one input item will result in exactly one output item. When the filter run transforms an input item into an empty result, the output for that item will be an empty string. When the filter run transforms an input item into multiple items, only the first item will appear in the output. This behavior can be overridden by providing the `flat` suffix. The `flat` suffix will cause all the items to appear in the output.
+
+| `:map` | `:map:flat` |
+|^<<.operator-example m0.1 "[range[4]] :map[match[this matches nothing]]">>|^<<.operator-example m0.2 "[range[4]] :map:flat[match[this matches nothing]]">>|
+|^<<.operator-example m1.1 "[range[4]] :map[range<currentTiddler>]">>|^<<.operator-example m1.2 "[range[4]] :map:flat[range<currentTiddler>]">>|
+|^<<.operator-example m2.1 "[range[4]] :map[range<currentTiddler>]">>|^<<.operator-example m2.2 "[range[4]] :map:flat[range<currentTiddler>first[]]">>|
+|^<<.operator-example m3.1 "[range[4]] :map[range<currentTiddler>sum[]]">>|^<<.operator-example m3.2 "[range[4]] :map:flat[range<currentTiddler>sum[]]">>|
+|^<<.operator-example m4.1 "[[1,2,3]] [[4,5]] :map[split[,]]">>|^<<.operator-example m4.2 "[[1,2,3]] [[4,5]] :map:flat[split[,]]">>|
+|^<<.operator-example m5.1 "[[1,2,3]] [[4,5]] :map[split[,]]">>|^<<.operator-example m5.2 "[[1,2,3]] [[4,5]] :map:flat[split[,]first[]]">>|
+
+
 !! Comparison between `:map` and `:and`/`+` filter run prefixes
 
 The functionality of the `:map` filter run prefix has some overlap with the `:and` prefix (alias `+`). They will sometimes return the same results as each other. In at least these cases, the results will be different:
 
 # The `:and` filter run can modify the number of items (either increase or decrease). The `:map` run will never alter the number of items.
-# The number of items in the `:and` filter run will also decrease due to de-duplication. The `:map` run will not de-duplicate.
+# The number of items in the `:and` filter run will also decrease due to [[de-duplication|Dominant Append]]. The `:map` run will not [[de-duplicate|Dominant Append]].
 # Explicit references to the "currentTiddler" variable will behave differently
 # Implicit references to the "currentTiddler" using TextReference will behave differently.
 

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

@@ -1,5 +1,5 @@
 created: 20210618133745003
-modified: 20211029025541750
+modified: 20220720190146771
 tags: [[Filter Syntax]] [[Filter Run Prefix]]
 title: Map Filter Run Prefix
 type: text/vnd.tiddlywiki
@@ -8,6 +8,7 @@ type: text/vnd.tiddlywiki
 
 |''purpose'' |modify input titles by the result of evaluating this filter run for each item |
 |''input'' |all titles from previous filter runs |
+|''suffix''|<<.from-version "5.2.3">> `flat` to return all results from the filter run, If omitted (default), only the first result is returned.|
 |''output''|the input titles as modified by the result of this filter run |
 
 Each input title from previous runs is passed to this run in turn. The filter run transforms the input titles and the output of this run replaces the input title. For example, the filter run `[get[caption]else{!!title}]` replaces each input title with its caption field, unless the field does not exist in which case the title is preserved.
@@ -22,6 +23,6 @@ The following variables are available within the filter run:
 * ''revIndex'' - <<.from-version "5.2.1">> the reverse numeric index of the current list item (with zero being the last item in the list).
 * ''length'' - <<.from-version "5.2.1">> the total length of the input list.
 
-Filter runs used with the `:map` prefix should return the same number of items that they are passed. Any missing entries will be treated as an empty string. In particular, when retrieving the value of a field with the [[get Operator]] it is helpful to guard against a missing field value using the [[else Operator]]. For example `[get[myfield]else[default-value]...`.
+Filter runs used with the `:map` prefix should return at least the same number of items that they are passed. Any missing entries will be treated as an empty string. In particular, when retrieving the value of a field with the [[get Operator]] it is helpful to guard against a missing field value using the [[else Operator]]. For example `[get[myfield]else[default-value]...`.
 
 [[Examples|Map Filter Run Prefix (Examples)]]

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

@@ -4,6 +4,12 @@ tags: [[Working with TiddlyWiki]]
 title: GettingStarted
 type: text/vnd.tiddlywiki
 
+The easiest way to use TiddlyWiki is to sign up for a free account with [[Tiddlyhost]], an independently run community service:
+
+https://tiddlyhost.com/
+
+If you find Tiddlyhost useful, please consider [[donation or sponsorship|https://tiddlyhost.com/donate]].
+
 Click here to download an empty copy of TiddlyWiki: {{$:/editions/tw5.com/snippets/download-empty-button}}
 
 The next step is to choose a method for saving changes. There's a wide variety of methods available, with different features and limitations. Click on the badge for a method to see more information about it. You can also click on one of the platform filters to restrict the listing to methods that work with that platform.

package/editions/tw5.com/tiddlers/hellothere/HelloThere.tid

@@ -1,6 +1,6 @@
 created: 20130822170200000
 list: [[A Gentle Guide to TiddlyWiki]] [[Discover TiddlyWiki]] [[Some of the things you can do with TiddlyWiki]] [[Ten reasons to switch to TiddlyWiki]] Examples [[What happened to the original TiddlyWiki?]] [[HelloThumbnail - TWEUM2017]]
-modified: 20220325130817150
+modified: 20220802122551819
 tags: TableOfContents
 title: HelloThere
 type: text/vnd.tiddlywiki

package/editions/tw5.com/tiddlers/howtos/Constructing JSON tiddlers.tid

@@ -0,0 +1,16 @@
+title: Constructing JSON tiddlers
+tags: [[JSON in TiddlyWiki]] [[Learning]]
+created: 20220427174702859
+modified: 20220427174702859
+
+See [[JSON in TiddlyWiki]] for an overview of using JSON in TiddlyWiki.
+
+JSON data is just plain text, and so there are an wide variety of techniques to generate it in wikitext.
+
+At a high level, we have several ways to generate JSON data in TiddlyWiki's own tiddler format:
+
+* JSONTiddlerWidget
+* [[jsontiddler Macro]]
+* [[jsontiddlers Macro]]
+
+When constructing JSON data manually, the [[jsonstringify Operator]] is needed to ensure that any special characters are properly escaped.

package/editions/tw5.com/tiddlers/howtos/Creating a splash screen.tid

@@ -8,7 +8,7 @@ By default, TiddlyWiki displays a blank screen while it is loading. You can add
 
 Larger TiddlyWiki files and those loaded over a slow network connection may take a little time to load. Once fully loaded, performance improves, because everything is now running entirely within the browser. Using a splash screen ensures people know the loading process is taking place, reducing the chance they will leave the page.
 
-In order for the splash screen to be displayed before TiddlyWiki is initialised it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the [[SystemTag: $:/tags/RawMarkupWikified/TopBody]].
+In order for the splash screen to be displayed before TiddlyWiki is initialised or [[decrypted|Encryption]], it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the [[SystemTag: $:/tags/RawMarkupWikified/TopBody]], or any of the other system tags beginning with $:/tags/RawMarkup. 
 
 In order to remove the splash screen when the wiki has finished loading, the HTML should be wrapped in a container with the special class `tc-remove-when-wiki-loaded`. Any DOM elements with this class are automatically deleted by the core once the wiki has loaded.
 

package/editions/tw5.com/tiddlers/howtos/How to apply custom styles by tag.tid

@@ -1,11 +1,11 @@
 caption: {{!!title}} - ^^deprecated^^
 created: 20141001132300000
-modified: 201804111739
+modified: 20220704174221300
 tags: [[How to apply custom styles]] $:/deprecated
 title: How to apply custom styles by tag
 type: text/vnd.tiddlywiki
 
-<<.deprecated-since "5.1.16 <- click" "Custom styles by data-tags">>. Also see: [[How to apply custom styles]]
+<<.deprecated-since "5.1.16" "Custom styles by data-tags">>. Also see: [[How to apply custom styles]]
 
 ----
 

package/editions/tw5.com/tiddlers/howtos/How to customize TiddlyDesktop.tid

@@ -8,7 +8,7 @@ type: text/vnd.tiddlywiki
 
 Before experimenting with TiddlyDesktop internals you should find the location of the “user configuration folder” - click the “Settings” button on the main TiddlyDesktop window, and then click the button “Open user config folder”. Then move up to locate the parent folder, which should be called “TiddlyDesktop”. If things go wrong, you can reset TiddlyDesktop to its factory state by deleting this entire folder.
 
-Click the `Backstage` button on the main TiddlyDesktop window to open the backstage wiki. This is is a Node.js-like instance of TiddlyWiki that runs the UI and logic of TiddlyDesktop.
+Click the `Backstage` button on the main TiddlyDesktop window to open the backstage wiki. This is a Node.js-like instance of TiddlyWiki that runs the UI and logic of TiddlyDesktop.
 
 !! How do I get rid of the "Add a ~TiddlyWiki Folder" button.
 

package/editions/tw5.com/tiddlers/howtos/How to update TiddlyWiki to the latest version.tid

@@ -0,0 +1,7 @@
+created: 20220426221124514
+modified: 20220426221240671
+tags: [[Working with TiddlyWiki]]
+title: How to update TiddlyWiki to the latest version
+type: text/vnd.tiddlywiki
+
+{{Upgrading}}

package/editions/tw5.com/tiddlers/howtos/Modifying JSON tiddlers.tid

@@ -0,0 +1,18 @@
+created: 20220427174702859
+modified: 20220427171707459
+tags: [[JSON in TiddlyWiki]] Learning
+title: Modifying JSON tiddlers
+type: text/vnd.tiddlywiki
+
+See [[JSON in TiddlyWiki]] for an overview of using JSON in TiddlyWiki.
+
+Note that 
+
+!! Using ActionSetFieldWidget and ActionListopsWidget
+
+The widgets ActionSetFieldWidget and ActionListopsWidget can manipulate named properties of data tiddlers by indicating the name of the property in the $index attribute.
+
+* To create or modify a named property with ActionSetFieldWidget, provide a $value attribute
+* To delete a named property with ActionSetFieldWidget, omit the $value attribute.
+
+ActionListopsWidget assigns the named property the list constructed through its $filter and $subfilter attributes.