Welcome to TiddlyWiki
This is version 5.0.9-prerelease of TiddlyWiki, a major reboot designed for the next 25 years. It is currently in beta (see the detailed ReleaseHistory). There is a RoadMap for moving to the full release. It is a great time to get involved and support the future development of TiddlyWiki.
TiddlyWiki is a free, open source project that depends on your love and support for its survival.
On this site, unless noted otherwise, "TiddlyWiki" refers to the new version 5, and "TiddlyWikiClassic" is used to identify the older version.
The deep internal improvements mean that the new version of TiddlyWiki is not fully compatible with TiddlyWikiClassic. Existing content will need massaging, while plugins and themes will have to be completely rewritten. The upgrade path will get smoother as the new version matures.
Getting started with TiddlyWiki under Node.js
- You can edit your content on any suitably compatible HTML5 browser, including smartphones and tablets
- Individual tiddlers are stored in separate files, which you can organise as you wish
- The ability to build multiple wikis that blend different combinations of shared and unique content
- Install Node.js from http://nodejs.org
- Open a command line terminal and type:
npm install -g tiddlywiki
If it fails with an error you may need to re-run the command as an administrator:
npm install -g tiddlywiki(Windows)
sudo npm install -g tiddlywiki(Mac/Linux)
- Check TiddlyWiki is installed by typing:
- In response, you should see TiddlyWiki report its current version (eg
5.0.8-beta; you may also see other debugging information reported)
- Try it out:
A slightly different method for installation is recommended if you plan on forking the source code in order to study it or contribute to it. See Working with the TiddlyWiki5 repository.
For example, the following command loads the tiddlers from a TiddlyWiki HTML file and then saves one of them in static HTML:
tiddlywiki --verbose --load mywiki.html --rendertiddler ReadMe ./readme.html
tiddlywiki from the command line boots the TiddlyWiki kernel, loads the core plugins and establishes an empty wiki store. It then sequentially processes the command line arguments from left to right. The arguments are separated with spaces.
The first argument is the optional path to the TiddlyWikiFolder to be loaded. If not present, then the current directory is used.
The commands and their individual arguments follow, each command being identified by the prefix
tiddlywiki [<wikipath>] [--<command> [<arg>[,<arg>]]]
The available commands are:
If you've installed TiddlyWiki on Node.js on the usual way, when a new version is released you can upgrade it with this command:
npm update -g tiddlywiki
On Mac or Linux you'll need to add sudo like this:
sudo npm update -g tiddlywiki
Working with the TiddlyWiki5 repository
If you plan on working with the TiddlyWiki5 source code then follow these steps:
- Fork the TiddlyWiki5 GitHub repository from https://github.com/Jermolene/TiddlyWiki5
- Clone a local copy of your fork
- Open a command line terminal and change the current working directory to the root of the repo
npm link(Windows) or
sudo npm link(Mac/Linux) to tell npm to use this copy of the repo as the globally installed one
See also Scripts for TiddlyWiki on Node.js.
This readme file was automatically generated by TiddlyWiki