From: Thomas Counsell <tamc2@...>
Date: 2005-01-12T04:15:27+09:00
Subject: [ANN] Soks - Yet Another Wiki

http://rubyforge.org/projects/soks/

Soks is yet another wiki. Sorry about that. It was written mainly for 
my own gratification and in no way reflects on the quality of other 
wikis available, nor on the fact that my time could probably have been 
better spent on improving one of them. As is always the way, none of 
them was quite right for me, and I've been enjoying using it to learn 
ruby.

What was right for me?
* Automatic linking between pages (no need for wiki words or any 
bracket shenanigans).
* Easy to add, move and delete pages
* Textile
* Flat file storage (incidentally, this makes it easy to import from 
instiki using its export function)
* Per wiki templates.
* Webrick (No need for Apache).
* Uploads and Images
* Calendars, automatic summaries and the like

Some of that might be right for you to, if so I'd be grateful if you 
would give it a go (instructions below) and let me know how you get on 
/ what you think.

First release, so don't trust your mission critical sites to it. In 
particular, I have not tested it on any flavour of windows or any 
version of ruby except the 1.8.2 series. If anyone does/doesn't get it 
working on windows, please let me know.  It is also not as fast as 
other wikis, so I wouldn't advise it on any 100MHz 64MB virtual hosts.

Thanks

Tom

USE

Best installed by a ruby gem:
1. gem install Soks
2. soks-create-wiki.rb (will create a folder called soks-wiki in the 
current directory)
3. http://localhost:8000

Otherwise install by
1. Download the tar or zip from http://rubyforge.org/projects/soks/ ,
2. untar or zip,
3. cd Soks-0.0.2,
4. ruby bin/soks-create-wiki.rb (will create a folder called soks-wiki 
in the current directory)
5. http://localhost:8000

To restart
A. soks-create-wiki.rb  (will not recreate the wiki if the folder 
soks-wiki already exists in the current directory)
OR B. ruby soks-wiki/start.rb

To allow the site to be accessible from beyond localhost:
1. cd soks-wiki
2. edit start.rb
3. un-comment the :url => 'http://localhost:8000' line and write your 
preferred url. If required also un-comment and change the :port line.

To tinker
A. Have a look at the start.rb file.  Lots of things you can change 
there.
B. Read the How to hack soks page either on rubyforge or in the soks 
wiki you have started.


----
Tom Counsell.  http://tom.counsell.org