Skip to content

Converting an internal core TiddlyWiki to external core

Simon Baird edited this page Sep 13, 2023 · 9 revisions

This can be used after upgrading your TiddlyWiki, since the upgrade process will produce an internal core TiddlyWiki file even if you start out with an external core.

Before you begin

Beware, this process is unforgiving of mistakes, so be careful. Consider making a backup of your site before you begin in case something goes wrong.

Note also that the version of the TiddlyWiki you are converting must be supported on Tiddlyhost, must not be a "prerelease" version, and must be 5.2.0 or higher.

Procedure

  1. View your site on Tiddlyhost, then find the shadow tiddler called $:/config/SaveWikiButton/Template. You can get to it via the "More" tab. Click "Shadows", scroll down until you find it, then click to open the tiddler.

  2. Update that shadow tiddler and carefully replace its content with the following:

$:/core/save/offline-external-js
  1. Once the shadow tiddler is updated, save the TiddlyWiki and then reload it. Your site should now be converted to an external core TiddlyWiki.

Confirmation

You can confirm your site is really now "external core" by doing a "view source" in your browser, and scrolling the the bottom and looking for the script command that loads the core plugin.

You can also reload your Tiddlyhost sites list and check the "kind" and the "size", which should be smaller than it was previously.

Converting back to internal core

This process can be reversed by deleting the $:/config/SaveWikiButton/Template tiddler and clicking the save button once again.