tiddlywiki 5.1.23 → 5.2.2

package/editions/tw5.com/tiddlers/howtos/Concatenating text and variables using macro substitution.tid

@@ -1,5 +1,5 @@
 created: 20160424150551727
-modified: 20190115162340362
+modified: 20211230153027382
 tags: Learning
 title: Concatenating text and variables using macro substitution
 type: text/vnd.tiddlywiki
@@ -9,9 +9,7 @@ It's a frequent use case in ~TiddlyWiki that you will want to put the results of
 
 You might, for instance want to set up a template for your customer database, where links will automatically refer to additional contact information about your customer. Inside your tiddler, you might try something like this:
 
-
-|warning|k
-|@@font-size:1.5em;&#9888;@@ Warning:<br/> Don't do it this way!| `[[Additional Info|<<currentTiddler>>-Contact]]` |
+<<.bad-example "`[[Additional Info|<<currentTiddler>>-Contact]]`">>
 
 But that won't work. If you try this, the link will be interpreted very literally, and will attempt to take you to:
 
@@ -29,9 +27,7 @@ Create a macro at the top of the tiddler like this:
 
 You might be tempted to invoke the new macro like this:
 
-|warning|k
-|@@font-size:1.5em;&#9888;@@ Warning:<br/> Don't do it this way!| `<<linkup <<currentTiddler>> >>` |
-
+<<.bad-example "`<<linkup <<currentTiddler>> >>`">>
 
 But if you do, you will find that `<<currentTiddler>>` doesn't get rendered, but instead gets passed literally.
 
