Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
a reusable non-linear personal web notebook.

This branch is 137 commits behind TiddlyWiki:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
deprecated
html
java
jquery
js
plugins
recipes
shadows
test
ALPHA
Makefile
README.md
bldalpha
bldxjs
cook
tiddlywiki.html.recipe
tiddlywiki_externaljs.html.recipe
tiddlywiki_externaljs_tiddlyspace.html.recipe
tiddlywiki_externaljs_tiddlyspace_alpha.html.recipe
tiddlywikinonoscript.html.recipe
tiddlywikinosaver.html.recipe
uploadalpha

README.md

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:

  1. tiddlywiki, this includes the source and test code for TiddlyWiki itself.

  2. 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.

  3. translations, this includes the translations of TiddlyWiki into a number of different languages.

  4. 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

TiddlyWiki is Copyright 2011 UnaMesa Assocation

It is licensed under a BSD License.

Something went wrong with that request. Please try again.