tiddlywiki 5.3.8 → 5.4.0

package/editions/tw5.com/tiddlers/css-variables/--tp-body-font-size Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-body-font-size
+created: 20260122111308483
+modified: 20260130045633904
+tags: [[Core CSS Variables]]
+title: --tp-body-font-size CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-body-font-size` CSS variable represents the "Font size for tiddler body" setting in Theme Tweaks.

package/editions/tw5.com/tiddlers/css-variables/--tp-body-line-height Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-body-line-height
+created: 20260122111249446
+modified: 20260130045720240
+tags: [[Core CSS Variables]]
+title: --tp-body-line-height CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-body-line-height` CSS variable represents the "Line height for tiddler body" setting in Theme Tweaks.

package/editions/tw5.com/tiddlers/css-variables/--tp-code-font-family Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-code-font-family
+created: 20260122110850673
+modified: 20260130045333134
+tags: [[Core CSS Variables]]
+title: --tp-code-font-family CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-code-font-family` CSS variable represents the "Code font family" setting in Theme Tweaks.

package/editions/tw5.com/tiddlers/css-variables/--tp-code-wrapping Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-code-wrapping
+created: 20260122110618231
+modified: 20260130045345387
+tags: [[Core CSS Variables]]
+title: --tp-code-wrapping CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-code-wrapping` CSS variable represents the "Wrap long lines in code blocks" setting in Theme Tweaks. Its value is `pre` when the setting is set to "No", and `pre-wrap` when set to "Yes".

package/editions/tw5.com/tiddlers/css-variables/--tp-editor-font-family Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-editor-font-family
+created: 20260122110858791
+modified: 20260130045422071
+tags: [[Core CSS Variables]]
+title: --tp-editor-font-family CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-editor-font-family` CSS variable represents the "Editor font family" setting in Theme Tweaks.

package/editions/tw5.com/tiddlers/css-variables/--tp-font-family Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-font-family
+created: 20260122110741282
+modified: 20260130045301357
+tags: [[Core CSS Variables]]
+title: --tp-font-family CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-font-family` CSS variable represents the "Font family" setting in Theme Tweaks.

package/editions/tw5.com/tiddlers/css-variables/--tp-font-size Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-font-size
+created: 20260122110956954
+modified: 20260130045455466
+tags: [[Core CSS Variables]]
+title: --tp-font-size CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-font-size` CSS variable represents the "Font size" setting in Theme Tweaks.

package/editions/tw5.com/tiddlers/css-variables/--tp-line-height Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-line-height
+created: 20260122111115266
+modified: 20260130045757204
+tags: [[Core CSS Variables]]
+title: --tp-line-height CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-line-height` CSS variable represents the "Line height" setting in Theme Tweaks.

package/editions/tw5.com/tiddlers/css-variables/--tp-sidebar-breakpoint CSS Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-sidebar-breakpoint
+created: 20260130065756457
+modified: 20260130065841355
+tags: [[Core CSS Variables]]
+title: --tp-sidebar-breakpoint CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-sidebar-breakpoint` CSS variable represents the minimum page width at which the story river and sidebar will appear side by side.

package/editions/tw5.com/tiddlers/css-variables/--tp-sidebar-width CSS Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-sidebar-width
+created: 20260130065850825
+modified: 20260130065925595
+tags: [[Core CSS Variables]]
+title: --tp-sidebar-width CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-sidebar-width` CSS variable represents the width of the sidebar in fluid-fixed layout.

package/editions/tw5.com/tiddlers/css-variables/--tp-story-left CSS Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-story-left
+created: 20260130065252380
+modified: 20260130065342364
+tags: [[Core CSS Variables]]
+title: --tp-story-left CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-story-left` CSS variable represents how far the left margin of the story river (tiddler area) is from the left of the page.

package/editions/tw5.com/tiddlers/css-variables/--tp-story-right CSS Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-story-right
+created: 20260130065417448
+modified: 20260130065457358
+tags: [[Core CSS Variables]]
+title: --tp-story-right CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-story-right` CSS variable represents how far the left margin of the sidebar is from the left of the page.