@@ -53,10 +49,4 @@ Notice that in this case we don't pass an argument. Instead, we reference the va
 
 ```
 <<linkup>>
-```
-
-<style>
-.warning code  {background-color:#ffff80}
-table.warning {background-color:#ffff80;}
-
-</style>
+```

package/editions/tw5.com/tiddlers/howtos/Creating SubStories.tid

@@ -1,44 +1,32 @@
 created: 20140214215718317
-modified: 20140919161514318
+modified: 20211127032217828
 tags: Learning
 title: Creating SubStories
 type: text/vnd.tiddlywiki
 
-This example shows how to create a sub-story within a tiddler that is independent of the main story.
+This example shows how to create a sub-story within a tiddler that is independent of the main [[story|Story River]].  The NavigatorWidget and ListWidget work together to:
 
-Here's the code:
+# Add tiddlers to the [[story|Story River]] when links are clicked. Navigate to the tiddler corresponding to the link click. (''story'' attribute of the NavigatorWidget)
+# Remove tiddlers from the [[story|Story River]] when tiddler close buttons are clicked. (''story'' attribute of NavigatorWidget)
+# Animate the opening and closing of tiddlers. (''storyview'' attribute of the ListWidget)
+# Display the list of open tiddlers. (''filter'' and ''template'' attributes of the ListWidget)
+# Display tiddlers in [[draft mode|DraftMechanism]]. (''editTemplate'' attribute of the ListWidget)
+# Track [[navigation history|HistoryMechanism]]. (''history'' attribute of both NavigatorWidget and ListWidget)
+# And more!
 
-```
-<$navigator story="MySubStoryList" history="MySubHistoryList">
+Here is the example code (see also StateMechanism for related discussion):
 
-Click this link to get started: HelloThere
+<$macrocall $name='wikitext-example-without-html'
+src='<$navigator story="$:/temp/DemoStoryList" history="$:/temp/DemoHistoryList">
 
-<$list filter="[list[MySubStoryList]]" history="MySubHistoryList">
-<div>
+{{$:/core/ui/SideBarSegments/search}}
 
-! <$button message="tm-close-tiddler" class="tc-btn-invisible">{{$:/core/images/close-button}}</$button> <$view field="title"/>
+<$list
+  filter="[list[$:/temp/DemoStoryList]]"
+  history="$:/temp/DemoHistoryList"
+  template={{$:/config/ui/ViewTemplate}}
+  editTemplate={{$:/config/ui/EditTemplate}}
+  storyview="classic"
+  emptyMessage="Use search box above. Clicked search links will open here instead of in the main story.<p>No search ideas? Click this link to get started: HelloThere</p>"/>
 
-<$transclude/>
-</div>
-</$list>
-
-</$navigator>
-```
-
-Note how you can open the HelloThere tiddler in the substory by clicking on the link below. Links within the substory open within the substory, and not in the main story.
-
-<$navigator story="MySubStoryList" history="MySubHistoryList">
-
-Click this link to get started: HelloThere
-
-<$list filter="[list[MySubStoryList]]" history="MySubHistoryList">
-<div>
-
-! <$button message="tm-close-tiddler" class="tc-btn-invisible">{{$:/core/images/close-button}}</$button> <$view field="title"/>
-
-<$transclude/>
-
-</div>
-</$list>
-
-</$navigator>
+</$navigator>'>

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

@@ -0,0 +1,11 @@
+created: 20211125175712017
+modified: 20211125175906085
+tags: [[Using Stylesheets]]
+title: Debugging Stylesheets
+type: text/vnd.tiddlywiki
+
+The core shadow tiddler $:/snippets/DebugStylesheets contains a simple tool for tracking down certain problems with mismatched brackets and other nested structures.
+
+In the list below, any stylesheets containing an error will be marked with a red cross:
+
+{{$:/snippets/DebugStylesheets}}

package/editions/tw5.com/tiddlers/howtos/Formatting List Results as Tables with CSS - Specified Columns Methods.tid

@@ -18,6 +18,8 @@ For other table-making techniques see also:
 /* FOUR COLUMN MODE */
 .fourcolumns {
    display:block;
+   column-count:4;
+   column-gap:1em;
    -moz-column-count:4;
    -moz-column-gap:1em;
    -webkit-column-count: 4;
@@ -42,6 +44,8 @@ Note the various places you need to indicate the number of columns
 <style>
 .fourcolumns {
    display:block;
+   column-count:4;
+   column-gap:1em;
    -moz-column-count:4;
    -moz-column-gap:1em;
    -webkit-column-count: 4;

package/editions/tw5.com/tiddlers/howtos/How to create a custom story tiddler template.tid

@@ -0,0 +1,40 @@
+created: 20211204120244761
+modified: 20211206165108185
+tags: Learning Cascades [[Story Tiddler Template]] [[Story Tiddler Template Cascade]] [[Customise TiddlyWiki]]
+title: How to create a custom story tiddler template
+type: text/vnd.tiddlywiki
+
+Here we show how to add a rule to the [[Story Tiddler Template Cascade]] that causes tiddlers tagged <<tag "$:/tags/TiddlerList">> to be displayed with a custom appearance incorporating thumbnails of the tiddlers named in the list field.
+
+Open [[Demo Tiddler List with Custom Story Tiddler Template]] to see the demo.
+
+First, we add a new step to the story tiddler template cascade. The new filter step is:
+
+```
+[tag[$:/tags/TiddlerList]then[$:/_tw5.com/CustomStoryTiddlerTemplateDemo/Template]]
+```
+
+It can be read as:
+
+```
+If the tiddler has the tag $:/tags/TiddlerList then return $:/_tw5.com/CustomStoryTiddlerTemplateDemo/Template
+```
+
+> The template $:/_tw5.com/CustomStoryTiddlerTemplateDemo/Template also depends on styles defined in [[$:/_tw5.com/CustomStoryTiddlerTemplateDemo/Styles]].
+
+The story tiddler template cascade is defined by the tag <<tag "$:/tags/StoryTiddlerTemplateFilter">>, so we need to create a configuration tiddler with that tag.
+
+We also need to make sure that it is inserted at the correct point in the cascade:
+
+* The new rule must be after the "draft" rule to ensure that draft tiddlers with the tag $:/tags/TiddlerList can be edited
+* The new rule must be before the "default" rule otherwise it will never be executed
+
+The control panel "Cascades" tab shows that this can be achieved by inserting the new step immediately before the default step using the `list-before` field.
+
+The full list of fields in the configuration tiddler is:
+
+<<.tiddler-fields "$:/_tw5.com/CustomStoryTiddlerTemplateDemo/Filter">>
+
+Finally, we need to create the demo tiddler itself:
+
+<<.tiddler-fields "Demo Tiddler List with Custom Story Tiddler Template">>

package/editions/tw5.com/tiddlers/howtos/How to create a custom tiddler colour rule.tid

@@ -0,0 +1,36 @@
+created: 20211206114114698
+modified: 20211206165150302
+tags: Learning Cascades [[Customise TiddlyWiki]]
+title: How to create a custom tiddler colour rule
+type: text/vnd.tiddlywiki
+
+Here we show how to add a rule to the [[Tiddler Colour Cascade]] that causes tiddlers with the tag <<tag "TableOfContents">> to be given a bright blue colour and tiddlers with the tag <<tag "Working with TiddlyWiki">> to be given a dark purple colour.
+
+<<.tip "[[How to create a custom tiddler icon rule]] describes how the same tiddlers have been given a custom icon">>
+
+First, we add a new step to the tiddler colour cascade. The new filter step is:
+
+```
+[tag[TableOfContents]then[#1e90ff]]
+[tag[Working with TiddlyWiki]then[darkorchid]]
+```
+
+It can be read as:
+
+```
+If the tiddler has the tag "TableOfContents" then return the colour #1e90ff
+Else if the tiddler has the tag "Working with TiddlyWiki" then return the colour darkorchid
+```
+
+The tiddler colour cascade is defined by the tag <<tag "$:/tags/TiddlerColourFilter">>, so we need to create a configuration tiddler with that tag.
+
+We also need to make sure that it is inserted at the correct point in the cascade:
+
+* The new rule must be after the "colour-field" rule to ensure that tiddlers with an explicit ''color'' field will respect the value of that field
+* The new rule must be before the "default" icon otherwise it will never be seen if the default colour is specified
+
+The control panel "Cascades" tab shows that this can be achieved by inserting the new step immediately before the default step using the `list-before` field.
+
+The full list of fields in the configuration tiddler is:
+
+<<.tiddler-fields "$:/_tw5.com/CustomTiddlerColourCascadeDemo">>

package/editions/tw5.com/tiddlers/howtos/How to create a custom tiddler icon rule.tid

@@ -0,0 +1,36 @@
+created: 20211204161649863
+modified: 20211206165129215
+tags: Learning Cascades [[Tiddler Icon Cascade]] [[Customise TiddlyWiki]]
+title: How to create a custom tiddler icon rule
+type: text/vnd.tiddlywiki
+
+Here we show how to add a rule to the [[Tiddler Icon Cascade]] that causes tiddlers with the tag <<tag "TableOfContents">> to be given the "globe" icon <<.icon $:/core/images/globe>> and tiddlers with the tag <<tag "Working with TiddlyWiki">> to be given the "help" icon <<.icon $:/core/images/help>>.
+
+<<.tip "[[How to create a custom tiddler colour rule]] describes how the same tiddlers have been given a custom colour">>
+
+First, we add a new step to the tiddler icon cascade. The new filter step is:
+
+```
+[tag[TableOfContents]then[$:/core/images/globe]]
+[tag[Working with TiddlyWiki]then[$:/core/images/help]] 
+```
+
+It can be read as:
+
+```
+If the tiddler has the tag "TableOfContents" then return $:/core/images/globe
+Else if the tiddler has the tag "Working with TiddlyWiki" then return $:/core/images/help
+```
+
+The tiddler icon cascade is defined by the tag <<tag "$:/tags/TiddlerIconFilter">>, so we need to create a configuration tiddler with that tag.
+
+We also need to make sure that it is inserted at the correct point in the cascade:
+
+* The new rule must be after the "icon-field" rule to ensure that tiddlers with an explicit ''icon'' field will respect the value of that field
+* The new rule must be before the "default" icon otherwise it will never be seen if the default icon is specified
+
+The control panel "Cascades" tab shows that this can be achieved by inserting the new step immediately before the default step using the `list-before` field.
+
+The full list of fields in the configuration tiddler is:
+
+<<.tiddler-fields "$:/_tw5.com/CustomTiddlerIconCascadeDemo">>

package/editions/tw5.com/tiddlers/howtos/How to create dynamic editor toolbar buttons.tid

@@ -0,0 +1,126 @@
+created: 20201216182347597
+modified: 20211018102328148
+tags: 
+title: How to create dynamic editor toolbar buttons
+type: text/vnd.tiddlywiki
+
+\define disabledFilterExample()`[[$(tempBoldDisabled)$]get[state-disabled]else[no]]`
+
+\define remove-shortcuts()
+<$action-deletetiddler $tiddler=<<shortcutInfo>>/>
+<$action-deletetiddler $tiddler=<<shortcutConfigMac>>/>
+<$action-deletetiddler $tiddler=<<shortcutConfigNotMac>>/>
+<$action-deletetiddler $tiddler=<<tempBold>>/>
+<$action-deletetiddler $tiddler=<<tempBoldDisabled>>/>
+\end
+
+\define create-shortcut-tiddlers()
+<$action-createtiddler $basetitle=<<shortcutInfo>> 
+  $template="$:/config/ShortcutInfo/bold" 
+  $overwrite="yes"
+/>
+<$action-navigate $to=<<shortcutInfo>>/>
+
+<$action-createtiddler $basetitle=<<shortcutConfigMac>> 
+  $template="$:/config/shortcuts-mac/bold" 
+  $overwrite="yes"
+  text="meta-shift-X"
+/>
+<$action-navigate $to=<<shortcutConfigMac>>/>
+
+<$action-createtiddler $basetitle=<<shortcutConfigNotMac>> 
+  $template="$:/config/shortcuts-not-mac/bold" 
+  $overwrite="yes"
+  text="ctrl-shift-X"
+/>
+<$action-navigate $to=<<shortcutConfigNotMac>>/>
+
+\end
+
+\define clone-bold()
+<$action-createtiddler $basetitle=<<tempBold>> 
+  $template="$:/core/ui/EditorToolbar/bold" 
+  $overwrite="yes"
+  icon="$:/core/images/spiral"
+  shortcuts="((temp-bold))"
+  condition-disabled="[[$(tempBoldDisabled)$]get[state-disabled]else[no]]"
+/>
+<$action-sendmessage $message="tm-edit-tiddler" $param=<<tempBold>>/>
+\end
+
+\define clone-button-bold()
+<$button actions=<<clone-bold>> >Create a Temporary Bold Button</$button>
+\end
+
+\define toggle-bold()
+<$action-listops  $tiddler=<<tempBoldDisabled>> $field="state-disabled" $subfilter="+[toggle[yes],[no]]" />
+\end
+
+<!-- $vars is needed don't remove it! -->
+<$vars tempBold="$:/temp/bold" tempBoldDisabled="$:/temp/bold/disabled" shortcutInfo="$:/config/ShortcutInfo/temp-bold"  shortcutConfigMac="$:/config/shortcuts-mac/temp-bold" shortcutConfigNotMac="$:/config/shortcuts-not-mac/temp-bold">
+
+!! Create a New Toolbar Button
+
+The easiest way to create new editor toolbar button is to clone and open one.
+
+><<clone-button-bold>> 
+
+This tiddler contains all the necessary elements that are important for toolbar buttons. 
+
+<<<
+
+; text
+: We don't discuss the text field details in this howto
+
+; caption
+: The caption field is used to display the shortcut name in the $:/ControlPanel : Keyboard Shortcuts tab
+
+; condition
+: A filter, that defines the button visibility state
+
+; condition-disabled  <<.from-version "5.1.23">>
+: A ''filter'', that allows us to define the "disabled" attribute for buttons. eg: <<disabledFilterExample>>
+:  This condition ''must'' return "no", if the "state tiddler" or "state field" doesn't exist! So there has to be a `else[no]` element in the filter.
+
+; description
+: Is used as the button tooltip
+
+; icon 
+: Assigns the button icon. We use `$:/core/images/spiral` {{$:/core/images/spiral}} here. More button icons can be found in the [[Icon Gallery]]
+
+; shortcuts
+: This is the [[Keyboard Shortcut Descriptor]] eg: `((temp-bold))`
+
+<<<
+
+!! Disabled State
+
+You can use any "state tiddler" to define the button disabled state. It's important, that the ''condition-disabled'' field is a ''filter''. For our example we use the `state-disabled` field from tiddler: <<tempBoldDisabled>>
+
+The easiest way to test filters is with the $:/AdvancedSearch : Filter tab
+
+> The temporary "bold button" is disabled: ''"{{{ [<tempBoldDisabled>get[state-disabled]else[no]] }}}"'' ... You can see the button in the editor toolbar if you edit any tiddler!
+
+> <$button actions=<<toggle-bold>>>Toggle Temporary Bold Button Visisbility</$button>
+
+!! Create Keyboard Shortcuts for New Button
+
+For our ~HowTo we use the ''Keyboard Shortcut Descriptor'': `((temp-bold))`
+
+To create a valid shortcut configuration we need 2 tiddlers: 
+
+>[[$:/config/ShortcutInfo/|$:/config/ShortcutInfo/temp-bold]]''temp-bold'' .. and
+>[[$:/config/shortcuts/|$:/config/shortcuts/temp-bold]]''temp-bold''
+
+> <$button actions=<<create-shortcut-tiddlers>>>Create Shortcut Tiddlers</$button>
+
+!! 
+
+!! Clean up the Configuration Tiddlers
+
+If you don't need the config tiddlers anymore you can 
+
+><$button actions=<<remove-shortcuts>>>Remove the Shortcut Configuration</$button>
+
+
+</$vars><!-- needed don't remove! -->

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.

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

@@ -1,9 +1,9 @@
 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 for your WikiText (The icon-eye will also open or close).
+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:
 
@@ -12,3 +12,7 @@ Right to the eye there is another icon, {{$:/core/images/chevron-down}}, which w
 * //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/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>> ><<.icon $:/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/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/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/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
@@ -28,7 +28,7 @@ By default the tabs are arranged horizontally above the content. To get vertical
 ;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
+: 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
 

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/qualify.tid

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