tiddlywiki 5.1.21 → 5.2.1

package/editions/tw5.com/tiddlers/demonstrations/Tasks/task.tid

@@ -1,7 +1,8 @@
 color: #8d9ac3
-created: 201308252132
+created: 20130825213200000
 list: [[Make the beds]]
-modified: 201606011653
+modified: 20211115013121643
+tags: TaskManagementExample
 title: task
 
 //This tag identifies the tasks for the TaskManagementExample//

package/editions/tw5.com/tiddlers/demonstrations/Weekdays/Days of the Week.tid

@@ -1,10 +1,11 @@
 created: 20150117192110000
-modified: 20150123214636000
-title: Days of the Week
-type: text/vnd.tiddlywiki
 list: Monday Tuesday Wednesday Thursday Friday Saturday Sunday
-short: Mon Tue Wed Thu Fri Sat Sun
+modified: 20211116221246915
 my-special-list: [[listed Operator (Examples)]]
+short: Mon Tue Wed Thu Fri Sat Sun
+tags: [[Operator Examples]]
+title: Days of the Week
+type: text/vnd.tiddlywiki
 
 <<.this-is-operator-example>>
 

package/editions/tw5.com/tiddlers/demonstrations/Weekdays/Friday.tid

@@ -1,5 +1,6 @@
 created: 20150117192111000
-modified: 20150118131534000
+modified: 20211116221111294
+tags: [[Operator Examples]]
 title: Friday
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/demonstrations/Weekdays/Monday.tid

@@ -1,5 +1,6 @@
 created: 20150117192113000
-modified: 20150118131645000
+modified: 20211116221111294
+tags: [[Operator Examples]]
 title: Monday
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/demonstrations/Weekdays/Saturday.tid

@@ -1,5 +1,6 @@
-created: 20151620490000000
-modified: 20150118131537000
+created: 20150422010000000
+modified: 20211116221111294
+tags: [[Operator Examples]]
 title: Saturday
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/demonstrations/Weekdays/Sunday.tid

@@ -1,5 +1,6 @@
 created: 20150117192115000
-modified: 20150118131539000
+modified: 20211116220736572
+tags: [[Operator Examples]]
 title: Sunday
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/demonstrations/Weekdays/Thursday.tid

@@ -1,5 +1,6 @@
 created: 20150117192116000
-modified: 20150124204253000
+modified: 20211116221111295
+tags: [[Operator Examples]]
 title: Thursday
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/demonstrations/Weekdays/Tuesday.tid

@@ -1,5 +1,6 @@
 created: 20150117192118000
-modified: 20150118131558000
+modified: 20211116221111295
+tags: [[Operator Examples]]
 title: Tuesday
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/demonstrations/Weekdays/Wednesday.tid

@@ -1,5 +1,6 @@
 created: 20150117192119000
-modified: 20150118131707000
+modified: 20211116221111295
+tags: [[Operator Examples]]
 title: Wednesday
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/demonstrations/sampletag1.tid

@@ -1,3 +1,6 @@
+created: 20211117214646420
+modified: 20211117214650773
+tags: [[Widget Examples]]
 title: sampletag1
 
 This is `sampletag1`.

package/editions/tw5.com/tiddlers/demonstrations/sampletag2.tid

@@ -1,3 +1,6 @@
+created: 20211117214707647
+modified: 20211117214716137
+tags: [[Widget Examples]]
 title: sampletag2
 
 This is `sampletag2`.

package/editions/tw5.com/tiddlers/features/AutoSave.tid

@@ -4,8 +4,8 @@ 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 {{$:/core/images/done-button}} ''ok'' or {{$:/core/images/delete-button}} ''delete'' when editing a tiddler.
+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.
 
 You should see a yellow notification at the top right of the window to confirm that an automatic save has taken place.
 
-Automatic saving can be enabled or disabled through the ''Settings'' tab of the [[control panel|$:/ControlPanel]] {{$:/core/images/options-button}}. Behind the scenes, it is controlled through the configuration tiddler [[$:/config/AutoSave]], which must have the value ''yes'' to enable automatic saving.
+Automatic saving can be enabled or disabled through the ''Settings'' tab of the [[control panel|$:/ControlPanel]] <<.icon $:/core/images/options-button>>. Behind the scenes, it is controlled through the configuration tiddler [[$:/config/AutoSave]], which must have the value ''yes'' to enable automatic saving.

