This page is part of a static HTML representation of the TiddlyWiki at https://tiddlywiki.com/

Releases

 5th October 2023 at 8:56pm

New releases of TiddlyWiki and TiddlyDesktop are announced via the official discussion groups and Twitter

See the TiddlyWiki Archive to download older versions.

Here are the details of recent releases of TiddlyWiki5. See TiddlyWiki5 Versioning for details of how releases are named.

If you are using node.js, you can also install prior versions like this:

npm install -g tiddlywiki@5.1.13

(BetaReleases and AlphaReleases are listed separately).

Release 5.3.3

Released 23rd December 2023 at 10:22

See GitHub for detailed change history of this release

Congratulations to catter-fly for their winning design for the banner for this release (here is the competition thread).

This is a bug fix release to address a number of bugs that were introduced with Release 5.3.2.

  • fixed handling of a list widget with an empty paragraph as inline template
  • fixed broken per-tiddler previews
  • fixed missing comma before skinny tiddlers in JSON store area
  • fixed handling of whitespace immediately after pragmas
  • fixed SelectWidget handling of classes and rendering typo

Since v5.3.3 replaces v5.3.2 after only a couple of weeks, here is the release note for v5.3.2.

Release Note for v5.3.2

See GitHub for detailed change history of this release

Congratulations to catter-fly for their winning design for the banner for this release (here is the competition thread).

Major Improvements

Conditional Shortcut Syntax

added a new shortcut syntax for concisely expressing if-then-else logic. This is the first of a new type of wikitext syntax based on tokens delimited with <% and %>. We plan to introduce other structures using the same format such as a "case" statement.

These new token-based shortcuts allow a richer structure and expressivity than existing features such as widgets or pragmas. For example:

<% if [<animal>match[Elephant]] %>
  It is an elephant
<% elseif [<animal>match[Giraffe]] %>
	It is a giraffe
<% else %>
	It is completely unknown
<% endif %>

Behind the scenes, the conditional shortcut syntax is rendered as the equivalent ListWidgets.

Explicit Templates for the ListWidget

added support for <$list-template> and <$list-empty> as immediate children of the $ListWidget widget to specify the list item template and/or the empty template.

This new feature is designed to replace a common pattern of using the emptyMessage attribute of the ListWidget to render complex wikitext that thus has to be quoted. Working with wikitext within quotes is awkward and error prone. The new structure can be somewhat faster because it allows the empty message to be parsed in advanced of rendering.

For example:

<$list filter=<<filter>>>
	<$list-template>
		<$text text=<<currentTiddler>>/>
	</$list-template>
	<$list-empty>
		None!
	</$list-empty>
</$list>

Note that the emptyMessage and template attributes take precedence if they are present.

Joiners for the ListWidget

added a join attribute to the $ListWidget widget to insert a short piece of text between list items. This is both easier to use and faster than using the counter attribute for the same purpose. So if your list looked like this:

<$list filter=<<filter>> counter="counter" variable="item">
<$text text=<<item>>/><$list filter="[<counter-last>match[no]]" variable="ignore"><$text text=", "/></$list>
</$list>

You can replace it with:

<$list filter=<<filter>> variable="item" join=", "><$text text=<<item>>/></$list>

If the joiner text that you need is long and awkward to write in an attribute, you can use the new <$list-join> widget. Like <$list-template> and <$list-empty>, it must be an immediate child of the $ListWidget:

<$list filter=<<filter>> variable="item"><$text text=<<item>>/><$list-join>, and <em>also</em> let's not forget </$list-join></$list>

jsonset operator

added jsonset Operator for setting values within JSON objects

QR Code Reader

extended QR Code plugin to be able to read QR codes and a number of other bar code formats

Translation improvements

Improvements to the following translations:

  • Chinese
  • Polish
  • Spanish

Plugin Improvements

  • fixed Comments Plugin to use predefined palette colours
  • improved Evernote Importer Plugin to support images and other attachments
  • added $floating attribute to Dynannotate Plugin to support popups that do not disappear when another part of the screen is clicked. Instead they have to dismissed manually

Widget Improvements

Usability Improvements

  • updated editor preview button to automatically focus the editor
  • improved file type names in the export menu

Hackability Improvements

Bug Fixes

Node.js Improvements

  • fixed a significant flaw in the synchronisation algorithm used by the client-server configuration. The flaw could lead to tiddlers temporarily disappearing from the browser

Performance Improvements

Developer Improvements

  • improved global hook handling to support removing hooks
  • added some useful npm scripts to package.json

Infrastructure Improvements

Acknowledgements

@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:

  1. @AnthonyMuscio
  2. @BramChen
  3. @BuckarooBanzay
  4. @BurningTreeC
  5. @CrossEye
  6. @EvidentlyCube
  7. @Gk0Wk
  8. @joebordes
  9. @kookma
  10. @linonetwo
  11. @mateuszwilczek
  12. @oflg
  13. @pille1842
  14. @pmario
  15. @rmunn
  16. @saqimtiaz
  17. @simonbaird
  18. @T1mL3arn
  19. @yaisog