npm - tiddlywiki - Versions diffs - 5.3.2 → 5.3.4 - Mend

tiddlywiki 5.3.2 → 5.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (906) hide show

package/editions/tw5.com/tiddlers/testcases/DataWidget/ImportedFilter.tid ADDED Viewed

@@ -0,0 +1,49 @@
+title: TestCases/DataWidget/ImportedFilter
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+description: Imported filter definition
+display-format: plaintext
+title: Narrative
+Using the data widget to create copies of all the tiddlers with the title prefix "Day: T", adding the field "custom" set to "Beta"
++
+title: Output
+<$data $filter="[prefix[Day: T]]" custom="Beta"/>
++
+title: Day: Monday
+text: Today is Monday
++
+title: Day: Tuesday
+text: Today is Tuesday
++
+title: Day: Wednesday
+text: Today is Wednesday
++
+title: Day: Thursday
+text: Today is Thursday
++
+title: Day: Friday
+text: Today is Friday
++
+title: Day: Saturday
+text: Today is Saturday
++
+title: Day: Sunday
+text: Today is Sunday
++
+title: ExpectedResult
+<p>[
+    {
+        "title": "Day: Thursday",
+        "text": "Today is Thursday",
+        "custom": "Beta"
+    },
+    {
+        "title": "Day: Tuesday",
+        "text": "Today is Tuesday",
+        "custom": "Beta"
+    }
+]</p>

package/editions/tw5.com/tiddlers/testcases/DataWidget/ImportedTiddler.tid ADDED Viewed

@@ -0,0 +1,29 @@
+title: TestCases/DataWidget/ImportedTiddler
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+description: Imported tiddler definition
+display-format: plaintext
+title: Narrative
+Using the data widget to create a tiddler that is a copy of the tiddler "Hello" with the addition of the field "custom" set to "Alpha"
++
+title: Output
+<$data $tiddler="Hello" custom="Alpha"/>
++
+title: Hello
+modifier: JoeBloggs
+This is the Hello tiddler
++
+title: ExpectedResult
+<p>[
+    {
+        "title": "Hello",
+        "modifier": "JoeBloggs",
+        "text": "This is the Hello tiddler",
+        "custom": "Alpha"
+    }
+]</p>

package/editions/tw5.com/tiddlers/testcases/DataWidget/Refreshing.tid ADDED Viewed

@@ -0,0 +1,30 @@
+title: TestCases/DataWidget/Refreshing
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+description: Refreshing the data widget
+display-format: plaintext
+title: Narrative
+Verifying that the JSON output of the data widget is correctly refreshed when the data changes
++
+title: Output
+<$data title="Epsilon" text={{Subject}}/>
++
+title: Subject
+Nothing
++
+title: Actions
+<$action-setfield $tiddler="Subject" text="Theta"/>
++
+title: ExpectedResult
+<p>[
+    {
+        "title": "Epsilon",
+        "text": "Theta"
+    }
+]</p>

package/editions/tw5.com/tiddlers/testcases/DataWidget/SimpleTiddler.tid ADDED Viewed

@@ -0,0 +1,22 @@
+title: TestCases/DataWidget/SimpleTiddler
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+description: Simple tiddler definition
+display-format: plaintext
+title: Narrative
+Using the data widget to create a tiddler with the title "Epsilon" and the text "Theta"
++
+title: Output
+<$data title="Epsilon" text="Theta"/>
++
+title: ExpectedResult
+<p>[
+    {
+        "title": "Epsilon",
+        "text": "Theta"
+    }
+]</p>

package/editions/tw5.com/tiddlers/testcases/TestCaseWidget/FailingTest.tid ADDED Viewed

@@ -0,0 +1,15 @@
+title: TestCases/TestCaseWidget/FailingTest
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec-failing]]
+description: An example of a failing test
+title: Narrative
+This test case intentionally fails (in order to show how failures are displayed). The expected result is set to <code><$text text={{ExpectedResult}}/></code>, but the result computes to <code><$wikify name="html" text={{Output}} mode="block" output="html"><$text text=<<html>>/></$wikify></code>
++
+title: Output
+The sum is <$text text={{{ [[2]add[2]] }}}/>.
++
+title: ExpectedResult
+text: <p>The sum is not 8.</p>