package/editions/tw5.com/tiddlers/css-variables/--tp-story-top CSS Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-story-top
+created: 20260130065351753
+modified: 20260130065451132
+tags: [[Core CSS Variables]]
+title: --tp-story-top CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-story-top` CSS variable represents how far the top margin of the story river is from the top of the page.

package/editions/tw5.com/tiddlers/css-variables/--tp-story-width CSS Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-story-width
+created: 20260130065510314
+modified: 20260130065552027
+tags: [[Core CSS Variables]]
+title: --tp-story-width CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-story-width` CSS variable represents the overall width of the story river.

package/editions/tw5.com/tiddlers/css-variables/--tp-tiddler-width CSS Variable.tid

@@ -0,0 +1,8 @@
+caption: --tp-tiddler-width
+created: 20260130065558913
+modified: 20260130065746707
+tags: [[Core CSS Variables]]
+title: --tp-tiddler-width CSS Variable
+type: text/vnd.tiddlywiki
+
+The `--tp-tiddler-width` CSS variable represents the tiddler width within the story river.

package/editions/tw5.com/tiddlers/css-variables/--tpc-_ variables.tid

@@ -0,0 +1,16 @@
+caption: --tpc-*
+created: 20260122104142525
+modified: 20260122104847331
+tags: [[Core CSS Variables]]
+title: --tpc-* CSS Variables
+type: text/vnd.tiddlywiki
+
+`--tpc-*` variables are CSS variables of palette colors. They can be accessed via appending the palette color names to the bottom. For example:
+
+```css
+.code {
+	background-color: var(--tpc-code-background);
+	color: var(--tpc-code-foreground);
+}
+```
+

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

@@ -3,4 +3,4 @@ modified: 20211117195517318
 tags: Definitions
 title: BT
 
-BT (née British Telecom) is the UK's largest telecommunications company. In 2007, [[Osmosoft]] was acquired by BT. JeremyRuston subsequently left BT in 2011.
+BT (née British Telecom) is the UK's largest telecommunications company. In 2007, [[Osmosoft]] was acquired by BT. [[@Jermolene]] subsequently left BT in 2011.

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

@@ -1,5 +1,5 @@
 created: 20130828185900000
-modified: 20150221120839000
+modified: 20250814073940003
 tags: Definitions
 title: ContentType
 type: text/vnd.tiddlywiki
