TerraSwarm Sponsors and Researchers who attend conferences
Information about the Wiki facility
Previous section  |  This section  |  Next section
Previous question  |  This question  |  Next question

How do I configure the wiki?
Christopher Brooks, 14 Dec 2012
Last updated: 24 Jan 2013

These notes are based on email from Jonathan Sprinkle (Thanks Jon!)
These notes are shared between a number of websites, which is why we are not using the wiki

Wiki Overview

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?

Things that appear at the top of a wiki page

Changing the title

To change the title to anything you would like, use:

(:title Foo Bar:)

Table of Contents

PageTableOfContents: looks for tags like
See PageTableOfContents for details.

Useful style directives


To create a comment in the wiki, use:
(:if false:)
text to omit

Wiki comments are a good way to tell editors about details such as that lists should be alphabetical.


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

$ ls -la
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                         
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/


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

Wiki Configuration things to try


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

# 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 webadmin at terraswarm and we can add it to ~www/php/pmwiki/pub/skins.

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


$TimeFmt = '%B %d, %Y, at %I:%M %p EST';


JsMath:Add markup to display and embed mathematical formulas in wiki pages using TeX was set up and could be set up again

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.


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