tiddlywiki 5.3.4 → 5.3.6

package/editions/tw5.com/tiddlers/community/links/TiddlyWiki on YouTube.tid

@@ -0,0 +1,7 @@
+title: TiddlyWiki on YouTube
+caption: ~YouTube
+tags: [[TiddlyWiki on the Web]]
+url: https://www.youtube.com/c/JeremyRuston
+icon: $:/core/images/video
+background-color: #e52d27
+text-color: #fff

package/editions/tw5.com/tiddlers/community/links/external-links-view-template.tid

@@ -0,0 +1,8 @@
+title: $:/_tw5.com/external-links-view-template
+tags: $:/tags/ViewTemplate
+
+<%if [<currentTiddler>tag[TiddlyWiki on the Web]] %>
+<div class="tc-cards tc-cards-vertical">
+<$macrocall $name="flex-card-external" backgroundcolor={{!!background-color}} textcolor={{!!text-color}} captionField="caption"/>
+</div>
+<%endif%>

package/editions/tw5.com/tiddlers/community/resources/Filter Examples by Tobias Beer.tid

@@ -10,5 +10,5 @@ This wiki gives examples for various [[filters|Filters]] and their use in the [[
 {{!!url}}
 
 <<<
-This wiki gives examples for various [[filters|Filters]] and their use in the [[list widget|ListWidget]]. A good starting point to understand what filters yield which results also is [[test-filters.js|https://github.com/Jermolene/TiddlyWiki5/blob/master/editions/test/tiddlers/tests/test-filters.js]].
+This wiki gives examples for various [[filters|Filters]] and their use in the [[list widget|ListWidget]]. A good starting point to understand what filters yield which results also is [[test-filters.js|https://github.com/TiddlyWiki/TiddlyWiki5/blob/master/editions/test/tiddlers/tests/test-filters.js]].
 <<<

package/editions/tw5.com/tiddlers/community/resources/Grok TiddlyWiki by Soren Bjornstad.tid

@@ -1,15 +1,15 @@
 created: 20210519110226889
-modified: 20210519110226889
+modified: 20241021161007731
 tags: [[Other Resources]]
 title: "Grok TiddlyWiki" by Soren Bjornstad
 type: text/vnd.tiddlywiki
 url: https://groktiddlywiki.com/read/
 
-This new textbook from Soren Bjornstad is highly recommended for learning ~TiddlyWiki. The presentation and design are also a first class example of using ~TiddlyWiki.
+Grok ~TiddlyWiki by Soren Bjornstad is an interactive learning environment for TiddlyWiki. It bundles three complementary modes of learning into one TiddlyWiki:
 
-From the site:
-
-> Grok ~TiddlyWiki is a textbook that helps you build a deep, lasting understanding of and proficiency with ~TiddlyWiki through a combination of detailed explanations, practical exercises, and spaced-repetition reviews of prompts called takeaways.
+* It ''explains concepts'' using English text and code examples
+* It ''assigns exercises'' that help you apply and practice what you've learned
+* It ''presents takeaways'', questions about key terms, concepts, or skills, for review as you continue through the book, to help you retain what you've learned over a longer period of time
 
 {{!!url}}
 

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

@@ -1,7 +1,8 @@
-title: CompoundTiddlers
-modified: 20240507221902644
 created: 20240507221902644
+modified: 20240729082610287
 tags: Concepts
+title: CompoundTiddlers
+type: text/vnd.tiddlywiki
 
 Compound tiddlers are a special type of tiddler that can store one or more payload tiddlers. The tiddlers within a compound tiddler are only accessible via special operations, typically with the TestCaseWidget.
 
@@ -29,3 +30,5 @@ tags: five six
 
 This is the third tiddler
 ```
+
+Also see: [[TestCaseTiddlers]]

package/editions/tw5.com/tiddlers/concepts/Dominant Append.tid

@@ -1,5 +1,5 @@
 created: 20150123220223000
-modified: 20190610165255223
+modified: 20240709170746678
 tags: Filters
 title: Dominant Append
 type: text/vnd.tiddlywiki
@@ -13,3 +13,5 @@ For example, if a selection contains `Andrew Becky Clara Daniel` and `Andrew Bar
 This behaviour can cause unexpected results when working with [[Mathematics Operators]]. For example, `1 2 3 +[sum[]]` evaluates to `6`, as expected. But `1 1 1 +[sum[]]` evaluates to `1`. Removing the `+[sum[]]` from each filter reveals the problem: `1 2 3` evaluates to the list `1`, `2`, `3`, while `1 1 1` evaluates to the single item `1` due to de-duplication.
 
 In such situations, the `=` prefix can be used to disable the de-duplication. For example, `=1 =1 =1 +[sum[]]` evaluates to `3` as expected. Alternatively, the [[split Operator]] can be used: `[[1,1,1]split[,]sum[]]`.
+
+<<.tip """To build a list of unique values that retains only the <<.em earliest>> copy of each value (the opposite behavior from <<.link "Dominant Append" "Dominant Append">>), first use the <<.link `:all` "All Filter Run Prefix">> filter run prefix (or its short form `=`) to retain all duplicate values while building your list. Then finish your filter run with the <<.olink unique>> operator to remove later duplicates.""">>

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/Selection Constructors.tid

@@ -1,5 +1,5 @@
 created: 20150117204109000
-modified: 20150917193713204
+modified: 20240708201746542
 tags: Filters
 title: Selection Constructors
 type: text/vnd.tiddlywiki
@@ -11,3 +11,7 @@ The output of a [[Filter Step]] depends on its [[operator|Filter Operators]]:
 * A few operators ignore their input and generate an independent output instead. These are called <<.def "selection constructors">>: they construct an entirely new [[selection|Title Selection]].
 
 A good example of a constructor is <<.olink title>>. The output of `[title[A]title[B]]` is just <<.tid B>>. But the <<.olink field>> operator is a modifier, so `[title[A]field:title[B]` outputs nothing at all.
+
+The following [[filter Operators|filter Operator]] are tagged <<tag>>:
+
+<<list-links "[tag<currentTiddler>]" class:"multi-columns">>

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/currentTab Variable.tid

@@ -0,0 +1,12 @@
+caption: currentTab
+created: 20240627195924480
+modified: 20240627201655746
+tags: Variables [[Core Variables]]
+title: currentTab Variable
+type: text/vnd.tiddlywiki
+
+The <<.def currentTab>> [[variable|Variables]] contains the title of the current tab within an enclosing set of tabs generated by the [[tabs Macro]].
+
+When a tiddler is [[transcluded|Transclusion]] within a tab, any use of the [[currentTiddler Variable]] will point to the tiddler containing the [[tabs Macro]] call. This may lead to surprises if the transcluded tiddler was originally written to display by itself in the [[Story River]] in ways that rely on self-reference. The currentTab macro enables a similar effect to currentTiddler for the special case of a tiddler rendered as a tab.
+
+Compare <<.vlink currentTiddler>>.

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/features/AutoSave.tid

@@ -4,7 +4,7 @@ tags: Features
 title: AutoSave
 type: text/vnd.tiddlywiki
 
-If there is a SaverModule available that supports it, TiddlyWiki will automatically trigger a save of the current document on clicking <<.icon $:/core/images/done-button>> ''ok'' or <<.icon $:/core/images/delete-button>> ''delete'' when editing a tiddler.
+If there is a SavingMechanism available that supports it, TiddlyWiki will automatically trigger a save of the current document on clicking <<.icon $:/core/images/done-button>> ''ok'' or <<.icon $:/core/images/delete-button>> ''delete'' when editing a tiddler.
 
 You should see a yellow notification at the top right of the window to confirm that an automatic save has taken place.
 

package/editions/tw5.com/tiddlers/fields/_canonical_uriField.tid

@@ -0,0 +1,5 @@
+created: 20240627223618060
+modified: 20240627223637576
+title: $:/language/Docs/Fields/_canonical_uri
+
+The full URI of an external image, audio, or html file

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/minlength.tid

@@ -1,12 +1,12 @@
 caption: minlength
 created: 20161011074235805
 from-version: 5.1.14
-modified: 20240621073052597
+modified: 20240709161140504
 op-input: a list of items
 op-output: those items at least as long as the specified minimum length
 op-parameter: the minimum length for items
 op-parameter-name: minlength
-op-purpose: filter items whose length is greater than the specified minimum length
+op-purpose: filter items whose length is greater than or equal to the specified minimum length
 tags: [[Filter Operators]]
 title: minlength Operator
 type: text/vnd.tiddlywiki

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">>