TiddlyWiki.org Production Process

The motivation is to make it easy to produce multiple variants of tiddlywiki that share some or all of the same content. For example, tiddlywiki.com, tiddlywiki.com/dev and osmosoft.com have all got content in common that previously had to be manually mirrored between them. A further goal is to allow the main block of TiddlyWiki JavaScript? code to be split up into separate files to make it easier to handle within Subversion.

Cooking TiddlyWiki

This is the process of building a vertical edition of TiddlyWiki from it's component parts scattered over the TiddlyWIki SourceTree using the Cook tool. We discuss cooking the index.html and empty.html files for tiddlywiki.com from their respective RecipeFiles?  index.html.recipe and  empty.html.recipe. There are similar processes for cooking the files for dev.tiddlywiki.com and www.osmosoft.com.

(See BetaProductionProcess for additional information about building beta versions of TiddlyWiki)

Windows

this is what I'm using and it seems to work fine in WindowsXP Pro, as long as the destination (-d) directories already exist.

cook.exe resides in the Trunk\cooker directory

cook.exe ..\verticals\tiddlywiki.com\empty.html.recipe -d ..\..\cooked\verticals\tiddlywiki.com\

Mac OS X

1. First, you'll need to be GettingTheSource if you haven't already done so. This description assumes that your working copy of the SourceTree is at /tiddlywiki/trunk/
2. Open a terminal window and change to the directory /tiddlywiki/
3. Execute the commands

   rm -R cooked/tiddlywiki.com
   mkdir cooked/tiddlywiki.com
   ruby -C trunk/cooker cook.rb ../verticals/tiddlywiki.com/index.html.recipe -d ../../cooked/tiddlywiki.com/
   ruby -C trunk/cooker cook.rb ../verticals/tiddlywiki.com/empty.html.recipe -d ../../cooked/tiddlywiki.com/
   

4. Check for errors
5. The cooked files should be in /tiddlywiki/cooked/tiddlywiki.com/, including the HTML file and the associated image files

Linux

TBD

Ginsuing TiddlyWiki

This is the process of splitting the tiddlers out of a TiddlyWiki and into separate files. This is typically done when a TiddlyWiki file has been modified in order to get the modified tiddlers back into the Subversion SourceTree.

Windows

TBD

Mac OS X

1. This description assumes that the TiddlyWiki file that has been modified is at /tiddlywiki/tiddlywiki.com/index.html
2. Open a terminal window and change to the directory /tiddlywiki/
3. Execute the commands

   ruby -C trunk/cooker ginsu.rb ../../tiddlywiki.com/index.html
   rm ginsued/tiddlywiki.com/*.*
   mv tiddlywiki.com/index.html.0/*.* ginsued/tiddlywiki.com/
   rm -d tiddlywiki.com/index.html.0
   

4. Check for errors
5. The individual tiddler files should be in /tiddlywiki/ginsued/tiddlywiki.com/
6. Execute this command to compare the ginsued tiddlers with the original versions:

   opendiff ginsued/tiddlywiki.com/ trunk/verticals/tiddlywiki.com/tiddlers/
   

Linux

TBD