Basic setup instructions for adding a wiki (www.dokuwiki.org) to a newly created CS wiki account.

Provided for CS research projects by request to software@cs…

• x-wiki account on wiki.cs.purdue.edu
• default dot files
• pre-configured apache setup, including apache, cgi-bin, and htdocs directories
• virtual x host name and main departmental apache server configured to point to x-wiki server
• x-wiki server run at boot time (via ~/apache/bin/rc.local)

For ease of administrative access to the x-wiki account, use ssh-keygen to create a public/private key. Install the public key in ~x-wiki/.ssh/authorized_keys. (Otherwise, use “sudo -u x-wiki bash”, say, to access the account after logging in to wiki.cs.purdue.edu.)

% ssh-keygen

Save file to, e.g., ~/.ssh/id_rsa_x (and id_rsa_x.pub).

• Download .tgz file from http://wiki.splitbrain.org/wiki:dokuwiki.
• Transfer to x-wiki account on wiki.cs.purdue.edu
• gunzip and untar the .tgz file
• mv dokuwiki files (including .htaccess) into htdocs directory
• Download .tar.gz file from http://www.jandecaluwe.com/testwiki/doku.php/navigation:sidebar_install
• gunzip and untar the .tar.gz file
• move sidebar into ~/htdocs/lib/tpl

• open http://YOURHOST.cs.purdue.edu/install.php in your browser
  • follow directions
  • suggested Initial ACL policy: Public Wiki
• login as administrative user
• enable “sidebar” as template (and create a page named “sidebar”)
• Change directory creation mode to 0770
• Change file creation mode to 0660
• Set email address for automatic mails (e.g., to yourself)

<?php
$conf['title'] = 'YOUR TITLE';
$conf['template'] = 'sidebar';
$conf['tagline'] = '';
$conf['baseurl'] = 'http://YOUR-HOST.cs.purdue.edu';
$conf['dmode'] = 0770;
$conf['fmode'] = 0660;
$conf['useacl'] = 1;
$conf['superuser'] = '@admin';
$conf['mailfrom'] = 'YOUR-EMAIL@cs.purdue.edu';
$conf['tpl']['sidebar']['editbtntxt'] = 'edit';
$conf['allowdebug'] = 0;
$conf['userewrite'] = 1;

@include(DOKU_CONF.'local.protected.php');

Uncomment the rewrite rules section, specifically “RewriteEngine on” and the block of Rule and Cond statements. (Leave the RewriteBase statement commented out.)