tiddlywiki 5.1.21 → 5.2.1

package/editions/tw5.com/tiddlers/howtos/Simple ways to write protect tiddlers.tid

@@ -1,6 +1,6 @@
 created: 20180310002601813
-modified: 20180310003428093
-tags: Learning
+modified: 20211106021629911
+tags: Learning [[How to apply custom styles]]
 title: Simple ways to write protect tiddlers
 type: text/vnd.tiddlywiki
 
@@ -10,9 +10,8 @@ Sometimes you want to protect individual tiddlers from accidental changes, eithe
 
 Create a tiddler with the following contents and tag it as `$:/tags/Stylesheet` :
 
-```
-.tc-tagged-Locked button[title="Edit this tiddler"]   {display: none;}
-
+```css
+[data-tags*="Locked"] button[title="Edit this tiddler"]   {display: none;}
 ```
 
 If your TW language isn't English, then you'll need to change the text in 'title="...."' to whatever the text is when you hover over the edit button.
@@ -26,6 +25,6 @@ Now any tiddler you tag as "Locked" will have the edit button hidden. To get it
 * Select all the tiddler text.
 * Click on the excise tool.
 * In the title box, type `$:/` and then paste the original title.
-* Use the defaults to excise and and leave a transclusion
+* Use the defaults to excise the text into a new tiddler and replace it with a transclusion
 
-Now you can view the contents of your original tiddler, but to edit them your will have to find the the tiddler with the `$:/` prefix.
+Now you can view the contents of your original tiddler, but to edit them you will have to find the the tiddler with the `$:/` prefix.

package/editions/tw5.com/tiddlers/howtos/Tagging.tid

@@ -26,10 +26,10 @@ There are two more things you can do with tags:
 
 ! Set a tag's colour and icon
 
-You can use the {{$:/core/images/tag-button}} [[tag manager|$:/TagManager]], found on the ''Tags'' tab under ''More'' in the sidebar, to change the colour of a tag's pill or add an icon to the pill.
+You can use the <<.icon $:/core/images/tag-button>> [[tag manager|$:/TagManager]], found on the ''Tags'' tab under ''More'' in the sidebar, to change the colour of a tag's pill or add an icon to the pill.
 
 * To change the colour, click the button in the ''Colour'' column to select from a colour picker. Alternatively, click the icon in the ''Info'' column, then type a [[CSS]] colour value in the ''Colour'' field
-* To change the icon, click the {{$:/core/images/down-arrow}} button in the ''Icon'' column and choose from the list of available icons
+* To change the icon, click the <<.icon $:/core/images/down-arrow>> button in the ''Icon'' column and choose from the list of available icons
 
 ! Change the order in which tags are listed
 

package/editions/tw5.com/tiddlers/howtos/Text preview.tid

@@ -1,6 +1,18 @@
 created: 20160817104110857
-modified: 20160817104802841
+modified: 20211029090145708
 tags: [[Editor toolbar]]
 title: Text preview
 
-Pressing the eye icon {{$:/core/ui/EditorToolbar/preview}} will open or close a preview window (and the eye) of the text you are editing.
+Pressing the eye icon {{$:/core/ui/EditorToolbar/preview}} will open or close a preview window showing the results of rendering the WikiText (the icon-eye will also open or close).
+
+Right to the eye there is another icon, {{$:/core/images/chevron-down}}, which when clicked, shows you a dropdown which gives you access to six different types of preview:
+
+* //output// shows you the text as you see it when you do not edit the tiddler.
+* //html// shows you the [[source code|https://www.w3schools.com/html/html_intro.asp]] of that output. Your web browser uses this source code to display webpages.
+* //parsetree// and //widgettree// show you the two object trees that ~TiddlyWiki internally generates from ~WikiText. The //parsetree// collects basic information about your ~WikiText. From the informations of the parsetree the //widgettree// then generates extended informations and finally the above html (and the widgettree also does other things).
+* //differences from current// shows you the differences since the tiddler was last saved. Deleted parts are <span style="color:red;">red</span>, added parts are <span style="color:green;">green</span>.
+* //differences from shadow (if any)// does the same, but this time it shows you the differences to the underlying [[shadow-tiddler|ShadowTiddlers]].
+
+<<.tip "By default, the preview pane button controls whether the preview pane is displayed for all tiddlers that are open for editing. There is a [[hidden setting|Hidden Setting: Show Edit Preview per Tiddler]] to make the button work on a per-tiddler basis">>
+
+<<.tip "The variable [[tv-tiddler-preview|tv-tiddler-preview Variable]] can be used to detect whether content is being displayed in the preview pane.">>

package/editions/tw5.com/tiddlers/howtos/Upgrading.tid

@@ -27,7 +27,7 @@ This process will work on most desktop browsers. Note that none of your personal
 #* If the file is encrypted you will be prompted for the password
 # Review the list of tiddlers that will be upgraded
 # Click ''Upgrade''
-# Save changes to save the new version ({{$:/core/images/save-button}})
+# Save changes to save the new version (<<.icon $:/core/images/save-button>>)
 
 This will download a file called ''upgrade.html'' to your computer. This file is the upgrade of your old file. You may need to open the location where ''upgrade.html'' was downloaded, rename ''upgrade.html'' with the name of the old file you are upgrading, and replace the old file by moving the new file in its place.
 

package/editions/tw5.com/tiddlers/howtos/Using Excise.tid

@@ -6,11 +6,11 @@ type: text/vnd.tiddlywiki
 
 
 ! Excise text
-From the EditorToolbar you can export selected text to a new tiddler and insert a [[link|Linking in WikiText]] [[Transclusion]] or [[macro|Macros]] in its place. Click ''Excise text'' ({{$:/core/images/excise}}), input name of the new tiddler, and choose excise method.
+From the EditorToolbar you can export selected text to a new tiddler and insert a [[link|Linking in WikiText]] [[Transclusion]] or [[macro|Macros]] in its place. Click ''Excise text'' (<<.icon $:/core/images/excise>>), input name of the new tiddler, and choose excise method.
 
 !! How to excise text
 # Highlight the relevant piece of text 
-#Click ''Excise text'' ({{$:/core/images/excise}})
+#Click ''Excise text'' (<<.icon $:/core/images/excise>>)
 # Give the new tiddler a title.
 # Chosse if the new tiddler will be tagged with the title of the current tiddler''*''.
 # Choose replacing method. [[link|Linking in WikiText]] [[Transclusion]] or [[macro|Macros]].

package/editions/tw5.com/tiddlers/howtos/Using Stamp.tid

@@ -5,24 +5,23 @@ title: Using Stamp
 type: text/vnd.tiddlywiki
 
 ! Insert snippets
-You can insert preconfigured snippets of text to use stamp from toolbar. Click ''stamp'' ({{$:/core/images/stamp}}) and just select a snippet.
+You can insert preconfigured snippets of text to use stamp from toolbar. Click ''stamp'' (<<.icon $:/core/images/stamp>>) and just select a snippet.
 
 ! Create a snippet
-# Click ''stamp'' ({{$:/core/images/stamp}})
+# Click ''stamp'' (<<.icon $:/core/images/stamp>>)
 # Create a snippet tiddler through the "//Add your own//" menu entry
 # Type some text as snippet for the tiddler, add a caption for the name as shown in the menu
-# Click the {{$:/core/images/done-button}} ''ok'' button
-
-<<.tip """''Tip:'' You can also create a snippet tiddler using the ''new tiddler'' {{$:/core/images/new-button}} button in the sidebar, and add tag ''~$:/tags/TextEditor/Snippet''""">>
+# Click the <<.icon $:/core/images/done-button>> ''ok'' button
 
+<$macrocall $name=".tip" _="""''Tip:'' You can also create a snippet tiddler using the ''new tiddler'' <<.icon $:/core/images/new-button>> button in the sidebar, and add tag ''~$:/tags/TextEditor/Snippet''""" />
 
 !!<<.from-version "5.1.20">> Adding a prefix and/or suffix to a selection
 
-# Click ''stamp'' ({{$:/core/images/stamp}})
+# Click ''stamp'' (<<.icon $:/core/images/stamp>>)
 # Create a snippet tiddler through the "//Add your own//" menu entry
 # Add a caption for the name as shown in the menu
 # Create a tiddler with the same title but add the suffix `/prefix`
 # Insert the prefix in its text field
 # Create a tiddler with the same title but add the suffix `/suffix`
 # Insert the suffix in its text field
-# Click the {{$:/core/images/done-button}} ''ok'' button
+# Click the <<.icon $:/core/images/done-button>> ''ok'' button

package/editions/tw5.com/tiddlers/howtos/Using Stylesheets.tid

@@ -1,5 +1,5 @@
 created: 20140305091244145
-modified: 201804111739
+modified: 20211125175708977
 tags: [[Customise TiddlyWiki]]
 title: Using Stylesheets
 type: text/vnd.tiddlywiki
@@ -16,9 +16,9 @@ type: text/vnd.tiddlywiki
 
 The first steps to changing the appearance of ~TiddlyWiki are to choose and apply:
 
-* One of the available themes: <span class="tc-btn-standard"> {{$:/core/ui/Buttons/theme}} </span>
-* Modify the colour palette: <span class="tc-btn-standard"> {{$:/core/ui/Buttons/palette}} </span>
-* Experiment with the <$button actions=<<openCpTheme>> >{{$:/core/images/options-button}} ControlPanel</$button>
+* One of the available themes: {{$:/core/ui/Buttons/theme}}
+* Modify the colour palette: {{$:/core/ui/Buttons/palette}}
+* Experiment with the <$button actions=<<openCpTheme>> class="tc-btn-invisible"><<.icon $:/core/images/options-button>> ~ControlPanel</$button>
 
 ! Work with Stylesheets
 
@@ -30,6 +30,8 @@ body.tc-body {
 }
 ```
 
