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:
Lars H, 16 Feb 2004: What is supposed to happen? When I try this (in Mac OS X) the tclkit command takes a second or two to complete, but there is no visible result: No window that opens, no error message, nothing! It just returns.
Welcome to Wikit!
You can put "tclkit" anywhere on your $PATH, it's just a runtime. The file "wikit" is an executable starkit containing all the scripts - typing just "wikit" (or "./wikit") should also work. Note that wikit expects a wikit.tkd file in the current directory (else it will create a fresh one).
This means that if you wish for people to share wikit data locally, you need to write a wrapper that cd's to a common, writable directory, before invoking the wikit.kit file. That is the only way that all the users - or even you yourself - will see an accumulation of data. It is an unfortunate consequence of the new design.
You can specify the name of the datafile on the command line. To open the wiki in read-only mode, add "-readonly" as command-line arg.
Wikit does not require Tcl/Tk or Metakit to be installed separately 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 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.
LV Someone want to document the benefits of running wikit as a desktop app instead of as a CGI application?
aa How about listing some of the drawbacks of a Wikit in local mode?
LV: Note however that all 3 of these are things that could be addressed, if someone wanted them badly enough to work on the code.
June 18, 2002 - There is a new version of wikit, see the Wikit home page at [L2 ]. It differs from the previous code in that it keeps the wiki data in a separate Metakit datafile, while the code is now a standard starkit. This is not a rewrite, but it does consolidate all the latest changes, clean up lots of internal messiness, and it's much easier to alter without losing existing wikit page contents.
The new code is now also driving the Tcl'ers Wiki itself -JCW
August 2, 2002 - Fixed link to wikit.kit, it was no longer pointing to the right spot.
November 26, 2002 - wikit has the ability to fetch newer versions of the data file itself - just do this:
tclkit wikit.kit /path/to/wikit.tkd -update http://mini.net/tclhist
Note that the versions fetched are the daily commits, not the very last-minute pages.
LV Anyone remember which page documents the whole Tcler's Wiki CVS page commit'' information? If so, replace this line with a page reference. Otherwise, I suppose this would be as good a place as any to document it.
Basically, the idea is that each time a page is modified, the new page , along with the date and IP address, are saved. Then at the end of the day, these changes are comitted to a CVS repository. There is an interface to that repository so that previous revisions of a page can be seen. See http://mini.net/tclhist/ for details.
What are some of the differences between the Wikit in local mode and the wikit in CGI mode?