package/editions/tw5.com/tiddlers/features/DateFormat.tid

@@ -1,14 +1,23 @@
 created: 20140418142957325
-modified: 20180730201626985
+modified: 20210912115121622
 tags: Features
 title: DateFormat
 type: text/vnd.tiddlywiki
 
-When used to display date values (with the `format` attribute set to ''date''), the ViewWidget accepts a `template` attribute that allows the format of the date values to be specified. The format string is processed with the following substitutions:
+The default representation of dates is a compact string such as `20211002153802059`. For example, the `created` and `modified` fields are stored like this. 
+
+The display format for this string can be controlled with a template. For example, transcluding the `modified` field automatically applies a template to display the date as `Sat Oct 02 2021 17:40:50 GMT+0200 (Central European Summer Time)`. A few widgets and filter operators allow you to manually specify a template, for example the ViewWidget:
+
+`<$view field=modified format=date template=“DDth mmm YYYY 0hh:0mm:0ss” />`
+
+The date string is processed with the following substitutions:
 
 |!Token |!Substituted Value |
+|`ddddd` |<<.from-version "5.2.0">> Day of year (1 to 365, or 366 for leap years) |
+|`0ddddd` |<<.from-version "5.2.0">> Zero padded day of year (001 to 365, or 366 for leap years) |
 |`DDD` |Day of week in full (eg, "Monday") |
 |`ddd` |Short day of week (eg, "Mon") |
+|`dddd` |<<.from-version "5.2.0">> Weekday number from 1 through 7, beginning with Monday and ending with Sunday |
 |`DD` |Day of month |
 |`0DD` |Adds a leading zero |
 |`DDth` |Adds a suffix |
@@ -21,7 +30,9 @@ When used to display date values (with the `format` attribute set to ''date''),
 |`YYYY` |Full year |
 |`YY` |Two digit year |
 |`wYYYY` |Full year with respect to week number |
+|`aYYYY` |<<.from-version "5.1.23">> Full year but negative dates are displayed as positive |
 |`wYY` |Two digit year with respect to week number |
+|`{era:BCE||CE}` |<<.from-version "5.1.23">> Displays a different string for years that are negative, zero or positive (see below) |
 |`hh` |Hours |
 |`0hh` |Adds a leading zero |
 |`hh12` |Hours in 12 hour clock |
@@ -40,6 +51,8 @@ When used to display date values (with the `format` attribute set to ''date''),
 
 Note that other text is passed through unchanged, allowing commas, colons or other separators to be used.
 
+The `{era:BCE||CE}` notation can specify different strings for years that are negative, zero or positive. For example `{era:BC|Z|AD}` would display `BC` for negative years, `AD` for positive years, and `Z` for year zero.
+
 ! Examples
 
 |!Template |!Output |

package/editions/tw5.com/tiddlers/features/Importing Tiddlers.tid

@@ -8,10 +8,10 @@ You can import tiddlers into a ~TiddlyWiki from external files or directly from
 
 !! Importing content from external files
 
-There are several ways to import content from external files:
+There are several ways to import content (including text, images, pdf documents, etc.) from external files:
 
-* Use the {{$:/core/images/import-button}} ''import'' button (under the ''Tools'' tab in the sidebar) to select a local file
-* Drag and drop files from Windows Explorer or OS X Finder etc. into the TiddlyWiki browser window
+* Use the <<.icon $:/core/images/import-button>> ''import'' button (under the ''Tools'' tab in the sidebar) to select a local file
+* Drag and drop files from Windows Explorer or OS X Finder etc. into the ~TiddlyWiki browser window
 * Paste content directly from the clipboard using the menu or keyboard shortcut (<kbd>ctrl-V</kbd> or <kbd>cmd-V</kbd>)
 ** Currently supported in Chrome, Firefox and Edge (but not Internet Explorer)
 

package/editions/tw5.com/tiddlers/features/LazyLoading.tid

@@ -1,5 +1,5 @@
 created: 20140206214608586
-modified: 20180701185417525
+modified: 20211009145417525
 tags: Features
 title: LazyLoading
 type: text/vnd.tiddlywiki