package/editions/tw5.com/tiddlers/testcases/TestCaseWidget/NoExpectedResults.tid ADDED Viewed

@@ -0,0 +1,12 @@
+title: TestCases/TestCaseWidget/NoExpectedResults
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+description: A testcase that does not specify expected results
+title: Narrative
+This testcase will display without the pass/fail icons because it does not include an `ExpectedResults` tiddler, and so will only be rendered, and not be executed as a test
++
+title: Output
+This is the output

package/editions/tw5.com/tiddlers/testcases/TestCaseWidget/TwoPlusTwo.tid ADDED Viewed

@@ -0,0 +1,18 @@
+title: TestCases/TestCaseWidget/TwoPlusTwo
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec-failing]]
+description: A testcase to calculate 2+2
+title: Narrative
+This test case shows an elaborate way to calculate 2+2 involving multiple tiddlers
++
+title: Output
+The sum is <$text text={{{ [{FirstNumber}add{SecondNumber}] }}}/>
++
+title: FirstNumber
+text: 2
++
+title: SecondNumber
+text: 2

package/editions/tw5.com/tiddlers/testcases/TestCaseWidget/currentTiddler.tid ADDED Viewed

@@ -0,0 +1,16 @@
+description: currentTiddler should be properly set
+tags: $:/tags/wiki-test-spec
+title: TestCases/TestCaseTiddler/currentTiddler
+type: text/vnd.tiddlywiki-multiple
+title: Narrative
+currentTiddler variable in Output tiddler should be "Output"
++
+title: Output
+<$text text=<<currentTiddler>>>
++
+title: ExpectedResult
+<p>Output</p>

package/editions/tw5.com/tiddlers/testcases/TranscludeWidget/SimpleTransclusion.tid ADDED Viewed

@@ -0,0 +1,23 @@
+title: TestCases/TranscludeWidget/SimpleTransclusion
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+description: Simple transclusion
+title: Narrative
+This test case demonstrates transclusion of and links to other tiddlers.
++
+title: Output
+Good morning, my [[name|Name]] is {{Name}} and I [[live in|Address]] {{Address}}
++
+title: Name
+Robert Rabbit
++
+title: Address
+14 Carrot Street, Vegetabletown
++
+title: ExpectedResult
+text: <p>Good morning, my <a class="tc-tiddlylink tc-tiddlylink-resolves" href="#Name">name</a> is Robert Rabbit and I <a class="tc-tiddlylink tc-tiddlylink-resolves" href="#Address">live in</a> 14 Carrot Street, Vegetabletown</p>

package/editions/tw5.com/tiddlers/variables/Variables.tid CHANGED Viewed

@@ -6,11 +6,12 @@ type: text/vnd.tiddlywiki
 !! Introduction
-A <<.def variable>> is a snippet of text that can be accessed by name. The text is referred to as the variable's <<.def value>>.
+* A <<.def variable>> is a ''snippet of text'' that can be accessed by name.
+* The text is referred to as the variable's <<.def value>>.
-Variables are defined by [[widgets|Widgets]]. Several core widgets define variables, the most common being the <<.wlink SetWidget>>, <<.wlink LetWidget>> and <<.wlink ListWidget>> widgets.
+Variables are defined by [[widgets|Widgets]]. Several core widgets define variables, the most common being the <<.wlink LetWidget>>, <<.wlink SetWidget>> and <<.wlink ListWidget>> widgets.
-The values of variables are available to descendant widgets, including transcluded content. For example, within each tiddler in the main story river the variable "currentTiddler" is set to the title of the tiddler.
+The values of variables are available to descendant widgets, including transcluded content. For example, within each tiddler in the main story river the variable <<.var currentTiddler>> is set to the title of the tiddler.
 Variables can also be overwritten by descendent widgets defining variables of the same name, thus binding a different snippet to that name for the scope of the children of the widget.

package/editions/tw5.com/tiddlers/variables/examples/tv-get-export-image-link.tid CHANGED Viewed

@@ -1,11 +1,17 @@
 created: 20150228124038000
