====== ======

==== Documentation Links ====
  * Sourceforge Interactive SHELL service page: https://sourceforge.net/apps/trac/sourceforge/wiki/Shell%20service
  * Sourceforge File Access page: https://sourceforge.net/apps/trac/sourceforge/wiki/Using%20the%20file%20management%20service%20for%20backups
  * DokuWiki on Sourceforge instructions: https://www.dokuwiki.org/install:sourceforge
  * Dokuwiki plugin for SMTP email: https://www.dokuwiki.org/plugin:swiftmail

==== Installation ====

The instructions at dokuwiki.org do not fit completely with the SF directory structure we have. So, I tried to extrapolate how it would be now, and I came to the following protocol:
<code>
# for Eva Pujadas, use:
ssh -t epujadas,screeningbee@shell.sourceforge.net create
# for Mario Emmenlauer, use:
ssh -t emmenlau,screeningbee@shell.sourceforge.net create

pwd
cd /home/project-web/screeningbee/

wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2012-10-13.tgz
tar -xzvf dokuwiki-2012-10-13.tgz

rmdir htdocs
ln -s dokuwiki-2012-10-13 htdocs

chmod -R 777 htdocs/conf
chmod -R 777 htdocs/data 
</code>

Then run the install.php script to configure the site. It can be found in: http://screeningbee.sourceforge.net/dokuwiki/install.php

Afterwards, remove the install.php file:
<code>
rm htdocs/install.php
</code>

==== Email configuration ====
Enable in SourceForge project config "PRWebEmail", and set a password for it. Documentation:
https://sourceforge.net/apps/trac/sourceforge/wiki/Project%20Web%20Email%20Configuration

Download and manually install the swiftmail plugin:
<code>
wget https://github.com/splitbrain/dokuwiki-plugin-swiftmail/zipball/master
unzip splitbrain-dokuwiki-plugin-swiftmail-7b1e6ec.zip 
mv splitbrain-dokuwiki-plugin-swiftmail-7b1e6ec swiftmail
mv swiftmail /home/project-web/screeningbee/htdocs/lib/plugins/
chmod -R g+rwX /home/project-web/screeningbee/htdocs/lib/plugins/swiftmail
</code>
Then configure swiftmail from the Dokuwiki admin pages. For me, SSL works.
NOTE: It seems the email sending is limited to 1 email per 10 minutes.

==== Template Design ====

<code>
cd /home/project-web/screeningbee/htdocs/lib/tpl/
cp -pr dokuwiki screeningBee01/
cd /home/project-web/screeningbee/htdocs/lib/tpl/screeningBee01/
</code>

Add or edit the sidebar:
  * http://screeningbee.sourceforge.net/doku.php?id=sidebar