A workgroup may have a wiki associated with it.
<br>For example, see
<a href="http://chess.eecs.berkeley.edu/ptexternal/wiki"><code>http://chess.eecs.berkeley.edu/ptexternal/wiki</code></a>

<p><a href="http://www.e3s-center.org/e3s/faq/29/">User level website wiki instructions</a>
<h2>Choosing a wiki</h2>
I chose <a href="http://www.pmwiki.org/">PmWiki</a> because:
<ol>
<li>Written in php, so we can access our user db
<li>Looked good and has skins
</ol>

<h3>Resources</h3>

<menu>
<li> <a href="http://c2.com/cgi/wiki?TopTenWikiEngines">Top Ten Wiki Engines</a> - by the original Wiki author
<li> <a href="http://www.wikimatrix.org/"><code>http://www.wikimatrix.org/</code></a> - Helps choose a wiki
<li> <a href="http://en.wikipedia.org/wiki/Wiki_software"><code>http://en.wikipedia.org/wiki/Wiki_software</code></a> - Description of wiki software on wikipedia

</menu>
<h2>Upgrading PmWiki</h2>
<ol>
<li>Follow the <a href="http://www.pmwiki.org/wiki/PmWiki/Upgrades">Generic Instructions here</a>, in particular the Backup, Download and Extract, and Copy steps. The Copy approach will preserve some locally modified files, such as the installed cookbooks and the config files in the local directory.
<li> Don't forget to update <a href="http://robotics.eecs.berkeley.edu/mast/wiki/pmwiki.php?n=Main.HomePage">http://robotics.eecs.berkeley.edu/mast/wiki/pmwiki.php?n=Main.HomePage</a>
<pre>
sudo -i
su - mastwiki
cd /projects/sastry/www-pages/home/mast
</pre> Then see the <code>README.txt</code> file.
<li>The following steps are needed only if you <em>do not</em> use the Copy approach:
<ol>
<li>Install the simple and monospace cookbooks, plus any other previously installed cookbooks.
<pre>
cd pmwiki/pub/skins
wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/simple.tgz
wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/monobook.zip
gtar -zxf simple.tgz
unzip monobook.zip
mkdir stripped
cd stripped
wget http://www.pmwiki.org/pmwiki/uploads/Skins/stripped.tmpl
</pre>
<li>Update <code>pmwiki-2.2.83/pub/skins/monobook/monobook.php</code> in two places so that https works
<pre>
66,70c66
<
< # Use MonobookPubDirUrl so that that https works.  -cxh
< #$HTMLHeaderFmt[] = "<link rel='stylesheet' type='text/css' href='$SkinDirUrl/monobook.css' />n";
< SDV( $MonobookPubDirUrl, "$PubDirUrl/skins/monobook" );
< $HTMLHeaderFmt[] = "<link rel='stylesheet' type='text/css' href="$MonobookPubDirUrl/monobook.css" />n";
---
> $HTMLHeaderFmt[] = "<link rel='stylesheet' type='text/css' href='$SkinDirUrl/monobook.css' />n";
</pre>
and
<pre>
181,185c183
<
< # Use MonobookPubDirUrl so that that https works.  -cxh 6/5/15
< #  $LinkUploadCreateFmt = "<a class='createlinktext' href='$LinkUpload'>$LinkText</a><a class='createlink' href='$LinkUpload'><img src='$SkinDirUrl/attachnew.png' alt='' /></a>";
<   $LinkUploadCreateFmt = "<a class='createlinktext' href='$LinkUpload'>$LinkText</a><a class='createlink' href='$LinkUpload'><img src='$MonobookPubDirUrl/attachnew.png' alt='' /></a>";
<
---
>   $LinkUploadCreateFmt = "<a class='createlinktext' href='$LinkUpload'>$LinkText</a><a class='createlink' href='$LinkUpload'><img src='$SkinDirUrl/attachnew.png' alt='' /></a>";
</pre>

<li>Update the local directory.
<br><code>pmwiki/local/config.php</code>:
<pre>
&lt;?php if (!defined('PmWiki')) exit();
include_once("wiki.php");
include_once("$FarmD/cookbook/pagetoc.php");
include_once("$FarmD/cookbook/expirediff.php");



$UploadExts['m'] = 'application/matlab';
$UploadExts['mdl'] = 'application/octet-stream';
$UploadExts['mat'] = 'application/octet-stream';

