WiKit and TclKit were designed to run out-of-the-box, with no installation or configuration whatsoever.
This goes beyond what you are probably used to with software applications as elaborate as WiKit.

Enough said, '''let's get you started''':

   1. Grab a compressed copy of [the Tcl'ers Wiki] at http://purl.org/mini/cgi-bin/wikit.gz (or an empty Wiki at [http://www.equi4.com/pub/tk/examples/wikit.bin])
   1. Uncompress it to '''wikit.tkd'''
   1. Grab the appropriate runtime of [TclKit] for your system at http://www.equi4.com/tclkit/
   1. Uncompress and rename it to '''tclkit''' (leave as is on Windows)
   1. Make both files executable: '''chmod a+rx wikit.tkd tclkit'''
   1. Type '''tclkit wikit.tkd''' ... and you should be up and running

''Welcome to WiKit!''

You can put "tclkit" anywhere on your $PATH, it's just a runtime.
The file "wikit.tkd" is an executable "[scripted document]" (containing all the scripts as well as a database with all the pages), and typing just "wikit.tkd" (or "./wikit.tkd") should also work.  In fact, you can put "wikit.tkd" anywhere on your $PATH as well.

WiKit does not require [Tcl/Tk] or MetaKit [http://www.equi4.com/metakit/] to be installed on your system - nor does it care if they are (or will be, one day).  Everything is wrapped up inside the TclKit standalone excutable.  To uninstall WiKit: delete these two files again.  To use this on another machine: move them.  If it's a different platform: switch to the proper TclKit runtime and move only the "wikit.tkd" file.

That's all there is to it.

----

Not quite.  I have downloaded tclkit-8.4-20 for solaris and the empty Wikit from [http://www.equi4.com/pub/tk/examples/wikit.bin].  I follow the directions above.  I launch wikit.tkd and edit it.  I close it.  I try to open wikit.tkd again and get a "Segmentation Fault".

Next, I try the TclKit 8.4 for Mac.  It does the same thing; the edited wikit.tkd file crashes the TclKit.  It seems that the wikit.tkd can only be opened once.  Am I missing something obvious? - Donavan Hall, [mailto:hall@magnet.fsu.edu]

----

April 2001: This problem was resolved recently (after 8.4-20) - on Solaris and Mac, the byte order differs from the system on which WiKit was created.  There was a bug in the MetaKit 2.3.3 beta, which did not convert properly.  New builds of TclKit work, there's a Solaris build at [http://www.equi4.com/pub/tk/tclkit-8.4-21-solaris/tclkit-sparc.gz], but I have no new Mac binary to point you to yet.  Once the wikit has been used on a big-endian machine, it will work with 8.4-20 too, btw.  Be sure to use a fresh copy of wikit, because the bug in 8.4-20 actually *damages* the datafile...

----

I Tried to run it (local) in a Win98 machine. When I run it at the firs time OK, but the second time I try, a "Fatal error" message box appears with the following message:

 couldn't read file "C:/wikit.bin/Html_library.tcl": No error

What am I doing wrong?

MRS

[JCW] - You're hitting a bug in the latest tclkit's - I seem to have botched the compatibility wiith older docs.  Am working on it right now.

----
[Category Wikit]