tiddlywiki 5.1.23 → 5.2.2

package/editions/tw5.com/tiddlers/releasenotes/Release 5.2.2.tid

@@ -0,0 +1,162 @@
+caption: 5.2.2
+created: 20220325130817150
+modified: 20220325130817150
+released: 20220325130817150
+tags: ReleaseNotes
+title: Release 5.2.2
+type: text/vnd.tiddlywiki
+
+\define contributor(username)
+<a href="https://github.com/$username$" style="text-decoration:none;font-size:24px;" class="tc-tiddlylink-external" target="_blank" rel="noopener noreferrer"><img src="https://github.com/$username$.png?size=32" width="32" height="32"/> @<$text text=<<__username__>>/></a>
+\end
+
+//[[See GitHub for detailed change history of this release|https://github.com/Jermolene/TiddlyWiki5/compare/v5.2.1...v5.2.2]]//
+
+<<.banner-credits
+	credit:"""Congratulations to [[Elise Springer|https://www.wesleyan.edu/academics/faculty/espringer/profile.html]] for her winning design for the banner for this release (here is the [[competition thread|https://groups.google.com/d/msgid/tiddlywiki/ad868177-3432-4f8c-bec5-5f6639d1aeddn%40googlegroups.com]]).
+"""
+	url:"https://raw.githubusercontent.com/Jermolene/TiddlyWiki5/e26a4d8cb54fa60b8a47e3cef2c3a962535ca619/editions/tw5.com/tiddlers/images/New%20Release%20Banner.png"
+>>
+
+! Highlights
+
+!! <<.link-badge-updated "https://github.com/Jermolene/TiddlyWiki5/pull/6427">> [[Highlight Plugin]] to use highlight.js v11.4.0
+
+This is a major upgrade to the latest version of highlight.js. The new version has many improvements, including better support for Fortran.
+
+<<.warning """The new version of the [[Highlight Plugin]] requires a modern browser that fully supports JavaScript ES6 (released in 2015). The older version is still available as the ''highlight-legacy'' plugin for users who need to use an older browser.""">>
+
+!! <<.link-badge-extended "https://github.com/Jermolene/TiddlyWiki5/pull/6498">> support for secondary windows
+
+The [[WidgetMessage: tm-open-window]] now supports an optional `windowID` parameter so that opened windows can be closed with the new [[WidgetMessage: tm-close-window]] message. There is also a new [[WidgetMessage: tm-close-all-windows]] message which closes all secondary windows.
+
+!! <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6421">> support for line breaks within filtered transcluded attributes
+
+To improve readability, it is now possible to use newlines as whitespace within filtered transcluded attributes of HTML elements and widgets. For example:
+
+```
+<span class={{{
+	[<currentTiddler>addsuffix[-primaryList]]
+	:except[<searchListState>get[text]]
+	:and[then[]else[tc-list-item-selected]]
+}}}>
+```
+
+!! <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/6383">> inconsistent ordering of tagged tiddlers
+
+This was a long standing bug that manifested itself in several ways.
+
+The root cause was that the order in which tiddlers were enumerated depended upon the order in which they had been added to the store.
+
+The effect was that lists based on enumerating tiddlers would show different results depending upon whether new tiddlers were added since the wiki was reloaded.
+
+For example, adding a new tiddler with a given tag previously caused the new tiddler to appear at the bottom of the tag pill listing for that tag. Saving and reloading the wiki would reorder the list to put the new tiddler in the correct position.
+
+The fix ensures that the enumeration order remains consistent.
+
+!! <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/6553">> some incorrectly nested `<span>` and `<div>` elements
+
+TiddlyWiki's core page layout has historically included several instances of inline `<span>` elements containing block `<div>` elements, something that is technically invalid HTML. In practice, browsers have always handled these cases leniently to make the page work but it has also been unhelpful for developers to encountering invalid HTML constructions in their first interactions with TiddlyWiki.
+
+The immediate prompt for starting to fix these issue now is that Chrome v100 [[includes a change|https://chromium.googlesource.com/chromium/src/+/4a76c96d2a4021257e691058c1fe1fb60d9d8327]] that causes some of these misnested elements to be rendered correctly visually but to be unclickable in some situations. (The change is [[reverted|https://chromium.googlesource.com/chromium/src/+/abadd1181ca70cf3d1ac7e7878d46b1d3173a2e0]] in Chrome v102, but it still makes sense to fix it)
+
+! Plugin Improvements
+
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/6428">> issue with ~LaTeX content within Markdown tiddlers
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/issues/6457">> incorrect handling of dropdown classes in the menu bar plugin
+* <<.link-badge-updated "https://github.com/Jermolene/TiddlyWiki5/pull/6520">> the Dynannotate plugin to use the new [[View Template Body Cascade]] to avoid modifying the default view template.
+
+! Translation improvements
+
+* Polish
+* Chinese
+* French
+
+! Usability Improvements
+
+* <<.link-badge-improved "https://github.com/Jermolene/TiddlyWiki5/pull/6435">> wording of drag and drop banner (from "drop here" to "drop now")
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/commit/853a899c77766e47eade1dfa5822640ef9915637">> wrapping and wikification of field names in field viewer
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/commit/0186c6490fbd1d8fd4de7c3fa99ccf4d129fbd80">> missing whitespace between description and MIME type in edit template dropdown for the ''type'' field
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/commit/c7e8c87f85b54f60302ff8e396a7569d996e3f67">> incorrect usage of code view for certain system tiddlers
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/6501">> sidebar plugin listing to be sorted by name rather than description
+
+! Widget Improvements
+
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/commit/66ae1d6930796a9eb062fdb64a755adab8f39294">> classes to the ImageWidget to indicate whether it is loading, loaded or has encountered an error
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/issues/6389">> RadioWidget not using default value if the field or index is missing
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/issues/6426">> issue with ImportVariablesWidget when importing block mode widgets
+* <<.link-badge-extended "https://github.com/Jermolene/TiddlyWiki5/pull/6480">> DraggableWidget to support an optional drag handle
+
+! Filter improvements
+
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6468">> support for case insensitive matching for the [[prefix Operator]] and [[suffix Operator]]
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/commit/1a0c831216c397c6fef8e5685e47857193411a1b">> [[sha256 Operator]]
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/6438">> crash when using deprecated regexp operands for filter operators
+* <<.link-badge-extended "https://github.com/Jermolene/TiddlyWiki5/pull/5742">> [[lookup Operator]] to support indexes as well as fields
+* <<.link-badge-extended "https://github.com/Jermolene/TiddlyWiki5/pull/6293">> [[search Operator]] with new 'some' flag
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/6478">> [[untagged Operator]] to consider non-existent tiddlers to be untagged
+* <<.link-badge-extended "https://github.com/Jermolene/TiddlyWiki5/pull/6477">> [[insertbefore Operator]] to accept the position title as a parameter, instead of as a variable name in the suffix
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/6483">> [[butlast Operator]] to be consistent with the [[rest Operator]]
+
+! Hackability Improvements
+
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6511">> [[Field Editor Cascade]] for customising how fields are displayed in the edit template
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6388">> support for directly specifying style properties on [[HTML elements|HTML in WikiText]] (for example, `<div style.color={{!!color}}>`)
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/commit/54cfda76ee353190f1cf0210b9071894fb1a5690">> support for ''code-body'' field set to ''yes'' to trigger display of a tiddler in the code view
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6410">> support to [[WidgetMessage: tm-scroll]] for scrolling without animating
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/commit/1d16206188ebd5ca7481a7f565bf5fc4c08239fd">> support for [[WidgetMessage: tm-relink-tiddler]]
+* <<.link-badge-extended "https://github.com/Jermolene/TiddlyWiki5/pull/6470">> [[WidgetMessage: tm-open-window]] to support 'top' and 'left' parameters
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6523">> new ''matchSelector'' attribute to the EventCatcherWidget
+
+! Developer Improvements
+
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6409">> support for ''renderEnd()'' method for storyviews
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6381">> sourceURL tags to $:/boot/boot.js and $:/boot/bootprefix.js, enabling them to be accessed in the browser debugger more easily
+
+! Node.js Improvements
+
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/5899">> several new web server options: [[admin|WebServer Parameter: admin]], [[required-plugins|WebServer Parameter: required-plugins]] and [[tls-passphrase|WebServer Parameter: tls-passphrase]]
+
+! Performance Improvements
+
+* <<.link-badge-added "https://github.com/Jermolene/TiddlyWiki5/pull/6327">> support for caching the [[listed Operator]]
+* <<.link-badge-improved "https://github.com/Jermolene/TiddlyWiki5/pull/6537">> stylesheet handling to avoid unnecessary refreshes
+
+! Bug Fixes
+
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/commit/60187dc59e6546d9ca8e6a35418f782a9627cda0">> importing/upgrading encrypted single file wikis
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/issues/6376">> [[WidgetMessage: tm-edit-text-operation]] crash with ''wrap-lines'' operation if prefix or suffix is missing
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/issues/6395">> processing of $:/tags/RawMarkupWikified/TopHead tiddlers
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/issues/6398">> issue whereby renaming tags could result in duplicate tags
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/issues/6440">> search results obscured on narrow screens
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/6540">> ActionListopsWidget bug with input list items starting with `-`, `+`, `~`, `:` or other character with a special meaning in filters
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/commit/28a91aafa74da04842dbff4b8d0eb7a8dad5dbaa">> (and [[here|https://github.com/Jermolene/TiddlyWiki5/pull/6531]]) refreshing of the ButtonWidget when the `default` attribute changes
+
+! Acknowledgements
+
+[[@Jermolene|https://github.com/Jermolene]] would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
+
+* <<contributor benwebber>>
+* <<contributor BramChen>>
+* <<contributor btheado>>
+* <<contributor CodaCodr>>
+* <<contributor cdruan>>
+* <<contributor damscal>>
+* <<contributor davout1806>>
+* <<contributor EvidentlyCube>>
+* <<contributor FlashSystems>>
+* <<contributor flibbles>>
+* <<contributor FSpark>>
+* <<contributor ibnishak>>
+* <<contributor jc-ose>>
+* <<contributor joshuafontany>>
+* <<contributor linonetwo>>
+* <<contributor Marxsal>>
+* <<contributor nilslindemann>>
+* <<contributor oflg>>
+* <<contributor pmario>>
+* <<contributor rryan>>
+* <<contributor saqimtiaz>>
+* <<contributor slaymaker1907>>
+* <<contributor tw-FRed>>
+* <<contributor twMat>>

package/editions/tw5.com/tiddlers/releasenotes/ReleaseTemplate.tid

@@ -1,3 +1,6 @@
+created: 20211117231152248
+modified: 20211119231156728
+tags: [[Release Template]]
 title: ReleaseTemplate
 
 <h2><$link to=<<currentTab>>><$view tiddler=<<currentTab>> field="title"/></$link></h2>

package/editions/tw5.com/tiddlers/releasenotes/Releases.tid

@@ -1,7 +1,9 @@
 created: 20150419144523070
-modified: 20150420114530386
+modified: 20220131165321472
 tags: About
 title: Releases
 type: text/vnd.tiddlywiki
 
-<<tabs "[[TiddlyWiki Releases]] [[TiddlyDesktop Releases]]" "TiddlyWiki Releases" "$:/state/tab">>
+New releases of TiddlyWiki, TiddlyDesktop and TiddlyFox are announced via the [[official discussion groups|Forums]] and [[Twitter|https://twitter.com/TiddlyWiki]] (you can also subscribe to an Atom/RSS feed of [[TiddlyWiki releases from GitHub|https://github.com/jermolene/tiddlywiki5/releases.atom]])
+
+<<tabs "[[TiddlyWiki Releases]] [[TiddlyDesktop Releases]]" "TiddlyWiki Releases" "$:/state/tab">>

package/editions/tw5.com/tiddlers/releasenotes/alpha/AlphaReleases.tid

@@ -1,6 +1,6 @@
 created: 20131109105400007
-modified: 20140701201607494
-tags: Releases
+modified: 20211117225858830
+tags: Releases AlphaReleaseNotes
 title: AlphaReleases
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt.meta

@@ -1,5 +1,5 @@
 title: Example config-tiddlyweb-host for IIS
 created: 20180328145039530
 modified: 20180328145234871
-tags: 
+tags: Saving
 type: text/plain

package/editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt.meta

@@ -1,5 +1,5 @@
 created: 20180328145039530
 modified: 20180328145234871
-tags: 
+tags: Saving
 title: Example package.json for IIS
 type: text/plain

package/editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt.meta

@@ -1,5 +1,5 @@
 created: 20180328151124878
 modified: 20180328151214616
-tags: 
+tags: Saving
 title: Example tiddlywiki.info for IIS
 type: text/plain

package/editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt.meta

@@ -1,5 +1,5 @@
 created: 20180328145259455
 modified: 20180701185215523
-tags: 
+tags: Saving
 title: Example web.config for IIS
 type: text/plain

package/editions/tw5.com/tiddlers/saving/Saving on Browser with the File System Access API.tid

@@ -0,0 +1,21 @@
+caption: TW5-browser-nativesaver (experimental)
+color: #FF8A65
+created: 20220206035734757
+delivery: Saver
+description: Save changes using new versions of Chromium based browsers
+method: save
+modified: 20220206035734757
+tags: Chrome Edge Opera Saving Linux Mac Windows
+title: Saving on Browser with File System Access API
+type: text/vnd.tiddlywiki
+
+Tiddlywiki can save changes to the filesystem without [[downloading a new file each time|Saving with the HTML5 fallback saver]]
+each time using the [[File System Access API|https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API]].
+
+<<.warning "This API is not yet fully standardized hence this method of saving is somewhat experimental.">>
+
+The API used by this saver works in most Chromium based browsers. See [[caniuse|https://caniuse.com/native-filesystem-api]]
+for up to date information on browser support.
+
+* [[Plugin Wiki|https://slaymaker1907.github.io/tiddlywiki/plugin-library.html]]
+* [[GitHub Repo|https://github.com/slaymaker1907/TW5-browser-nativesaver]]

package/editions/tw5.com/tiddlers/saving/Saving on TidGi.tid

@@ -0,0 +1,26 @@
+caption: TidGi Desktop
+color: #FF8A65
+community-author: LinOnetwo
+created: 20220221080637764
+delivery: App
+description: Desktop application for serving and syncing TiddlyWiki
+method: save
+tags: Saving Mac Windows Linux
+title: Saving on TidGi Desktop
+type: text/vnd.tiddlywiki
+url: https://github.com/tiddly-gittly/TidGi-Desktop/releases/latest
+
+See its [[readme|https://github.com/tiddly-gittly/TidGi-Desktop#readme]] about details of TidGi's design decisions, here is a brief summary:
+
+# TidGi runs [[TiddlyWiki on Node.js]] while [[TiddlyDesktop|Saving on TiddlyDesktop]] focus on single HTML wiki
+# TidGi has built-in git-sync backup script
+# TidGi provides some electron based feature, such as a menubar mini window and a shell executor.
+
+!!! How to install
+
+# Install the latest release of TidGi Desktop from {{!!url}}
+# Run TidGi
+# Create a new wiki, or open an existing nodejs tiddlywiki folder
+# Changes are automatically saved, you can optionally configue it to sync to the github every 30min
+
+[img[https://github.com/tiddly-gittly/TidGi-Desktop/raw/master/docs/images/preference.png]]

package/editions/tw5.com/tiddlers/saving/Saving on TiddlyHost.tid

@@ -0,0 +1,17 @@
+caption: ~TiddlyHost
+color: #29B6F6
+community-author: Simon Baird
+created: 20210422191232572
+delivery: Service
+description: Online service for creating and hosting TiddlyWikis
+method: save
+modified: 20210423003921468
+tags: Android Chrome Firefox [[Internet Explorer]] Linux Mac Opera PHP Safari Saving Windows iOS Edge
+title: Saving on TiddlyHost
+type: text/vnd.tiddlywiki
+
+[img width=140 [https://github.com/simonbaird/tiddlyhost/raw/main/rails/app/assets/images/logo-800.png]]
+
+[[TiddlyHost.com|https://tiddlyhost.com/]] is a hosting service for TiddlyWiki created by Simon Baird. Once you sign up and confirm your email you can create "sites", (i.e. ~TiddlyWikis), with support for online saving. Sites can be private or public, and you can optionally list them on the taggable and searchable [[TiddlyHost Hub|https://tiddlyhost.com/hub]] where they'll be discoverable by others.
+
+Unlike [[TiddlySpot|Saving on TiddlySpot]], [[TiddlyHost|https://tiddlyhost.com]] is secure, open source, and has proper support for TiddlyWiki5. It also allows uploading existing ~TiddlyWiki files, supports TiddlyWikiClassic, and lets you claim ownership of your ~TiddlySpot sites. For more information see the [[FAQ|https://github.com/simonbaird/tiddlyhost/wiki/FAQ]] and the [[About|https://tiddlyhost.com/about]] page.

package/editions/tw5.com/tiddlers/saving/Saving on TiddlySpot.tid

@@ -1,56 +1,46 @@
 caption: ~TiddlySpot
 color: #29B6F6
-community-author: Simon Baird and Daniel Baird
+community-author: Simon Baird & Daniel Baird
 created: 20130825213500000
 delivery: Service
-description: Free online service for hosting TiddlyWiki files
+description: Online TiddlyWiki hosting. (Deprecated in favour of TiddlyHost)
 method: save
-modified: 20200507202953380
+modified: 20210423004027196
 tags: Android Chrome Firefox [[Internet Explorer]] Linux Mac Opera PHP Safari Saving Windows iOS Edge
 title: Saving on TiddlySpot
 type: text/vnd.tiddlywiki
 
-[[TiddlySpot|http://tiddlyspot.com]] is a free hosting service for TiddlyWiki documents from Simon Baird and Daniel Baird.
+----
+<<.warning "''Please note: ~TiddlySpot is in maintenance mode and no longer allows new sites to be created. Instead of ~TiddlySpot you can now use [[TiddlyHost|Saving on TiddlyHost]], a new service from the creator of ~TiddlySpot.''">>
+----
+[img[https://raw.githubusercontent.com/simonbaird/tiddlyhost/main/rails/app/assets/images/tiddlyspot-banner-logo.png]]
 
-! Setting up a TiddlyWiki on ~TiddlySpot
-To set up a [[TiddlyWiki Classic|TiddlyWikiClassic]], you merely create a new wiki at http://tiddlyspot.com
+[[TiddlySpot.com|http://tiddlyspot.com]] is a hosting service for TiddlyWiki created in 2006 by Simon Baird and Daniel Baird.
 
-!!TiddlyWiki5 on ~TiddlySpot
-~TiddlyWiki5 also functions well on ~TiddlySpot but this version is not offered directly in the ~TiddlySpot set-up.
+In early 2021 it was superseded by [[TiddlyHost|Saving on TiddlyHost]], a new, secure, modern reimagining of ~TiddlySpot. Creating new sites on ~TiddlySpot is no longer supported, (though sites created in 2020 or earlier are still functional).
 
-The simplest way to create a new ~TiddlySpot with ~TiddlyWiki5 is probably through the community created site http://tiddlywiki5.tiddlyspot.com
+!! Security warning for ~TiddlySpot
 
-Alternatively, you can upload an existing ~TiddlyWiki5 document from your local disc to ~TiddlySpot by following these steps:
-
-# Sign up for a new wiki at http://tiddlyspot.com/, and remember the wiki name and password
-# Open your locally stored TiddlyWiki document in your browser
-# Fill in the ~TiddlySpot wikiname and password in ''Saving'' tab of the ''control panel'' <<.icon $:/core/images/options-button>>
-# Click the <<.icon $:/core/images/save-button>> ''save changes'' button. You should get a confirmation notification at the top right saying ''Saved wiki''. Saving can take several seconds if you're on a slow connection or working with a large wiki.
-# Navigate to your ~TiddlySpot URL at http://{wikiname}.tiddlyspot.com/
-
-Note that your password is sent unencrypted when using ~TiddlySpot. From http://faq.tiddlyspot.com/:
+Note that your password is sent unencrypted when using ~TiddlySpot. From the [[FAQ|http://faq.tiddlyspot.com/]]:
 
 <<<
 ''Is Tiddlyspot secure?''
 
-No. Tiddlyspot does not use SSL/https. Your password is sent in clear text when uploading and when authenticating to access a private site. This means that your Tiddlyspot is vulnerable to packet sniffing and your password could be discovered by a malicious third party. Also your data is transmitted unencrypted when you view your site, even if it is a private site. For this reason please don't put sensitive information such as banking details in your Tiddlyspot and don't use a password that you use for other high security sites.
+No. Tiddlyspot does not use SSL/https, so all ~TiddlySpot web traffic is vulnerable to packet sniffing. This means your password and site data could be intercepted by a malicious third party. For this reason, please don't keep sensitive information in your ~TiddlySpot site, and don't use a password that you use for other web sites.
 <<<
 
-! Problems with saving on ~TiddlySpot
+!! Problems with saving on ~TiddlySpot
 
-In case you run into this error when uploading a new or freshly upgraded local TiddlyWiki to ~TiddlySpot :
+In case you run into this error when uploading a freshly upgraded local TiddlyWiki to ~TiddlySpot:
 
 <<<
-Error while saving:
-
-Error:NS_ERROR_DOM_BAD_URI: Access to restricted URI denied
+Error: NS_ERROR_DOM_BAD_URI: Access to restricted URI denied
 <<<
 
 The upgrade operation falls foul of a security restriction in Firefox. Until this can be resolved, we suggest using Chrome.
 
-*# Use Chrome to open the local TiddlyWiki document you want to upload to ~TiddlySpot and follow the steps 1 through 5 described above
-*# Once you've checked the ~TiddlySpot-hosted TiddlyWiki loads properly in Chrome, you should be able to access, edit and [[save using TiddlyFox|Saving with TiddlyFox]] again
-* After you've uploaded your local document once, further editing and saving of the online version hosted on ~TiddlySpot should work with any modern browser of your choice.
-** Don't forget to fill in the ~TiddlySpot wikiname and password in your ~TiddlySpot TiddlyWiki control panel for any new browser you want to use for saving changes
+* Use Chrome to open the local TiddlyWiki document you want to upload to ~TiddlySpot and follow the steps 1 through 5 described at [[Upgrading]].
+* Once you've checked the ~TiddlySpot-hosted TiddlyWiki loads properly in Chrome, you should be able to access, edit and [[save using TiddlyFox|Saving with TiddlyFox]] again.
+* After you've uploaded your local document once, further editing and saving of the online version hosted on ~TiddlySpot should work with any modern browser of your choice. (Don't forget to fill in the ~TiddlySpot password in your ~TiddlySpot TiddlyWiki control panel for any new browser you want to use for saving changes.)
 
-* //See also : [[Upgrading]]//
+//See also: [[Upgrading]]//

package/editions/tw5.com/tiddlers/saving/Saving to a Git service.tid

@@ -15,7 +15,7 @@ Saving to a Git service is configured in the [[$:/ControlPanel]] in the ''Git Se
 
 * ''Type'' - (mandatory) the type of the service (e.g. GitHub, GitLab)
 * ''Username'' - (mandatory) the username for the Git service account used for saving changes
-* ''Password'' - (mandatory) the password, OAUTH token or personal access token for the specified account. Note that GitHub permits [[several different mechanisms|https://developer.github.com/v3/#authentication]] for authentication
+* ''Password'' - (mandatory) the OAUTH token or personal access token for the specified account. Note that GitHub deprecated password authetication, permitted authentication methods are shown in the[[API documentation|https://developer.github.com/v3/#authentication]].
 * ''Repository'' - (mandatory) the name of the Git repository. Both the owner name and the repository name must be specified. For example `Jermolene/TiddlyWiki5`
 * ''Branch'' - (optional) the name of the branch to be used within the Git repository. Defaults to `main` (~GitHub) or `master` (~GitLab)"
 * ''Path'' - (optional) the path to the target file. Defaults to `/`
@@ -23,4 +23,4 @@ Saving to a Git service is configured in the [[$:/ControlPanel]] in the ''Git Se
 
 Notes
 
-* The Git service password is stored persistently in browser local storage. Be sure to clear the password if using a shared machine. Using a [[personal access token|]] for authentication offers an extra layer of security: if the access token is accidentally exposed it can be revoked without needing to reset the account password
+* The Git service token or password is stored persistently in browser local storage. Be sure to clear the password if using a shared machine. Using a personal access token for authentication offers an extra layer of security: if the access token is accidentally exposed it can be revoked without needing to reset the account password

package/editions/tw5.com/tiddlers/saving/Saving via WebDAV.tid

@@ -4,29 +4,84 @@ created: 20160216191710789
 delivery: Protocol
 description: Standard web protocol available on products such as Sharepoint
 method: save
-modified: 20200507202752943
+modified: 20220222190056634
 tags: Android Chrome Firefox [[Internet Explorer]] Linux Mac Opera PHP Safari Saving Windows iOS Edge
 title: Saving via WebDAV
 type: text/vnd.tiddlywiki
 
-If hosted on a [[WebDAV|https://en.wikipedia.org/wiki/WebDAV]]-enabled server, TiddlyWiki will automatically save changes via HTTP.
+If hosted on a [[WebDAV|https://en.wikipedia.org/wiki/WebDAV]]-enabled server, TiddlyWiki will automatically save changes via HTTP for TiddlyWiki's created after 2016. If you created your wiki before Feb 16 2016  you'll need to [[Upgrade|Upgrading]] to enable ~WebDAV.
+
+
+
+!! Cross platform lightweight servers
+
+Lightweight, portable and easy to use solutions
+
+*   [[rclone|https://rclone.org/commands/rclone_serve_webdav/]]
+**  Running it can be as simple as: <br/>`rclone serve webdav some_directory_containing_tiddlywiki_files`
+*   [[micromata dave - the simple webdav server|https://github.com/micromata/dave]]
+* [[dav-server|https://github.com/edrex/dav-server]] is a quick way to serve up a folder of HTML ~TiddlyWikis.
+*   [[hacdias webdav server|https://github.com/hacdias/webdav/]]
+    **   Guide for using this ~WebDAV server by Mohammad [[Scripts in Tiddlywiki — codes, macros, and solutions in TW|https://kookma.github.io/TW-Scripts/#Easy%20Local%20Saving%20with%20WebDav]]
 
-!! Servers
 
-Many [[NAS|https://en.wikipedia.org/wiki/NAS]] or [[Subversion|https://en.wikipedia.org/wiki/Apache_Subversion]] servers support WebDAV out of the box. Setting up your own server might take some effort though:
+!! Windows
 
-[[dav-server|https://github.com/edrex/dav-server]] is a quick way to serve up a folder of HTML ~TiddlyWikis.
+*   IIS
+    **   Video guide by [[pmario|https://talk.tiddlywiki.org/u/pmario]]: [[01 Intro - How to use TiddlyWiki with IIS and WebDAV - YouTube|https://www.youtube.com/watch?v=tpkQhKyqPzc&list=PLuiC_HFhI4OwoVDb-B-VK0ydj-mBPNn-1]]
+    **  Step-by-step ~HowTo video by ~MagoArcade on using a “real” IIS server + SSL + ~WindowsAuth with self-signed certificate: [[TiddlyWiki Install - Windows IIS WebDAV Method - YouTube|https://youtu.be/VMQ3Lfko8uQ]]
 
-[[webdav server|https://play.google.com/store/apps/details?id=com.theolivetree.webdavserver&hl=en]] for Android lets you put wikis in your pocket. You can share with other devices on the local network too.
+*   ~SharePoint / ~OneDrive for Windows
+** Save your ~TiddlyWiki file with an `.aspx` extension
+** Copy it to a ~SharePoint/~OneDrive for Business sync'd library
+**   As long as ~WebDAV hasn’t been disabled, renaming single-file wiki from .html to .aspx “just works” when stored in one of these folders
+** This //might// work with Mac also.
 
-!! Existing Wikis
+!! OSX
+*   ~WebDavNav Server via the Mac App store.
 
-~WebDAV support was added Feb 16 2016. If you created your wiki before that, you'll need to [[Upgrade|Upgrading]] to enable ~WebDAV.
+!! Android
+
+* RCX is an open source file manager for Android based on //rclone//. It is available on both //F-Droid// and //Google Play//. Thanks to its integrated WebDAV server, it lets you edit the wikis that you keep in your pocket. You can share them with other devices on the local network too.
+
+!! Servers
+
+Many [[NAS|https://en.wikipedia.org/wiki/NAS]] or [[Subversion|https://en.wikipedia.org/wiki/Apache_Subversion]] servers support ~WebDAV out of the box. Setting up your own server might take some effort though:
 
-!! Video HowTo's
 
-[[Mario Pietsch|"Wikilabs" by PMario]] has [[created several videos|https://www.youtube.com/watch?v=tpkQhKyqPzc&list=PLuiC_HFhI4OwoVDb-B-VK0ydj-mBPNn-1]] that show how to prepare Microsoft Internet Information Service (IIS) to host a local TiddlyWiki using ~WebDav
 
 !! Free Hosting
 
 Several ~WebDAV hosting services tested (~~box.com~~, ~~swissdisk.com~~) don't support accessing HTML files via a webbrowser, so they won't work with ~TiddlyWiki. However, The GMX mediacenter (www.gmx.net) has been reported as working with WebDAV with a free account.
+
+!!! Koofr
+
+//''Koofr''// is a cloud service that emphasizes privacy. To use their webdav services, sign up for an account at `koofr.eu` . Then go to `preferences` on their web app. Then `password` from the menu on the left. Scroll down to `App Passwords`. Use some name like 'tiddlywiki' and generate a password. Despite what it says, save the password somewhere. Upload your file on some path, preferably without spaces to their site. Then in the browser link to the site with an address like:
+
+```
+https://app.koofr.net/dav/Koofr/myfile.html
+
+```
+When you do, an authentication dialog will come up. Use your email address that you used to sign up and the password you just generated to login.
+
+You should be able to load the file and save changes back in place.
+
+!! Paid Hosting
+
+!!! pCloud
+
+//''pCloud''// is cloud service with servers in Europe and the United States. When you sign up, you need to select which server location is best for you. Then in your web browser, sign in to the service. Upload the file you wish to access via the browser interface. Then, in another tab, open either
+
+```
+https://webdav.pcloud.com
+```
+
+if your servers are in the U.S. or
+
+```
+https://ewebdav.pcloud.com
+```
+
+if your servers are in Europe.
+
+A file navigation page should come up. Navigate to your file and open in your browser. You should be able create and save changes.

package/editions/tw5.com/tiddlers/saving/Saving with Polly.tid

@@ -0,0 +1,29 @@
+caption: Polly
+color: #29B6F6
+community-author: TiddlyTweeter
+created: 20220223153410510
+delivery: Service
+description: Batch script for saving downloaded TiddlyWiki files.
+method: save
+modified: 20220223160414274
+tags: Chrome Firefox [[Internet Explorer]] Linux Mac Opera Safari Saving Windows Edge
+title: Saving with Polly
+type: text/vnd.tiddlywiki
+
+[[Polly|https://github.com/Marxsal/polly]] is a batch file system using Windows //~PowerShell// to restore ~TiddlyWiki files from a specified download directory to their original home directory.
+
+Effectively, this becomes a new way to save your files, but with these features:
+
+* No binary executables
+* Human-readable batch script.
+* No special plugins in your ~TiddlyWiki file
+* No special browser required
+* No browser extension required.
+* No need for node.exe running in background
+* Total size expanded package only 100k
+* Backups as regular file and/or zip to specified directories
+* The ability to "parrot" extra copies to target directories (e.g. a Dropbox folder)
+
+It should be able to run anywhere that //~PowerShell// runs, including Windows, Linux, and Mac.
+
+https://github.com/Marxsal/polly

package/editions/tw5.com/tiddlers/saving/TiddlyWiki in the Sky for Dropbox.tid

@@ -12,6 +12,6 @@ url: https://twcloud.github.io/tw5-dropbox/
 
 Originally built by Jeremy Ruston and now maintained by Arlen Beiler, TiddlyWiki Cloud (formerly known as TiddlyWiki in the Sky for Dropbox) is an online service that lets you edit TiddlyWiki documents directly in your own Dropbox using just a browser.
 
-It works with TiddlyWiki 5 and Classic.
+It works with TiddlyWiki 5. As for TiddlyWiki Classic, the mainstream loader does not work, and a newer loader may work.
 
 https://twcloud.github.io/

package/editions/tw5.com/tiddlers/styleguide/Documentation Macros.tid

@@ -1,7 +1,8 @@
 created: 20150110182600000
-modified: 20150228082845000
-title: Documentation Macros
+modified: 20211206080809651
 tags: [[Improving TiddlyWiki Documentation]]
+title: Documentation Macros
+type: text/vnd.tiddlywiki
 
 The following macros are used throughout ~TiddlyWiki's documentation. Their names start with a dot to keep them out of the way of names that a user might try experimenting with.
 
@@ -13,6 +14,7 @@ The following macros are used throughout ~TiddlyWiki's documentation. Their name
 |.place |a placeholder for the user to fill in |<<.place tagname>> |
 |.strong |major emphasis within a tiddler |<<.strong Important!>> |
 |.word |a mention of an ordinary word or phrase |<<.word "hello world">> |
+|.icon |an icon, sized to match the surrounding text |<<.icon "$:/core/images/globe">> |
 
 !Advice
 
@@ -36,6 +38,8 @@ The following macros are used throughout ~TiddlyWiki's documentation. Their name
 |.wid |a widget name |<<.wid list>> |
 |.attr |an attribute name |<<.attr filter>> |
 |.param |a macro parameter name |<<.param text>> |
+|.tiddler-fields |a list of tiddler fields |<<.tiddler-fields "Monday">> |
+
 
 !Links
 

package/editions/tw5.com/tiddlers/styleguide/Tiddler Structure.tid

@@ -1,5 +1,5 @@
 created: 20150110183300000
-modified: 20150117152556000
+modified: 20210207124737959
 title: Tiddler Structure
 tags: [[Improving TiddlyWiki Documentation]]
 
@@ -13,4 +13,6 @@ Use numbered lists for step-by-step instructions, and bullet points for lists wh
 
 Use a table when information naturally falls into three or more columns, and also for lists of parameters, attributes, etc in [[reference tiddlers|Reference Tiddlers]].
 
+Avoid periods at the end of list items, headings and table cell text.
+
 The documentation describes the current reality of ~TiddlyWiki. Avoid discussing future aspirations.