$UploadExts['docm'] = 'application/vnd.ms-word.document.macroEnabled.12';
$UploadExts['docx'] = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
$UploadExts['dotm'] = 'application/vnd.ms-word.template.macroEnabled.12';
$UploadExts['dotx'] = 'application/vnd.openxmlformats-officedocument.wordprocessingml.template';
$UploadExts['potm'] = 'application/vnd.ms-powerpoint.template.macroEnabled.12';
$UploadExts['potx'] = 'application/vnd.openxmlformats-officedocument.presentationml.template';
$UploadExts['ppam'] = 'application/vnd.ms-powerpoint.addin.macroEnabled.12';
$UploadExts['ppsm'] = 'application/vnd.ms-powerpoint.slideshow.macroEnabled.12';
$UploadExts['ppsx'] = 'application/vnd.openxmlformats-officedocument.presentationml.slideshow';
$UploadExts['pptm'] = 'application/vnd.ms-powerpoint.presentation.macroEnabled.12';
$UploadExts['pptx'] = 'application/vnd.openxmlformats-officedocument.presentationml.presentation';
$UploadExts['xlam'] = 'application/vnd.ms-excel.addin.macroEnabled.12';
$UploadExts['xlsb'] = 'application/vnd.ms-excel.sheet.binary.macroEnabled.12';
$UploadExts['xlsm'] = 'application/vnd.ms-excel.sheet.macroEnabled.12';
$UploadExts['xlsx'] = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
$UploadExts['xltm'] = 'application/vnd.ms-excel.template.macroEnabled.12';
$UploadExts['xltx'] = 'application/vnd.openxmlformats-officedocument.spreadsheetml.template';
$UploadExts['xml'] = 'application/vnd.moml+xml';
$UploadExts['odb'] = 'application/vnd.oasis.opendocument.database';
$UploadExts['odc'] = 'application/vnd.oasis.opendocument.chart';
$UploadExts['odf'] = 'application/vnd.oasis.opendocument.formula';
$UploadExts['odg'] = 'application/vnd.oasis.opendocument.graphics';
$UploadExts['odm'] = 'application/vnd.oasis.opendocument.text-master';
$UploadExts['odp'] = 'application/vnd.oasis.opendocument.presentation';
$UploadExts['odp'] = 'application/vnd.oasis.opendocument.presentation';
$UploadExts['ods'] = 'application/vnd.oasis.opendocument.spreadsheet';
$UploadExts['odt'] = 'application/vnd.oasis.opendocument.text';
$UploadExts['otg'] = 'application/vnd.oasis.opendocument.graphics-template';
$UploadExts['oth'] = 'application/vnd.oasis.opendocument.text-web';
$UploadExts['otp'] = 'application/vnd.oasis.opendocument.presentation-template';
$UploadExts['ots'] = 'application/vnd.oasis.opendocument.spreadsheet-template';
$UploadExts['ott'] = 'application/vnd.oasis.opendocument.text-template';
$UploadExts['sda'] = 'application/vnd.stardivision.draw';
$UploadExts['sdc'] = 'application/vnd.stardivision.calc';
$UploadExts['sdd'] = 'application/vnd.stardivision.impress';
$UploadExts['sdf'] = 'application/vnd.stardivision.math';
$UploadExts['sds'] = 'application/vnd.stardivision.chart';
$UploadExts['sdw'] = 'application/vnd.stardivision.writer';
$UploadExts['sgl'] = 'application/vnd.stardivision.writer-global';

// See http://www.mail-archive.com/pmwiki-users@pmichaud.com/msg13806.html                                             
# Provide notnull conditional                                                                                          
# (:if notnull $Var:)                                                                                                  
# (:if notnull $Var PageName:)                                                                                         
$Conditions['notnull'] = 'NotNullCondition($pagename, $condparm)';


function NotNullCondition($pagename, $arg) {
  //log_event("pmwiki local/config.php NotNull: <$pagename>, <$arg> ");                                                
  $arg = ParseArgs($arg);
  $varname = @$arg[''][0];
  if (@$arg[''][1]) // pagename                                                                                        
    {
      $pagename = $arg[''][1];
    }
  //log_event("pmwiki local/config.php NotNull: varname: $varname, pagename: $pagename");                              
  $val = PageVar($pagename, $varname);
  if ($val)
    {
      return true;
    }
  return false;
}

// Need this for the TerraSwarm Quarterly Reports                                                                      
// http://www.pmwiki.org/wiki/PmWiki/LayoutVariables#MaxIncludes                                                       
$MaxIncludes = 1000;

## By default, viewers are prevented from seeing the existence  
## of read-protected pages in search results and page listings, 
## but this can be slow as PmWiki has to check the permissions 
## of each page.  Setting $EnablePageListProtect to zero will  
## speed things up considerably, but it will also mean that 
## viewers may learn of the existence of read-protected pages. 
## (It does not enable them to access the contents of the pages.)
$EnablePageListProtect = 0;

