TiddlyWiki5/readme.md

Welcome to TiddlyWiki

TiddlyWiki is a web application you can download for free, store wherever you like, customize however you wish, and use to take / organize / share your notes in ways that word processors and other note-taking tools cannot. TiddlyWiki is designed in a "non-linear" way, using tags, hyperlinks, and many other features, so that you can organize and retrieve your notes in ways that conform to your personal thought patterns, rather than feel chained to one pre-set organizational structure.

You can use TiddlyWiki as a single file that you view and edit through any web browser, whether you are online or offline. Or you can use it as a powerful Node.js application that treats each of your notes as a separate file and accesses them through a central hub.

How can you make TiddlyWiki work for you? We recommend you start with our introductory documentation, listed below, then browse the TableOfContents, always available in the Contents tab in the sidebar. Or just download an empty TiddlyWiki now and try it out for yourself!

• Discover TiddlyWiki
• Some of the things you can do with TiddlyWiki
• Examples of TiddlyWiki in the wild
• The history of TiddlyWiki
• What happened to the other TiddlyWiki?

Getting started with TiddlyWiki under Node.js

Running TiddlyWiki on Node.js brings several important benefits over and above the single file version:

• 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

Installation

1. Install Node.js from http://nodejs.org
2. 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)

3. Check TiddlyWiki is installed by typing:

   tiddlywiki --version

4. In response, you should see TiddlyWiki report its current version (eg 5.0.8-beta; you may also see other debugging information reported)
5. Try it out:
   1. tiddlywiki mynewwiki --init server to create a folder for a new wiki that includes server-related components
   2. tiddlywiki mynewwiki --server to start TiddlyWiki
   3. Visit http://127.0.0.1:8080/ in your browser
   4. Try editing and creating tiddlers

The -g flag causes TiddlyWiki to be installed globally. Without it, TiddlyWiki will only be available in the directory where you installed it.

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.

Usage

TiddlyWiki5 can be used on the command line to perform an extensive set of operations based on TiddlyWikiFolders, TiddlerFiles and TiddlyWikiFiles.

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

Running 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:

• BuildCommand
• ClearPasswordCommand
• HelpCommand
• InitCommand
• LoadCommand
• MakeLibraryCommand
• OutputCommand
• PasswordCommand
• RenderTiddlerCommand
• RenderTiddlersCommand
• SaveTiddlerCommand
• SaveTiddlersCommand
• ServerCommand
• SetFieldCommand
• VerboseCommand
• VersionCommand

See also:

• Environment Variables on Node.js

Upgrading

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

Introduction

Mario Pietsch has created a short video tutorial on working with the TiddlyWiki5 GitHub repository.

Setting Up

If you plan on working with the TiddlyWiki5 source code then follow these steps:

1. Fork the TiddlyWiki5 GitHub repository from https://github.com/Jermolene/TiddlyWiki5
2. Clone a local copy of your fork
3. Open a command line terminal and change the current working directory to the root of the repo
4. Type npm link (Windows) or sudo npm link (Mac/Linux) to tell npm to use this copy of the repo as the globally installed one

After this procedure you can work with TiddlyWiki5 via npm as though it were installed in the usual way with npm install -g tiddlywiki.

See also Scripts for TiddlyWiki on Node.js.

This readme file was automatically generated by TiddlyWiki