tiddlywiki 5.2.0 → 5.2.3

package/editions/tw5.com/tiddlers/hellothere/Some of the things you can do with TiddlyWiki.tid

@@ -1,5 +1,5 @@
 created: 20140904090300000
-modified: 20160602051709631
+modified: 20211018102355896
 tags: HelloThere
 title: Some of the things you can do with TiddlyWiki
 type: text/vnd.tiddlywiki
@@ -11,7 +11,7 @@ type: text/vnd.tiddlywiki
 * Inventory just about anything: your recipes, personal library, contacts, music collection, and more
 * Create a blog or website
 * Write a book
-* Organise your images into galleries (see our [[ImageGallery Example]])
+* Organise your images into galleries (see [[Icon Gallery]])
 * Share the information in your ~TiddlyWiki with others, as an online file, as a file attachment, as a tiddler file, or as a link to a specific online tiddler (try clicking and dragging a tiddler from one ~TiddlyWiki file to another to see what happens)
 * Draw a sketch (Edit [[Motovun Jack.jpg]] and start drawing over the image to see what happens)
 * Use familiar web user interface elements such as lightboxes - see SampleWizard

package/editions/tw5.com/tiddlers/hellothere/badges/ProductHunt-Badge.svg.tid

@@ -1,5 +1,6 @@
 title: ProductHunt-Badge.svg
 type: image/svg+xml
+tags: [[HelloThere Badge]]
 
 <?xml version="1.0" encoding="UTF-8"?>
 <svg width="250px" height="54px" viewBox="0 0 250 54" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">

package/editions/tw5.com/tiddlers/hellothere/badges/ProductHunt-Link.tid

@@ -1,3 +1,4 @@
 title: Product Hunt Link
+tags: [[HelloThere Badge]]
 
 <a href="https://www.producthunt.com/posts/tiddlywiki-2?utm_source=badge-top-post-badge&utm_medium=badge&utm_souce=badge-tiddlywiki-2" alt="Product Hunt: Product of the Day" target="_blank" rel="noopener noreferrer">{{ProductHunt-Badge.svg}}</a>

package/editions/tw5.com/tiddlers/hiddensettings/Hidden Setting NewImageType.tid

@@ -1,5 +1,7 @@
+created: 20211116222524148
+modified: 20211116222535549
+tags: [[Hidden Settings]]
 title: Hidden Setting: New-Image Type
-tags: [[Hidden Setting]]
 type: text/vnd.tiddlywiki
 
 By default new images are created with the image-type `jpeg`

package/editions/tw5.com/tiddlers/hiddensettings/Hidden Setting ShowEditPreviewPerTiddler.tid

@@ -0,0 +1,10 @@
+created: 20211028083211182
+modified: 20211029090311444
+tags: [[Hidden Settings]]
+title: Hidden Setting: Show Edit Preview per Tiddler
+
+Controls whether the [[tiddler editing preview|Text preview]] is controlled globally (the default) or on a per-tiddler basis.
+
+Set it to ''yes'' to enable per-tiddler mode.
+
+$:/config/ShowEditPreview/PerTiddler

package/editions/tw5.com/tiddlers/hiddensettings/Hidden Setting_ Typin Refresh Delay.tid

@@ -4,10 +4,10 @@ tags: [[Hidden Settings]]
 title: Hidden Setting: Typing Refresh Delay
 type: text/vnd.tiddlywiki
 
-TiddlyWiki defers processing changes to draft tiddlers until a timeout has elapsed (this is called throttling). The mechanism can be extended to other tiddlers by adding a `throttle.refresh` field. See RefreshThrottling for details.
+TiddlyWiki defers processing changes to draft tiddlers and tiddlers with the prefix `$:/temp/volatile/` until a timeout has elapsed (this is called throttling). The mechanism can be extended to other tiddlers by adding a `throttle.refresh` field. See RefreshThrottling for details.
 
 The default value of 400ms gives a good balance of responsiveness in most cases but isn't always optimal on lower powered mobile devices.
 
 The timeout can now be changed by changing this value (in milliseconds):
 
-$:/config/Drafts/TypingTimeout
+$:/config/Drafts/TypingTimeout

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/Constructing JSON tiddlers.tid

@@ -0,0 +1,16 @@
+title: Constructing JSON tiddlers
+tags: [[JSON in TiddlyWiki]] [[Learning]]
+created: 20220427174702859
+modified: 20220427174702859
+
+See [[JSON in TiddlyWiki]] for an overview of using JSON in TiddlyWiki.
+
+JSON data is just plain text, and so there are an wide variety of techniques to generate it in wikitext.
+
+At a high level, we have several ways to generate JSON data in TiddlyWiki's own tiddler format:
+
+* JSONTiddlerWidget
+* [[jsontiddler Macro]]
+* [[jsontiddlers Macro]]
+
+When constructing JSON data manually, the [[jsonstringify Operator]] is needed to ensure that any special characters are properly escaped.

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/Creating a splash screen.tid

