tiddlywiki 5.3.4 → 5.3.6

package/editions/tw5.com/tiddlers/widgets/DroppableWidget.tid

@@ -1,22 +1,27 @@
 caption: droppable
 created: 20170406082820317
-modified: 20231121101447359
+modified: 20240612125454153
 tags: Widgets TriggeringWidgets
 title: DroppableWidget
 type: text/vnd.tiddlywiki
 
-\define droppable-image-actions()
+\procedure drop-on-tags-actions()
+<$action-log actionTiddlerList=<<actionTiddlerList>>/>
+<$action-setfield $tiddler="$:/temp/drop/TitleList" $field="text" text=<<actionTiddlerList>> type="text/plain"/>
+\end
+
+\procedure droppable-image-actions()
 <$action-setfield $tiddler=<<actionTiddler>> $field="icon" $value=<<currentTiddler>>/>
 \end
 
-\define colour-demo-body()
+\procedure colour-demo-body()
 <$droppable actions=<<droppable-colour-actions>>>
-<span style="display: inline-block; width: 1em; height: 1em;background-color: $(currentTiddler)$;">
+<span style=`display: inline-block; width: 1em; height: 1em;background-color: $(currentTiddler)$;`>
 </span>
 </$droppable>
 \end
 
-\define droppable-colour-actions()
+\procedure droppable-colour-actions()
 <$action-setfield $tiddler=<<actionTiddler>> $field="color" $value=<<currentTiddler>>/>
 \end
 
@@ -26,22 +31,23 @@ See DragAndDropMechanism for an overview.
 
 ! Content and Attributes
 