?&gt;

</pre>
<b>Note</b>: Don't forget the trailing newline!
<br><code>pmwiki/local/farmconfig.php</code>
<pre>
&lt;?php if (!defined('PmWiki')) exit();
    include_once('include/util.inc.php');
    #log_event("farmconfig.php: FarmD: $FarmD");                                                                       
    # Settings performed before field-customizations                                                                   
    $SERVER_NAME     = $_SERVER['SERVER_NAME'];
    #$ScriptUrl = "http://$SERVER_NAME/php/$SERVER_NAME/pmwiki/pmwiki.php";                                            
    #$ScriptUrl = "http://$SERVER_NAME/wiki";                                                                          
    $FarmPubDirUrl = "http://$SERVER_NAME/php/$SERVER_NAME/pmwiki/pub";

    # load the field's global and per-group customizations                                                             
    include_once("$SERVER_NAME/pmwiki/local/config.php");
    $EnableLocalConfig = 1;
    include_once('local/pgcust.php');
    # Make sure the user can read the wiki. See php/wiki.php                                                           
    wiki_access_auth();
    # Override field customizations here                                                                               
    $EnableUpload = 1;            # enable uploads                                                                     
    $UploadMaxSize = 20000000;

    /* cookbooks */
    include_once("$FarmD/cookbook/AdvancedTableDirectives.php");
    include_once("$FarmD/cookbook/attachdel.php");
    include_once("$FarmD/cookbook/extendcond.php");
    include_once("$FarmD/cookbook/editformcustomfields.php");
    include_once("$FarmD/cookbook/expirediff.php");
    include_once("$FarmD/cookbook/httpvariables.php");
    include_once("$FarmD/cookbook/markupexprplus.php");
    include_once("$FarmD/cookbook/counter.php");
    include_once("$FarmD/cookbook/templates.php");
    include_once("$FarmD/cookbook/zap.php");
    include_once("$FarmD/cookbook/zaptoolbox.php");

    // configure the attachtable cookbook                                                                              
    switch($action) {
      case 'delattach':
      case 'renameattach':
      case 'downloaddeleted':
	include_once("$FarmD/cookbook/attachtable/attachtable-actions.php");
	break;
      case 'fileinfo':
      case 'thumbnail':
	include_once("$FarmD/cookbook/attachtable/fileinfo.php");
	break;
      case 'upload':
      default:
	include_once("$FarmD/cookbook/attachtable/attachtable.php");
	break;
    }

?&gt;

</pre>
Again, don't forget the trailing newline
<li>Update the cookbook directory.  The easiest way is to copy from the old directory to the new:
<pre>
cd ~www/php/pmwiki-2.2.56/cookbook
(cd ../../pmwiki/cookbook; tar -cf - . ) | tar -xpf -
</pre>
As of 10/12, the following cookbooks were in use.  Zap is used by the TerraSwarm quarterly reports.
<pre>
AdvancedTableDirectives.php  editformcustomfields.php  httpvariables.php   sourceblock.php
attachdel.php                expirediff.php            markupexprplus.php  templates.php
attachtable                  extendcond.php            mkexpext.php        zap.php
counter.php                  geshi                     pagetoc.php         zaptoolbox.php
</pre>
See <code>pmwiki/cookbooks.txt</code> for a description of cookbooks that are installed.
<p>
Below are instructions for installing various cookbooks by hand
<br/>SourceBlock
<a href="http://www.pmwiki.org/wiki/Cookbook/SourceBlock"><code>http://www.pmwiki.org/wiki/Cookbook/SourceBlock</code></a>:
<pre>
cd ~www/php/pmwiki/cookbook
wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/sourceblock.php
</pre>
Get the <a href="http://www.pmwiki.org/wiki/Cookbook/PageTableOfContents">TableOfContents</a> cookbook:
<pre>
cd ~www/php/pmwiki/cookbook
wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/pagetoc.php
</pre>

Download and unpack the <a href="http://en.wikipedia.org/wiki/GeSHi">GeSHI (Generic Syntax Highlighter)</a> from:
<ul>
 <li> <a href="http://qbnz.com/highlighter/"><code>http://qbnz.com/highlighter/</code></a> - did not work in Dec., 2010.</li>
 <li> <a href="http://sourceforge.net/projects/geshi/"><code>http://sourceforge.net/projects/geshi/</code></a></li>
</ul>

<b>Note that in 1/2012, the sourceforge GeSHI project page for the most recent file lead to an old version.</b> Be sure to look in the Files page for the most recent version 
<pre>
cd pmwiki/cookbook wget 'http://downloads.sourceforge.net/project/geshi/geshi/GeSHi%201.0.8.11/GeSHi-1.0.8.11.tar.bz2?r=http%3A%2F2Fsourceforge.net%2Fprojects%2Fgeshi%2F&ts=1353975857&use_mirror=iweb'
tar -jxf GeSHi-1.0.8.11.tar.bz2
</pre>

