I've modified Wikit with a few things that I would like to see. All modifications are described below. The modified kit can be downloaded from [L1 ] (which includes the source, naturally).
Larry Smith I get 403 Forbidden when I click on that link.
Current version:
2003/10/14 11:33:47 23489-30081 wikit-akg.kit
Fixes a bug with static page cache maintenance with referring pages.
Cheers, AKG.
Formatting Rules
Headings
You can specify headings using using the format:
==<level> <Heading Text> ===
e.g.
==2 Headings ===
The level is a number between 1 and 6.
References
Adding highlights
Adding structure to your text
If the following line is plain text, i.e. isn't enumerated or quoted text, it will be part of the current item, with a line break before it.
If the following line is plain text, i.e. isn't enumerated or quoted text, it will be part of the current item, with a line break before it.
Further text for tag1.
All other lines beginning with white space are shown as is - no highlighting, reference generating, or even text wrapping occur.
Using brackets in your text can be done by doubling them, so [[ shows as [.
Wikit Configuration
In addition to the configuration described in Wikit Configuration, AKG Wikit has been extended with the following configuration environment variables:
Wikit URL's
This version integrates the functionality from tclhist (thanks to [L4 ]). I've tried to keep as much backward compatibility as possible, which has resulted in a somewhat inconsistent format.
To display an unformatted version, e.g. for WikiDiff to consume, use /<num>&?fmt=0. The "History" link on each page displays the version summary for that page. The tclhist specifier of "*" is accepted, but doesn't mix well with the static page cache.
The "Annotation" link on each page displays the version annotation for that page.
To obtain the source (unformatted) use /<num>.<ver>?fmt=0 Links for displaying earlier versions are provided in the History (Version Summary) page.
The differences are displayed thanks to Pascal Scheffers worddiff package, which is part of https://wiki.tcl-lang.org/WikiDiff . To display unformatted output, i.e. direct from cvs diff, use /<num>-<ver>?fmt=0 Links for displaying differences are provided in the History (Version Summary) page.
Modifiers:
The fmt modifier seems to be lost when used in conjunction with the static page cache. I'm still investigating why.
Page History
Wikit can use CVS to keep a history of each page, which may be viewed using the commands described above.
To enable history, WIKIT_HIST and WIKIT_CVSDIR must be defined.
To add pages into cvs run:
wikit.kit -archiveHistory
periodically, e.g. from a cron job. A delay of 1 second is included between each update to prevent the cvs server from being flooded.
Miscellaneous Enhancements
This includes a fix to the annoyance of having a "Saved Page" message displayed when cancelling the edit.
CvK: <wikit-akg.kit> - The page Edit function link seems unavailable on all pages when running under WindowsXP as a HTTPD service. (ie, tclkit wikit-akg.kit -httpd <port#> ), but all seems to work when run as CGI under Apache. Unsure why this is?
MHo: One thing preventing me from using this derivate of wikit is, that actual changes in wikit are not reflected. It would be nice if the modifications in AKG Wikit were isolated in the code, so that one could apply it to the 'normal' wikit after a new version of that became available...