+modified: 20240310134432122
 tags: [[tv-get-export-image-link Variable]] [[Variable Examples]]
 title: tv-get-export-image-link Variable (Examples)
 type: text/vnd.tiddlywiki
-This example fetches [[the TiddlyWiki icon|https://www.tiddlywiki.com/favicon.ico]]:
+This example fetches [[the TiddlyWiki icon|https://www.tiddlywiki.com/favicon.ico]]
 <$importvariables filter="$:/editions/tw5.com/macro-examples/tv-get-export-image-link">
 <$codeblock code={{$:/editions/tw5.com/macro-examples/tv-get-export-image-link}}/>
 <$macrocall $name=".example" n="1" eg="""[img[favicon.ico]]"""/>
 </$importvariables>
+Also see:
+* [[substitute Operator]]
+* [[Substituted Attribute Values]]

package/editions/tw5.com/tiddlers/variables/tv-filter-export-link Variable.tid CHANGED Viewed

@@ -7,8 +7,6 @@ type: text/vnd.tiddlywiki
 <<.from-version "5.1.15">> The <<.def tv-filter-export-link>> [[variable|Variables]] controls the value of the `href` attribute on the HTML `a` element generated by the <<.wlink LinkWidget>> widget. If defined, it takes precedence over the [[tv-wikilink-template Variable]].
-<<.this-is-static-link-variable>>
 The variable is treated as a filter that is given the target tiddler title as input. The filter is evaluated and the first result is used as the `href` attribute.
 For example:
@@ -18,3 +16,5 @@ For example:
 ```
 See also the <<.vlink tv-get-export-link>> variable, which dominates over this one.
+<<.this-is-static-link-variable>>

package/editions/tw5.com/tiddlers/variables/tv-get-export-image-link.tid CHANGED Viewed

@@ -1,13 +1,13 @@
+caption: tv-get-export-image-link
 created: 20150228122257000
-modified: 20150228130940000
-title: tv-get-export-image-link Variable
+modified: 20240310133708578
 tags: Variables [[Core Variables]] [[Configuration Variables]]
+title: tv-get-export-image-link Variable
 type: text/vnd.tiddlywiki
-caption: tv-get-export-image-link
 The <<.def tv-get-export-image-link>> [[variable|Variables]] controls the value of the `src` attribute on the HTML `img` element generated by the <<.wlink ImageWidget>> widget when the value of its `source` attribute is not the title of a tiddler.
-The variable should be a [[macro|Macros]] with the following parameter:
+The variable should be a [[function|Functions]] with the following parameter:
 ;src
 : The value of the `source` attribute -- equivalent to the image name specified in <$link to="Images in WikiText">the shorthand syntax</$link> `[img[source]]`

package/editions/tw5.com/tiddlers/variables/tv-get-export-link.tid CHANGED Viewed

@@ -1,17 +1,17 @@
+caption: tv-get-export-link
 created: 20150228114004000
 modified: 20150228130943000
-title: tv-get-export-link Variable
 tags: Variables [[Core Variables]] [[Configuration Variables]]
+title: tv-get-export-link Variable
 type: text/vnd.tiddlywiki
-caption: tv-get-export-link
 The <<.def tv-get-export-link>> [[variable|Variables]] controls the value of the `href` attribute on the HTML `a` element generated by the <<.wlink LinkWidget>> widget.
-<<.this-is-static-link-variable>>
 The variable should be a [[macro|Macros]] with the following parameter:
 ;to
 : The title of the target tiddler of the link, with no escaping
 See also <<.vlink tv-wikilink-template>>. If both that variable and this one exist, this one dominates.
+<<.this-is-static-link-variable>>

package/editions/tw5.com/tiddlers/variables/tv-wikilink-template.tid CHANGED Viewed

@@ -7,8 +7,6 @@ type: text/vnd.tiddlywiki
 The <<.def tv-wikilink-template>> [[variable|Variables]] controls the value of the `href` attribute on the HTML `a` element generated by the <<.wlink LinkWidget>> widget. The <<.vlink tv-filter-export-link>>, if defined, it takes precedence over the <<.vlink tv-wikilink-template>> variable.
-<<.this-is-static-link-variable>>
 The variable is treated as if it was a [[macro|Macros]] with the following parameters:
 ;uri_encoded
@@ -21,3 +19,5 @@ The variable is treated as if it was a [[macro|Macros]] with the following param
 The variable defaults to `#$uri_encoded$`.
 See also the <<.vlink tv-get-export-link>> variable, which dominates over this one.
+<<.this-is-static-link-variable>>

package/editions/tw5.com/tiddlers/webserver/Using the external JavaScript template.tid CHANGED Viewed

@@ -1,5 +1,5 @@
 created: 20180905075846391
-modified: 20230319130830880
+modified: 20240413045138914
 tags: [[WebServer Guides]]
 title: Using the external JavaScript template
 type: text/vnd.tiddlywiki
@@ -20,7 +20,7 @@ The remaining inefficiency when working in the client server configuration is th
 ! Using the external ~JavaScript template with the client-server configuration
-The mechanism is activated by setting the [[root-tiddler|WebServer Parameter: root-tiddler]] parameter to `$:/core/save/all-external-js`. This template externalises ~TiddlyWiki's core ~JavaScript into a separate file. For example, the following command will start your server with caching enabled. It will transfer the wiki with two GET requests, and the core can be cached by the browser.
+The mechanism is activated by setting the [[root-tiddler|WebServer Parameter: root-tiddler]] parameter to `$:/core/save/all-external-js`. This template externalises ~TiddlyWiki's core ~JavaScript into a separate file. For example, the following command will [[start your server with caching enabled|WebServer Parameter: use-browser-cache]]. It will transfer the wiki with two GET requests, and the core can be cached by the browser.
 ```
 tiddlywiki YOUR_WIKI_FOLDER --listen 'root-tiddler=$:/core/save/all-external-js' use-browser-cache=yes

package/editions/tw5.com/tiddlers/webserver/Using the integrated static file server.tid CHANGED Viewed

@@ -1,5 +1,5 @@
 created: 20180703095630828
-modified: 20180703100445719
+modified: 20240413045124764
 tags: [[WebServer Guides]]
 title: Using the integrated static file server
 type: text/vnd.tiddlywiki
@@ -13,4 +13,19 @@ Static files can be referenced directly:
 * `[ext[./files/a-big-document.pdf]]` - to make a link to a PDF
 * `[img[./files/a-big-image.png]]` - to embed an image
-Alternatively, the ''_canonical_uri'' field can be used to reference the files as [[external tiddlers|ExternalImages]].
+Alternatively, the ''_canonical_uri'' field can be used to reference the files as [[external tiddlers|ExternalImages]].
+If [[WebServer Parameter: use-browser-cache]] is used, these files will be cached by the client's browser to save on bandwidth. In this case, the `cache busting strategy` can be used to make sure the client always has the latest updated files.
+<<<
+https://javascript.plainenglish.io/what-is-cache-busting-55366b3ac022
+!! Cache Busting
+There are a couple different ways of changing the names of files so that they will load when they change. One way is to use version numbers and have them somewhere in the file name when loading. You could have a subdirectory for every version, `v1/index.js` `v2/index.css` . You could also have the version in queries in the URLs, `index.js?v1` , `index.css?v2` .
+Another way is to change the name of the file, `index.v1.js` , `index.v2.css` . These ways are not as manageable because this can become very hard once you have a ton of files that are being changed.
+A more popular and manageable way is to keep hashes inside the file names. Hashes, if you don’t know, are fixed length character representations of any content and they are irreversible, meaning you can get the hash from the file but you can’t get the file from the hash. Hashes are perfect for this, because when a file changes its hash will change, so if we keep the hash inside the filename `index.[someHashHere].js` browsers will detect it and load it instead of an old file.
+<<<

package/editions/tw5.com/tiddlers/webserver/WebServer Parameter_ use-browse-cache.tid ADDED Viewed

@@ -0,0 +1,25 @@
+caption: use-browse-cache
+created: 20240413042652008
+modified: 20240413050841387
+tags: [[WebServer Parameters]]
+title: WebServer Parameter: use-browser-cache
+type: text/vnd.tiddlywiki
+The [[web server configuration parameter|WebServer Parameters]] ''use-browser-cache=yes'' activates 200 OK browser caching via the `Cache-Control` header and a smart a Etag header:
+* The server javascript creates an MD5 `hash` object.
+* Adds the data of the current `request:response` (for example: json text or an image binary) to the hash object.
+* Adds the current `headers` of the response to the hash object.
+* If the response data has an `encoding` value, adds the encoding to the hash object.
+* Calculates the final MD5 hash string as a `contentDigest` javascript variable, and saves it as an `Etag: "<<contentDigest>>"` header.
+If the incoming request contains a header named `if-none-match`, then the server will check the generated Etag against all values.
+If any `if-none-match` value DOES match the current Etag, the server will send a `304 NOT MODIFIED` response with the current response headers, instead of the data with a `200 OK` response.
+This saves bandwidth, as the client can be sure they have already received the exact data and has it in their current cache.
+If ''use-browser-cache=no'' (or any other value including null), then the server will return a `Cache-Control: no-store` header by default.
+If any customer server route module defines custom `Cache-Control` header behavior, then the server will pass that header through instead of the default.

package/editions/tw5.com/tiddlers/webserver/WebServer.tid CHANGED Viewed

@@ -1,5 +1,5 @@
 created: 20180626150526207
-modified: 20181216181934282
+modified: 20240413043741157
 tags: ListenCommand ServerCommand Features
 title: WebServer
 type: text/vnd.tiddlywiki

package/editions/tw5.com/tiddlers/widgets/ActionDeleteFieldWidget.tid CHANGED Viewed

@@ -1,6 +1,6 @@
 caption: action-deletefield
 created: 20141025120850184
-modified: 20150220162042000
+modified: 20240608151322035
 tags: Widgets ActionWidgets
 title: ActionDeleteFieldWidget
 type: text/vnd.tiddlywiki
@@ -16,30 +16,61 @@ The ''action-deletefield'' widget is invisible. Any content within it is ignored
 |!Attribute |!Description |
 |$tiddler |The title of the tiddler whose fields are to be modified (if not provided defaults to the [[current tiddler|Current Tiddler]]) |
 |$field |Optional name of a field to delete |
+|$timestamp |<<.from-version "5.3.4">> Specifies whether the timestamp(s) of the target tiddler will be updated (''modified'' and ''modifier'', plus ''created'' and ''creator'' for newly created tiddlers). Can be "yes" (the default) or "no" |
 |//{any attributes not starting with $}// |Each attribute name specifies a field to be deleted. The attribute value is ignored and need not be specified |
 ! Examples
-Here is an example of a button that deletes the caption and tags fields of the current tiddler:
+<$testcase>
+<$data title=Description text="Delete currentTiddler fields using plain attributes"/>
+<$data title=Narrative text="""Use the $action-deletefield widget to delete the "caption" and "tags" fields of the current tiddler"""/>
+<$data title=Output caption="A caption" tags="tag1 tag2 tag3" text="""Click
+<$button actions="<$action-deletefield caption tags/>">
+Delete
+</$button>
+and watch the "caption" and "tags" field disappear."""/>
+</$testcase>
-<$macrocall $name='wikitext-example-without-html'
-src='<$button>
-<$action-deletefield caption tags/>
-Delete "caption" and "tags"
-</$button>'/>
+<$testcase>
+<$data title=Description text="Delete fields from a specific tiddler"/>
+<$data title=Narrative text="""Use the $action-deletefield widget to delete the "list" and "tags" fields of the tiddler ~HelloThere"""/>
+<$data $tiddler="HelloThere"/>
+<$data title=Output text="""Click HelloThere, then click
+<$button actions='<$action-deletefield $tiddler="HelloThere" list tags/>'>
+Delete
+</$button>
+and watch the "list" and "tags" fields disappear"""/>
+</$testcase>
-Here is an example of a button that deletes the modified date and tags fields of the tiddler HelloThere:
+<$testcase>
+<$data title=Description text="Delete field from a specific tiddler"/>
+<$data title=Narrative text="""Use the $field attribute of the $action-deletefield widget to delete the "text" field of the tiddler ~HelloThere"""/>
+<$data $tiddler="HelloThere"/>
+<$data title=Output text="""Click HelloThere, then click
+<$button actions='<$action-deletefield $tiddler="HelloThere" $field="text"/>'>
+Delete
+</$button>
+and watch the contents of the "text" field disappear"""/>
+</$testcase>
-<$macrocall $name='wikitext-example-without-html'
-src='<$button>
-<$action-deletefield $tiddler="HelloThere" modified tags/>
-Delete "modified" and "tags" from ~HelloThere
-</$button>'/>
+<$testcase>
+<$data title=Description text="Delete a variable field name"/>
+<$data title=Narrative text="""Use the $field attribute of the $action-deletefield widget to delete a variable field name"""/>
+<$data title=Output description="This field will be deleted" text="""<$let fieldName=description>
+Click
+<$button actions="<$action-deletefield $field=<<fieldName>>/>">
+Delete
+</$button>
+and watch the "<<fieldName>>" field disappear."""/>
+</$let>
+</$testcase>
-Here is an example of a button that uses the optional $field attribute to delete the text field of the tiddler HelloThere:
-<$macrocall $name='wikitext-example-without-html'
-src='<$button>
-<$action-deletefield $tiddler="HelloThere" $field="text"/>
-Delete text from ~HelloThere
-</$button>'/>
+<$testcase>
+<$data title=Description text="Delete field without updating timestamps"/>
+<$data title=Narrative text="""Use the $timestamp attribute of the $action-deletefield widget to prevent creation/change of "modified" and "created" fields"""/>
+<$data title=Output description="This field will be deleted" text="""Click
+<$button actions='<$action-deletefield $field="description" $timestamp="no"/>'>
+Delete
+</$button>
+and watch the "description" field disappear without the "modified" and "created" fields getting added"""/>
+</$testcase>

package/editions/tw5.com/tiddlers/widgets/ActionDeleteTiddlerWidget.tid CHANGED Viewed

@@ -1,6 +1,6 @@
 caption: action-deletetiddler
 created: 20141025120850184
-modified: 20141106173455527
+modified: 20240608152211834
 tags: Widgets ActionWidgets
 title: ActionDeleteTiddlerWidget
 type: text/vnd.tiddlywiki
@@ -25,18 +25,20 @@ The ''action-deletetiddler'' widget is invisible. Any content within it is ignor
 ! Examples
-Here is an example of a button that deletes the tiddler HelloThere:
-<$macrocall $name='wikitext-example-without-html'
-src='<$button>
-<$action-deletetiddler $tiddler="HelloThere"/>
+<$testcase>
+<$data title=Description text="Delete a specific tiddler"/>
+<$data title=Narrative text="""Use the $tiddler attribute of the $action-deletefield widget to delete the "~HelloThere" tiddler"""/>
+<$data $tiddler="HelloThere"/>
+<$data title=Output text="""<$button actions="<$action-deletetiddler $tiddler=HelloThere/>">
 Delete "~HelloThere"
-</$button>'/>
-Here is an example of a button that deletes all tiddlers tagged [[TableOfContents]]:
-<$macrocall $name='wikitext-example-without-html'
-src='<$button>
-<$action-deletetiddler $filter="[tag[TableOfContents]]"/>
+</$button>"""/>
+</$testcase>
+<$testcase>
+<$data title=Description text="Delete tiddlers matching a filter"/>
+<$data title=Narrative text="""Use the $filter attribute of the $action-deletefield widget to delete all tiddlers tagged "~TableOfContents" """/>
+<$data $filter="[tag[TableOfContents]]"/>
+<$data title=Output text="""<$button actions='<$action-deletetiddler $filter="[tag[TableOfContents]]"/>'>
 Delete tiddlers tagged "~TableOfContents"
-</$button>'/>
+</$button>"""/>
+</$testcase>

package/editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid CHANGED Viewed

@@ -1,6 +1,6 @@
 caption: action-listops
 created: 20141025120850184
-modified: 20230805103548113
+modified: 20240509135041526
 myfield:
 tags: ActionWidgets Widgets
 title: ActionListopsWidget
@@ -35,10 +35,12 @@ The above widget will toggle the presence of the element <<.value "List Item">>
 Similarly, if an element is to always be removed when it is present, the `-` / `:except` [[filter run prefix|Filter Expression]] can be used. Both of the following yield the same result:
 ```
-<$action-listops $subfilter="-[[List Item]]"/>
-<$action-listops $subfilter="+[remove[List Item]]"/>
+<$action-listops $subfilter="-[[ListItem]]"/>
+<$action-listops $subfilter="+[remove[ListItem]]"/>
 ```
+<<.infoBox """Note that the parameter of the [[remove Operator]] is a [[Title List]]. To remove one or more titles containing spaces the individual titles must be wrapped in double square brackets, usually via a soft [[Filter Parameter]]. See //Filtered List Variable Assignment// in the [[SetWidget]] documentation to learn more.""">>
 Without any prefixes, the filter run output is simply [[dominantly appended|Dominant Append]] to the list.
 See also the [[Examples|ActionListopsWidget (Examples)]].

package/editions/tw5.com/tiddlers/widgets/DataWidget.tid ADDED Viewed

@@ -0,0 +1,42 @@
+caption: data
+created: 20240507221902644
+modified: 20240507221902644
+tags: Widgets
+title: DataWidget
+type: text/vnd.tiddlywiki
+! Introduction
+The data widget is used with the <<.wlink TestCaseWidget>> widget and the [[Innerwiki Plugin]] to specify payload tiddlers that are to be included in the test case or innerwiki.
+! Content and Attributes
+The content of the data widget is ignored. It supports the following attributes:
+|!Attribute |!Description |
+|<<.attr $tiddler>> |Optional title of a tiddler to be used as a payload tiddler (optional) |
+|<<.attr $filter>> |Optional filter string identifying tiddlers to be used as payload tiddlers (optional) |
+|<<.attr $compound-tiddler>> |Optional title of a tiddler containing payload tiddlers in `text/vnd.tiddlywiki-multiple` format (see below) |
+|//any attribute<br>not starting<br>with $// |Field values to be assigned to the payload tiddler(s) |
+The data widget is not rendered when used within the <<.wlink TestCaseWidget>> widget or the [[Innerwiki Plugin]] but for ease of testing, when used elsewhere it renders a JSON representation of the payload tiddlers.
+Without any of the attributes <<.attr $tiddler>>, <<.attr $filter>> or <<.attr $compound-tiddler>>, any attributes whose name does not start with $ are used as the field values for creating a single new tiddler.
+<<testcase "TestCases/DataWidget/SimpleTiddler">>
+If any of the attributes <<.attr $tiddler>>, <<.attr $filter>> or <<.attr $compound-tiddler>> are specified then they are used to generate base tiddlers that are then modified with the addition of fields derived from any attributes whose name does not start with $.
+The attribute <<.attr $tiddler>> is used to ingest a single tiddler from the wiki containing the data widget:
+<<testcase "TestCases/DataWidget/ImportedTiddler">>
+The attribute <<.attr $filter>> is used to ingest multiple tiddlers from the wiki containing the data widget:
+<<testcase "TestCases/DataWidget/ImportedFilter">>
+! Compound Tiddlers
+[[Compound tiddlers|CompoundTiddlers]] provide a way to easily create multiple tiddlers from within a single tiddler. They are contained in tiddlers of type `text/vnd.tiddlywiki-multiple`. The text field consists of a series of tiddlers in the same format as `.tid` files, each separated by a line containing a single `+` character.
+<<testcase "TestCases/DataWidget/ImportCompound">>

package/editions/tw5.com/tiddlers/widgets/EncryptWidget.tid CHANGED Viewed

@@ -1,12 +1,12 @@
-title: EncryptWidget
-created: 201310241419
-modified: 201310300837
-tags: Widgets
 caption: encrypt
+created: 20131024141900000
+modified: 20230803050114889
+tags: Widgets
+title: EncryptWidget
 ! Introduction
-The encrypt widget renders a filtered list of tiddlers to an encrypted block with the password currently held in the PasswordVault. The encrypted block can subsequently be decrypted by the TiddlyWiki5 BootMechanism. See the EncryptionMechanism for more details.
+The encrypt widget renders a filtered list of tiddlers to an encrypted block with the password currently held in the PasswordVault. The encrypted block can subsequently be decrypted by the TiddlyWiki5 BootMechanism. See the [[EncryptionMechanism|Encryption]] for more details.
 ! Content and Attributes