How do I configure the wiki?
Christopher Brooks, 7 Sep 2006
Last updated: 23 Feb 2011

This notes are based on email from Jonathan Sprinkle (Thanks Jon!)

The way the wiki works is a little bit tricky. (tricky wiki)

We use PmWiki and wiki farms.

Each workgroup that has a wiki has a few configuration files checked in to CVS under workgroupName/web/wiki. To access these files, use CVS. For example for workgroups on the Trust website:

cvs -d :ext:source.eecs.berkeley.edu:/home/cvs_trust co workgroupName

Once you make your changes, check them in and then click on the CVS Update link on the main page. For more information, see How do I edit pages in a group with the "CVS Authoring" option?

Skins

PmWiki Skins can be used to change the look and feel.

If you want to try a new a skin, then the website admins probably need to add it to the wiki-wide skins directory. For example, /export/home/www/php/pmwiki/pub/skins needed to have the monobook directory set up.

As of 1/7, we have the simple and monobook skins. The monobook skin is now the default. The monobook skin is similar to the skin used by Wikipedia. To select a skin, create wiki/local/config.php and

<?php
# Specifies the name of the template file
# to be used to generate pages.
$Skin = 'simple';
?>

Note: the file must start with <? and end with ?>. The last line must end in a new line

It is possible to place a copy of the skins directory in your own wiki, but this gets confusing since the paths tend to look for files in the wiki-wide directory. If you find a skin you would like to try, send email to webmgr at www truststc org and we can add it to ~www/php/pmwiki/pub/skins.

sourceblock

By the way, if you're adding code segments to the wiki, I installed the sourceblock package from the cookbook: http://www.pmwiki.org/wiki/Cookbook/SourceBlock To add/format source, use:

(:source:)                                                                    
$ ls -la
(:sourcend:)                                                                  

To get those nifty little boxes that call out source from readable text. You can give specific languages and it will format that text correctly as well...

(:source lang=bash header=/etc/bash.bashrc:) export                           
ICE_HOME=/opt/Ice-3.1.0 export PATH=$ICE_HOME/bin:$PATH                       
export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH                         
(:sourcend:)                                                                  

As from http://chess.eecs.berkeley.edu/dgc3/wiki/Dgc3/ComputerConfigOrca2Prereq

Languages that are supported can be found here (GeSHi tool): http://qbnz.com/highlighter/

emenu

ExpandingMenu is another possibility. It is used by the Escher Wiki

Table of Contents

PageTableOfContents: looks for tags like

(:toc:)

See PageTableOfContents for details.

An example config.php

A more complex wiki/local/config.php:

<?php if (!defined('PmWiki')) exit();
$WikiTitle = "DARPA Grand Challenge 3 (DGC3)";
$PageLogoUrl = "http://chess.eecs.berkeley.edu/dgc3/images/gdc150.gif";

$DefaultPasswords['admin'] = crypt('notarealpassword');

$EnableUpload = 1;
$DefaultPasswords['upload'] = crypt('notanotherrealpass');

include_once('cookbook/sourceblock.php');

putenv("TZ=EST5EDT");
$TimeFmt = '%B %d, %Y, at %I:%M %p EST';
?>

JsMenu

JsMath:Add markup to display and embed mathematical formulas in wiki pages using TeX is set up.

Upload Extensions

To add an extension to the list of acceptable extensions to be uploaded, add

$UploadExts['wmv'] = 'video/wmv';

to web/wiki/local/config.php in the cvs repository for the group. Then do a cvs update: http://host/group?Action=cvsupdate.

Admin

Systems Administrator level pages (for people who have a login account on the webserver): How do I set up the Wiki System?