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://mini.net/cgi-bin/wikit.gz and and uncompress it to '''wikit.tkd''' (unless you want to start with a fresh set of pages) 1. Grab the appropriate runtime of [Tclkit] for your system at http://www.equi4.com/tclkit/, or in the case of Mac OS X better Daniel Steffens latest "Wishkit" [http://www.maths.mq.edu.au/~steffen/tcltk/TclTkAqua/]. 1. Uncompress and rename it to '''tclkit''' (leave as is on Windows) 1. Grab a copy of the latest wikit code at [http://www.equi4.com/pub/sk/wikit.kit] and rename to wikit 1. Make both files executable: '''chmod +x tclkit wikit''' 1. Type '''tclkit wikit''' ... 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" 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? * It's fast. [RPH] Not over a dialup connection... * Pages can be renamed. [RPH] Why can't you do this with the CGI version? [aa] How about listing some of the ''drawbacks'' of a [Wikit in local mode]? * The wiki external URL links don't work. * There's no way to "find" text on a page (the browser will provide you this function with the web app). * The local editor doesn't support drag-and-drop, which your web browser might. [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. 17feb04 [jcw] - Note also that there's the option to run "wikit.kit -httpd 12345" and then point your browser at http://localhost:12345 ... ---- [mailto:bchlawrence@hotmail.com] 2004-04-20 Lawrence: Hello! The standalone wikit allow hyperlink to files. Say "file://c:\a.jpg" can link to a.jpg in c:\ However I can't figure out how to use using relative paths. Say the my_wiki.tdk is in c:\my_documents folder, and I got a.jpg in c:\my_documents. I can't open it by "file:a.jpg". however, I can use "file://c:\my_documents\a.jpg" but that will be not useful instead of a relative path. How to do that? Thx! '''June 18, 2002''' - There is a new version of wikit, see the Wikit home page at [http://www.equi4.com/wikit/]. 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? * In local mode, on some machines anyway, the font uses is very very small. * In CGI mode, one can apply Style Sheets. (Is there a web page that discusses how to do this?) * In local mode, each viewing page has a search box at the top of the page. * In local mode, HTTP is not supported. Thus, links outside of the wikit do not work. In fact, if you use http: links '''within''' the wiki, instead of using wiki likes like [formatting rules], those won't work either. * In local mode, you can add images into the wikit itself [Adding images to local mode wikis] ---- [Lars H], 16 Feb 2004: What is supposed to happen when one starts wikit in local mode? When I try the above instructions (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. [jcw] - Don't know why it doesn't report errors, but you need to have X11 running on OSX to use Tclkit in GUI mode. Or get Daniel Steffens latest "Wishkit" [http://www.maths.mq.edu.au/~steffen/tcltk/TclTkAqua/] - which is already set up to run .kit files simply by double-clicking on it, anti-aliased and all: [http://mini.net/pub/wikit.png] [Lars H]: OK, with wishkit it works fine, and looks quite cool (as your image shows). However, I find it ''really'' strange that tclkit should require X11 on Mac OS X; I suppose the combination is technically possible, but from a novice usability standpoint it could be a nightmare. Sort of spoils the "trivial installation" idea. Therefore I modified the instructions above, to include at the wishkit alternative. Some other points: * Why isn't the wiki downloadable as "wikit.tkd.gz" rather than "wikit.gz"? This would remove a renaming step (cryptically described as "uncompress it to" above). * I'd like to be able to use the page up/down keys to scroll the page, but the only way to scroll seems to be to use the mouse. * The search-as-you-type feature seems a bit over-zealous, searching before one has finished typing. Possibly it is meant to be immediate, but the wiki has grown too large for that. * Browsing via categories is a bit more awkward than on the net, because it you go Category page -> list of references to it -> Some page in that list and then click Back, you're back to the category page rather than the list. On the whole, though, it is a major improvement to have access to wisdom of [The Tcler's Wiki] even when I'm off-line. ---- [Category Wikit]