tiddlywiki 5.3.3 → 5.3.4

package/editions/tw5.com/tiddlers/concepts/Bags and Recipes.tid

@@ -0,0 +1,42 @@
+created: 20240309135835396
+modified: 20240309142156125
+tags: Concepts
+title: Bags and Recipes
+type: text/vnd.tiddlywiki
+
+The bags and recipes model is a reference architecture for how tiddlers can be shared between multiple wikis. It was first introduced by TiddlyWeb in 2008.
+
+The principles of bags and recipes can be simply stated:
+
+# Tiddlers are stored in named "bags"
+# Bags have access controls that determines which users can read or write to them
+# Recipes are named lists of bags, ordered from lowest priority to highest
+# The tiddlers within a recipe are accumulated in turn from each bag in the recipe in order of increasing priority. Thus, if there are multiple tiddlers with the same title in different bags then the one from the highest priority bag will be used as the recipe tiddler
+# Wikis are composed by splicing the tiddlers from the corresponding recipe into the standard TW5 HTML template
+
+A very simple example of the recipe/bag model might be for a single user who maintains the following bags:
+
+* ''recipes'' - tiddlers related to cooking recipes
+* ''work'' - tiddlers related to work
+* ''app'' - common tiddlers for customising TiddlyWiki
+
+Those bags would be used with the following recipes:
+
+* ''recipes'' --> recipes, app - wiki for working with recipes, with common custom components
+* ''work'' --> work, app - wiki for working with work, with common custom components
+* ''app'' --> app - wiki for maintaining custom components
+
+All of this will work dynamically, so changes to the app bag will instantly ripple into the affected hosted wikis.
+
+A more complex example might be for a teacher working with a group of students:
+
+* ''student-{name}'' bag for each students work
+* ''teacher-course'' bag for the coursework, editable by the teacher
+* ''teacher-tools'' bag for custom tools used by the teacher
+
+Those bags would be exposed through the following hosted wikis:
+
+* ''student-{name}'' hosted wiki for each students work, including the coursework material
+* ''teacher-course'' hosted wiki for the coursework, editable by the teacher
+* ''teacher'' hosted wiki for the teacher, bringing together all the bags, giving them an overview of all the students work
+

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

@@ -1,10 +1,10 @@
 created: 20140216102454178
-modified: 20160617101212889
+modified: 20230803045407958
 tags: Concepts
 title: ColourPalettes
 type: text/vnd.tiddlywiki
 
