User Tools

Site Tools


wiki_setup

Wiki (DokuWiki) Setup

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

Initial Conditions

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)

Create SSH Access

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).

Install Dokuwiki

Configure Dokuwiki

    • 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)

Sample Contents of ~/htdocs/conf/local.php

<?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');

Changes to ~/htdocs/.access

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

wiki_setup.txt · Last modified: 2007/10/15 05:55 by jtkorb