WiKit

See the Tcl'ers Wiki [1]

10/09/04 das - upodated to latest Wikit release, now uses wikit/edit/n@ for edit links and wikit/references/n! for references links, to allow robot exlusion of these pages via robots.txt

26/07/03 das - migrated this wiki to new Wikit with CSS suport & page caching (as mentioned by jcw below), c.f. http://www.equi4.com/wikit

Notes about this wikit installation: (mostly only useful to SourceForge alphatcl project developers with shell access; all paths below are relative to the alphatcl group homedir, /home/groups/a/al/alphatcl/ )

pages are styled via http://alphatcl.sourceforge.net/wikit.css, adapted from http://wiki.tcl.tk/wikit.css
wiki/wikit.kit is the standard starkit from [2], except for a tiny modification that adds a <p id="footer">...</p> around the footer on each page to allow separate styling (in particular adding the SF logo via CSS background-image).
the SF alphatcl home page http://alphatcl.sourceforge.net/ is redirected to the toplevel wiki page at http://alphatcl.sourceforge.net/wikit/ (aka http://alphatcl.sourceforge.net/wikit/0 )
all urls starting with http://alphatcl.sourceforge.net/wikit/ that don't have a cached html version in htdocs/wikit/ are rewritten via local redirect to the wikit cgi at http://alphatcl.sourceforge.net/cgi-bin/wikit/ ; this is all done via apache rewrites, c.f. htdocs/.htaccess:

 RewriteEngine on
 RewriteBase /
 RewriteRule ^$ wikit/ [R,L]
 RewriteRule ^wikit$ wikit/ [R,L]
 RewriteRule ^wikit/$ wikit/0 [PT]
 RewriteCond /home/groups/a/al/alphatcl/htdocs/$1 !-f
 RewriteCond /home/groups/a/al/alphatcl/htdocs/$1.html !-f
 RewriteRule ^(wikit/.*)$ cgi-bin/$1 [L]
 RewriteCond /home/groups/a/al/alphatcl/htdocs/$1 !-f
 RewriteRule ^(wikit/.*)$ $1.html [L]

wikit is started as a cgi via the following script (c.f. cgi-bin/wikit) :

 #!/bin/sh
 H=/home/groups/a/al/alphatcl
 export WIKIT_BASE=http://alphatcl.sourceforge.net/wikit/
 export WIKIT_EMAIL=das@users.sourceforge.net
 export WIKIT_CACHE=$H/htdocs/wikit
 export WIKIT_CSS=/wikit.css
 export WIKIT_HIST=$H/wiki/data/wikihist
 #export WIKIT_DUMP=$H/wiki/data/wikit.log
 cd $H/wiki/data
 umask 002
 exec ../tclkit ../wikit.kit wikit.tkd

the directories wiki/data, wiki/data/wikihist, htdocs/wikit all need to be 'chmod 2777' and wiki/data/wikit.tkd needs to be 'chmod 666' for everything to work.
certain pages are protected and are only editable in local mode, c.f. Web Settings (that page in particular...).
to run wikit in local mode (allows eding page titles & protected pages), you need to 'chmod go-w wiki/data/wikit.tkd', 'scp wiki/data/wikit.tkd' to a local box, run wikit there in local mode, 'scp' back and 'chmod go+w wiki/data/wikit.tkd'.
you can also download the wiki database at http://alphatcl.sourceforge.net/alphatcl-wikit.tkd (but if doing local changes on the DB, still need to prevent concurrent web editing as above).
wiki/data/wikihist/ contains the full history of all page edits, no cleaning is performed at present (may lead to quota problems with SF over time).
a cron job (running as user das) backs up wikit.tkd every day; the last 14 backups are kept, c.f. bin/bckp_wiki; the backups are in wiki/backup/. The cron job also compresses all uncompressed pages in wiki/data/wikihist/.
wiki/wikitool.kit can be used to perform database maintenance, e.g. cleaning of unlinked/empty pages: 'wikitool wikit.tkd scan mark; wikitool wikit.tkd scan; wikitool wikit.tkd scan clean; wikitool wikit.tkd scan unmark'.
to fix incorrect page refs, run [3] (i.e. when the ! links at the top of wiki pages are out of sync). This uses 'wikitool wikit.tkd pages fix'.

15nov02 jcw - There's a new version of Wikit out, which supports CSS. It runs as a starkit nowadays (separate from wikit.tkd), and requires tclkit 8.4.x probably. Conversion from older wikits is automatic (but irreversible). See the Tclers' Wiki for more details, or [4]).

[ das 28/07/03 ]

Category Wiki