-A colour palette is a [[data tiddler|DataTiddlers]] that supplies a [[CSS]] colour value, such as ''yellow'' or ''#fe0'', for each of several colour names, like this:
+A colour palette is a [[data tiddler|DataTiddlers]] that supplies a [[CSS|Cascading Style Sheets]] colour value, such as ''yellow'' or ''#fe0'', for each of several colour names, like this:
 
 ```
 page-background: #fe0

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

@@ -0,0 +1,31 @@
+title: CompoundTiddlers
+modified: 20240507221902644
+created: 20240507221902644
+tags: Concepts
+
+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.
+
+The compound tiddler format is extremely simple, and includes the notable flaw that it does not permit tiddlers that contain a plus sign (`+`) on a line by itself. It is not intended as a general purpose way of storing tiddler data.
+
+Compound tiddlers are identified by having their type field set to `text/vnd.tiddlywiki-multiple`.
+
+The content of a compound tiddler consists of a sequence of tiddlers separated by a plus sign (`+`) on a line by itself. Each tiddler uses the same format as [[.tid files|TiddlerFiles]].
+
+For example:
+
+```
+title: First
+tags: one two
+
+This is the first tiddler
++
+title: Second
+tags: three four
+
+This is the second tiddler
++
+title: third
+tags: five six
+
+This is the third tiddler
+```

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

@@ -1,7 +1,7 @@
 created: 20130827080000000
 list: [[Introduction to filter notation]] [[Filter Syntax]]
-modified: 20220316145511797
-tags: Reference Concepts
+modified: 20230710074511095
+tags: Reference Concepts TableOfContents
 title: Filters
 type: text/vnd.tiddlywiki
 
@@ -15,7 +15,7 @@ You can think of TiddlyWiki as a database in which the records are tiddlers. A d
 
 A <<.def filter>> is a concise notation for selecting a particular [[set of tiddlers|Title Selection]], known as its <<.def "output">>. Whenever ~TiddlyWiki encounters a filter, it calculates the output. Further work can then be done with just those tiddlers, such as [[counting|CountWidget]] or [[listing|ListWidget]] them.
 
-The following example passes a filter to the <<.mlink list-links>> macro to display a list of all tiddlers whose titles are <<.olink2 tagged tag>> with the word <<.word Filters>>:
+The following example passes a filter to the <<.mlink list-links>> macro. It displays a list of all tiddlers using the <<.olink2 tag tag>> <<.word Filters>>:
 
 <<wikitext-example-without-html """<<list-links "[tag[Filters]]">>""" >>
 

package/editions/tw5.com/tiddlers/concepts/Hard and Soft Links.tid

@@ -1,10 +1,10 @@
 created: 20150123220237000
-modified: 20150226163104000
+modified: 20240610085736941
 tags: Concepts
 title: Hard and Soft Links
 type: text/vnd.tiddlywiki
 
-A <<.def "hard link">> is one that can be detected by a superficial examination of WikiText.
+A <<.def "hard link">> is a [[link|Linking in WikiText]] that can be detected by a superficial examination of WikiText.
 
 A link is <<.def "soft">> if it is:
 
@@ -13,3 +13,5 @@ A link is <<.def "soft">> if it is:
 * generated by a link widget whose <<.attr to>> attribute is a transclusion, macro or variable
 
 <$macrocall $name=".warning" _="""Soft links are not detected by link-related filter operators such as <<.olink backlinks>>, <<.olink links>>, <<.olink all>> and <<.olink is>>."""/>
+
+This concept is analogous to [[Hard and Soft Transclusions]].

package/editions/tw5.com/tiddlers/concepts/Hard and Soft Transclusions.tid

@@ -0,0 +1,16 @@
+created: 20240610085133221
+modified: 20240610085613037
+tags: Concepts
+title: Hard and Soft Transclusions
+
+A <<.def "hard transclusion">> is a [[transclusion|Transclusion]] that can be detected by a superficial examination of WikiText.
+
+A transclusion is <<.def "soft">> if it is:
+
+* contained in text [[trancluded|Transclusion]] from elsewhere
+* supplied via a [[macro|Macros]], [[procedure|Procedures]] or [[variable|Variables]]
+* generated by a [[transclude widget|TranscludeWidget]] whose <<.attr $tiddler>> attribute is a transclusion, macro or variable
+
+<$macrocall $name=".warning" _="""Soft transclusions are not detected by transclusion-related filter operators <<.olink transcludes>> and <<.olink backtranscludes>>."""/>
+
+This concept is analogous to [[Hard and Soft Links]].

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

@@ -1,5 +1,7 @@
-title: ShadowTiddlers
+created: 20230803052544962
+modified: 20230803052604957
 tags: Concepts
+title: ShadowTiddlers
 
 \define actions()
 <$action-setfield $tiddler="$:/state/tab/moresidebar-1850697562" $field="text" $value="$:/core/ui/MoreSideBar/Shadows"/>
@@ -13,7 +15,7 @@ ShadowTiddlers are tiddlers that are loaded from [[Plugins]] at the wiki startup
 
 !! Overriding Shadow Tiddlers to modify plugins
 
-A ShadowTiddler can be overridden with an ordinary tiddler of the same name. This leaves the shadow tiddler intact but the plugin will use the overriding tiddler in its place, effectively allowing users to modify the behaviour of plugins.
+A [[ShadowTiddler|ShadowTiddlers]] can be overridden with an ordinary tiddler of the same name. This leaves the shadow tiddler intact but the plugin will use the overriding tiddler in its place, effectively allowing users to modify the behaviour of plugins.
 
 Users are cautioned against overriding shadow tiddlers because if the shadow tiddler is changed in a plugin update, the overriding tiddler may no longer perform as intended. To remedy this, the overriding tiddler may be modified or deleted. If the overriding tiddler is deleted, then the plugin falls back to using the original shadow tiddler.
 

package/editions/tw5.com/tiddlers/concepts/Temporary Tiddlers.tid

@@ -0,0 +1,8 @@
+created: 20240202112358997
+modified: 20240202120248326
+tags: Concepts
+title: Temporary Tiddlers
+
+Temporary tiddlers are tiddlers that will be discarded when TiddlyWiki is saved. Under default configuration of the SavingMechanism (more specifically, the filter in [[$:/core/save/all]]), these are tiddlers prefixed with `$:/temp/`. This prefix makes them SystemTiddlers as well.
+
+One example usage of temporary tiddlers is storing the search queries. The query typed in the [[$:/AdvancedSearch]] is stored in [[$:/temp/advancedsearch]].

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

@@ -0,0 +1,26 @@
+title: TestCaseTiddlers
+modified: 20240507221902644
+created: 20240507221902644
+tags: Concepts
+
+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 are formatted as CompoundTiddlers, allowing them to contain multiple tiddlers packed into one.
+
+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 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 |
+
+Test case tiddlers with the appropriate tag are shown in $:/ControlPanel
+
+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 |

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

@@ -1,5 +1,5 @@
 created: 20130827075900000
-modified: 20161216173541948
+modified: 20230321130421587
 tags: Concepts
 title: TextReference
 type: text/vnd.tiddlywiki
@@ -27,7 +27,7 @@ Text references can be used in several places:
 
 * As [[indirect parameters|Filter Parameter]] within [[Filters]] (eg, `<$list filter="[tag{MyTag!!name}]"/>`)
 * As [[indirect attributes|HTML in WikiText]] of an element or widget (eg, `<$widget attrib={{Title!!description}}/>`)
-* As the operand of a shortcut transclusion (eg, `{{MyTiddler!!title}}`)
+* As the parameter of a shortcut transclusion (eg, `{{MyTiddler!!title}}`)
 * As the `state` attribute of the RevealWidget and the LinkCatcherWidget
 
 <$macrocall $name=".tip" _="""Note the distinction between a text reference such as `foo!!bar` and a transclusion of a text reference such as `{{foo!!bar}}`"""/>

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

@@ -1,11 +1,11 @@
 created: 20130825213300000
-modified: 20220109101407050
+modified: 20240520162904479
 tags: Concepts
 title: TiddlerFields
 type: text/vnd.tiddlywiki
 
 \define lingo-base() $:/language/Docs/Fields/
-~TiddlerFields are name:value pairs that make up a [[tiddler|Tiddlers]]. Field names must be lowercase letters, digits or the characters `-` (dash), `_` (underscore) and `.` (period).
+~TiddlerFields are name:value pairs that make up a [[tiddler|Tiddlers]]. Field names may contain any combination of characters (prior to [[v5.2.0|Release 5.2.0]], fields were constrained to be lowercase letters, digits or the characters `-` (dash), `_` (underscore) and `.` (period)).
 
 The standard fields are:
 
@@ -24,7 +24,7 @@ The standard fields are:
 Other fields used by the core are:
 
 |!Field Name |!Description |
-|`class` |<<lingo class>> |
+|`class` |<<.from-version "5.1.16">> <<lingo class>> |
 |`code-body` |<<.from-version "5.2.1">> <<lingo code-body>> |
 |`color` |<<lingo color>> |
 |`description` |<<lingo description>> |
@@ -39,6 +39,7 @@ Other fields used by the core are:
 |`name` |<<lingo name>> |
 |`plugin-priority` |<<lingo plugin-priority>> |
 |`plugin-type` |<<lingo plugin-type>> |
+|`stability` |<<lingo stability>> |
 |`source` |<<lingo source>> |
 |`subtitle` |<<lingo subtitle>> |
 |`throttle.refresh` |<<lingo throttle.refresh>> |

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

@@ -1,9 +1,15 @@
 created: 20141129194651420
-modified: 20141130195444237
-tags: Concepts
+modified: 20240621074019077
+tags: Concepts Definitions
 title: Transclusion
 
-[[Transclusion|https://en.wikipedia.org/wiki/Transclusion]] is the process of referencing one tiddler "A" from another tiddler "B" such that the content of "A" appears to be a part of "B".
+! Definition
+
+<<< Wikipedia: [[Transclusion|https://en.wikipedia.org/wiki/Transclusion]]
+In computer science, transclusion is the inclusion of part or all of an electronic document into one or more other documents by reference via hypertext.
+<<<
+
+In ~TiddlyWiki: ''Transclusion'' is the process of referencing one tiddler "A" from another tiddler "B" such that the content of "A" appears to be a part of "B".
 
 Copying and pasting content creates multiple copies of the same content in several different places. With transclusion, there can be a single copy and a special instruction in "B" which indicates the point at which content should be inserted from tiddler "A".
 
@@ -20,3 +26,4 @@ To learn more:
 * TextReference
 * TemplateTiddlers
 * TranscludeWidget
+* [[Hard and Soft Transclusions]]

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

@@ -1,5 +1,5 @@
 created: 20201123172925848
-modified: 20211126120310891
+modified: 20240627060629394
 tags: [[Customise TiddlyWiki]]
 title: Alternative page layouts
 type: text/vnd.tiddlywiki
@@ -8,8 +8,39 @@ type: text/vnd.tiddlywiki
 
 ! Creating an alternative page layout
 
-Creating an alternative layout goes beyond [[adding or removing features|Page and tiddler layout customisation]] from the default interface and allows you to create an entirely new layout from scratch.
+Creating an alternative layout goes beyond [[adding or removing features|Customising TiddlyWiki's user interface]] from the default interface, which also known as [[standard layout|$:/core/ui/PageTemplate]], and allows you to create an entirely new layout from scratch.
 
 To create an alternative page layout and have the ability to switch to it, you need to create an alternative page template tiddler with the [[SystemTag: $:/tags/Layout]].
 
-This alternative page template can either be a tweaked and modified version of the [[default page template|$:/core/ui/PageTemplate]], or something entirely different. The layout switching mechanism requires that your page template tiddler has the fields `name` and `description`, which are used in the listing in the switching user interface.
+This alternative page template can either be a tweaked and modified version of the [[default page template|$:/core/ui/PageTemplate]], or something entirely different. The layout switching mechanism requires that your page template tiddler has the fields `name` and `description`, which are used in the listing in the switching user interface.
+
+!! Common layout setup
+
+```tid
+\whitespace trim
+\import [subfilter{$:/core/config/GlobalImportFilter}]
+\define containerClasses()
+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>
+\end
+
+<$navigator story="$:/StoryList" history="$:/HistoryList" openLinkFromInsideRiver={{$:/config/Navigation/openLinkFromInsideRiver}} openLinkFromOutsideRiver={{$:/config/Navigation/openLinkFromOutsideRiver}} relinkOnRename={{$:/config/RelinkOnRename}}>
+	<$messagecatcher $tm-navigate=<<redirected-navigate-actions>>>
+		{{$:/core/ui/CommandPaletteTemplate}}
+		<div class=<<containerClasses>>>
+			<!-- Your layout content here -->
+		</div>
+	</$messagecatcher>
+</$navigator>
+```
+
+It includes
+
+# Import macros that is globally available in standard layout, so wikitext that works on standard layout also works on your layout.
+# Define the top-level css class, some style may depends on them. You can add your plugin's name in css class here.
+# Handle navigation when click on links. If your layout does not contains a story view (for example, you are writing a calendar or whiteboard layout), then the combination of `redirected-navigate-actions` `$navigator` and `$messagecatcher` will redirect user back to standard layout, and open the tiddler there.
+# Add some [[PageTemplate|$:/tags/PageTemplate]] back, for example the `$:/core/ui/CommandPaletteTemplate` or `$:/core/ui/PageTemplate/sidebar`, if you want them exist on your layout.

package/editions/tw5.com/tiddlers/customising/Creating new toolbar buttons.tid

@@ -1,5 +1,5 @@
 created: 20211124205415217
-modified: 20211126162937536
+modified: 20230803050345698
 tags: [[Customise TiddlyWiki]]
 title: Creating new toolbar buttons
 type: text/vnd.tiddlywiki
@@ -8,7 +8,7 @@ Let's say you have a skeleton tiddler called 'Recipe template', and you want to
 
 # You will want an image for your button. If none of the core images (shadow tiddlers with the prefix $:/core/images/) work for you, then you will need to create or acquire an SVG image (for example, one of the images at http://flaticon.com), drag it into your file so that it becomes a tiddler, edit the tiddler and adjust the height and width to 22px
 # You will want to create the tiddler that contains your tiddler. Create it, title it, and add the button code (see the code at the bottom of this tiddler for an example, with hints where you will need to adapt it). Tag it [[$:/tags/ViewToolbar]]
-# You will need to create a tiddler that tells TiddlyWiki whether your button should be visible in the toolbar or hidden. Let's title it [[$:/config/ViewToolbarButtons/Visibility/Recipe]]. Type `show` into the text area, and save. If you want to hide it, type `hide` into the text area and save. The button will also be accessable from the ''ControlPanel : Appearance : Toolbars : ViewToolbar'' tab
+# You will need to create a tiddler that tells TiddlyWiki whether your button should be visible in the toolbar or hidden. Let's title it [[$:/config/ViewToolbarButtons/Visibility/Recipe]]. Type `show` into the text area, and save. If you want to hide it, type `hide` into the text area and save. The button will also be accessable from the ''Control Panel : Appearance : Toolbars : View Toolbar'' tab
 # You will want to position the button properly. Open the tiddler $:/tags/ViewToolbar and insert your button tiddler's title in the appropriate place in the list field.
 
 ```

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

