About Tiddlywiki

About Tiddlywiki for webOS

This is TiddlyWiki for webOS version 1.0.5.

TiddlyWiki is a single-file, self-contained wiki for managing micro-content, written in JavaScript.

A complete TiddlyWiki is stored in a single file on your computer, and thus belongs to the class of Single Page Applications. That makes it super-easy to move your TiddlyWiki around on a USB stick or by emailing it to yourself.

The single file that is a TiddlyWiki contains not only all of your data, but all the machinery to edit and manipulate it.

On webOS the TiddlyWiki file is located on the USB drive of your device in: www/itw.html. Since webOS' browser doesn't support viewing local files, this app acts as a wrapper around this limitation by using Palm's WebView widget to render the TiddlyWiki file.

Saving the wiki after you modified it, is somewhat special due to more limitations on webOS. Since we cannot access the filesystem from JavaScript in any way, TiddlyWiki for webOS uses the UploadTiddlerPlugin to post it to an upload CGI program running on the device (localhost) served by lighttpd mini-webserver.

Beside this a couple of preparations have been made to the TiddlyWiki file so it works well on webOS: it contains a modified Plugin to automatically enlarge the edit area if you edit a Tiddler so that the whole Tiddler fits into the box, because we don't have scrollbars on webOS. There is also a Search-Plugin installed which pops up matching Tiddlers instead to show them all.

You can do almost everything with TiddlyWiki for webOS, you may even install your own plugins. Just copy the mentioned file to your desktop computer, open it there with your browser, modify it to your needs, save it and finally upload it back to the phone.

If you ever run into a bricked wiki file (e.g. you installed a plugin with syntax errors) - don't worry. The upload CGI program creates always a backup copy each time it saves the wiki file. You can easily restore a backup by opening the app-menu, choose Restore and select the wikifile you want to use as your current copy. Backups have the timestamp of their creation in the filename to make it easy to decide which one to take. Just tap the Save button after opening the backup copy and it will be your current live TiddlyWiki file.