<li> Optional: Copy over <code>jsMath.php</code> from the old cookbook directory. <i>We don't support jsMath because it is too damn big</i>

</ul>

<li> Install attachtable into <code>pub/</code>.
<pre>
cd pmwiki-2.2.56/pub
(cd ../../pmwiki/pub; tar -cf - attachtable) | tar -xpf -
</pre>

<li>Edit <code>pmwiki/scripts/upload.php</code> and change
the <a href="http://www.pmwiki.org/wiki/PmWiki/UploadVariables#UploadMaxSize"><code>UploadMaxSize</code></a> to match the value of <code>upload_max_filesize</code> in <code>/etc/php.ini</code> (Linux) or <code>/usr/local/lib/php.ini</code> (Solaris):

<pre>SDV($UploadMaxSize,20000000);</pre>
<b>Note</b>: this step shouldn't be necessary, as the value is set in <code>pmwiki/local/farmconfig.php</code>

<li> We prefer to have the author name hardwired into
the edit field. 
Update <pre>pmwiki/wikilib.d/Site.EditForm</pre>
and change:
<pre>
$[Author]: (:input e_author:) 
</pre>
to
<pre>
$[Author]: {$Author}
</pre>

<li> <a name="pmwikiphpupdate">The</a> siteConfig array was not available so we need to edit
<code>pmwiki.php</code>.  The problem here is that 
<code>GLOBALS["trustSessionKey"]</code> was
not set, which meant that <code>session[]</code> is not available.

<p>if pmwiki.php contains
<pre>
if (ini_get('register_globals')) 
  foreach($_REQUEST as $k=>$v) { unset(${$k}); }
</pre>
The solution is to comment out these lines.

<p>If pmwiki.php contains
<pre>
if (ini_get('register_globals')) 
  foreach($_REQUEST as $k=>$v) { 
   if (preg_match('/^(GLOBALS|_GET|_POST|_COOKIE|_FILES|_ENV|_REQUEST|_SESSION)$/i', $k)) exit();
   unset(${$k}); 
  }
</pre>
Then do
<pre>
if (ini_get('register_globals')) 
  foreach($_REQUEST as $k=>$v) { 
    if (preg_match('/^(GLOBALS|_GET|_POST|_COOKIE|_FILES|_ENV|_REQUEST|_SESSION)$/i', $k)) exit();
    if (preg_match('/^(_SESSION)$/i', $k))
      unset(${$k}); 
  }
</pre>

<p><b>FIXME</b>: we should not be using global variables here.
See <a href="http://us2.php.net/register_globals">http://us2.php.net/register_globals</a>

<li> If you have not yet done so, create the link
<pre>
rm pmwiki
ln -s pmwiki-x.y.z pmwiki
</pre>
To check this, see
<a href="http://chess.eecs.berkeley.edu/dgc3/wiki/Dgc3/ComputerConfigOrca2Prereq"><code>http://chess.eecs.berkeley.edu/dgc3/wiki/Dgc3/ComputerConfigOrca2Prereq</code></a>
<br><b>Note:</b> why this paricular site? what if tester doesn't have access to it?

