How do I configure the wiki?

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

PageTableOfContents: looks for tags like

(:toc:)

See PageTableOfContents for details.

Useful style directives

Comments

To create a comment in the wiki, use:

(:if false:)
text to omit
(:ifend:)

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

sourceblock

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:

(: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

Wiki Configuration things to try

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 webster at www truststc org 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');

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

Admin

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

Team for Research in
Ubiquitous Secure Technology