Prerequisites
CS-Wiki requires the Microsoft .NET Framework 2.0. I recommend Windows Server 2003 and IIS.
CS-Wiki is built as an add-in to the Community Server application. You must be running Community Server version 2.1.
CS-Wiki currently has only a single storage provider completed and coded: the FileSystemWikiProvider which will require write access to a single folder on your server hard drive. (Preconfigured to use /app_data, the default ASP.NET writable data folder)
Installation
Copy the required files and configuration
Copy com.db4o.Wiki.dll into the /bin folder.
Merge the contents of the communityserver.wiki.config file. The key sections are the Provider/add@name="WikiDataProvider", Wiki, and CSModules/add@name="Wiki*".
Copy the CommunityServer.Web/Wiki folder and merge the contents of the /Themes folder. The key files are the contents of the /Themes/default/Skins/Wiki and /Themes/default/Masters folders.
Merge the content of the siteurls.wiki.config file.
Merge the content of the resources.wiki.xml file into your /Languages/en-US/resources.xml file.
Log into your community as an administrator and create the "WikiAdministrator" role on the Manage Roles page (~/ControlPanel/Membership/roles.aspx).
See below for creating the placeholder folders for the root topic sets.
Customizing the configuration
Wiki data storage
CS-Wiki currently ships with a single data provider, the WikiFileDataProvider. The WikiFileDataProvider manages loading and saving all wiki content. The location of all wiki content can be configured in the wikiDataStoragePath attribute of the providers/add@name="WikiDataProvider" element. It should go without saying that the website will require Full Permissions to this folder.
Root topic sets
Root topic sets are the root URLs that the wiki content will be displayed as. Community Server also uses /Forums and /Blogs as root folders. CS-Wiki has the ability to run under multiple root folders....so your site can appear to have multiple wikis. CS-Wiki comes pre-configured with 2 root namespaces: /Sandbox and /Wiki.
Each root topic set, or folder requires a <Location> element in the communityserver.config file CommunityServer/Wiki/Locations collection.
Unfortunately, you also have to prime the root topic sets: Make sure the folder specified in the CommunityServer.config @wikiDataStoragePath (above) exists.
For each wiki root specified in the <Wiki>/<Locations> section, create the folder. In each folder, create a new XML file named _Namespace.xml. The contents of the file should be thus: (Change the ID and Title properties to match your root topicset.
<?xml version="1.0" encoding="utf-8"?>
<TopicSet ID="Sandbox" Title="Sandbox" Owners="">
<Permissions/>
</TopicSet>
Default Permissions
CS-Wiki ships with the default permissions set so that anonymous users may read, and any registered user may edit/create content.
Everyone: Read topics
Registered Users: Read topic & topic history, Edit Topic, and Create new topic
Topic Set Owners: Full access
SystemAdministrators: Full access + Administer
WikiAdministrators: Full access + Administer
Note that the Administer bit is undefined and reserved for future use.
An administrative UI has not been create yet to manage the default permissions. Please see the comments within the communityserver.wiki.config file for instructions to customize the default permissions.
Create the placeholder folders for the root topic sets
For each root topic set, create the folder in your CommunityServer.Web folder. Into each folder, place an empty file named default.aspx. These folders and files are placeholder files required by IIS for the URL rewriting to take place.