Purpose: A cookbook approach to creating a Wiki of your own.
I'm sure this doesn't belong here, but it doesn't seem to belong anywhere else either. It took me two days of headbanging to figure out how to create a new wiki page in wikit. It turns out you are supposed to make a "pretend" link in an existing page (by surrounding it with square brackets), save, click on the resulting link and then edit the new page. Seems kind of boneheaded, but at least now I know. Hmmm...and even then, the original link stays as linked square brackets (instead of becoming a regular link) and clicking it brings me to a new edit thing every time.
How about some n00b docs for this thing?
OK, now I have a series of steps to create new page:
1 Edit an existing page and put word W in square brackets. W will be the title of the new page. 2 Save the existing page. 3 Click on the little blue brackets around W. You will be brought to the edit page for W. 4 Don't edit yet. Click the link at the top (which says W). 5 You will be brought to the W page, but the title isn't linked. 6 Stop and restart wikit. 7 Go back to the existing page and click the square bracket again to get to the edit page for W 8 STILL do not edit the page, instead click the W link at the top (just like 4) 9 You will be brought to the W page, but now the title is linked. 10 Click edit on the W page and edit it how you want. 11 If you go back to the existing page, now your square brackets have become a link.
This can't be what everyone else has to go through to create a new wikit wiki page. Or did I download an old buggy version? Where are the docs?
15jun04 jcw - Ouch. To get help on wikit, run it in a directory where there is no wikit.tkd and it'll create a fresh one with help pages (I see it does indeed not mention clearly how to create a new page). See How to create your own page. The problem with the title not being linked is new to me - how are you running wikit: tk/cgi/httpd/other?
The reason that adding pages is not totally obvious is deliberate, btw - it is a small hurdle to take so occasional visitors don't start creating pages all over the place. Then again, the way to add is now linked prominently on the new front page, at http://wiki.tcl.tk/
15jun04 I'm running httpd. When I follow the recommended sequence, it all succeeds. But then if I go back to the original page (where I inserted the new reference) the link is still blue brackets which, if I click them, bring me to editing *another* new page with the same title (I know it's another page because my old text isn't there and the "URL number" is incremented). Just tested tk mode and it does the exact same thing. (Don't want to create junk on your server, but I should probably test this outside of my own sandbox. ThisIsMyVeryOwnLinkDPR)
MR: It'd be remiss to not mention other Wiki systems, that might be easier to get going in a particular environment... my ProjectForum and CourseForum systems are particularly easy in this regard.. no bias of course!
Note that logging goes to stdout (or is it stderr) so you should expect to redirect it if you want logs that you can monitor.
Also, the default wikit.kit content has some unfilled links (pages Starkit (10), Tclkit (11), Incr Tcl (12), Adding Help to Starkits (13)).
The wiki format can be highly addictive. Don't miss a chance to get acquainted with the Notebook App, a very good tool for one to keep their personal notes.
dlb: has anyone been successful in running the new (07-Nov-2000)VFS wikit via CGI ? -- if not, are there still older versions available ? I've been having a hell of a time getting wikit running as a cgi process , is there someone I can direct questions to ??
LV: Did you check the link above about Wikits and CGI? Did you put up a note on the Gripes about Wikit, or Wikit Problems, pages?
VPT: 17th Feb '02 - the current wikit.tkd runs as a cgi process (at least on Linux). I put the tclkit in /usr/bin since that was in the PATH in apache's environment (as displayed by the printenv cgi-bin script). I then put the wikit.tkd in the cgi-bin directory and set the permissions to rwx for the user apache runs as (I'm a lttle uncomfortable with having the write permission set but at least it only has the permissions of the apache user). Editing a page with Mozilla 0.9.8 fails with,
[error] (26)Text file busy: exec of /var/www/cgi-bin/wikit.tkd failed
whilst editing with Netscape Communicator works. This failure mode has been reported before see wikit under CGI. Actually the edit succeeds although the browser reports an error. In any case it only fails if you are using Mozilla local to the server.
MDD: What would be really nice would be if someone would create a Starkit that combines tclhttpd and the wikit into one turnkey wiki server. Performance should be better, since you wouldn't have to use CGI.
11apr03 jcw - Yes, that would be cool, but it may need some work (either to make it properly keep state with repeated requests, or to make it work in a slave interp which gets re-inited on each access). Meanwhile, as of a month or so, code was added to wikit so it has its own simple-minded http server, courtesy of PS. I just looked, and see that for some reason it comes up in read-only mode, no idea why. Anyway, the command to make it work is:
./wikit.kit -httpd 8080
Or on Windows, I suppose you could do:
tclkitsh wikit.kit -httpd 8080
Then you can access it as http://my.machine.name:8080/
May 10 2004: Jeff Smith : refering to jcw's comments regarding getting it to work under tclhttpd, the Session module in tclhttpd provides a session state array and a slave interpreter which can keep state for the life of the session. Check out [L1 ] for an example.
TV (jun 18 03) Easy to use 'personal' web services seem like a good idea to me, everyone dsl, energy friendly cheap server computers.. Beware that tclhttpd being a fine and interesting program has MAJOR security loopholes when you start it (at least the versions I saw) out_of_the_box, which may already take some work, though I can download and have a server running in 15 min I guess. I mean the upload option together with .tml gives you unlimited tcl power on the webserver machine with simple means, and on a non user restricted od like many ms windows versions, that means total control from all over the world is possible once you hook up to the internet. Not that most people would know how. Can be solved easily enough though, I'll see if I can make a neat page with a start-and-go tclhttpd install variation.
(Brent Welch For the record, I've never heard of tclhttpd granting "total control" of its host to anyone. If there is an exploit of the file upload feature, I'd like to know about it. And besides, you can create a minimal tclhttpd that doesn't have anything you might worry about.)
2004-2-29 Brent Welch Here is a CGI script I've used to launch wikit:
#!/bin/sh here=/http/wiki cd $here WIKIT_CSS=/htdocs/stylesheet.css export WIKIT_CSS echo HTTP/1.0 200 ok exec /usr/pan/bin/tclkit $here/bin/wikit.kit $here/panasas.tkd