+You can then use your own [[styles and classes in WikiText|Styles and Classes in WikiText]].
+
 !! Additional Resrouces
 
 * [[Cascading Style Sheets (CSS) at mozilla|https://developer.mozilla.org/en-US/docs/Web/CSS]]
@@ -71,3 +73,7 @@ A stylesheet tiddler is processed such that it is first wikified and then the te
 !! Stylesheet Macros
 
 The ~TiddlyWiki core provides several [[global macros that are helpful in constructing stylesheets|Stylesheet Macros]].
+
+!! See Also
+
+* <<list-links "[tag[Using Stylesheets]]">>

package/editions/tw5.com/tiddlers/howtos/Windows HTA Hack.tid

@@ -1,9 +1,10 @@
 caption: HTA Hack
+color: #F06292
 created: 20131212223146250
 delivery: DIY
 description: Manual method to let Internet Explorer save changes directly
 method: save
-modified: 20171113160539299
+modified: 20200507110355115
 tags: Saving Windows
 title: Windows HTA Hack
 type: text/vnd.tiddlywiki
@@ -12,4 +13,4 @@ Under Windows it is possible to convert TiddlyWiki into a true local application
 
 Note that one disadvantage of this approach is that the TiddlyWiki file is saved in UTF-16 format, making it up to twice as large as it would be with the usual UTF-8 encoding. However, opening and saving the file via another saving method will re-encode the file to UTF-8.
 
-See Wikipedia for more details: http://en.wikipedia.org/wiki/HTML_Application
+See Wikipedia for more details: https://en.wikipedia.org/wiki/HTML_Application

package/editions/tw5.com/tiddlers/images/Grok TiddlyWiki.png.meta

@@ -0,0 +1,3 @@
+title: Grok TiddlyWiki Banner
+type: image/png
+tags: picture

package/editions/tw5.com/tiddlers/images/Icon Gallery.tid

@@ -0,0 +1,14 @@
+created: 20211013132515594
+modified: 20211018102307833
+tags: Learning
+title: Icon Gallery
+type: text/vnd.tiddlywiki
+
+\define copyActions() <$action-sendmessage $message="tm-copy-to-clipboard" $param=<<imageTitle>>/>
+
+<<.tip "Click an icon to copy the title to the clipboard">>
+
+<div class="tc-image-chooser">
+<$macrocall $name="image-picker-list" filter="[all[shadows+tiddlers]tag[$:/tags/Image]]" actions=<<copyActions>> />
+</div>
+

package/editions/tw5.com/tiddlers/images/TiddlyWikiLinks.png.meta

@@ -0,0 +1,3 @@
+title: TiddlyWikiLinks
+type: image/png
+tags: picture

package/editions/tw5.com/tiddlers/languages/Japanese (Japan) Edition.tid

@@ -0,0 +1,11 @@
+caption: 日本語 (日本国)
+created: 20201227004927059
+modified: 20201227010050287
+tags: Languages
+title: Japanese (Japan) Edition
+type: text/vnd.tiddlywiki
+
+TiddlyWikiの日本語バージョンはこちら:
+
+<!--* ''ドキュメント'' : https://tiddlywiki.com/languages/ja-JP/index.html-->
+* ''空白のコピー'' : https://tiddlywiki.com/languages/ja-JP/empty.html

package/editions/tw5.com/tiddlers/languages/LanguageGallery.tid

@@ -1,6 +1,6 @@
 created: 20151231083708980
-modified: 20151231084132703
-tags: 
+modified: 20211117212723856
+tags: Languages
 title: LanguageGallery Example
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/macros/ColourMacro.tid

@@ -1,5 +1,5 @@
 created: 20150221154058000
-modified: 20150221154522000
+modified: 20200228142855357
 tags: Macros [[Core Macros]]
 title: colour Macro
 type: text/vnd.tiddlywiki
@@ -7,7 +7,7 @@ caption: colour
 
 The <<.def colour>> (or <<.def color>>) [[macro|Macros]] returns the [[CSS|Cascading Style Sheets]] value of one the colours in the current [[palette|ColourPalettes]].
 
-If no such entry exists in the current palette, the [[vanilla palette|$:/palettes/Vanilla]] is used instead.
+If no such entry exists in the current palette, the [[vanilla palette|$:/palettes/Vanilla]] is used instead. If no such entry exists in the vanilla palette, the system looks for a configuration tiddler with the title `$:/config/DefaultColourMappings/<colour-name>` and transcludes the colour from the text field. This enables to plugins to ship defaults for colours that are not present in the core palettes.
 
 !! Parameters
 

package/editions/tw5.com/tiddlers/macros/JsonTiddlersMacro.tid

@@ -1,5 +1,5 @@
 created: 20150221152226000
-modified: 20150221154213000
+modified: 20200204135513721
 tags: Macros [[Core Macros]]
 title: jsontiddlers Macro
 type: text/vnd.tiddlywiki
@@ -13,3 +13,5 @@ An example can be seen in the [[template tiddler for JSON exports|$:/core/templa
 
 ;filter
 : A [[filter|Filters]] selecting which tiddlers to include
+;spaces
+: An optional number of spaces to use for formatting the JSON. Defaults to 4, with blank or zero resulting in packed JSON with no formatting spaces

package/editions/tw5.com/tiddlers/macros/MakeDataUriMacro.tid

@@ -1,5 +1,5 @@
 created: 20131228163141555
-modified: 20150221223416000
+modified: 20200330105334133
 tags: Macros [[Core Macros]]
 title: makedatauri Macro
 type: text/vnd.tiddlywiki
@@ -15,5 +15,7 @@ The <<.def makedatauri>> [[macro|Macros]] takes a piece of text and an associate
 : The text to be converted to a data URI
 ;type
 : The ContentType of the text
+;_canonical_uri
+: The optional ''_canonical_uri'' address of the content
 
 <<.macro-examples "makedatauri">>

package/editions/tw5.com/tiddlers/macros/NowMacro.tid

@@ -1,6 +1,6 @@
 caption: now
 created: 20141008141616791
-modified: 20170630223406157
+modified: 20210629215024061
 tags: Macros [[Core Macros]]
 title: now Macro
 type: text/vnd.tiddlywiki
@@ -16,5 +16,7 @@ The value doesn't update automatically, like a ticking clock. It updates wheneve
 
 ''Note'': The format string `[UTC]YYYY0MM0DD0hh0mm0ssXXX` will return a date string representing the UTC time-stamp as it is used in the ~TiddlyWiki `created` and `modified` time-stamp fields.
 
+<<.from-version 5.2.0>><<.tip "You can now pass literal parameters to the `now` macro in filters. For example, this filter will return all tiddlers created today: `[all[tiddlers]] :filter[get[created]format:date[YYYY0MM0DD]match<now YYYY0MM0DD>]`">>
+
 
 <<.macro-examples "now">>

package/editions/tw5.com/tiddlers/macros/TableOfContentsMacro.tid

@@ -1,5 +1,5 @@
 created: 20140919155729620
-modified: 20150221224034000
+modified: 20201017134038305
 tags: Macros [[Core Macros]]
 title: Table-of-Contents Macros
 type: text/vnd.tiddlywiki
@@ -34,6 +34,8 @@ The tree displays the <<.field caption>> field of a tiddler if it has one, or th
 
 Each tiddler in the tree is normally displayed as a link. To suppress this, give the tiddler a <<.field toc-link>> field with the the value <<.value no>>. In the [[examples|Table-of-Contents Macros (Examples)]], the SecondThree tiddler is set up like this. Clicking such a tiddler in the tree causes its branch to expand or collapse.
 
+<<.from-version "5.1.23">> By default, the links open the tiddlers making up the table of contents. Alternatively, if the tiddler contains a <<.field target>> field then its contents will be used as the target of the link.
+
 The table of contents is generated as an HTML ordered list. The `<ol>` elements always have the class `tc-toc`. Expandable trees have the additional class `tc-toc-expandable`. Selectively expandable trees (including those in the two-panel browser) have `tc-toc-selective-expandable`.
 
 To make a table of contents appear in the sidebar, see [[How to add a new tab to the sidebar]].

package/editions/tw5.com/tiddlers/macros/TabsMacro.tid

@@ -1,6 +1,6 @@
 caption: tabs
 created: 20131228162203521
-modified: 20180408084453861
+modified: 20210721122823354
 tags: Macros [[Core Macros]]
 title: tabs Macro
 type: text/vnd.tiddlywiki
@@ -16,7 +16,7 @@ By default the tabs are arranged horizontally above the content. To get vertical
 ;tabsList
 : A [[filter|Filters]] selecting which tiddlers to include
 ;default
-: The title of the tiddler whose tab is to be selected by default
+: The title of the tiddler whose tab is to be selected by default, if the [[state tiddler|StateMechanism]] doesn't exist. The state tiddler takes precedence over this setting
 ;state
 : The prefix for the title of a [[state tiddler|StateMechanism]] for noting the currently selected tab, defaulting to `$:/state/tab`. It is recommended that this be a [[system tiddler|SystemTiddlers]]
 ;class
@@ -27,6 +27,10 @@ By default the tabs are arranged horizontally above the content. To get vertical
 : Optionally, the title of a tiddler to use as a [[template|TemplateTiddlers]] for transcluding the content of the button for the selected tab
 ;retain
 : Optionally, "yes" specifies that the content of the tabs should be retained when switching to another tab, avoiding re-rendering it (this can be useful to avoid video or audio sources unexpectedly resetting)
+;actions
+: Optionally, actions can be specified that are triggered when changing a tab. Within the actions, the title of the selected tab is available in the <<.var currentTab>> variable and the `currentTiddler` variable from outside the tabs macro is available in the <<.var save-currentTiddler>>
+;explicitState
+: Optionally, an explicit state title can be specified. It will be preferred over the internally computed (qualified) state title
 
 Within the template, the title of the selected tab is available in the <<.var currentTab>> variable.
 

package/editions/tw5.com/tiddlers/macros/UnusedTitleMacro.tid

@@ -1,5 +1,6 @@
-
 caption: unusedtitle
+created: 20210104143546885
+modified: 20210427184035684
 tags: Macros [[Core Macros]]
 title: unusedtitle Macro
 type: text/vnd.tiddlywiki
@@ -10,7 +11,30 @@ It uses the same method as the create new tiddler button, a number is appended t
 
 !! Parameters
 
-;baseName
-: A string specifying the desired base name, defaulting to `New Tiddler`
+; baseName
+: A string specifying the desired base name, defaulting to `New Tiddler`. <br>The default setting can be adjusted in the $:/ControlPanel '': Info : Basics - tab.''
+
+; separator
+: <<.from-version "5.2.0">> An ''optional'' string specifying the separator between baseName and the unique number. eg: `separator:"-"`. Defaults to a space: `" "`. If you need an empty separator use the ''template''!
+
+; template
+: <<.from-version "5.2.0">> A ''optional'' template string can be used to allow you maximum flexibility. If the template string is used, there will always be a counter value. 
+
+!! Template String
+
+; `$basename$`
+: This variable will be replaced by the content of the ''baseName'' parameter
+
+; `$separator$`
+: This variable will be replaced by the ''separator'' parameter
+
+;`$count$`
+: This variable will be createad automatically and is a counter starting with 0
+
+;`$count:4$`
+: This variable will be createad automatically and starts at 0000
+: `:4` represents the number of digits
+
+!! Examples
 
-<<.macro-examples "unusedtitle">>
+<<list-links "[prefix[unusedtitle Macro (E]!sort[]]">>

package/editions/tw5.com/tiddlers/macros/examples/colour-picker Macro (Example 1).tid

@@ -1,6 +1,6 @@
 created: 20160418154853776
-modified: 20160418155450547
-tags: 
+modified: 20211116034610950
+tags: [[Macro Examples]]
 title: colour-picker Macro (Example 1)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/macros/examples/image-picker Macro (Example 1).tid

@@ -1,6 +1,6 @@
 created: 20160418155523369
-modified: 20160418155913663
-tags: 
+modified: 20211116035014728
+tags: [[Macro Examples]]
 title: image-picker Macro (Example 1)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/macros/examples/image-picker Macro (Example 2).tid

@@ -1,6 +1,6 @@
 created: 20160418155523369
-modified: 20160418155913663
-tags: 
+modified: 20211116035110986
+tags: [[Macro Examples]]
 title: image-picker Macro (Example 2)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/macros/examples/list-thumbnails Macro (Examples).tid

@@ -0,0 +1,11 @@
+created: 20200612170734735
+modified: 20200612171403882
+tags: [[Macro Examples]]
+title: list-thumbnails Macro (Examples)
+type: text/vnd.tiddlywiki
+
+This example lists all the tiddlers which are tagged with "HelloThumbnail":
+
+<$macrocall $name=".example" n="1" eg="""<<list-thumbnails filter:"[tag[HelloThumbnail]]" width:"168" height:"95">>"""/>
+
+

package/editions/tw5.com/tiddlers/macros/examples/qualify.tid

@@ -15,6 +15,4 @@ eg="""<ul>
 <li><code><<transclusion>></code></li>
 </ul>"""/>
 
-<blockquote>
 {{$:/editions/tw5.com/macro-examples/qualify-transcluded}}
-</blockquote>

package/editions/tw5.com/tiddlers/macros/examples/unusedtitle Macro (Examples 1).tid

@@ -0,0 +1,51 @@
+created: 20210227212730299
+modified: 20211118025545823
+tags: [[Macro Examples]]
+title: unusedtitle Macro (Examples 1)
+type: text/vnd.tiddlywiki
+
+\define testCreate()
+<$action-createtiddler $basetitle=<<unusedtitle template:"$count:2$-new">>/>
+\end
+
+\define testCreate1()
+<$action-createtiddler $basetitle=<<unusedtitle baseName:"new" separator:"-" template:"$count:2$$separator$$basename$">>/>
+\end
+
+\define testNew()
+<$action-sendmessage $message="tm-new-tiddler" title=<<unusedtitle baseName:"new" template:"$count:2$-$basename$">> />
+\end
+
+```
+<<unusedtitle template:"$count:2$-new">>
+```
+
+<$button actions=<<testCreate>> >
+<$action-setfield $tiddler="$:/state/tab/sidebar--595412856" text="$:/core/ui/SideBar/Recent"/>
+Create Tiddler
+</$button>
+
+```
+<<unusedtitle baseName:"new" template:"$count:2$-$basename$">>
+```
+
+<$button actions=<<testNew>>>
+<$action-setfield $tiddler="$:/state/tab/sidebar--595412856" text="$:/core/ui/SideBar/Recent"/>
+New Tiddler
+</$button>
+
+```
+<<unusedtitle baseName:"new" separator:"-" template:"$count:2$$separator$$basename$">>
+```
+
+<$button actions=<<testCreate1>>>
+<$action-setfield $tiddler="$:/state/tab/sidebar--595412856" text="$:/core/ui/SideBar/Recent"/>
+Create Tiddler
+</$button>
+
+---
+
+<details>
+    <summary>Show the code</summary>
+    <pre><code><$view><pre><code>
+</details>

package/editions/tw5.com/tiddlers/macros/examples/unusedtitle.tid

@@ -1,7 +1,16 @@
+created: 20210104143940715
+modified: 20210228141241657
 tags: [[unusedtitle Macro]] [[Macro Examples]]
 title: unusedtitle Macro (Examples)
 type: text/vnd.tiddlywiki
 
 <$macrocall $name=".example" n="1" eg="""<<unusedtitle>>"""/>
-<$macrocall $name=".example" n="2" eg="""<<unusedtitle AnotherBase>>"""/>
-<$macrocall $name=".example" n="3" eg="""<<unusedtitle TiddlyWiki>>"""/>
+''The following example works best if there is an open tiddler in draft mode, or there is a tiddler named "New Tiddler".'' So you can see the automatic numbering.
+<$macrocall $name=".example" n="2" eg="""<<unusedtitle separator:"-">>"""/>
+<$macrocall $name=".example" n="3" eg="""<<unusedtitle baseName:"anotherBase">>"""/>
+<$macrocall $name=".example" n="4" eg="""<<unusedtitle baseName:"About" separator:"-">>"""/>
+<$macrocall $name=".example" n="5" eg="""<<unusedtitle template:"$count:2$-test">>"""/>
+
+---
+
+Working buttons can be found at: [[unusedtitle Macro (Examples 1)]]. You'll have to examine the code to see, what's going on.

package/editions/tw5.com/tiddlers/macros/keyboard-driven-input_Macro.tid

@@ -0,0 +1,25 @@
+title: keyboard-driven-input Macro
+tags: Macros [[Core Macros]]
+
+The <<.def keyboard-driven-input>> [[macro|Macros]] generates an input field or textarea that lets you cycle through a given list of entries with the <kbd><<displayshortcuts ((input-up))>></kbd> and <kbd><<displayshortcuts ((input-down))>></kbd> keys. Doing so, an entry gets selected and can be processed with further actions
+
+!! Parameters
+
+To create the input field or textarea, the <<.def keyboard-driven-input>> [[macro|Macros]] accepts all parameters of the EditTextWidget
+
+The additional parameters are:
+
+|parameter  |purpose |h
+|storeTitle |the title of the tiddler that stores the user input |
+|selectionStateTitle |the title of the tiddler that stores the selected entry with a -primaryList or -secondaryList suffix to make it unique |
+|inputAcceptActions |the actions that get processed when the user hits <kbd><<displayshortcuts ((input-accept))>></kbd> |
+|inputAcceptVariantActions |the actions that get processed when the user hits <kbd><<displayshortcuts ((input-accept-variant))>></kbd> |
+|inputCancelActions |the actions that get processed when the user hits <kbd><<displayshortcuts ((input-cancel))>></kbd> |
+|configTiddlerFilter |a ''filter'' that specifies the tiddler that stores the first item-filter in its <<.field first-search-filter>> field and the second item-filter in its <<.field second-search-filter>> field |
+|firstSearchFilterField |the field of the configTiddler where the first search-filter is stored. Defaults to <<.field first-search-filter>> |
+|secondSearchFilterField |the field of the configTiddler where the second search-filter is stored. Defaults to <<.field second-search-filter>> |
+|filterMinLength |the minimum length of the user input after which items are filtered |
+
+See [[Demonstration: keyboard-driven-input Macro]] for further guidance on using this macro.
+
+

package/editions/tw5.com/tiddlers/macros/list-thumbnails Macro.tid

@@ -0,0 +1,19 @@
+caption: list-thumbnails
+created: 20200612170158838
+modified: 20200612171804473
+tags: Macros [[Core Macros]]
+title: list-thumbnails Macro
+type: text/vnd.tiddlywiki
+
+The <<.def list-thumbnails>> [[macros|Macros]] are used to create lists of linkable thumbnail panels.
+
+!! Parameters
+
+;filter
+: filter for selecting thumbnails
+;width
+:Width of thumbnail (default 280 pixels)
+;height
+:Height of thumbnail (default 157 pixels)
+
+<<.macro-examples "list-thumbnails">>

package/editions/tw5.com/tiddlers/macros/tag-picker_Macro.tid

@@ -11,5 +11,7 @@ The <<.def tag-picker>> [[macro|Macros]] generates a combination of a text box a
 
 ;actions
 : Action widgets to be triggered when the pill is clicked. Within the text, the variable ''tag'' contains the title of the selected tag.
+;tagField
+: <<.from-version 5.1.23>> The ''field'' that gets updated with the selected tag. Defaults to ''tags''.
 
 <<.macro-examples "tag-picker">>

package/editions/tw5.com/tiddlers/mechanisms/AlertMechanism.tid

@@ -4,7 +4,7 @@ tags: Mechanisms Features
 title: AlertMechanism
 type: text/vnd.tiddlywiki
 
-Alerts are displayed as yellow boxes overlaying the main TiddlyWiki window. Each one corresponds to a tiddler with the tag [[$:/tags/Alert]]. Clicking the {{$:/core/images/delete-button}} delete icon on an alert deletes the corresponding tiddler.
+Alerts are displayed as yellow boxes overlaying the main TiddlyWiki window. Each one corresponds to a tiddler with the tag [[$:/tags/Alert]]. Clicking the <<.icon $:/core/images/delete-button>> delete icon on an alert deletes the corresponding tiddler.
 
 Here's a demo <$fieldmangler tiddler="SampleAlert"><$set name="currentTiddler" value="SampleAlert"><$button message="tm-add-tag" param="$:/tags/Alert">alert</$button></$set></$fieldmangler>.
 

package/editions/tw5.com/tiddlers/mechanisms/HistoryMechanism.tid

@@ -13,7 +13,7 @@ The history list also maintains the field ''current-tiddler'' that contains the
 ```
 <$list filter="[list[$:/StoryList]]" history="$:/HistoryList" storyview="pop">
 
-<$button message="tm-close-tiddler" class="tc-btn-invisible tc-btn-mini">&times;</$button> <$link to={{!!title}}><$view field="title"/> <$reveal type="match" state="$:/HistoryList!!current-tiddler" text=<<currentTiddler>>>&#x2713;</$reveal></$link>
+<$button message="tm-close-tiddler" class="tc-btn-invisible tc-btn-mini">&times;</$button> <$link><$view field="title"/> <$reveal type="match" state="$:/HistoryList!!current-tiddler" text=<<currentTiddler>>>&#x2713;</$reveal></$link>
 
 </$list>
 ```
@@ -22,7 +22,7 @@ Which renders the same as the "Open" sidebar tab, with the addition of a tick ag
 
 <$list filter="[list[$:/StoryList]]" history="$:/HistoryList" storyview="pop">
 
-<$button message="tm-close-tiddler" class="tc-btn-invisible tc-btn-mini">&times;</$button> <$link to={{!!title}}><$view field="title"/> <$reveal type="match" state="$:/HistoryList!!current-tiddler" text=<<currentTiddler>>>&#x2713;</$reveal></$link>
+<$button message="tm-close-tiddler" class="tc-btn-invisible tc-btn-mini">&times;</$button> <$link><$view field="title"/> <$reveal type="match" state="$:/HistoryList!!current-tiddler" text=<<currentTiddler>>>&#x2713;</$reveal></$link>
 
 </$list>
 
@@ -32,4 +32,4 @@ To display content when the story is empty, create $:/config/EmptyStoryMessage a
 
 ```
 {{GettingStarted||$:/core/ui/ViewTemplate}}
-```
+```

package/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid

@@ -1,5 +1,5 @@
 created: 20140720164948099
-modified: 20190307175403915
+modified: 20201124185829706
 tags: Mechanisms
 title: InfoMechanism
 type: text/vnd.tiddlywiki
@@ -13,6 +13,7 @@ System tiddlers in the namespace `$:/info/` are used to expose information about
 ! Information Tiddlers
 
 |!Title |!Description |
+|[[$:/info/startup-timestamp]] |<<.from-version "5.1.23">> Startup timestamp in TiddlyWiki date format |
 |[[$:/info/browser]] |Running in the browser? ("yes" or "no") |
 |[[$:/info/browser/language]] |<<.from-version "5.1.20">> Language as reported by browser (note that some browsers report two character codes such as `en` while others report full codes such as `en-GB`) |
 |[[$:/info/browser/screen/width]] |Screen width in pixels |
@@ -26,3 +27,4 @@ System tiddlers in the namespace `$:/info/` are used to expose information about
 |[[$:/info/url/port]] |<<.from-version "5.1.14">> Port portion of URL of wiki (eg, ''<<example port>>'') |
 |[[$:/info/url/protocol]] |<<.from-version "5.1.14">> Protocol portion of URL of wiki (eg, ''<<example protocol>>'') |
 |[[$:/info/url/search]] |<<.from-version "5.1.14">> Search portion of URL of wiki (eg, ''<<example search>>'') |
+|[[$:/info/darkmode]] |<<.from-version "5.1.23">> Is dark mode enabled? ("yes" or "no") |