mirrors/TiddlyWiki5
1
0
Fork 0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-11-27 03:57:21 +00:00
Code Issues Releases Wiki Activity
A self-contained JavaScript wiki for the browser, Node.js, AWS Lambda etc.
3,307 Commits 101 Branches 68 Tags 91 MiB
JavaScript 96.9%
TeX 1.3%
Shell 0.9%
CSS 0.7%
Batchfile 0.1%
Other 0.1%
7f5f4df562
Go to file
Jermolene 7f5f4df562 Tweaks to the vanilla theme and palette entries
2014-02-23 17:19:58 +00:00
boot Require that wiki folders have a tiddlywiki.info file 2014-02-22 16:38:34 +00:00
core Tweaks to the vanilla theme and palette entries 2014-02-23 17:19:58 +00:00
editions Docs updates 2014-02-22 17:06:02 +00:00
languages Merge pull request #430 from xcazin/fr-FR 2014-02-22 16:13:49 +00:00
licenses Merge branch 'fr-FR' of https://github.com/xcazin/TiddlyWiki5 into xcazin-fr-FR 2014-02-21 16:05:11 +00:00
plugins/tiddlywiki Make type information translateable 2014-02-16 19:58:53 +00:00
themes/tiddlywiki Tweaks to the vanilla theme and palette entries 2014-02-23 17:19:58 +00:00
.gitignore Removed .gitignore by mistake 2014-02-20 22:00:11 +01:00
2bld.cmd Added Windows specific build scripts. 2013-11-19 19:57:05 -05:00
2bld.sh Get rid of the "new_" prefix we had on some methods 2013-11-08 08:51:14 +00:00
bld-languages.sh Add initial translation for Simplified Chinese (zh-Hans). 2014-02-20 23:03:06 +08:00
bld.cmd Generate the copyright.md file in the same way we generate readme.md 2014-01-24 18:35:17 +00:00
bld.sh Generate the copyright.md file in the same way we generate readme.md 2014-01-24 18:35:17 +00:00
contributing.md Update static link generation 2014-01-26 13:34:53 +00:00
deploy.cmd Sync bld.cmd with latest bld.sh 2013-11-26 16:43:00 -05:00
deploy.sh Update the deploy script to publish to NPM 2013-11-09 10:54:10 +00:00
ginsu.cmd Sync bld.cmd with latest bld.sh 2013-11-26 16:43:00 -05:00
ginsu.sh Get rid of the "new_" prefix we had on some methods 2013-11-08 08:51:14 +00:00
lazy.cmd Add support for serving TW5 with lazily loaded images 2014-01-29 09:05:00 +00:00
lazy.sh Add support for serving TW5 with lazily loaded images 2014-01-29 09:05:00 +00:00
package.json Update version number for next release 2014-01-27 16:23:27 +00:00
qbld.cmd Add quick build 2013-12-20 15:29:53 +00:00
qbld.sh Add quick build 2013-12-20 15:29:53 +00:00
readme.md Add better control over whether tiddlers are transcluded in block or inline mode 2014-02-12 17:59:28 +00:00
serve.cmd Added primitive support for basic authentication 2013-11-28 14:03:08 +00:00
serve.sh Added primitive support for basic authentication 2013-11-28 14:03:08 +00:00
tankbld.cmd Add new edition for Tank, along with a build script 2014-02-12 18:29:32 +00:00
tankbld.sh Add new edition for Tank, along with a build script 2014-02-12 18:29:32 +00:00
test.cmd Adjust references to five.tiddlywiki.com 2013-12-15 16:53:10 +00:00
test.sh Adjust references to five.tiddlywiki.com 2013-12-15 16:53:10 +00:00
tiddlywiki.js Make require() compliant with CommonJS Modules/1.1 2013-10-12 13:44:09 -04:00
verbump.cmd Update verbump script to include version number in commit message 2013-12-03 10:09:37 +00:00
verbump.sh Update verbump script to include version number in commit message 2013-12-03 10:09:37 +00:00
wbld.cmd Update template used for deployment to TiddlyWeb 2013-12-11 07:37:08 +00:00
wbld.sh Update template used for deployment to TiddlyWeb 2013-12-11 07:37:08 +00:00

readme.md

Welcome to TiddlyWiki

Welcome to TiddlyWiki, a complete interactive wiki in JavaScript. It can be used as a single HTML file in the browser or as a powerful Node.js application. It is highly customisable: the entire user interface is itself implemented in hackable WikiText.

This is version 5.0.8-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.

TiddlyWikiClassic - http://classic.tiddlywiki.com

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

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.4-beta; you may also see other debugging information reported)
  5. Try it out:
    1. mkdir mywiki to create a folder for a new wiki
    2. cd mywiki to move into the new folder
    3. tiddlywiki --server to start TiddlyWiki
    4. Visit http://127.0.0.1:8080/ in your browser
    5. 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:

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

Commands

The following commands are available:

Working with the TiddlyWiki5 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