TiddlyWiki

https://github.com/TiddlyWiki/tiddlywiki

Description

This is the master repository for the core of TiddlyWiki. It is for the development and maintenance of TiddlyWiki.

If you simply wish to use TiddlyWiki, it is easiest to download it from: http://tiddlywiki.com/

This site also gives details about TiddlyWiki.

TiddlyWiki code and issues used to be stored at http://svn.tiddlywiki.org and http://trac.tiddlywiki.org .

Installation

Install the git version control system, if you do not already have it.

Install the ruby programming language, if you do not already have it. Ruby is required for some of the TiddlyWiki tools (cook and ginsu).

TiddlyWiki has 4 important parallel repositories:

tiddlywiki, this includes the source and test code for TiddlyWiki itself.
cooker, this includes the tool for building a TiddlyWiki from a set of tiddlers (cook) and the tool for splitting a TiddlyWiki into separate tiddlers (ginsu). You need to download this repository for any TiddlyWiki development.
translations, this includes the translations of TiddlyWiki into a number of different languages.
tiddlywiki.com, this includes what is required to build and upload the http://tiddlywiki.com website.

To do any serious work on TiddlyWiki you will probably want to download all four of these repositories. They should be downloaded into parallel directories, since some of the build scripts used relative links to the other repositories:

git clone git@github.com:TiddlyWiki/tiddlywiki.git
git clone git@github.com:TiddlyWiki/cooker.git
git clone git@github.com:TiddlyWiki/tiddlywiki.com.git
git clone git@github.com:TiddlyWiki/translations.git

Next you need to set up cook. Copy the cook script file to somewhere that is on your path. Edit this file according to the instructions in the file.

Building and testing

There is a Makefile for managing testing. To build and execute the TiddlyWiki tests, type:

make test

Note that, depending on your machine configuration, the tests may take a while to run (perhaps as long as a 30 seconds to a minute).

To set the version number of the alpha build output files edit the file ALPHA. This should normally be set to the same version as in the TiddlyWiki Version.js file.

To build an alpha version of TiddlyWiki incorporating any changes you have made, run the bldalpha script by typing:

./bldalpha

Contributing

Pull requests for feature requests/bug fixes are being accepted for this project. Pull requests should be accompanied by tests. If no tests existed for the given functionality previously, please include these in your contribution to ensure that the TiddlyWiki code base is as reliable as possible going forward. Any pull requests without tests will not generally be folded into the core codebase. See https://github.com/TiddlyWiki/tiddlywiki/wiki for more information.

License

It is licensed under a BSD License.

3.3 KiB Executable File Raw Blame History