The Embedded Website Workgroup
FAQ
Previous section  |  This section  |  Next section
Collapse

Wiki

Information about the wiki facility.

How do I set up a Wiki?
Website workgroups can have a wiki associated with them. To enable the wiki, go to the "admin" page for your workgroup, then select "Configure Group", click on the Wiki box and select "Change Group Configuration".

Email will be sent to the website staff, who will set up your wiki and email you when the setup is done.

(website staff, see How do I set up the Wiki infrastructure)

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

Table of Contents

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 webmgr at embedded eecs berkeley edu 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?

How do I change access to the wiki?
To change who can access a wiki, go to the admin -> access page for the workgroup.

See also How do I control access to my workspace?

How do I change the logo in the corner of the wiki?
To change the logo, use CVS to edit wiki/local/pgcust.php and add $PageLogoURL:
<?php if (!defined('PmWiki')) exit();
$WikiTitle = "DARPA Grand Challenge 3 (DGC3)";
$PageLogoUrl = "http://chess.eecs.berkeley.edu/dgc3/images/logo-150.png";
?>

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?

How do I mirror a wiki?
http://www.pmwiki.org/wiki/Cookbook/ExportHTML?from=Cookbook.PmWiki2HTML-usingWGET says:
wget -r -k -np -p -l 0 http://example.org/wiki
That page has other suggestions about how to get html.

However, we have authentication, so Look up the websitesessionKey cookie in your browser and then use it with wget:

wget -r -k -np -p -l 0 --no-cookies 
 --header "Cookie: websiteSessionKey=xxxxxxxxxxxxxxxxxxxx" 
 --reject "*action=print","*action=diff","*action=upload","*action=edit"
 http://website_long_name/group/wiki/ 

How do I change the title of the wiki?

To change the title, edit the wiki page and use

(:title This is the title:)

Another way is to use CVS to edit wiki/local/pgcust.php and add or edit $WikiTitle:

<?php if (!defined('PmWiki')) exit();
$WikiTitle = "DARPA Grand Challenge 3 (DGC3)";
?>

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?

How do I get rid of 'HomePage'?
To change the default, use CVS to edit wiki/local/pgcust.php and add $DefaultName or $DefaultGroup:
<?php if (!defined('PmWiki')) exit();
$DefaultGroup= "Gsoc";
$DefaultName= "Gsoc";
?>

See PmWiki Basic Variables for details.

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?

Previous section  |  This section  |  Next section
Collapse
You are not logged in 
Contact 
©2002-2017 U.C. Regents