@@ -0,0 +1,9 @@
+created: 20230319131443509
+modified: 20230319132235520
+tags: Definitions
+title: Legacy
+type: text/vnd.tiddlywiki
+
+>Legacy code is old computer source code that is no longer supported on the standard hardware and environments, and is a codebase that is in some respect obsolete or supporting something obsolete. Legacy code may be written in programming languages, use frameworks and external libraries, or use architecture and patterns that are no longer considered modern, increasing the mental burden and ramp-up time for software engineers who work on the codebase.
+>
+>https://en.wikipedia.org/wiki/Legacy_system

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

@@ -1,10 +1,12 @@
 created: 20130825161100000
-modified: 20200104111952539
+modified: 20230803051056946
 tags: Definitions
 title: TiddlyFox
 type: text/vnd.tiddlywiki
 
-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 [[Firefox]]. See [[Saving with TiddlyFox]] or [[Saving with TiddlyFox on Android]] for detailed instructions.
+<<.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 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.
 

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

@@ -2,8 +2,9 @@ created: 201308300841
 modified: 20170127221451610
 tags: Definitions
 title: TiddlyWeb
+type: text/vnd.tiddlywiki
 
-TiddlyWeb is a reference implementation for an interface to put [[Tiddlers]] on the web.
+TiddlyWeb is a reference implementation for an interface to put [[Tiddlers]] on the web using the [[Bags and Recipes]] model.
 
 It was created by a team led by Chris Dent at [[Osmosoft]] under [[BT]] from 2008 to 2012. 
 