@@ -11,19 +11,20 @@ In TiddlyWiki, the `type` field gives the content type to apply to the main `tex
 !! List of Common Content Types
 
 |!Group |!Type |!Content of `type` field |
-|^''Developer'' |Data dictionary |application/x-tiddler-dictionary|
-|~|~JavaScript code |application/javascript|
-|~|JSON data |application/json|
-|~|Static stylesheet |text/css|
+|^''Developer'' |[[Data dictionary|DictionaryTiddlers]] |application/x-tiddler-dictionary|
+|~|[[Compound Tiddler|CompoundTiddlers]] |text/vnd.tiddlywiki-multiple|
+|~|JavaScript code |application/javascript|
+|~|[[JSON data|JSONTiddlers]] |application/json|
+|~|[[Static stylesheet|Using Stylesheets]] |text/css|
 |^''Image''|GIF image |image/gif|
 |~|ICO format icon file |image/x-icon|
 |~|JPEG image |image/jpeg|
 |~|PDF image |application/pdf|
 |~|PNG image |image/png|
 |~|Structured Vector Graphics image |image/svg+xml|
-|^''Text''|HTML markup |text/html|
+|^''Text''|[[HTML markup|HyperText Markup Language]] |text/html|
 |~|[[CSS|Cascading Style Sheets]] stylesheet |text/css|
 |~|[[Comma-separated values|Comma-Separated Values]] |text/csv|
 |~|Plain text |text/plain|
-|~|~TiddlyWiki 5 |text/vnd.tiddlywiki|
-|~|~TiddlyWiki Classic |text/x-tiddlywiki|
+|~|[[TiddlyWiki 5|WikiText]] |text/vnd.tiddlywiki|
+|~|[[TiddlyWiki Classic|TiddlyWikiClassic]] |text/x-tiddlywiki|

package/editions/tw5.com/tiddlers/definitions/Intertwingled Innovations.tid

@@ -4,6 +4,6 @@ tags: Definitions
 title: Intertwingled Innovations
 type: text/vnd.tiddlywiki
 
-Intertwingled Innovations Limited is the company through which [[JeremyRuston]] performs commercial consultancy work helping companies and individuals release the business value of TiddlyWiki.
+Intertwingled Innovations Limited is [[JeremyRuston]]'s company through which he offers services helping organisations release the business value of TiddlyWiki.
 
 See https://intertwingledinnovations.com/ for more information.

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

@@ -4,16 +4,4 @@ tags: Definitions
 title: JeremyRuston
 type: text/vnd.tiddlywiki
 
-I'm the original inventor of TiddlyWiki. You can hire me through [[Intertwingled Innovations]], and find me on these services:
-
-* jeremy (at) jermolene (dot) com
-* [[Jermolene on GitHub|https://github.com/Jermolene]]
-* [[Jermy on LinkedIn|http://www.linkedin.com/in/jermy]]
-* [[Jermy on Flickr|http://www.flickr.com/photos/jermy/]]
-
-Further information:
-
-* A recording of the [[keynote I gave at QCon London in April 2024|https://www.infoq.com/presentations/bbc-micro/]], and the [[discussion on talk.tiddlywiki.org|https://talk.tiddlywiki.org/t/recording-of-jeremys-keynote-at-qcon-london-april-2024/10505]]. The talk mixes some nostalgia about my teenage activities with the BBC Micro with thoughts on the development of the software industry and insights gained from working with TiddlyWiki
-* An [[interview with me in The Inquirer|http://www.theinquirer.net/inquirer/feature/2105529/bt-software-engineer-tells-telco-source]] by Wendy Grossman
-* A [[hilarious interview with me|https://www.youtube.com/watch?v=auyIhw8MTmQ]] from British television in 1983
-* Here's a video of a presentation I did in 2007 called [["How to Start an Open Source Project"|http://vimeo.com/856110]].
+See [[@Jermolene]].

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

@@ -3,4 +3,4 @@ modified: 201308281902
 tags: Definitions
 title: Jermolene
 
-Alias for JeremyRuston.
+See [[@Jermolene]].

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

@@ -3,7 +3,7 @@ modified: 20211119004632506
 tags: Definitions
 title: Osmosoft
 
-Founded in 2004 by JeremyRuston, Osmosoft was originally a consultancy for software services around TiddlyWiki. Notable engagements included working with Socialtext on [[Socialtext Unplugged|https://www.socialtext.net/open/socialtext_unplugged]].
+Founded in 2004 by [[@Jermolene]], Osmosoft was originally a consultancy for software services around TiddlyWiki. Notable engagements included working with Socialtext on [[Socialtext Unplugged|https://www.socialtext.net/open/socialtext_unplugged]].
 
 In 2007, Osmosoft was acquired by [[BT]] and became the champions for open source within the enterprise. As part of BT, Osmosoft has worked on a diverse range of projects within BT and for BT's customers.
 

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

@@ -1,6 +1,9 @@
 created: 20211117003509226
-modified: 20211117003657902
+modified: 20260102135713260
 tags: sampletag1 sampletag2 [[Widget Examples]]
 title: SampleTiddlerFirst
+type: text/vnd.tiddlywiki
 
-This is a test tiddler called SampleTiddlerFirst.
+This is a test tiddler called SampleTidlerFirst.
+It is used in [[DiffTextWidget]].
+You can modify its content.

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

@@ -1,6 +1,8 @@
 created: 20211117003511221
-modified: 20211117003724108
+modified: 20260102135739735
 tags: sampletag1 sampletag2 [[Widget Examples]]
 title: SampleTiddlerSecond
 
-This test tiddler is called SampleTiddlerSecond.
+This test tiddler is called SampleTiddlerSecond.
+It is used in [[DiffTextWidget]].
+You can edit its content.

package/editions/tw5.com/tiddlers/demonstrations/TableOfContentsMacro Simple Example.tid

@@ -1,11 +1,43 @@
-created: 20150221201838000
-modified: 20150221203742000
-title: Example Table of Contents: Simple
 caption: Simple
-tags: table-of-contents-example
+created: 20150221201838000
+modified: 20260124125915331
 order: 1
+tags: table-of-contents-example
+title: Example Table of Contents: Simple
+type: text/vnd.tiddlywiki
 
 <$macrocall $name=".example" n="1"
 eg="""<div class="tc-table-of-contents">
 <<toc "Contents">>
 </div>"""/>
+
+---
+
+<<.tip"""If you use several parameters in a macro call, it is advised to use ''named parameters'' for all of them""">>
+
+<$macrocall $name=".example" n="2"
+eg="""<div class="tc-table-of-contents">
+<<toc tag:"Contents" level:"1">>
+</div>"""/>
+
+<$macrocall $name=".example" n="3"
+eg="""<div class="tc-table-of-contents">
+<<toc tag:"Contents" level:"2">>
+</div>"""/>
+
+<$macrocall $name=".example" n="4"
+eg="""<div class="tc-table-of-contents">
+<<toc tag:"Contents" level:"4">>
+</div>"""/>
+
+* If you want to ''change'' or ''remove'' the indicator, you can locally overwrite the `toc-level-indicator` macro. 
+* It is globally defined at: $:/core/macros/toc tiddler. Eg:
+
+<$macrocall $name=".example" n="5"
+eg="""\define toc-level-indicator()
+<!-- remove the indicator --> 
+\end
+
+<div class="tc-table-of-contents">
+<<toc tag:"Contents" level:"1">>
+</div>"""/>

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

@@ -4,22 +4,22 @@ tags: Learning
 title: TaskManagementExample
 type: text/vnd.tiddlywiki
 
-TiddlyWiki5 can be used as a simple task management system without further customisation. The idea is that tasks be tagged `task`, with those that are completed also tagged `done`. In this way it is straightforward to generate task lists.
+TiddlyWiki5 can be used as a simple task management system without further customisation.<br>The idea is that tasks be tagged `task`, with those that are completed also tagged `done`. In this way it is straightforward to generate task lists.
 
 <<.tip """There is [[an enhanced version of this demo|TaskManagementExample (Draggable)]] that adds the ability to drag and drop the tasks to re-order them.""">>
 
 ! Outstanding tasks
 
-<$list filter="[!has[draft.of]tag[task]!tag[done]sort[created]]">
-
-<$checkbox tag="done"> <$link/></$checkbox>
-
+<$macrocall $name='wikitext-example-without-html'
+src="""<$list filter="[!has[draft.of]tag[task]!tag[done]sort[created]]">
+<$checkbox tag="done"> <$link/></$checkbox><br>
 </$list>
+"""/>
 
 ! Completed tasks
 
-<$list filter="[!has[draft.of]tag[task]tag[done]sort[created]]">
-
-<$checkbox tag="done"> ~~<$link/>~~</$checkbox>
-
+<$macrocall $name='wikitext-example-without-html'
+src="""<$list filter="[!has[draft.of]tag[task]tag[done]sort[created]]">
+<$checkbox tag="done"> ~~<$link/>~~</$checkbox><br>
 </$list>
+"""/>

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

@@ -4,20 +4,24 @@ tags: Learning
 title: TaskManagementExample (Draggable)
 type: text/vnd.tiddlywiki
 
-This is a version of the TaskManagementExample enhanced with the ability to drag and drop the task list to re-order them.
+This is a version of the TaskManagementExample enhanced with the ability to drag and drop the task list to re-order them.<br>The list uses a the itemTemplate [[TaskManagementExampleDraggableTemplate]] tiddler, which you will also need to experiment yourself.
 
 ! Outstanding tasks
 
-//Drag the tasks to re-order them//
+<$macrocall $name='wikitext-example-without-html'
+src="""//Drag the tasks to re-order them//
 
 <<list-tagged-draggable tag:"task" subFilter:"!has[draft.of]!tag[done]" itemTemplate:"TaskManagementExampleDraggableTemplate" emptyMessage:"You don't have any active tasks">>
+"""/>
 
 ! Completed tasks
 
-//(Listed in reverse order of completion)//
+<$macrocall $name='wikitext-example-without-html'
+src="""//(Listed in reverse order of completion)//
 
 <$list filter="[!has[draft.of]tag[task]tag[done]sort[modified]]">
 <div>
 <$checkbox tag="done"> ~~<$link/>~~</$checkbox>
 </div>
 </$list>
+"""/>

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

@@ -4,35 +4,36 @@ tags: Features
 title: DateFormat
 type: text/vnd.tiddlywiki
 
-The default representation of dates is a compact string such as <<.value 20211002153802059>>. The associated template is `[UTC]YYYY0MM0DD0hh0mm0ss0XXX`. For example, the <<.field created>> and <<.field modified>> fields are stored like this.
+The default representation of dates is a compact string such as <<.value "<$view field='modified' format='text'/>">>. The associated template is `[UTC]YYYY0MM0DD0hh0mm0ss0XXX`. For example, the <<.field created>> and <<.field modified>> fields are stored like this.
 
-The display format for this string can be controlled with a template. For example, transcluding the <<.field modified>> field automatically applies a template to display the date as <<.value "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:
+The display format for this string can be controlled with a template. For example, transcluding the <<.field modified>> field automatically applies a template to display the date as "{{!!modified}}". 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 |
+|`[UTC]`|Time-shift the represented date to UTC. Must be at very start of format string |
+|`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) |
+|`MMM` |Month in full (e.g. "July") |
+|`mmm` |Short month (e.g. "Jul") |
+|`MM` |Month number |
+|`0MM` |Adds leading zero |
 |`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") |
+|`DDD` |Day of week in full (e.g. "Monday") |
+|`ddd` |Short day of week (e.g. "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 |
 |`WW` |ISO-8601 week number of year |
 |`0WW` |Adds a leading zero |
-|`MMM` |Month in full (eg, "July") |
-|`mmm` |Short month (eg, "Jul") |
-|`MM` |Month number |
-|`0MM` |Adds leading zero |
-|`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 |
@@ -43,12 +44,12 @@ The date string is processed with the following substitutions:
 |`0ss` |Seconds with leading zero |
 |`XXX` |Milliseconds |
 |`0XXX` |Milliseconds with leading zero |