@@ -11,7 +11,7 @@ Lazy loading can be used in two configurations:
 * When running [[TiddlyWiki on Node.js]], just image tiddlers or all non-system tiddlers can be subject to lazy loading
 * When running [[TiddlyWiki in the Sky for TiddlyWeb]], all tiddlers are subject to lazy loading
 
-See the LazyLoadingMechanism for details of how lazy loading is implemented.
+See the [[Lazy Loading Mechanism|https://tiddlywiki.com/dev/#LazyLoadingMechanism]] for details of how lazy loading is implemented.
 
 ! Lazy loading under Node.js
 
@@ -28,4 +28,3 @@ To apply lazy loading to all non-system tiddlers use this command:
 ```
 tiddlywiki --listen root-tiddler=$:/core/save/lazy-all
 ```
-

package/editions/tw5.com/tiddlers/features/Modals.tid

@@ -1,11 +1,20 @@
 created: 20160107225427489
-modified: 20160107225651558
+modified: 20201117081054556
 tags: Features
 title: Modals
 type: text/vnd.tiddlywiki
 
 Modals (or "wizards") fade the main TiddlyWiki window to display an isolated tiddler that must be explicitly dismissed by the user.
 
+The tiddler to be displayed can contain the following optional fields that are used to customize the modal:
+
+|!Field |!Description |
+|footer|The footer text for the modal|
+|subtitle|The subtitle text for a modal, displayed in a `h3` html tag|
+|class|An additional class to apply to the modal wrapper|
+
+Note that the footer and subtitle fields are not limited to plain text, and wiki text features such as widgets and transclusions can be used as well.
+
 Modals are displayed with the [[WidgetMessage: tm-modal]].
 
-<$button message="tm-modal" param="SampleWizard">Open demo modal</$button>
+<$button message="tm-modal" param="SampleWizard">Open demo modal</$button>

package/editions/tw5.com/tiddlers/features/Performance Instrumentation.tid

@@ -18,11 +18,11 @@ The information above should be interpreted as follows:
 
 * mainRender is the time taken for the initial display of the page template
 * styleRefresh is the time taken to refresh the page stylesheet
-* mainRender is the time taken to refresh the main page template
+* mainRefresh is the time taken to refresh the main page template
 
 As an example, try switching between the sidebar tabs to compare how long they take to render.
 
-More detailed information on filter execution timings is also available. With performance instrumentation enabled, ype the following JavaScript command in the browser developer console:
+More detailed information on filter execution timings is also available. With performance instrumentation enabled, type the following JavaScript command in the browser developer console:
 
 ```
 $tw.perf.log()

package/editions/tw5.com/tiddlers/features/SafeMode.tid

@@ -1,5 +1,5 @@
 created: 20140419082845576
-modified: 20160610082458079
+modified: 20190912093109517
 tags: Features
 title: SafeMode
 type: text/vnd.tiddlywiki
@@ -8,6 +8,8 @@ type: text/vnd.tiddlywiki
 
 Safe mode provides a way to disabling most customisations in TiddlyWiki. This is useful because if TiddlyWiki is customised incorrectly it can be rendered inoperable. A particular issue is that some customisations break when upgrading to a newer core version of TiddlyWiki (especially during the beta).
 
+<<.warning "Safe mode should only be used with the single file configuration of TiddlyWiki, and then only with savers that do not autosave. Using safe mode in the client server configuration can lead to data loss.">>
+
 ! Enabling Safe Mode
 
 Safe mode is enabled in the browser by starting TiddlyWiki with the URL hash set to the string `#:safe`. For example:
@@ -18,7 +20,7 @@ https://tiddlywiki.com/#:safe
 
 Safe mode triggers two changes:
 
-* All plugins are temporarily disabled. You can use the [[control panel|$:/ControlPanel]] {{$:/core/images/options-button}} to disable individual plugins
+* All plugins are temporarily disabled. You can use the [[control panel|$:/ControlPanel]] <<.icon $:/core/images/options-button>> to disable individual plugins
 * Any tiddlers that override shadow tiddlers are renamed to give them the prefix `SAFE: `, thus restoring the underlying shadow tiddler
 * Certain configuration options are ignored, and the default settings used instead:
 ** WikiParserRuleConfiguration

package/editions/tw5.com/tiddlers/features/Scalability.tid

@@ -1,7 +1,9 @@
 created: 20130822173400000
-modified: 20140912145800365
+modified: 20211124215615812
 tags: Features
 title: Scalability
 type: text/vnd.tiddlywiki
 
-You might expect that TiddlyWiki's architecture as a SinglePageApplication would make it unsuitable for large amounts of data. In fact, TiddlyWiki users regularly work with files that are 20 or 30 megabytes without problems - and successful experiments have been done up into the gigabytes.
+You might expect that TiddlyWiki's architecture as a SinglePageApplication would make it unsuitable for large amounts of data. In fact, TiddlyWiki users regularly work with files that are tens or even over a hundred megabytes without problems - and successful experiments have been done up into the gigabytes.
+
+See [[performance tips|Performance]] for large wikis.

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

@@ -14,7 +14,7 @@ Typing text into the search box in the sidebar will turn up a list of all the ti
 
 ! Advanced searching
 
-Clicking on the magnifying glass icon {{$:/core/images/advanced-search-button}} to the right of the search box will open [[$:/AdvancedSearch]]. This tiddler contains four tabs:
+Clicking on the magnifying glass icon <<.icon $:/core/images/advanced-search-button>> to the right of the search box will open [[$:/AdvancedSearch]]. This tiddler contains four tabs:
 
 * The ''standard'' tab contains another instance of the search box found in the sidebar
 * The ''system'' tab allows you to limit your search to system tiddlers

package/editions/tw5.com/tiddlers/features/StartupActions.tid

@@ -1,16 +1,21 @@
 created: 20180323092308399
-modified: 20190307183936035
+modified: 20201025161723719
 tags: Features
 title: StartupActions
 type: text/vnd.tiddlywiki
 
 TiddlyWiki executes any ActionWidgets found in tiddlers with the following system tags during startup:
 
-* <<tag "$:/tags/StartupAction">> (executed on all platforms)
-* <<tag "$:/tags/StartupAction/Browser">> (only executed when running in the browser)
-* <<tag "$:/tags/StartupAction/Node">> (only executed when running under Node.js)
+* Executed during initial startup:
+** <<tag "$:/tags/StartupAction">> (executed on all platforms)
+** <<tag "$:/tags/StartupAction/Browser">> (only executed when running in the browser)
+** <<tag "$:/tags/StartupAction/Node">> (only executed when running under Node.js)
+* Executed after startup rendering:
+** <<.from-version "5.1.23">> <<tag "$:/tags/StartupAction/PostRender">> (only executed when running in the browser)
 
-Startup actions are useful for customising TiddlyWiki according to environmental factors such as the screen size. For example, the following action widgets when placed in a tiddler tagged `$:/tags/StartupAction/Browser` will cause the sidebar to be hidden by default when the screen width is less than 1000 pixels:
+!! Initial Startup Actions
+
+The initial startup actions are useful for customising TiddlyWiki according to environmental factors such as the screen size. For example, the following action widgets when placed in a tiddler tagged `$:/tags/StartupAction/Browser` will cause the sidebar to be hidden by default when the screen width is less than 1000 pixels:
 
 ```
 <$reveal type="lt" state="$:/info/browser/screen/width" text="3000">
@@ -28,8 +33,12 @@ Startup actions are useful for customising TiddlyWiki according to environmental
 <$action-setfield $tiddler="$:/language" text={{{ [[$:/languages/en-GB]] [plugin-type[language]sort[description]removeprefix[$:/languages/]] +[prefix{$:/info/browser/language}] ~[[en-GB]] +[addprefix[$:/languages/]] }}}/>
 ```
 
-Note that global macros are not available within startup action tiddlers by default. If you need to access them then you'll need to explicitly include them with an ''import'' [[pragma|Pragma]] at the top of the tiddler:
+Note that global macros are not available within initial startup action tiddlers by default. If you need to access them then you'll need to explicitly include them with an ''import'' [[pragma|Pragma]] at the top of the tiddler:
 
 ```
 \import [[$:/core/ui/PageMacros]] [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of]]
 ```
+
+!! Post-Render Startup Actions
+
+<<.from-version "5.1.23">> Post-render startup actions occur after the TiddlyWiki user interface has been rendered. This makes it possible to perform actions that depend on the rendered display (such as displaying modals).

package/editions/tw5.com/tiddlers/fileformats/TiddlerFiles.tid

@@ -1,5 +1,5 @@
 created: 20130825150000000
-modified: 20190609154450433
+modified: 20210714130751701
 tags: [[TiddlyWiki on Node.js]]
 title: TiddlerFiles
 type: text/vnd.tiddlywiki
@@ -78,11 +78,22 @@ The ContentType `application/json` is used internally for these files.
 
 Note that JSON files that do not conform to the tiddler structure will instead be imported as a single tiddler containing the JSON data.
 
-!! TiddlyWiki HTML files
+!! New JSON-based format for TiddlyWiki HTML files
 
-TiddlyWiki HTML files contain a collection of tiddlers encoded in `<DIV>` format.
+The new format for TiddlyWiki HTML files embeds the tiddlers in JSON format within a script tag:
 
-For TiddlyWiki to import an unencrypted HTML file, it requires a `<div id="storeArea">` containing tiddler DIVs as explained above. For example:
+```json
+<script class="tiddlywiki-tiddler-store" type="application/json">[
+{"title": "A","text": "One"},
+{"title": "B","text": "Two"}
+]</script>
+```
+
+!! Old DIV-based format for TiddlyWiki HTML files
+
+TiddlyWiki Classic and TiddlyWiki 5 prior to version v5.2.0 stored tiddlers encoded in `<DIV>` format.
+
+For TiddlyWiki to import an unencrypted DIV-based HTML file, it requires a `<div id="storeArea">` containing tiddler DIVs as explained above. For example:
 
 ```
 <div id="storeArea">

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

@@ -1,12 +1,12 @@
 created: 20140410103123179
-modified: 20190206140446821
+modified: 20210830010231559
 tags: Filters
 title: Filter Operators
 type: text/vnd.tiddlywiki
 
 \define .operator-rows(filter)
 <$list filter="$filter$"><tr>
-<td><$link to={{!!title}}>{{!!caption}}</$link></td>
+<td><$link>{{!!caption}}</$link></td>
 <td>{{!!op-purpose}}</td>
 <td align="center"><$list filter="[all[current]tag[Common Operators]]">✓</$list></td>
 <td align="center"><$list filter="[all[current]tag[Negatable Operators]]">`!`</$list></td>
@@ -36,9 +36,9 @@ The following table lists all core operators, the most common ones marked ✓. T
 <<.group-heading "Listops Operators">>
 <<.operator-rows "[tag[Filter Operators]tag[Listops Operators]tag[Order Operators]!tag[Mathematics Operators]!tag[String Operators]!tag[Tag Operators]!tag[Special Operators]sort[]]">>
 <<.group-heading "String Operators">>
-<<.operator-rows "[tag[Filter Operators]!tag[Order Operators]!tag[Mathematics Operators]tag[String Operators]!tag[Tag Operators]!tag[Special Operators]sort[]]">>
+<<.operator-rows "[tag[Filter Operators]!tag[Order Operators]tag[String Operators]!tag[Tag Operators]!tag[Special Operators]sort[]]">>
 <<.group-heading "Mathematics Operators">>
-<<.operator-rows "[tag[Filter Operators]!tag[Order Operators]tag[Mathematics Operators]!tag[String Operators]!tag[Tag Operators]!tag[Special Operators]sort[]]">>
+<<.operator-rows "[tag[Filter Operators]!tag[Order Operators]tag[Mathematics Operators]!tag[Tag Operators]!tag[Special Operators]sort[]]">>
 <<.group-heading "Tag Operators">>
 <<.operator-rows "[tag[Filter Operators]!tag[Order Operators]!tag[Mathematics Operators]!tag[String Operators]tag[Tag Operators]!tag[Special Operators]sort[]]">>
 <<.group-heading "Special Operators">>

package/editions/tw5.com/tiddlers/filters/Introduction to filter notation.tid

@@ -1,5 +1,5 @@
 created: 20140410101941871
-modified: 20150228104558000
+modified: 20201103111438568
 tags: Learning Filters
 title: Introduction to filter notation
 type: text/vnd.tiddlywiki
@@ -72,16 +72,23 @@ In a similar way, we can use a `-` sign to <<.em remove>> a run's tiddlers from
 
 !Special parameters
 
-The parameter of each step we've seen so far has been in square brackets, meaning that ~TiddlyWiki treats it literally. But two other kinds of bracket are possible:
+The parameter of each step we've seen so far has been in square brackets. It means that ~TiddlyWiki will filter for the exact string found between the brackets. But two other kinds of bracket are possible:
 
-<<.def "Curly brackets">> `{}` mean that the parameter is a TextReference, and that its value is to be looked up in a specified tiddler. For example, if we have a tiddler called <<.tid Preference>> whose text happens to be the word <<.value Vegetarian>>, we can say
+<<.def "Curly brackets">> `{}` mean that the parameter is a TextReference, and it will be replaced with content from another tiddler. For example, if we have a tiddler with the title <<.tid Preference>> whose content is the single word <<.value Vegetarian>>, we can say
 
 > `[tag{Preference}]`
 
-as an alternative to `[tag[Vegetarian]]`. This allows the preference to change over time.
+In this simplest form the TextReference will take the full content of the tiddler (in technical terms, the text field of the tiddler) and substitute it in place of the TextReference. This way the tiddler's content will become the filter parameter, just like if you have written `[tag[Vegetarian]]`. But it gives you the added flexibility to change the parameter by changing the content of the Preference tiddler.
 
 <<.def "Angle brackets">> `<>` mean that the parameter is the name of a [[variable|Variables]] whose value is to be used instead. Here we use the built-in <<.vlink currentTiddler>> variable in a filter that selects any tiddlers whose text contains the title of the current one:
 
 > `[search<currentTiddler>]`
 
 Note that these special brackets cannot be nested. It is not possible for example to write `[search{<currentTiddler>}]`.
+
+!Multiple parameters
+
+<<.from-version "5.1.23">> Some steps accept multiple parameters which are separated by a ` , ` character.
+
+> Example: `[param1],[param2]` or `<param1>,{param2}`
+

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

@@ -1,5 +1,5 @@
 created: 20190206140446821
-modified: 20190611155838557
+modified: 20210417090408263
 tags: Filters
 title: Mathematics Operators
 type: text/vnd.tiddlywiki
@@ -26,6 +26,7 @@ The mathematics operators take three different forms:
 * ''Reducing operators'' apply an operation to all of the numbers in the input list, returning a single result (e.g. sum, product)
 ** <<.inline-operator-example "=1 =2 =3 =4 +[sum[]]">>
 ** <<.inline-operator-example "=1 =2 =3 =4 +[product[]]">>
+** <<.inline-operator-example "=1 =2 =3 =4 +[average[]]">>
 
 Operators can be combined:
 

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

@@ -0,0 +1,15 @@
+caption: acos
+created: 20211019211936842
+modified: 20211021222835888
+op-input: a [[selection of titles|Title Selection]]
+op-output: the arccosine (in radians) of the input numbers
+op-purpose: calculate the arccosine value (in radians) of a list of numbers
+tags: [[Filter Operators]] [[Mathematics Operators]] [[Trigonometric Operators]] [[Unary Mathematics Operators]]
+title: acos Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.21">> See [[Mathematics Operators]] for an overview.
+
+<<.tip " This is the inverse operation of [[cos|cos Operator]]: cos calculate the cosine of an angle (in radian), but acos calculate the angle (in radian) of a cosine.">>
+
+<<.operator-examples "acos">>

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

@@ -0,0 +1,15 @@
+caption: asin
+created: 20211019212120548
+modified: 20211021222841479
+op-input: a [[selection of titles|Title Selection]]
+op-output: the arcsine (in radians) of the input numbers
+op-purpose: calculate the arcsine value (in radians) of a list of numbers
+tags: [[Filter Operators]] [[Mathematics Operators]] [[Trigonometric Operators]] [[Unary Mathematics Operators]]
+title: asin Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.21">> See [[Mathematics Operators]] for an overview.
+
+<<.tip " This is the inverse operation of [[sin|sin Operator]]: sin calculate the sine of an angle (in radian), but asin calculate the angle (in radian) of a sine.">>
+
+<<.operator-examples "asin">>

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

@@ -0,0 +1,13 @@
+caption: atan
+created: 20211019211516128
+modified: 20211021222847610
+op-input: a [[selection of titles|Title Selection]]
+op-output: the arctangent (in radians) of the input numbers
+op-purpose: calculate the arctangent value (in radians) of a list of numbers
+tags: [[Filter Operators]] [[Mathematics Operators]] [[Trigonometric Operators]] [[Unary Mathematics Operators]]
+title: atan Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.21">> See [[Mathematics Operators]] for an overview.
+
+<<.operator-examples "atan">>

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

@@ -0,0 +1,15 @@
+caption: atan2
+created: 20211019222810994
+modified: 20211021222853123
+op-input: a [[selection of titles|Title Selection]] = coordinate Y (<<.place Y>>)
+op-output: the angle in radians (in [ - π , π ] ) between the positive x-axis and the ray from (0,0) to the point (x,y)
+op-parameter: coordinate X
+op-parameter-name: X
+op-purpose: returns the angle in the plane (in radians) between the positive x-axis and the ray from (0,0) to the point (x,y), for [<<.place Y>>]atan2[<<.place X>>]
+tags: [[Filter Operators]] [[Mathematics Operators]] [[Binary Mathematics Operators]] [[Trigonometric Operators]]
+title: atan2 Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.21">> See [[Mathematics Operators]] for an overview.
+
+<<.operator-examples "atan2">>

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

@@ -0,0 +1,13 @@
+caption: average
+created: 20210417090137714
+modified: 20210426131553482
+op-input: a [[selection of titles|Title Selection]]
+op-output: the arithmetic mean of the input as numbers
+op-purpose: treating each input title as a number, compute their arithmetic mean
+tags: [[Reducing Mathematics Operators]] [[Filter Operators]] [[Mathematics Operators]]
+title: average Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.0">> See [[Mathematics Operators]] for an overview.
+
+<<.operator-examples "average">>

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

@@ -0,0 +1,17 @@
+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-parameter: numeric character code
+op-parameter-name: C
+op-purpose: generates string characters from their numeric character codes
+tags: [[Filter Operators]]
+title: charcode Operator
+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]`).
+
+<<.operator-examples "charcode">>

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

@@ -0,0 +1,51 @@
+created: 20200412181551706
+modified: 20200412181551706
+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 operand
+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.
+
+The <<.op compare>> operator uses an extended syntax to specify all the options:
+
+```
+[compare:<type>:<mode>[<operand>]]
+```
+
+The ''type'' can be:
+
+* "number" - invalid numbers are interpreted as zero
+* "integer" - invalid integers are interpreted as zero
+* "string"
+* "date" - invalid dates are interpreted as 1st January 1970
+* "version" - invalid versions are interpreted as "v0.0.0"
+
+The ''mode'' can be:
+
+* "eq" - equal to
+* "ne" - not equal to
+* "gteq" - greater than or equal to
+* "gt" - greater than
+* "lteq" - less than or equal to
+* "lt" - less than
+
+The operator compares each item in the selection against the value of the parameter, retaining only those items that pass the specified condition.
+
+For example:
+
+```
+[[2]compare:number:eq[3]] returns nothing
+[[2]compare:number:lt[3]] returns "2"
+[[2]compare:number: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]`.
+
+<<.operator-examples "compare">>

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

@@ -7,7 +7,7 @@ op-output: those input tiddlers in which the list field <<.place F>> contains th
 op-parameter: a possible value to be found in list field <<.place F>>
 op-parameter-name: S
 op-purpose: filter the input by searching list fields for a value
-op-suffix: the name of a [[field|TiddlerFields]]
+op-suffix: the name of a [[field|TiddlerFields]] (defaults to `list`)
 op-suffix-name: F
 tags: [[Filter Operators]] [[Field Operators]] [[Negatable Operators]]
 title: contains Operator

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

@@ -0,0 +1,13 @@
+caption: cos
+created: 20211019211007324
+modified: 20211021222900121
+op-input: a [[selection of titles|Title Selection]]
+op-output: the cosine of the input angles (numeric value between -1 and 1)
+op-purpose: calculate the cosine value of a list of angles (given in radians)
+tags: [[Filter Operators]] [[Mathematics Operators]] [[Trigonometric Operators]] [[Unary Mathematics Operators]]
+title: cos Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.21">> See [[Mathematics Operators]] for an overview.
+
+<<.operator-examples "cos">>