@@ -8,7 +8,7 @@ By default, TiddlyWiki displays a blank screen while it is loading. You can add
 
 Larger TiddlyWiki files and those loaded over a slow network connection may take a little time to load. Once fully loaded, performance improves, because everything is now running entirely within the browser. Using a splash screen ensures people know the loading process is taking place, reducing the chance they will leave the page.
 
-In order for the splash screen to be displayed before TiddlyWiki is initialised it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the [[SystemTag: $:/tags/RawMarkupWikified/TopBody]].
+In order for the splash screen to be displayed before TiddlyWiki is initialised or [[decrypted|Encryption]], it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the [[SystemTag: $:/tags/RawMarkupWikified/TopBody]], or any of the other system tags beginning with $:/tags/RawMarkup. 
 
 In order to remove the splash screen when the wiki has finished loading, the HTML should be wrapped in a container with the special class `tc-remove-when-wiki-loaded`. Any DOM elements with this class are automatically deleted by the core once the wiki has loaded.
 

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/How to apply custom styles by tag.tid

@@ -1,11 +1,11 @@
 caption: {{!!title}} - ^^deprecated^^
 created: 20141001132300000
-modified: 201804111739
+modified: 20220704174221300
 tags: [[How to apply custom styles]] $:/deprecated
 title: How to apply custom styles by tag
 type: text/vnd.tiddlywiki
 
-<<.deprecated-since "5.1.16 <- click" "Custom styles by data-tags">>. Also see: [[How to apply custom styles]]
+<<.deprecated-since "5.1.16" "Custom styles by data-tags">>. Also see: [[How to apply custom styles]]
 
 ----
 

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

@@ -1,5 +1,5 @@
 created: 20201216182347597
-modified: 20201217193318816
+modified: 20211018102328148
 tags: 
 title: How to create dynamic editor toolbar buttons
 type: text/vnd.tiddlywiki
@@ -86,7 +86,7 @@ This tiddler contains all the necessary elements that are important for toolbar
 : Is used as the button tooltip
 
 ; icon 
