View source

This page contains instructions for working on the mpich2 website.

The live source for the website can be found at <code>/nfs/web/www.mcs.anl.gov/content/research/projects/mpich2</code>.  This directory is an SVN working copy that is used  as a poor-man's deployment mechanism. A few things to note:

* '''NO MANUAL EDITS''' should be done on this main working copy. The process is to commit changes to the SVN repository separately from a different location and then run the '''update''' script present in <code>/nfs/web/www.mcs.anl.gov/content/research/projects/mpich2</code>. The above script (as opposed to a direct <code>svn update</code>) sets the umask to 0002 to make sure that the newly created files/directories are writable by other users as well.

* The source for the site can be found [https://svn.mcs.anl.gov/repos/mpi/www in SVN]. It consists largely of a straightforward set of PHP files. When making changes, pull down a working copy of the repository with <code><nowiki>svn checkout https://svn.mcs.anl.gov/repos/mpi/www www</nowiki></code>. You will need SVN credentials under the current setup.

* You can use <code>/nfs/web/www.mcs.anl.gov/content/research/projects/mpich2staging/$USER</code> as a working copy if you wish to view your changes before committing them in (preferred).

* Note that if you want to change the structure of the site (menus, some intra-site links, etc), you'll need to update several places.  There are links inside of some pages, on the navbar at the top, and on the subnav on the left.  These all live in separate PHP files, so take care when updating this type of link.

Finding broken links can be done in an easy and automated fashion with any number of tools.  I (goodell@) have used <code>[http://world.std.com/~swmcd/steven/perl/pm/lc/linkcheck.html linkcheck]</code> with good success.  Once we have the site cleaned up, we should probably run this nightly and have it send us a report if we break anything.