<li>Test the wikis for each website.  The easiest way
to find the wikis is to do:
<pre>
ls -d ~www/cvswww/<i>website</i>/*/wiki
</pre>
<br><b>Note:</b> there are an awful of a lot of sites to check manually! and the tester may not have access to all of them. should this testing by automated? or can it be skipped?

<li> Check for security issues with <a href="http://www.pmwiki.org/wiki/PmWiki/SiteAnalyzer">http://www.pmwiki.org/wiki/PmWiki/SiteAnalyzer</a>
</ol>


<h2>Getting Started</h2>
<ol>
<li> Download from <a href="http://www.pmwiki.org/"><code>http://www.pmwiki.org</code></a>
to <code>~www/php/<i>website</i></code>, for example
<code>~www/php/trust.eecs.berkeley.edu</code>.
<li> Create a link
<pre>
ln -s pmwiki-x.y.z pmwiki
</pre>

<li>Edit the GSRC website config.php file, for example
<code>~www/php/trustt.eecs.berkeley.edu/config.php</code>:
<pre>
// Set to 1 to enable the Wiki facility
$siteConfig['enableWiki'] = 1;
</pre>

<li>Do a cvs update in <code>~www/php</code> and get recent
changes.
<dl>
<dt> <code>~www/php/bin/cvswiki</code>
<dd> Creates wiki directory and prompts admin to update
 <code>rewrite.conf</code>
<dt> <code>~www/php/include/group.inc.php</code>
<dd> Added support for hasWiki field in groups db.
<br> If you are adding wiki support to a preexisting
website, you will need to add a <code>hasWiki</code> 
field to the <code>groups</code> field in the
<code>auth_<i>N</i></code> table.  To do this,
the phpMyAdmin interface, for example 
<a href="http://trust.eecs.berkeley.edu/mysql">
http://trust.eecs.berkeley.edu/mysql</a>.
Browse to the <code>auth_<i>N</i></code> table
and then to the <code>groups</code> field.
Then select add and add the field with these parameters:
TINYINT (1) DEFAULT '0' not null

<dt> <code>~www/php/subpages/admin.config.php</code>
<dd> Added support to allow group admin to request a wiki
<dt> <code>~www/php/wiki.php</code>
<dd> Wiki configurations common to all wiki sites on Chess, Trust etc.
<br> If you are adding a new website, be sure to create 
<code>/images/logo-100.gif</code> in the corresponding website cvs
repository, for example: <code>trustwww/images/logo-100.gif</code>.
The <code>wiki.php</code> file uses <code>logo-100.gif</code>
in the title bar.

</dl>

<li>Create
 <code>~www/php/trust.eecs.berkeley.edu/pmwiki/local/config.php</code>:
<pre>
&lt;?php if (!defined('PmWiki')) exit();
include_once("wiki.php");
?&gt;
</pre>
This will load <code>php/wiki.php</code>
<br>Before we started using <code>php/wiki.php</code>, we used
<code>php/<i>website</i>/wikiconfig.php</code>. If you are using <code>wikiconfig.php</code>, use this:
<pre>
&lt;?php if (!defined('PmWiki')) exit();
$SERVER_NAME     = $_SERVER['SERVER_NAME'];
include_once("$SERVER_NAME/wikiconfig.php");
?&gt;
</pre>
This will load the website specific
<code>wikiconfig.php</code>, which is kept separate
from pmwiki so that we can easily use version control.

<li> We use <a href="#farm">Wiki farms</a> to manage the
separate wiki pages for workgroups
<br>Create
 <code>~www/php/trust.eecs.berkeley.edu/pmwiki/local/farmconfig.php</code>:
<pre>
&lt;?php if (!defined('PmWiki')) exit();
    include_once('include/util.inc.php');
    #log_event("farmconfig.php: FarmD: $FarmD");
    # Settings performed before field-customizations
    $SERVER_NAME     = $_SERVER['SERVER_NAME'];
    #$ScriptUrl = "http://$SERVER_NAME/php/$SERVER_NAME/pmwiki/pmwiki.php";
    #$ScriptUrl = "http://$SERVER_NAME/wiki";
    $FarmPubDirUrl = "http://$SERVER_NAME/php/$SERVER_NAME/pmwiki/pub";

    # load the field's global and per-group customizations
    #include_once("$SERVER_NAME/pmwiki/local/config.php");
    include_once('local/pgcust.php');
    $EnableLocalConfig = 1;
    include_once('local/pgcust.php');
    # Make sure the user can read the wiki. See php/wiki.php
    wiki_access_auth();
    # Override field customizations here
    $EnableUpload = 0;            # disable uploads
?&gt;
</pre>

<li> Set up a skin
<pre>
cd /home/www/php/trustt.eecs.berkeley.edu/pmwiki/pub/skins
wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/simple.tgz
tar -zxf simple.tgz
</pre>
<code>wikiconfig.php</code> already includes the skin, so you
need not edit <code>wikiconfig.php</code>

<li> <a name="pmwikiphpupdate">The</a> siteConfig array was not available so we need to edit
<code>pmwiki.php</code>.  The problem here is that 
<code>GLOBALS["trustSessionKey"]</code> was
not set, which meant that <code>session[]</code> is not available.

<p>if pmwiki.php contains
<pre>
if (ini_get('register_globals')) 
  foreach($_REQUEST as $k=>$v) { unset(${$k}); }
</pre>
The solution is to comment out these lines.

<p>If pmwiki.php contains
<pre>
if (ini_get('register_globals')) 
  foreach($_REQUEST as $k=>$v) { 
   if (preg_match('/^(GLOBALS|_GET|_POST|_COOKIE|_FILES|_ENV|_REQUEST|_SESSION)$/i', $k)) exit();
   unset(${$k}); 
  }
</pre>
Then do
<pre>
if (ini_get('register_globals')) 
  foreach($_REQUEST as $k=>$v) { 
    if (preg_match('/^(GLOBALS|_GET|_POST|_COOKIE|_FILES|_ENV|_REQUEST|_SESSION)$/i', $k)) exit();
    if (preg_match('/^(_SESSION)$/i', $k))
      unset(${$k}); 
  }
</pre>

<p><b>FIXME</b>: we should not be using global variables here.
See <a href="http://us2.php.net/register_globals">http://us2.php.net/register_globals</a>

<li> We prefer to have the author name hardwired into
the edit field. 
Update <pre>/pmwiki/wikilib.d/Site.EditForm</pre>
and change:
<pre>
$[Author]: (:input e_author:) 
</pre>
to
<pre>
$[Author]: {$Author}
</pre>

<li> Become the admin for the first workgroup that is to have 
a wiki, go to the admin page and request a wiki.
You will be prompted to edit <code>/usr/local/apache/conf/rewrite.conf</code>
and,  as root, restart httpd:
<pre>
/etc/init.d/apachectl graceful
</pre>

<li>Go to the page for the new wiki.
<li>Create a subdirectory with the name as the group.  The reason is
because we want to possibly be able to use the wiki as a top level.
So, for the group scada, go to
<a href="http://trust.eecs.berkeley.edu/scada/wiki">http://trust.eecs.berkeley.edu/scada/wiki"</a> and edit the page, creating a link to Scada/Main:
<pre>
[[Scada/Main | Main Scada Page]]
</pre>
Then save the edit and click on the "Main Scada Page" link to bring up
<a href="http://trust.eecs.berkeley.edu/scada/wiki">http://trust.eecs.berkeley.edu/scada/wiki/Scada/Main"</a>

</ol>

<h2>Using JS</h2>
JsMath is a cookbook that will display LaTeX.
<ol>
<li><a href="http://www.pmwiki.org/wiki/Cookbook/JsMath">http://www.pmwiki.org/wiki/Cookbook/JsMath</a> contains <a href="http://www.pmwiki.org/pmwiki/uploads/Cookbook/jsMath.php"><code>jsMath.php</code></a>
which gets copied to <code>~www/php/pmwiki/cookbook</code>
<li>Edit <code>~www/php/wiki.php</code> and add
<pre>
# JsMath "Add markup to display and embed mathematical formulas in wiki pages using TeX.: http://www.pmwiki.org/wiki/Cookbook/JsMath
include_once('pmwiki/cookbook/jsMath.php');
</pre>
<li>Download JsMath from <a href="http://www.math.union.edu/locate/jsMath"><code> http://www.math.union.edu/locate/jsMath</code></a>
<li>Follow the "Download JsMath for Authors instructions"
and download "jsMath" and "jsMath Image Fonts".
<li>See the top of the <code>jsMath.php</code> file.
Go to <code>~www/php/pmwiki</code> and
uncompress the two files.  This will create
<code>~www/php/pmwiki/jsMath</code>.
<li>You are done! See
<a href="http://chess.eecs.berkeley.edu/dgc3/wiki/Dgc3/ChristopherBrooks"><code>http://chess.eecs.berkeley.edu/dgc3/wiki/Dgc3/ChristopherBrooks</code></a>
for an example.


</ol>


<h2>Getting Started</h2>
Below are my notes on how I installed wiki the first time.
If you are installing for a GSRC website, see above.
<ol>
<li> Download from <a href="http://www.pmwiki.org/"><code>http://www.pmwiki.org</code></a>
to <code>~www/php/<i>website</i></code>, for example
<code>~www/php/trust.eecs.berkeley.edu</code>.
<li> Create a link
<pre>
ln -s pmwiki-x.y.z pmwiki
</pre>
<li> As root, modify <code>/usr/local/apache/conf/rewrite.conf</code>
to remap wiki/ to pmwiki.php
<pre>
RewriteRule ^/wiki$ /wiki/ [R,L]
RewriteRule ^/wiki/([^/]*)/?(.*)$ /home/www/php/%{HTTP_HOST}/pmwiki/pmwiki.php?%{QUERY_STRING} [L]

</pre> 
Then, as root, restart httpd:
<pre>
/etc/init.d/apachectl graceful
</pre>

<li> Set up the wiki directory.  Note that this is temporary,
we will set up per website and per workgroup wikis shortly

<pre>
mkdir /home/www/php/trust.eecs.berkeley.edu/pmwiki/wiki.d
chown apache /home/www/php/trust.eecs.berkeley.edu/pmwiki/wiki.d
</pre>

<li> Go to the wiki!
<a href="http://trustt.eecs.berkeley.edu/wiki"><code>http://trustt.eecs.berkeley.edu/wiki</code></a>


</ol>

<h2>Configuring pmwiki</h2>
We need to set passwords etc, see
<a href="http://www.pmwiki.org/wiki/PmWiki/Installation">Further Installation Instructions</a>

<ol>
<li> Set up the sample file
<pre>
cd /home/www/php/trust.eecs.berkeley.edu/pmwiki
cp sample-config.php local/config.php
</pre>

Make these edits to <code>config.php</code>
<pre>
$WikiTitle = 'Team for Research in Ubiquitous Secure Technology';
$PageLogoUrl = "/images/trust-100.gif";
$DefaultPasswords['admin'] = crypt('<i>a password</i>');
$DefaultPasswords['upload'] = crypt('<i>a password</i>');
$SERVER_NAME     = $_SERVER['SERVER_NAME'];
$ScriptUrl = "http://$SERVER_NAME/php/$SERVER_NAME/pmwiki/pmwiki.php";
$PubDirUrl = "http://$SERVER_NAME/php/$SERVER_NAME/pmwiki/pub";

</pre>
<li> Set up a skin
<pre>
cd /home/www/php/trustt.eecs.berkeley.edu/pmwiki/pub/skis
wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/simple.tgz
tar -zxf simple.tgz
</pre>

Make these edits to <code>config.php</code>
<pre>
$Skin = 'simple';
$SkinCopyright = "Copyright &#169; 2006 The Regents of the University of California";
</pre>

<li><a name="farm">Setting up a Wiki Farm</a>
<br>See <a href="http://www.pmichaud.com/wiki/PmWiki/WikiFarms"><code>http://www.pmichaud.com/wiki/PmWiki/WikiFarms</code></a>
  <ol>
  <li><code>php/subpages/admin.config.php</code> and the database have
  been extended to include a <code>hasWiki</code> field.
  <code>~/php/bin/cvswiki</code> is a script that adds a <code>wiki</code>
  directory to the cvs repository for a workgroup.  Note that 
  using a wiki on the database requires cvs authoring which in turn
  requires a cvs module for this workgroup.  The reason is that we
  want to allow farm administrators to be able to configure their farm.
  Hopefully the workgroup config page will do the right thing if
  "Wiki" is selected: request a cvs repository if necessary and set
  up cvs authoring for the home page.
  <li> The page
  <code>~/php/trustt.eecs.berkeley.edu/pmwiki/local/farmconfig.php</code>  
  Controls the look and feel for all the farms.  <code>farmconfig.php</code>
  looks like:
  <pre>
&lt;?php if (!defined('PmWiki')) exit();
    # Settings performed before field-customizations
    $SERVER_NAME     = $_SERVER['SERVER_NAME'];
    #$ScriptUrl = "http://$SERVER_NAME/php/$SERVER_NAME/pmwiki/pmwiki.php";
    $FarmPubDirUrl = "http://$SERVER_NAME/php/$SERVER_NAME/pmwiki/pub";
    # load the field's global and per-group customizations
    include_once('local/config.php');
    #include_once('local/pgcust.php');

    # Override field customizations here
    $EnableUpload = 0;            # disable uploads
?&gt;
  </pre>

  </ol>

<li> As root, modify <code>/usr/local/apache/conf/rewrite.conf</code>
to remap wiki/ to pmwiki.php
<pre>
RewriteRule ^/scada/wiki$ /scada/wiki/ [R,L]
RewriteRule ^/scada/wiki/$ /home/www/cvswww/%{HTTP_HOST}/scada/wiki/field.php [L]
RewriteRule ^/scada/wiki/index.php$ /home/www/cvswww/%{HTTP_HOST}/scada/wiki/field.php [L]
RewriteRule ^/scada/wiki/([^/a-z].*) /home/www/cvswww/%{HTTP_HOST}/scada/wiki/field.php?n=$1 [QSA,L]

</pre>
</pre> 
Then, as root, restart httpd:
<pre>
/etc/init.d/apachectl graceful
</pre>


</ol>

<h2>Problems</h2>
<h3>The siteConfig array was not available</h3>
The problem here is that 
<code>GLOBALS["trustSessionKey"]</code> was
not set, which meant that <code>session[]</code> is not available.

<p>pmwiki.php contains
<pre>
if (ini_get('register_globals')) 
  foreach($_REQUEST as $k=>$v) { unset(${$k}); }
</pre>
The solution is to comment out these lines.
<p><b>FIXME</b>: we should not be using global variables here.
See <a href="http://us2.php.net/register_globals">http://us2.php.net/register_globals</a>

<h3>Cleaning URLS</h3>
<a href="http://www.pmwiki.org/wiki/Cookbook/CleanUrls">http://www.pmwiki.org/wiki/Cookbook/CleanUrls</a>

<h3>Set up per group directories</h3>
<a href="http://www.pmichaud.com/wiki/Cookbook/PerGroupSubDirectories">http://www.pmichaud.com/wiki/Cookbook/PerGroupSubDirectories</a> says to
put the following in <code>config.php</code>
<pre>
$WikiDir = new PageStore('wiki.d/$Group/$FullName');
</pre>
Note that for each group, you will need to do
<pre>
mkdir ~www/php/trust.eecs.berkeley.edu/pmwiki/wiki.d/Foo
chown apache ~www/php/trust.eecs.berkeley.edu/pmwiki/wiki.d/Foo
</pre>
The group names need to be capitalized.

<h3>Setting the group name</h3>
To set the website group name, wiki/local/pgcust.php sets
<code>$WikiGroup</code>.  Note that phpcust.php is created
by <code>php/bin/cvsauthoring</code>.

<h3>Setting the author name</h3>
See <a href="http://www.pmwiki.org/wiki/Cookbook/RequireAuthor"><code>http://www.pmwiki.org/wiki/Cookbook/RequireAuthor</code></a>
<br>  Basically, <code>wikiconfig.php</code> includes
<pre>
include_once("$SERVER_NAME/pmwiki/scripts/authuser.php");
$Author = $AuthId;
</pre>

<h3>Controlling read access to wiki pages</h3>
<code>wiki.php</code> defines a 
<code>wiki_access_auth()</code> function that checks the
access array.  This function is called from
<code>$SERVER/pmwiki/local/farmconfig.php</code>
after <code><i>group</i>/local/pgcust.php</code> is 
called and the <code>$WikiGroup</code> is set.

<h3>Having the upload link in the monospace skin</h3>
This one was fun!
<br>The monospace skin has tabs at the top.  The tabs
are defined in <code>Find alternate file: /home/www/php/chess.eecs.berkeley.edu/pmwiki-2.1.5/wikilib.d/Site.PageActions
</code>.  That file looks has a section:
<pre>
(:if auth upload:) 
</pre>
and then creates the upload link.
<p><code>pmwiki.php</code> includes
<pre>
$Conditions['auth'] =
  'NoCache(@$GLOBALS["PCache"][$GLOBALS["pagename"]]["=auth"][trim($condparm)])';
</pre>
what this does is look for an array that has 
<code>[=auth][auth]</code> set to 1.
<p>The way we set this value is in <code>wiki.php</code>
we now explicitly set that value when we check for
<code>edit</code> access.

<h3>Fixing codeboxes in the monospace skin</h3>
Another useful Cookbook item for PmWiki is the <a href="http://www.pmwiki.org/wiki/Cookbook/SourceBlock">Sourceblock</a> recipe. Sourceblock and Monobook are both products by the same developer in PmWiki, <a href="http://www.pmwiki.org/wiki/Profiles/Dfaure">dfaure</a>. The stylesheets which afford a separation of code blocks were not working with the monobook skin, so there was this advice: 

<pre>
Dominique Faure wrote:

Some urls in the page dumps you provided suggest that 
you where using pmwiki v2.1.5 and a not-as-old monobook
skin. Sadly, the monobook skin version is more up-to-date
than the wiki engine itself.
You may then either:
* upgrade your pmwiki version to v2.1.27 (latest stable,
  my prefered choice here),
* or downgrade your monobook skin local copy, by locating
  and modifying the monobook.tmpl text file: search the
  string "&lt;!--HTMLHeader--&lt;" and replacing it with 
  "&lt;!--HeaderText--&gt;".
</pre>

I chose to edit the monobook skin locally, on andrews, in the chess php directory. FIXME: When upgrading PmWiki, the monobook skin should also be upgraded. [Notes by Jonathan Sprinkle.]

<h3>Problems with uploads</h3>
If you click on an upload and get the group page, then
check that <code>Home Page</code> and <code>CVS checkin</code> are enabled.
<p>User level notes about configuring the wiki:
"<a href="http://www.truststc.org/trust/faq/40.html">How do I configure the wiki?</a>"

<h3>Adjusting the upload size</h3>
To adjust the upload size, edit <code>php/wiki.php</code>

<h3>Search not working</h3>
<code>docs/sample-config.php</code> contains text that gets added to <code>local/config.php</code>.
<pre>
## By default, viewers are prevented from seeing the existence  
## of read-protected pages in search results and page listings, 
## but this can be slow as PmWiki has to check the permissions 
## of each page.  Setting $EnablePageListProtect to zero will  
## speed things up considerably, but it will also mean that 
## viewers may learn of the existence of read-protected pages. 
## (It does not enable them to access the contents of the pages.)
$EnablePageListProtect = 0;
</pre>