@@ -16,5 +17,3 @@ 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/definitions/TiddlyWebAdaptor.tid

@@ -0,0 +1,9 @@
+created: 20240309100338678
+modified: 20240309135821423
+tags: Definitions
+title: TiddlyWebAdaptor
+type: text/vnd.tiddlywiki
+
+TiddlyWebAdaptor is a component of [[TiddlyWiki on Node.js]]. It provides the means to synchronise changes to tiddlers from the browser to a server, and from the server to the browser. It can be found in the plugin [[$:/plugins/tiddlywiki/tiddlyweb]].
+
+TiddlyWebAdaptor was designed to be compatible both with TiddlyWeb and with TiddlyWiki's own built-in server mechanism. The [[Bags and Recipes]] model is fully supported by [[TiddlyWeb]], but TiddlyWiki's built-in server only supports a simplified model with a single bag and a single recipe.

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

@@ -0,0 +1,10 @@
+created: 20230803213647552
+modified: 20230803214110365
+tags: Definitions
+title: UnaMesa
+
+<<<
+The UnaMesa Association, a 501(c)(3) non-profit, helps entrepreneurs strengthen communities, improve health, and increase well-being. Located in Palo Alto, CA, we incubate projects such as the Magical Bridge Foundation and ~InPlay that translate technology into better social services and new ways of connecting within and across communities. Our overarching goal is to work with networks of social enterprises to develop shared technologies and frameworks for appropriately valuing interactions and relationships in healthcare, education, social services and related domains that recieve short shrift in today's transaction based marketplace. In our view, the purpose of "impact accounting" should be to drive innovations in health, education, social services by making visible which opportunities and experiences are most meaningful in the lives of individuals and families.
+<<<
+
+[[UnaMesa|https://unamesa.org/]] holds the intellectual property rights in TiddlyWiki for the benefit of the community, ensuring that it always remains available under the present permissive license. It has supported the TiddlyWiki open source project since 2006.

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

@@ -1,8 +1,8 @@
+caption: list
 created: 20130830092500000
-modified: 20150124202924000
+modified: 20230803052727464
 tags: Fields
 title: ListField
-caption: list
 type: text/vnd.tiddlywiki
 
 The `list` [[field of a tiddler|TiddlerFields]] is an optional feature that can be used to help structure your content. Its value is a [[title list|Title List]], and it can be used in several ways:
@@ -10,4 +10,4 @@ The `list` [[field of a tiddler|TiddlerFields]] is an optional feature that can
 * The `list` field of a tiddler that is being used as a tag determines the ordering of the tiddlers that carry that tag - see [[Tagging]] for details
 * The `list` [[filter|Filters]] selects the entries from a list
 * The `listed` [[filter|Filters]] selects the tiddlers that list the selected tiddler(s)
-* The NavigatorWidget manipulates a StoryList tiddler containing a `list` field of the tiddlers that are displayed in the main story column
+* The NavigatorWidget manipulates a [[StoryList|$:/StoryList]] tiddler containing a `list` field of the tiddlers that are displayed in the main story column

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

@@ -1,10 +1,10 @@
 created: 20190802113703788
-modified: 20230501175143648
+modified: 20230711082337975
 tags: Filters
 title: Conditional Operators
 type: text/vnd.tiddlywiki
 
-<<.from-version "5.1.20">>The conditional filter operators allow for ''if-then-else'' logic to be expressed within filters.
+<<.from-version "5.1.20">> The conditional filter operators allow ''if-then-else'' logic to be expressed within filters.
 
 The foundation is the convention that an empty list can be used to represent the Boolean value <<.value false>> and a list with at one (or more) entries to represent <<.value true>>.
 
@@ -25,6 +25,8 @@ The <<.olink else>> operator can be used to apply a defaults for missing values.
 
 <<.operator-example 2 "[[HelloThere]get[custom-field]else[default-value]]">>
 
-! Filter Run Prefixes
+''Filter Run Prefixes''
 
-The [[:then|:then Filter Run Prefix]] and [[:else|:else Filter Run Prefix]] filter run prefixes serve a similar purpose as the conditional operators.  Refer to their documentation for more information.
+The [[:then|Then Filter Run Prefix]] and [[:else|Else Filter Run Prefix]] named filter run prefixes serve a similar purpose as the conditional operators. 
+
+Also see: [[Named Filter Run Prefix]]

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

@@ -1,5 +1,6 @@
+breadcrumbs: [[Filter Step]]
 created: 20140410103123179
-modified: 20211217141224284
+modified: 20230410114132501
 tags: Filters
 title: Filter Operators
 type: text/vnd.tiddlywiki
@@ -18,13 +19,19 @@ type: text/vnd.tiddlywiki
 <tr class="doc-table-subheading"><th colspan="5" align="center">$_$</th></tr>
 \end
 
-A <<.def "filter operator">> is a predefined keyword attached to an individual [[step|Filter Step]] of a [[filter|Filters]]. It defines the particular action of that step.
+A <<.def "filter operator">> is a predefined keyword attached to an individual step of a [[filter|Filters]]. It defines the particular action of that step.
 
-''Important:'' Each first [[step|Filter Step]] of a [[filter run|Filter Run]] not given any input titles receives the output of <$link to="all Operator">[all[tiddlers]]</$link> as its input.
+''Important:'' In general, each first [[filter step|Filter Step]] of a [[filter run|Filter Run]] not given any input titles receives the output of <$link to="all Operator">[all[tiddlers]]</$link> as its input.
 
-The following table lists all core operators, the most common ones marked ✓. The `!` column indicates whether an operator allows ''negation'' using the <$link to="Filter Step"><code>!</code> prefix</$link>. For specifics as to each operator's negated output please refer to its documentation. 
 
-Most steps process the [[selection of titles|Title Selection]] that are supplied as their input, but a few [[construct an entirely new selection|Selection Constructors]] instead, as indicated by the last column. A `C?` indicates it might construct a new selection, depending on usage. For specifics as to each operator's selection creation please refer to its documentation. 
+''Table legend:''
+
+|tc-table-no-border tc-first-col-min-width|k
+|^ ✓|^... |,Used to mark the most common ones |
+|^ `!`|^... |,The column indicates whether an operator allows ''negation'' using the <$link to="Filter Step"><code>!</code> prefix</$link>.<br>For specifics as to each operator's negated output please refer to its documentation |
+|^ `C`|^... |,Most steps process the [[selection of titles|Title Selection]] that are supplied as their input, but a few [[construct an entirely new selection|Selection Constructors]] instead, as indicated by the last column.<br>A `C?` indicates it might construct a new selection, depending on usage. For specifics as to each operator's selection creation please refer to its documentation |
+
+The following table lists all core operators:
 
 <table>
 <tr>
@@ -49,6 +56,6 @@ Most steps process the [[selection of titles|Title Selection]] that are supplied
 <<.operator-rows "[tag[Filter Operators]!tag[Order Operators]!tag[Mathematics Operators]!tag[String Operators]!tag[Tag Operators]tag[Special Operators]sort[]]">>
 </table>
 
-A typical step is written as `[operator[parameter]]`, although not all of the operators need a [[parameter|Filter Parameter]]. 
+A typical step is written as `[operator[parameter]]`, although not all of the operators need a [[parameter|Filter Parameter]].
 
 For the exact rules, see [[Filter Syntax]].

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

@@ -1,5 +1,5 @@
 created: 20190206140446821
-modified: 20220330133748666
+modified: 20230321133008898
 tags: Filters
 title: Mathematics Operators
 type: text/vnd.tiddlywiki
@@ -22,7 +22,7 @@ The mathematics operators take three different forms:
 ** <<.inline-operator-example "=1 =2 =3 =4 +[negate[]]">>
 ** <<.inline-operator-example "=1.2 =2.4 =3.6 =4.8 +[trunc[]]">>
 ** <<.inline-operator-example "=1.2 =2.4 =3.6 =4.8 +[round[]]">>
-* ''Binary operators'' apply an operation and operand to each number in the input list (e.g. add, multiply, remainder) 
+* ''Binary operators'' apply an operation and parameter to each number in the input list (e.g. add, multiply, remainder) 
 ** <<.inline-operator-example "=1 =2 =3 =4 +[add[3]]">>
 ** <<.inline-operator-example "=1 =2 =3 =4 +[multiply[8]]">>
 * ''Reducing operators'' apply an operation to all of the numbers in the input list, returning a single result (e.g. sum, product)

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

@@ -1,11 +1,11 @@
 caption: add
 created: 20190206140446821
-modified: 20190611125053329
+modified: 20230321130647487
 op-input: a [[selection of titles|Title Selection]]
 op-output: the input as numbers, but with <<.place N>> added to each one
 op-parameter: a number
 op-parameter-name: N
-op-purpose: treating each input title as a number, add to each the numeric value of the operand
+op-purpose: treating each input title as a number, add to each the numeric value of the parameter
 tags: [[Filter Operators]] [[Mathematics Operators]] [[Binary Mathematics Operators]]
 title: add Operator
 type: text/vnd.tiddlywiki

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

@@ -1,6 +1,6 @@
 caption: all
 created: 20140410103123179
-modified: 20211217135719266
+modified: 20230321131457669
 op-input: ignored, unless the parameter is empty
 op-output: the titles that belong to all the specified categories
 op-parameter: zero or more categories
@@ -9,10 +9,14 @@ tags: [[Filter Operators]] [[Common Operators]] [[Selection Constructors]] [[Sel
 title: all Operator
 type: text/vnd.tiddlywiki
 
-The parameter specifies zero or more fundamental categories using the following syntax:
+The parameter specifies zero or more fundamental categories using the following [[filter step|Filter Step]] syntax:
 
 <$railroad text="""
-[{: ("current" | "missing" |: "orphans" | "shadows" | "tags" | "tiddlers" ) +"+" }]
+\start none
+\end none
+<-"all"->  (  "[" | "<" | "{"  )
+   [{: ("current" | "missing" |: "orphans" | "shadows" | "tags" | "tiddlers" ) +"+" }] 
+   (  "]" | ">" | "}"  )
 """/>
 
 |!Category |!Members |!Sorted |
@@ -25,7 +29,7 @@ The parameter specifies zero or more fundamental categories using the following
 
 If the parameter specifies more than one category, they are processed from left to right. The overall output is initially empty, and each category's output is [[dominantly appended|Dominant Append]] to it in turn. Unrecognised categories contribute nothing to the output.
 
-As a special case, if the parameter is empty, the output is simply a copy of the input. This can be useful when the parameter is [[soft|Filter Parameter]].
+As a special case, if the parameter is empty, the output is simply a copy of the input. This can be useful when the parameter is a [[soft parameter|Filter Parameter]].
 
 The <<.olink is>> operator is similar, but its scope is restricted to its input.
 

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

@@ -1,9 +1,9 @@
 caption: append
 created: 20151017145358368
-modified: 20151108051540981
+modified: 20230321131631510
 op-input: a list of items
-op-neg-output: a list with items appended from the tail of the operand array
-op-output: a list with items appended from the head of the operand array
+op-neg-output: a list with items appended from the tail of the parameter array
+op-output: a list with items appended from the head of the parameter array
 op-parameter: the array of items to be appended to the tail of the list
 op-parameter-name: list
 op-purpose: append a range of items from an array to the list

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

@@ -0,0 +1,14 @@
+caption: backtranscludes
+created: 20211002204500000
+modified: 20240610085949413
+op-input: a [[selection of titles|Title Selection]]
+op-output: any non-[[system|SystemTiddlers]] titles that [[hard-transclude|Hard and Soft Transclusions]] the input titles
+op-parameter: none
+op-purpose: find the titles that transclude each input title
+tags: [[Filter Operators]]
+title: backtranscludes Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version 5.3.4>> Each input title is processed in turn. The corresponding tiddler's list of backtransclusions is generated, sorted alphabetically by title, and then [[dominantly appended|Dominant Append]] to the operator's overall output. Analogous to [[backlinks|backlinks Operator]].
+
+<<.operator-examples "backtranscludes">>

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

@@ -2,7 +2,7 @@ caption: charcode
 created: 20210622214425635
 modified: 20210622214425635
 op-input: ignored
-op-output: a string formed from concatenating the characters specified by the numeric codes given in the operand(s)
+op-output: a string formed from concatenating the characters specified by the numeric codes given in the parameter(s)
 op-parameter: numeric character code
 op-parameter-name: C
 op-purpose: generates string characters from their numeric character codes
@@ -12,6 +12,6 @@ type: text/vnd.tiddlywiki
 
 <<.from-version "5.2.0">>
 
-This operator returns a string formed from concatenating the characters specified by the numeric codes given in one or more operands. It is useful for generating special characters such as tab (`charcode[9]`) or new line (`charcode[13],[10]`).
+This operator returns a string formed from concatenating the characters specified by the numeric codes given in one or more parameters. It is useful for generating special characters such as tab (`charcode[9]`) or new line (`charcode[13],[10]`).
 
 <<.operator-examples "charcode">>