-|!Attribute |!Description |
-|actions |Actions to be performed when items are dropped |
+|! Attribute |! Description |
+|actions |Actions to be performed when items are dropped. It activates ''1 action per item'' |
+|listActions |<<.from-version "5.3.4">> Actions to be performed when items are dropped. It activates ''1 action for'' a the whole ''list of items'' |
 |class |Optional CSS classes to assign to the draggable element. The class `tc-droppable` is added automatically, and the class `tc-dragover` is applied while an item is being dragged over the droppable element |
 |tag |Optional tag to override the default of a "div" element when the widget is rendered in block mode, or a "span" element when it is rendered in inline mode |
 |enable |<<.from-version "5.1.22">> Optional value "no" to disable the droppable functionality (defaults to "yes") |
 |data-* |<<.from-version "5.3.2">> Optional [[data attributes|https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes]] to be assigned to the HTML element |
 |style.* |<<.from-version "5.3.2">> Optional [[CSS properties|https://developer.mozilla.org/en-US/docs/Web/CSS/Reference]] to be assigned to the HTML element |
 
-Within the action string, there are two Variables generated by the DroppableWidget:
+''Within the action string'', the following variables are generated by the DroppableWidget:
 
-* The [[actionTiddler Variable]] contains the title of the item being dropped
-* The [[modifier Variable]] contains the Modifier Key held while dragging (can be normal, ctrl, shift or ctrl-shift)
+|!Variables |!Description |
+|`actionTiddler` |For parameter <<.param actions>>, the [[actionTiddler Variable]] contains the title of the item being dropped |
+|`actionTiddlerList` |For parameter <<.param listActions>> the [[actionTiddlerList Variable]] contains a [[Title List]] of all the items being dropped |
+|`modifier` |The [[modifier Variable]] contains the modifier key held while dragging (can be normal, ctrl, shift or ctrl-shift) |
 
-If multiple items are dropped then the actions are performed repeatedly, once for each dropped item.
-
-<<.tip """Note that the [[actionTiddler Variable]] holds a single, unquoted title. This is unlike the DraggableWidget which uses the same variable to pass a quoted [[Title List]].""">>
+<<.note """Note that the <<.var actionTiddler>> variable holds a single, unquoted title. This is unlike the DraggableWidget which uses the same variable to pass a quoted [[Title List]].""">>
 
 ! Examples
 
@@ -53,9 +59,22 @@ This example displays a palette of icons. Dragging a tiddler onto one of the ico
 </$droppable>
 </$list>
 
+---
+
 Similarly, this example shows a palette of colours. Dragging a tiddler onto one of the colours assigns that colour to be used for rendering the icon of the tiddler.
 
 <$list filter="LightPink Pink Crimson LavenderBlush PaleVioletRed HotPink DeepPink MediumVioletRed Orchid Thistle Plum Violet Magenta Fuchsia DarkMagenta Purple MediumOrchid DarkViolet DarkOrchid Indigo BlueViolet MediumPurple MediumSlateBlue SlateBlue DarkSlateBlue Lavender GhostWhite Blue MediumBlue MidnightBlue DarkBlue Navy RoyalBlue CornflowerBlue LightSteelBlue LightSlateGrey SlateGrey DodgerBlue AliceBlue SteelBlue LightSkyBlue SkyBlue DeepSkyBlue LightBlue PowderBlue CadetBlue Azure LightCyan PaleTurquoise Cyan Aqua DarkTurquoise DarkSlateGrey DarkCyan Teal MediumTurquoise LightSeaGreen Turquoise Aquamarine MediumAquamarine MediumSpringGreen MintCream SpringGreen MediumSeaGreen SeaGreen Honeydew LightGreen PaleGreen DarkSeaGreen LimeGreen Lime ForestGreen Green DarkGreen Chartreuse LawnGreen GreenYellow DarkOliveGreen YellowGreen OliveDrab Beige LightGoldenrodYellow Ivory LightYellow Yellow Olive DarkKhaki LemonChiffon PaleGoldenrod Khaki Gold Cornsilk Goldenrod DarkGoldenrod FloralWhite OldLace Wheat Moccasin Orange PapayaWhip BlanchedAlmond NavajoWhite AntiqueWhite Tan BurlyWood Bisque DarkOrange Linen Peru PeachPuff SandyBrown Chocolate SaddleBrown Seashell Sienna LightSalmon Coral OrangeRed DarkSalmon Tomato MistyRose Salmon Snow LightCoral RosyBrown IndianRed Red Brown FireBrick DarkRed Maroon White WhiteSmoke Gainsboro LightGrey Silver DarkGrey Grey DimGrey Black">
 <<colour-demo-body>>
 </$list>
 
+---
+
+Drag the tag pill <<tag HelloThere>> or a single tiddler link [[HelloThere]] into the "Drop Area" below. It will show the "Title List" stored in $:/temp/drop/TitleList
+
+<<.note title:""
+_:"""<$droppable listActions=<<drop-on-tags-actions>> >
+''Drop'' the tagpill or a link into this ''area''.<br>
+~TitleList: <$transclude $tiddler="$:/temp/drop/TitleList"/>
+</$droppable>""">>
+
+

package/editions/tw5.com/tiddlers/widgets/EditTextWidget.tid

@@ -1,7 +1,9 @@
 caption: edit-text
 created: 20131024141900000
-modified: 20230122210049893
+heading: 
+modified: 20240627184331133
 tags: Widgets
+temp: 
 title: EditTextWidget
 type: text/vnd.tiddlywiki
 
@@ -66,3 +68,18 @@ Provide a dated heading for this example where only the placeholder (but not the
 <$macrocall $name=".example" n="3"
 eg="""<$edit-text tiddler=<<currentTiddler>> field="heading" size="25" focus="yes" focusSelectFromEnd="13" default={{{ [[Heading Text (]] [<now YYYY-0MM-0DD>] [[)]] +[join[]] }}} />
 """/>
+
+!!! Input Actions, with class attribute
+
+<$macrocall $name=".example" n="4"
+eg="""\procedure onInput()
+  <%if [get[temp]match[$:/]] %>
+		<$action-confirm $message="Yes, this is how system tiddler names begin!"/>
+  <%endif%>
+\end
+
+Type a new tiddler name, starting with the system prefix `$:/`: <$edit-text inputActions=<<onInput>> field="temp" class="tc-edit-texteditor"/>
+
+"""/>
+
+

package/editions/tw5.com/tiddlers/widgets/EditWidget.tid

@@ -1,6 +1,6 @@
 caption: edit
 created: 20131024141900000
-modified: 20211009121634055
+modified: 20240627220419761
 tags: Widgets TriggeringWidgets
 title: EditWidget
 type: text/vnd.tiddlywiki
@@ -24,3 +24,16 @@ The content of the `<$edit>` widget is ignored.
 |inputActions |<<.from-version 5.1.23>> Optional actions that are triggered every time an input event occurs within the input field or textarea |
 |refreshTitle |<<.from-version 5.1.23>> An optional tiddler title that makes the input field update whenever the specified tiddler changes |
 
+! Examples
+
+!! Edit the contents (text field) of a tiddler titled <%if [<now YYYY-0MM-0DD>is[tiddler]] %> <$tiddler tiddler=<<now YYYY-0MM-0DD>> > <$link/></$tiddler> <%else %> with today’s date <%endif%>
+
+<$macrocall $name=".example" n="1"
+eg="""<$edit tiddler=<<now YYYY-0MM-0DD>> class="tc-edit-texteditor"/>
+"""/>
+
+!! Edit $:/status/UserName with single-line input box, have browser offer autocomplete for email
+
+<$macrocall $name=".example" n="2"
+eg="""<$edit-text tiddler="$:/status/UserName" tag="input" size=40 autocomplete="email"/>
+"""/>

package/editions/tw5.com/tiddlers/widgets/GenesisWidget.tid

@@ -25,7 +25,7 @@ The content of the <<.wid genesis>> widget is used as the content of the dynamic
 
 <<.from-version "5.2.6">> If the `$type` attribute is missing or blank, the <<.wlink GenesisWidget>> widget does not render an intrinsic element, instead just rendering its children.
 
-Note that attributes explicitly specified take precedence over attributes with the same name specified in the `$names` filter.
+<<.from-version "5.3.6">> Note that attributes explicitly specified take precedence over attributes with the same name specified in the `$names` filter. This has always been the documented behaviour but prior to [[Release 5.3.6]] the implementation was reversed, and the `$names` attributes took precedence. This was fixed in [[Release 5.3.6]].
 
 ! Examples
 

package/editions/tw5.com/tiddlers/widgets/LinkCatcherWidget.tid

@@ -1,6 +1,6 @@
 caption: linkcatcher
 created: 20131024141900000
-modified: 20220226121122574
+modified: 20241031151342973
 tags: Widgets MessageHandlerWidgets TriggeringWidgets
 title: LinkCatcherWidget
 type: text/vnd.tiddlywiki
@@ -23,6 +23,10 @@ The content of the `<$linkcatcher>` widget is displayed normally.
 |message |Optional identifier for a [[widget message|Messages]] to be sent when a navigation is caught  |
 |set |Optional title of the tiddler to be set to a specified value when navigation occurs |
 |setTo |Value to be assigned by the `set` attribute |
-|actions |Actions to be performed when a link is caught. Within the action string, the variable "navigateTo" contains the title of the tiddler being navigated. <<.from-version "5.1.23">> the <<.def "modifier">> variable lists the modifier keys that are pressed when the action is invoked. The possible modifiers are ''ctrl'', ''ctrl-alt'', ''ctrl-shift'', ''alt'', ''alt-shift'', ''shift'' and ''ctrl-alt-shift'' |
+|actions |Actions to be performed when a link is caught. Within the action string, the variable <<.var navigateTo>> contains the title of the tiddler being navigated.<br><<.from-version "5.1.23">> the <<.var modifier>> variable lists the modifier keys that are pressed when the action is invoked.<br>The possible modifiers are ''ctrl'', ''ctrl-alt'', ''ctrl-shift'', ''alt'', ''alt-shift'', ''shift'' and ''ctrl-alt-shift'' |
+
+|!Action Variables |!Description |
+|`navigateTo` |Contains the tiddler title being navigated to  |
+|`modifier` |Contains the value of a modifier key, active while actions are activated |
 
 <<.tip """<<.from-version "5.2.0">> For more complex use cases involving trapping the <<.param tm-navigate>> message consider the MessageCatcherWidget which provides greater flexibility""">>

package/editions/tw5.com/tiddlers/widgets/LinkWidget.tid

@@ -1,6 +1,6 @@
 caption: link
 created: 20131024141900000
-modified: 20231113093304323
+modified: 20240730065043721
 tags: Widgets
 title: LinkWidget
 type: text/vnd.tiddlywiki
@@ -69,11 +69,13 @@ This causes the tooltip to be the ''tooltip'' field of the target tiddler. If th
 
 The link widget automatically determines and applies the following classes to links:
 
-* `tc-tiddlylink` - applied to all links
+* `tc-tiddlylink` - applied to ''all'' links
 * `tc-tiddlylink-external` - applied to external, non-tiddler links
 * `tc-tiddlylink-internal` - applied to tiddler links
 * `tc-tiddlylink-missing` - applied to tiddler links where the target tiddler doesn't exist
 * `tc-tiddlylink-resolves` - applied to tiddler links when the target tiddler does exist
+* `tc-tiddlylink-shadow` - applied to tiddler links when the target is a shadow tiddler
+** `tc-tiddlylink-shadow tc-tiddlylink-resolves` - applied to ''overwritten'' shadow tiddlers
 
 Use the `class` attribute to specify additional css classes, or `overrideClass` to apply only that but not the above defaults, e.g. when used in a LinkCatcherWidget:
 

package/editions/tw5.com/tiddlers/widgets/RevealWidget.tid

@@ -1,7 +1,7 @@
 caption: reveal
 created: 20131024141900000
 jeremy: tiddlywiki
-modified: 20230803052644851
+modified: 20240721175716320
 tags: Widgets
 title: RevealWidget
 type: text/vnd.tiddlywiki
@@ -47,57 +47,10 @@ This is useful for edge-cases where titles may contain characters that are used
 
 ! Examples
 
-!! Simple content reveal
+<<testcase TestCases/RevealWidget/SimpleReveal>>
 
-Here's a simple example of showing and hiding content with buttons:
+<<testcase TestCases/RevealWidget/AccordionSlider>>
 
-<<wikitext-example-without-html '<$button set="$:/state/SampleReveal1" setTo="show">Show me</$button>
-<$button set="$:/state/SampleReveal1" setTo="hide">Hide me</$button>
+<<testcase TestCases/RevealWidget/Popup>>
 
-<$reveal type="match" state="$:/state/SampleReveal1" text="show">
-
-! This is the revealed content
-And this is some text
-
-</$reveal>'>>
-
-!! Accordion or Slider
-
-An "accordion" or "slider" is a button that can be used to toggle the display of associated content.
-
-<<wikitext-example-without-html '<$reveal type="nomatch" state="$:/state/SampleReveal2" text="show">
-
-<$button set="$:/state/SampleReveal2" setTo="show">Show me</$button>
-
-</$reveal>
-<$reveal type="match" state="$:/state/SampleReveal2" text="show">
-
-<$button set="$:/state/SampleReveal2" setTo="hide">Hide me</$button>
-
-! This is the revealed content
-And this is some text
-
-</$reveal>'>>
-
-!! Popup
-
-Here is a simple example of a popup built with the RevealWidget:
-
-<<wikitext-example-without-html '<$button popup="$:/SamplePopupState">Pop me up!</$button>
-
-<$reveal type="popup" state="$:/SamplePopupState">
-<div class="tc-drop-down">
-
-! This is the popup
-And this is some text
-
-</div>
-</$reveal>'>>
-
-!! How to use text references with field content
-
-Here is a simple example how to use text references with field content to control the  RevealWidget. If the field ``jeremy`` is populated with text ``tiddlywiki``, a message will be displayed.
-
-<<wikitext-example-without-html '<$reveal type="match" state="!!jeremy" text="tiddlywiki">
-~TiddlyWiki!
-</$reveal>'>>
+<<testcase TestCases/RevealWidget/TextReference>>

package/editions/tw5.com/tiddlers/widgets/Widgets.tid

@@ -1,6 +1,6 @@
 created: 20140908130500000
-modified: 20240326164134356
-tags: Concepts Reference
+modified: 20240422083334052
+tags: Concepts [[Core Widgets]]
 title: Widgets
 type: text/vnd.tiddlywiki
 
@@ -14,6 +14,4 @@ Each class of widget contributes a specific ability to the overall functionality
 
 The more specialised widgets use a general-purpose [[widget syntax|Widgets in WikiText]] as their only possible WikiText representation.
 
-The following classes of widget are built into the core:
 
-<<list-links "[tag[Widgets]]" class:"multi-columns">>

package/editions/tw5.com/tiddlers/wikitext/Conditional Shortcut Syntax.tid

@@ -11,40 +11,40 @@ Within an "if" or "elseif" clause, the variable `condition` contains the value o
 A simple example:
 
 <$macrocall $name='wikitext-example-without-html'
-src='<% if [{$:/info/url/protocol}match[file:]] %>
+src='<%if [{$:/info/url/protocol}match[file:]] %>
   Loaded from a file URI
-<% else %>
+<%else%>
   Not loaded from a file URI
-<% endif %>
+<%endif%>
 '/>
 
-One or more `<% elseif %>` clauses may be included before the `<% else %>` clause:
+One or more `<%elseif%>` clauses may be included before the `<%else%>` clause:
 
 <$macrocall $name='wikitext-example-without-html'
-src='<% if [{$:/info/url/protocol}match[file:]] %>
+src='<%if [{$:/info/url/protocol}match[file:]] %>
   Loaded from a file URI
-<% elseif [{$:/info/url/protocol}match[https:]] %>
+<%elseif [{$:/info/url/protocol}match[https:]] %>
   Loaded from an HTTPS URI
-<% elseif [{$:/info/url/protocol}match[http:]] %>
+<%elseif [{$:/info/url/protocol}match[http:]] %>
   Loaded from an HTTP URI
-<% else %>
+<%else%>
   Loaded from an unknown protocol
-<% endif %>
+<%endif%>
 '/>
 
 The conditional shortcut syntax can be nested:
 
 <$macrocall $name='wikitext-example-without-html'
 src='\procedure test(animal)
-<% if [<animal>match[Elephant]] %>
+<%if [<animal>match[Elephant]] %>
   It is an elephant
-<% else %>
-  <% if [<animal>match[Giraffe]] %>
+<%else%>
+  <%if [<animal>match[Giraffe]] %>
     It is a giraffe
-  <% else %>
+  <%else%>
     It is completely unknown
-  <% endif %>
-<% endif %>
+  <%endif%>
+<%endif%>
 \end
 
 <<test "Giraffe">>
@@ -56,7 +56,7 @@ src='\procedure test(animal)
 
 Notes:
 
-* Clauses are parsed in inline mode by default. Force block mode parsing by following the opening `<% if %>`, `<% elseif %>` or `<% else %>` with two line breaks
+* Clauses are parsed in inline mode by default. Force block mode parsing by following the opening `<%if %>`, `<%elseif%>` or `<%else%>` with two line breaks
 * Widgets and HTML elements must be within a single conditional clause; it is not possible to start an element in one conditional clause and end it in another
 * The conditional shortcut syntax cannot contain pragmas such as procedure definitions
 

package/editions/tw5.com/tiddlers/wikitext/HTML Entities.tid

@@ -1,5 +1,5 @@
 created: 20130204165019000
-modified: 20221025124615415
+modified: 20240726074846436
 tags: WikiText
 title: HTML Entities
 type: text/vnd.tiddlywiki
@@ -30,7 +30,8 @@ Comprehensive lists of html entities can be found at...
 !! Examples Of Common And Useful Entities
 
 |>|>|>|>|>|>| ! HTML Entities |
-|   |   | no-break space |    | ' | ' | single quote, apostrophe |
+|   |   | no-break space |    |  |  |  |
+| &~NoBreak; | ⁠ | zerro width WordJoiner |    | ' | ' | single quote, apostrophe |
 | – | – | en dash |~| " | " | quotation mark |
 | — | — | em dash |~| ′ | ′ | prime; minutes; feet |
 | … | … |	horizontal ellipsis |~| ″ | ″ | double prime; seconds; inches |

package/editions/tw5.com/tiddlers/wikitext/HTML in WikiText.tid

@@ -1,6 +1,6 @@
 caption: HTML
 created: 20131205160816081
-modified: 20230615060119987
+modified: 20241025073517909
 tags: WikiText
 title: HTML in WikiText
 type: text/vnd.tiddlywiki
@@ -68,13 +68,13 @@ In an extension of conventional HTML syntax, attributes of elements and widgets
 
 !! Style Attributes
 
-<<.from-version "5.2.2">> TiddlyWiki supports the usual HTML ''style'' attribute for assigning CSS styles to elements:
+TiddlyWiki supports the usual HTML ''style'' attribute for assigning CSS styles to elements:
 
 ```
 <div style="color:red;">Hello</div>
 ```
 
-In an extension to HTML, TiddlyWiki also supports accessing individual CSS styles as independent attributes. For example:
+<<.from-version "5.2.2">> In an extension to HTML, TiddlyWiki also supports accessing individual CSS styles as independent attributes. For example:
 
 ```
 <div style.color="red">Hello</div>
@@ -86,10 +86,8 @@ The advantage of this syntax is that it simplifies assigning computed values to
 <div style.color={{!!color}}>Hello</div>
 ```
 
+<<.from-version "5.3.6">> TiddlyWiki also supports setting [[CSS custom properties|https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties]] as independent attributes. For example:
 
-
-
-
-
-
-
+```
+<div --bg-color={{{ [[red]] }}}>Hello</div>
+```

package/editions/tw5.com/tiddlers/wikitext/Lists in WikiText.tid

@@ -48,7 +48,7 @@ Here's an example the other way around, with numbers as the first level:
 You can also assign a CSS class to an individual member of a list with this notation:
 
 <<wikitext-example src:"* List One
-*.MyClass List Two
+*.tc-muted List Two
 * List Three
 ">>
 

package/editions/tw5.com/tiddlers/wikitext/Utility Classes.tid

@@ -13,8 +13,9 @@ type: text/vnd.tiddlywiki
 |`tc-max-width-80`|Sets the width of a block-element to use 80% of the maximum container width. This setting is useful with the `tc-center` class |
 |`tc-edit-max-width `|Expands [[TextWidget]]s to use the maximum available width. See [[ControlPanel -> Info -> Basics|$:/core/ui/ControlPanel/Basics]]|
 |`tc-first-link-nowrap` |Ensures that any links in the first table column will never wrap to the next line |
-
+|`tc-clearfix`|<<.from-version "5.3.6">> This class can be used to prevent elements, that have a `class="tc-float-right"` from overflowing their container elements. tc-clearfix is already assigned to all major ViewTemplate and EditTemplate elements. So it only needs to be used where the default does not work out of the box.|
 !! Table Utility Classes
 
 |`tc-table-no-border` |Removes the borders of a table |
 |`tc-first-col-min-width` |The first column of a table will take up minimal possible width. It adapts to the content |
+|`tc-table-wrapper` |<<.from-version "5.3.6">> A class to be applied to a `div` element outside the table to prevent table from overflowing |

package/editions/tw5.com/tiddlers/wikitext/parser/Places where the parser ignores WikiText.tid

@@ -1,6 +1,6 @@
 caption: ignore parser mode
 created: 20220111000929700
-modified: 20220122182842038
+modified: 20240921085112396
 tags: [[WikiText Parser Modes]]
 title: Places where the parser ignores WikiText
 type: text/vnd.tiddlywiki
@@ -10,5 +10,5 @@ Text enclosed by these constructs is skipped by the parser and WikiText punctuat
 |[[Code Blocks in WikiText]]|One of the main purposes of code blocks is to suppress wikitext expansion. Once the code block starts, the parser will ignore all WikiText punctuation until the code block ends.|
 |[[Images in WikiText]]|`[[img|literal image link text]]` - the text enclosed by square braces will be ignored. This means, for example, [[transclusions|Transclusion in WikiText]] and [[macro calls|Macro Calls]] cannot be used to dynamically construct the link text|
 |[[Linking in WikiText]]|`[[literal link target|literal link text]]` - the text enclosed by square braces will be ignored. This means, for example, [[transclusions|Transclusion in WikiText]] and [[macro calls|Macro Calls]] cannot be used to dynamically construct the link target or the link text|
-|[[Macro Calls]]|`<<mymacro ''notbold'' "literal text" "<<macro_expansion_ignored>>" {{transclusion_ignored}}>>` - while processing the text enclosed by a macro call, the parser will follow special rules for detecting macro parameters. These rules do not include detection of WikiText. However, after the parameters are substituted into the macro definition, the result will be parsed using [[normal rules|Wiki Text Parser Modes]]. This will likely result in the detection of any WikiText.|
+|[[Macro Calls]]|`<<mymacro ''notbold'' "literal text" "<<macro_expansion_ignored>>" {{transclusion_ignored}}>>` - while processing the text enclosed by a macro call, the parser will follow special rules for detecting macro parameters. These rules do not include detection of WikiText. However, after the parameters are substituted into the macro definition, the result will be parsed using the [[normal rules|WikiText Parser Modes]]. This will likely result in the detection of any WikiText.|
 

package/editions/tw5.com/tiddlers/wikitext/parser/WikiText parser mode_ HTML examples.tid

@@ -1,38 +1,20 @@
 created: 20220122153235162
-modified: 20220122180508134
+modified: 20240713165558596
 tags: [[WikiText parser mode transitions]]
 title: WikiText parser mode: HTML examples
 type: text/vnd.tiddlywiki
 
-<<wikitext-example-without-html "<div>
-
-* blank line after open tag allows
-* block mode punctuation (i.e. this list) to
-* be recognised
-</div>
-">>
+<<testcase TestCases/HTML/OpenTagBlankLine>>
 
 ---
 
 The open tag blank line "trick" also works inside of punctuation only recognised in inline mode (such as [[Formatting in WikiText]]):
 
-<<wikitext-example-without-html "''<div>
-
-* list item one
-* list item two
-</div>''">>
+<<testcase TestCases/HTML/OpenTagBlankLineInBoldSyntax>>
 
 ---
 
-<<wikitext-example-without-html "<div>
-* Open tag without a blank line means
-* block mode punctuation (i.e. this list) will
-* NOT be recognised.
-
-Paragraphs are only recognised in block mode. Even with blank lines, new paragraphs are not recognised.
-
-This also is not a new paragraph.
-</div>">>
+<<testcase TestCases/HTML/OpenTagNoBlankLine>>
 
 ---
 
@@ -42,11 +24,7 @@ Adding a blank link after an open tag within a table cell causes the row to span
 
 <<wikitext-example-without-html "|table row|all on|one line|is recognised|">>
 
-<<wikitext-example-without-html "|For a blank line after open tag|<div>
-
-* list is recognised
-* but the surrounding table row is not
-</div>|">>
+<<testcase TestCases/HTML/OpenTagBlankLineInTableSyntax>>
 
 ---
 
@@ -58,15 +36,4 @@ Note that <<.wlink MacroCallWidget>> does not have a similar <<.attr mode>> attr
 
 ---
 
-The less convenient `<table>`, `<tr>`, `<td>` html tags can be used as a foolproof way to get [[block mode|Block Mode WikiText]] punctuation recognised inside of table cells.
-
-<<wikitext-example-without-html "<table>
-<tr><td>
-
-* list item one
-* list item two
-</td><td>
-
-|nested|table|
-</td></tr>
-</table>">>
+<<testcase TestCases/HTML/BlockModeInHTMLTable>>

package/editions/tw5.com/tiddlers/workingwithtw/TiddlyWiki Privacy and Security.tid

@@ -0,0 +1,48 @@
+title: TiddlyWiki Privacy and Security
+created: 20241106165307259
+modified: 20241106165307259
+
+<span class="tc-float-right">[img width=200 [TiddlyWiki Privacy Badge.png]]</span>
+TiddlyWiki is unique in that ordinary people without special training can use it securely and privately. It is easy to apply the advice from the EFF to ~TiddlyWiki. The key is that ~TiddlyWiki is just a file, and so everything that users may have already learned about how to keep documents and images private can be applied to ~TiddlyWiki.
+
+Because data is stored in simple text files, people choosing to use ~TiddlyWiki today can be confident that their data will still be accessible in the decades to come.
+
+! Verifiable Trust
+
+An important aspect of ~TiddlyWiki's claims in the area of security and privacy is that these claims can be readily verified by anyone with basic technical skills. For example, the network monitoring tools built into browsers allow users to verify that ~TiddlyWiki doesn't send any data to other servers. Similarly anyone can open a ~TiddlyWiki HTML file in an editor and verify that their data is readily accessible.
+
+! Single File Configuration
+
+As a practical matter, using ~TiddlyWiki securely and privately in the single file configuration depends upon keeping that single file securely and privately.
+
+Users can employ the same tools that they use to keep any document and photograph secure. So, for many users, the simplest solution will be to use an existing file storage service such as Google Drive, Apple's iCloud, or Dropbox. Many users will already be relying on the privacy and security of these services.
+
+There are also open source alternatives such as [[Syncthing|https://syncthing.net/]] that allow users to synchronise files between their devices without using a third party service.
+
+Users may wish to use additional layers of security. ~TiddlyWiki in the single file configuration itself offers built-in encryption. It uses an industry standard encryption library to offer AES 128 bit encryption in CCM mode. All the data within the file is encrypted, and cannot be accessed without entering the correct password. The password is never stored in the file, and so if it is lost, the data is lost. Instructions can be found in [[Encryption]].
+
+It is important to understand that ~TiddlyWiki's built in encryption is our best endeavour to offer privacy and usability. However, the encryption feature has not been subject to the kind of rigorous third party testing that characterises secure services like Signal or Syncthing.
+
+So, cautious users may wish to use ~TiddlyWiki's built in encryption as an extra layer of security, but should take care not to rely on it as one would rely on industry standard encryption solutions that have been rigorously tested in a variety of situations.
+
+! Node.js Configuration
+
+Using ~TiddlyWiki in the Node.js configuration requires more technical knowledge than the single file edition. There are several important areas with respect to security and privacy.
+
+Firstly, and most obviously, there is the matter of how user data is stored on disc as individual `.tid` files. Just as with the single file configuration, these are just ordinary files, and so can be used with third party tools that provide encryption.
+
+Secondly, consideration must be given to how data is transmitted across the network. By default, the Node.js configuration does not use SSL and so traffic can be observed by others (the impact is mitigated by the fact that by default only users on the same machine can connect to the server). While ~TiddlyWiki itself does offer the option of setting up an SSL connection it is generally advised to use an external proxy server to provide SSL services. nginx is popular for this purpose.
+
+! Community Tools
+
+There are also third party tools from the community that extend ~TiddlyWiki's built in encryption:
+
+* [["Encrypt single tiddler plugin" by Danielo Rodriguez]] allows individual tiddlers to be encrypted
+* [[TW5-CSEncryption|https://wiki.fspark.me/TW5-CSEncryption/]] offers client-side encryption for ~TiddlyWiki on Node.js
+
+! Further Information
+
+If security and privacy are important to you then you need to take the best available advice, and the best place for that is specialist organisations that focus on this area. The Electronic Frontier Foundation in the US is well respected, and their advice would be a good place to start. It emphasises basics such as dealing with passwords and two factor authentication, but also explains more advanced topics such as making a security plan, and how to set up a device securely.
+
+https://ssd.eff.org/module-categories/basics
+

package/editions/tw5.com/tiddlywiki.info

@@ -1,16 +1,13 @@
 {
 	"description": "Documentation from https://tiddlywiki.com",
 	"plugins": [
-		"tiddlywiki/nodewebkitsaver",
 		"tiddlywiki/browser-sniff",
 		"tiddlywiki/railroad",
-		"tiddlywiki/evernote",
 		"tiddlywiki/internals",
 		"tiddlywiki/menubar",
 		"tiddlywiki/confetti",
 		"tiddlywiki/dynannotate",
-		"tiddlywiki/tour",
-		"tiddlywiki/qrcode"
+		"tiddlywiki/tour"
 	],
 	"themes": [
 		"tiddlywiki/vanilla",

package/editions/tw5.com-docs/tiddlers/Welcome to tw5.com-docs.tid

@@ -2,7 +2,7 @@ title: Welcome to tw5.com-docs
 
 This edition of TiddlyWiki is a tool to help people make and submit improvements to the main documentation on https://tiddlywiki.com/
 
-In this wiki, all the tiddlers from https://tiddlywiki.com (to be precise, all the tiddlers [[from here|https://github.com/Jermolene/TiddlyWiki5/tree/master/editions/tw5.com/tiddlers]]) are packed into a plugin:
+In this wiki, all the tiddlers from https://tiddlywiki.com (to be precise, all the tiddlers [[from here|https://github.com/TiddlyWiki/TiddlyWiki5/tree/master/editions/tw5.com/tiddlers]]) are packed into a plugin:
 
 [[$:/plugins/tiddlywiki/tw5.com-docs]]
 

package/editions/tw5.com-server/tiddlywiki.info

@@ -4,7 +4,6 @@
 		"tiddlywiki/tiddlyweb",
 		"tiddlywiki/filesystem",
 		"tiddlywiki/highlight",
-		"tiddlywiki/mobiledragdrop",
 		"tiddlywiki/internals"
 	],
 	"themes": [