-: Assigns the button icon. We use `$:/core/images/spiral` {{$:/core/images/spiral}} here.
+: 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))`

package/editions/tw5.com/tiddlers/howtos/How to customize TiddlyDesktop.tid

@@ -8,7 +8,7 @@ type: text/vnd.tiddlywiki
 
 Before experimenting with TiddlyDesktop internals you should find the location of the “user configuration folder” - click the “Settings” button on the main TiddlyDesktop window, and then click the button “Open user config folder”. Then move up to locate the parent folder, which should be called “TiddlyDesktop”. If things go wrong, you can reset TiddlyDesktop to its factory state by deleting this entire folder.
 
-Click the `Backstage` button on the main TiddlyDesktop window to open the backstage wiki. This is is a Node.js-like instance of TiddlyWiki that runs the UI and logic of TiddlyDesktop.
+Click the `Backstage` button on the main TiddlyDesktop window to open the backstage wiki. This is a Node.js-like instance of TiddlyWiki that runs the UI and logic of TiddlyDesktop.
 
 !! How do I get rid of the "Add a ~TiddlyWiki Folder" button.
 

package/editions/tw5.com/tiddlers/howtos/How to update TiddlyWiki to the latest version.tid

@@ -0,0 +1,7 @@
+created: 20220426221124514
+modified: 20220426221240671
+tags: [[Working with TiddlyWiki]]
+title: How to update TiddlyWiki to the latest version
+type: text/vnd.tiddlywiki
+
+{{Upgrading}}

package/editions/tw5.com/tiddlers/howtos/Modifying JSON tiddlers.tid

@@ -0,0 +1,18 @@
+created: 20220427174702859
+modified: 20220427171707459
+tags: [[JSON in TiddlyWiki]] Learning
+title: Modifying JSON tiddlers
+type: text/vnd.tiddlywiki
+
+See [[JSON in TiddlyWiki]] for an overview of using JSON in TiddlyWiki.
+
+Note that 
+
+!! Using ActionSetFieldWidget and ActionListopsWidget
+
+The widgets ActionSetFieldWidget and ActionListopsWidget can manipulate named properties of data tiddlers by indicating the name of the property in the $index attribute.
+
+* To create or modify a named property with ActionSetFieldWidget, provide a $value attribute
+* To delete a named property with ActionSetFieldWidget, omit the $value attribute.
+
+ActionListopsWidget assigns the named property the list constructed through its $filter and $subfilter attributes.

package/editions/tw5.com/tiddlers/howtos/Reading data from JSON tiddlers.tid

@@ -0,0 +1,25 @@
+created: 20220427174702859
+modified: 20220427171449102
+tags: [[JSON in TiddlyWiki]] Learning
+title: Reading data from JSON tiddlers
+type: text/vnd.tiddlywiki
+
+See [[JSON in TiddlyWiki]] for an overview of using JSON in TiddlyWiki.
+
+!! Text References for Accessing JSON Data
+
+[[Text references|TextReference]] are a simple shortcut syntax to look up the value of a named property. For example, if a [[DictionaryTiddler|DictionaryTiddlers]] called `MonthDays` contains:
+
+```
+oct:31
+nov:30
+dec:31
+```
+
+... then `{{MonthDays##nov}}` will resolve to the value `30`.
+
+The same is true if `MonthDays` is a [[JSONTiddler|JSONTiddlers]] with the following content:
+
+```
+{"oct":31,"nov":30,"dec":31}
+```

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: 20210104090402829
+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
 
@@ -73,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/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/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/JsonTiddlersMacro.tid

@@ -1,11 +1,11 @@
+caption: jsontiddlers
 created: 20150221152226000
-modified: 20200204135513721
+modified: 20220427171155184
 tags: Macros [[Core Macros]]
 title: jsontiddlers Macro
 type: text/vnd.tiddlywiki
-caption: jsontiddlers
 
-The <<.def jsontiddlers>> [[macro|Macros]] returns the fields of a [[selection of tiddlers|Title Selection]] in [[JSON|JavaScript Object Notation]] form.
+The <<.def jsontiddlers>> [[macro|Macros]] returns the fields of a [[selection of tiddlers|Title Selection]] in [[JSON|JavaScript Object Notation]] form. See [[JSON in TiddlyWiki]] for an overview.
 
 An example can be seen in the [[template tiddler for JSON exports|$:/core/templates/exporters/JsonFile]].
 

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

@@ -5,7 +5,7 @@ tags: Macros [[Core Macros]]
 title: tag Macro
 type: text/vnd.tiddlywiki
 
-The <<.def tag>> [[macro|Macros]] generates a tag pill for a specified tag.
+The <<.def tag>> [[macro|Macros]] generates a tag pill for a specified tag. Clicking the tag pill opens a dropdown. This can be compared to the [[tag-pill Macro]] which also features other parameters.
 
 !! Parameters
 

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/unusedtitle Macro (Examples 1).tid

@@ -1,6 +1,6 @@
 created: 20210227212730299
-modified: 20210427184057456
-tags: 
+modified: 20211118025545823
+tags: [[Macro Examples]]
 title: unusedtitle Macro (Examples 1)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/macros/jsontiddler Macro.tid

@@ -1,11 +1,11 @@
 caption: jsontiddler
 created: 20170317140130417
-modified: 20170317140226040
+modified: 20220427171228844
 tags: Macros [[Core Macros]]
 title: jsontiddler Macro
 type: text/vnd.tiddlywiki
 
-The <<.def jsontiddler>> [[macro|Macros]] returns the fields of a single tiddler in [[JSON|JavaScript Object Notation]] form.
+The <<.def jsontiddler>> [[macro|Macros]] returns the fields of a single tiddler in [[JSON|JavaScript Object Notation]] form. See [[JSON in TiddlyWiki]] for an overview.
 
 !! Parameters
 

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

@@ -1,6 +1,6 @@
 caption: list-links-draggable
 created: 20170328204925306
-modified: 20170329093008550
+modified: 20211214141650488
 tags: Macros [[Core Macros]]
 title: list-links-draggable Macro
 type: text/vnd.tiddlywiki
@@ -13,6 +13,8 @@ The <<.def list-links-draggable>> [[macro|Macros]] renders the ListField of a ti
 : The title of the tiddler containing the list
 ;field
 : The name of the field containing the list (defaults to `list`)
+;emptyMessage
+: Optional wikitext to display if there is no output (tiddler is not existed, field is not existed or empty)
 ;type
 : The element tag to use for the list wrapper (defaults to `ul`)
 ;subtype

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

@@ -15,6 +15,7 @@ System tiddlers in the namespace `$:/info/` are used to expose information about
 |!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/mobile]] |<<.from-version "5.2.3">> Is running on a mobile device? ("yes" or "no" - eg, ''<<example full>>'') |
 |[[$:/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 |
 |[[$:/info/browser/screen/height]] |Screen height in pixels |