-|`am` or `pm` |Lower case AM/PM indicator |
+|`am` or `pm` |Lower case am/pm indicator |
 |`AM` or `PM` |Upper case AM/PM indicator |
-|`TZD` |Timezone offset |
+|`TZD` |Timezone offset from UTC (e.g. "+01:00", "-05:00"…) |
 |`TIMESTAMP` |<<.from-version "5.2.4">> Number of milliseconds since the [[ECMAScript epoch|https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date#the_ecmascript_epoch_and_timestamps]], 1 January 1970. |
 |`\x` |Used to escape a character that would otherwise have special meaning |
-|`[UTC]`|Time-shift the represented date to UTC. Must be at very start of format string|
+
 
 Note that other text is passed through unchanged, allowing commas, colons or other separators to be used.
 

package/editions/tw5.com/tiddlers/filters/examples/days.tid

@@ -6,15 +6,13 @@ type: text/vnd.tiddlywiki
 <<.operator-example 2 "[!days:created[-800]]" "tiddlers created more than 800 days ago">>
 The filter can be used to highlight new items in a list. For example:
 <$macrocall
-  $name="wikitext-example-without-html" src=
-"""
-<ul>
+  $name="wikitext-example-without-html"
+  src="""<ul>
   <$list filter="[tag[ReleaseNotes]!<currentTiddler>!sort[modified]]">
     <li>
       <$link><$view field="title"/></$link>
-         <$list filter="[<currentTiddler>days[-180]]"> @@color:red;^^new^^@@</$list>
-         <$list filter="[<currentTiddler>days[-500]!days[-180]]"> @@color:black;^^recent^^@@</$list>
+      <$list filter="[<currentTiddler>days[-180]]"> @@color:red;^^new^^@@</$list>
+      <$list filter="[<currentTiddler>days[-500]!days[-180]]"> @@color:black;^^recent^^@@</$list>
     </li>
   </$list>
-</ul>
-"""/>
+</ul>"""/>

package/editions/tw5.com/tiddlers/filters/examples/jsondelete.tid

@@ -0,0 +1,59 @@
+created: 20250115120000000
+modified: 20250115120000000
+tags: [[Operator Examples]] [[jsondelete Operator]]
+title: jsondelete Operator (Examples)
+
+<$let object-a="""{
+    "a": "one",
+    "b": "",
+    "c": "three",
+    "d": {
+        "e": "four",
+        "f": [
+            "five",
+            "six",
+            true,
+            false,
+            null
+        ],
+        "g": {
+            "x": "max",
+            "y": "may",
+            "z": "maize"
+        }
+    }
+}
+"""
+object-b="""{"a":"one","b":"","c":1.618,"d":{"e":"four","f":["five","six",true,false,null]}}"""
+array-a="""["une","deux","trois",["quatre","cinq"]]""">
+
+The examples below assume the following JSON object is contained in the variable `object-a`:
+
+<pre><<object-a>></pre>
+
+<<.operator-example 1 "[<object-a>jsondelete[a]]" "Delete a top-level object property">>
+<<.operator-example 2 "[<object-a>jsondelete[d],[e]]" "Delete a nested object property">>
+<<.operator-example 3 "[<object-a>jsondelete[d],[f],[0]]" "Delete the first element from an array">>
+<<.operator-example 4 "[<object-a>jsondelete[d],[f],[-1]]" "Delete the last element from an array using negative index">>
+<<.operator-example 5 "[<object-a>jsondelete[d],[f],[-2]]" "Delete the second-to-last element from an array using negative index">>
+<<.operator-example 6 "[<object-a>jsondelete[d],[g],[x]]" "Delete a deeply nested object property">>
+<<.operator-example 7 "[<object-a>jsondelete[]]" "If no parameters are specified, the JSON object is returned unchanged">>
+<<.operator-example 8 "[<object-a>jsondelete[missing]]" "If the property does not exist, the JSON object is returned unchanged">>
+
+The examples below assume the following JSON object is contained in the variable `object-b`:
+
+<pre><<object-b>></pre>
+
+<<.operator-example 9 "[<object-b>jsondelete[b]]" "Delete an empty string property">>
+<<.operator-example 10 "[<object-b>jsondelete[d],[f],[1]]" "Delete a middle element from an array">>
+
+The examples below assume the following JSON array is contained in the variable `array-a`:
+
+<pre><<array-a>></pre>
+
+<<.operator-example 11 "[<array-a>jsondelete[0]]" "Delete the first element from a top-level array">>
+<<.operator-example 12 "[<array-a>jsondelete[-1]]" "Delete the last element from a top-level array using negative index">>
+<<.operator-example 13 "[<array-a>jsondelete[3],[0]]" "Delete an element from a nested array">>
+
+<<.operator-example 14 "[<object-a>] [<object-b>] :and[jsondelete[a]]" "If the input consists of multiple JSON objects with matching properties, the property is deleted from all of them">>
+

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

@@ -1,37 +1,60 @@
 created: 20230614225302905
-modified: 20230614233448662
+modified: 20251021140446753
 tags: [[Operator Examples]] [[substitute Operator]]
 title: substitute Operator (Examples)
 type: text/vnd.tiddlywiki
 
-\define time() morning
-\define field() modified
-\procedure sentence() This tiddler was last $(field)$ on ${[{!!modified}format:date[DDth MMM YYYY]]}$
-\define name() Bugs Bunny
-\define address() Rabbit Hole Hill
+!! Substitute operator parameters
+
+The following example uses a ''function definition'' and a ''function call'' with a ''filter expression''
+
+<<wikitext-example-without-html """\function f.text() [[Hi, I'm $1$ and I live in $2$]substitute[Bugs Bunny],[Rabbit Hole Hill]]
+
+<<f.text>>
+""">>
+
+---
+
+The following example uses a [[filtered transclusion|Transclusion in WikiText]] with a [[filter expression|Filter Syntax]] creating a link and a text output.
+
+<<wikitext-example-without-html """link: {{{ [[Hi, I'm $1$ and I live in $2$]substitute[Bugs Bunny],[Rabbit Hole Hill]] }}}
+
+text: <$text text={{{ [[Hi, I'm $1$ and I live in $2$]substitute[Bugs Bunny],[Rabbit Hole Hill]] }}}/>
+""">>
 
-!Substitute <<.op substitute[]>> operator parameters
-<<.operator-example 1 "[[Hi, I'm $1$ and I live in $2$]substitute[Bugs Bunny],[Rabbit Hole Hill]]">>
 
-!Substitute variables
-This example uses the following variables:
+!! Substitute variables and parameters
 
-* name: <$codeblock code=<<name>>/>
-* address: <$codeblock code=<<address>>/>
+The following example uses [[variable definitions|Pragma: \procedure]] "name", "address", a ''filtered transclusion'' assigned to a ''text-widget''. The variables "name" and "address" are used as ''substitute parameters''.
 
-<<.operator-example 2 "[[Hi, I'm $(name)$ and I live in $(address)$]substitute[]]">>
+<<wikitext-example-without-html """\procedure name() Bugs Bunny
+\procedure address() Rabbit Hole Hill
 
-!Substitute variables and operator parameters
-This example uses the following variable:
+<$text text={{{ [[Hi, I'm $1$ and I live in $2$]substitute<name>,<address>] }}}/>
+""">>
 
-* time: <$codeblock code=<<time>>/>
+!! Substitute $(variables)$
+
+The following examples use the variables "name" and "address" and directly substitute the with the [[attribute substitution|Substituted Attribute Values]] syntax. 
+
+<<wikitext-example-without-html """\procedure name() Bugs Bunny
+\procedure address() Rabbit Hole Hill
+
+<$text text=`Hi, I'm $(name)$ and I live in $(address)$`/>
+""">>
+
+!! Substitute a filter expression and a variable
+
+The following example uses a procedure, that defines the text with substitution placeholders. `$(field)$` is defined as a variable. `${ ... }$` is filtered <<.olink2 "substitution placeholder" to:"substitute">>.
+
+<<wikitext-example-without-html """\procedure field() modified
+
+\procedure sentence() This tiddler was last $(field)$ on ${[{!!modified}format:date[DDth MMM YYYY]]}$
 
-<<.operator-example 3 "[[Something in the $(time)$ at $2$ about $1$ ]substitute[Maths],[the Library]]">>
+<$text text={{{ [<sentence>substitute[]] }}}/>
 
-!Substitute a filter expression and a variable
-This example uses the following variables:
+---
 
-* field: <$codeblock code=<<field>>/>
-* sentence: <$codeblock code=<<sentence>>/>
+<$text text=`This tiddler was last $(field)$ on ${[{!!modified}format:date[DDth MMM YYYY]]}$`/>
 
-<<.operator-example 4 "[<sentence>substitute[]]">>
+""">>