Skip to content

Upgrading your site to the latest version of TiddlyWiki

Simon Baird edited this page Sep 28, 2022 · 9 revisions

1. Download your site

  • Make sure you're logged in to Tiddlyhost, the click "Home" to view your sites list.
  • Find the site you want to upgrade and click its "..." actions menu and select "Download".
  • Identify where the downloaded file was saved. (Usually it's in your "Downloads" directory but it depends on how your browser is configured.)

2. Upgrade the downloaded TiddlyWiki file

  • Visit https://tiddlywiki.com/upgrade.html
  • Click the big button to upload your TiddlyWiki
  • Find the TiddlyWiki file you just downloaded and select it
  • Review the list of tiddlers being imported. (I think it's generally safe to leave the default selections as they are.)
  • Click the "Upgrade" button
  • Click the green "Save upgraded TiddlyWiki button" which should cause a new file to be downloaded called upgrade.html.
  • Identify where that file was saved. (Once again it's usually the "Downloads" directory.)

3. Verify the upgrade

  • Open the newly downloaed upgrade.html file and make sure it works as expected. (It's likely to work fine, but there might be plugin or other compatibility problems, so it's worthwhile checking.)

4. Upload the new TiddlyWiki file to your Tiddlyhost site

  • Back on the sites list, find the site you're upgrading, click the "..." actions menu and select "Upload". Tip: Be extra careful to choose the correct site.
  • Click the "Choose file to upload" button and select the new "upgrade.html" that you verified in the previouis step.
  • Click the "Upload file" button and click "Ok" to confirm.

5. Confirm the upload was successful and that everything is working

  • View your newly upgraded site online at its usual Tiddlyhost url. (Make sure you hit reload to ensure you have the latest freshly updated version.)
  • Optionally you can verify the TiddlyWiki version by putting <<version>> inside a tiddler's content and seeing what it says.
  • Click the save button and confirm that the site saves as per usual.
  • (In the unlikely event that something is broken at this point, you can restore the previous version of your site by redoing the upload step and selecting the originally downloaded TiddlyWiki file instead of the upgraded file.)
  • FAQ - a list of frequently asked questions
  • Journal - A few notes on what what's new and interesting
Clone this wiki locally