Rainbow Group Website
---------------------

The website

  http://www.cl.cam.ac.uk/research/rainbow/

is formatted by the ucampas system

  http://www.cl.cam.ac.uk/local/web/ucampas/

and version-controlled via Subversion as explained at

  http://www.cl.cam.ac.uk/local/web/subversion/ .


The most obvious things to remember are:

  * If a file in /anfs/www/VH-cl/html/research/rainbow is owned by user wwwupdate, then this part
    of the website is managed via Subversion. Therefore, in your own working space, do

      svn checkout svn+ssh://wwwsvn@svn-www.cl.cam.ac.uk/rainbow

    and edit the web pages in there, rather than in Apache's working directory
    /anfs/www/VH-cl/html/research/rainbow.  An "svn commit" will cause the latter to be updated
    and reformatted automatically.

  * Always edit the "-b.html" version of the file; ucampas will autogenerate the ".html" version.

  * To add a new research topic, create an appropriate file in the research directory and then edit
    uconfig.txt there to ensure that the file is included in the navigation index.


Website Access From Windows
---------------------------

1. Set up an SSH key pair:
   First, use puttygen to make an SSH key pair and file it in ~/.ssh/authorized-keys.
   See http://www.cl.cam.ac.uk/local/sys/microsoft/putty/ for details.  You have probably already
   done this to set up remote access to Unix machines in the lab, and you might as well use the
   same key pair for this.

2. Get Subversion access to website:
   Ask pagemaster to use this for for access to the lab's Subversion repository for web pages:
   http://www.cl.cam.ac.uk/local/web/subversion/#getaccess

3. Install TortoiseSVN:
   TortoiseSVN is a Subversion client that integrates into the Windows explorer;
   it should be available via "Run Advertised Programs" in the Control Panel.

4. Check out working copy:
   Make a local directory, perhaps on the desktop, and call it something like "Rainbow web".
   Right click on it and select "SVN Checkout...".  The URL of the repository should be
   svn+ssh://wwwsvn@svn-www.cl.cam.ac.uk/rainbow and the checkout directory is what you called it.
   Use a fully recursive checkout.

5. Edit web pages:
   You can now edit files locally, remembering to use Subversion to "Add" new files explicitly.
   It is prudent to right click on the directory and select "SVN Update" if you come back to it
   after someone else may have made changes.  When you have finished a batch of changes, right
   click on the directory and select "SVN Commit".  Ucampas will be run automatically.