How to Contribute to the Imager Web

1. Create some HTML pages that describe something useful pertaining to Imager. Here is a good starting point to learn about HTML , but a lot of people just copy an existing page and make changes.

   One convention we ask you to observe is to place your HTML "title" directive all on one line, like this:

        <title>Page Title Here</title>
   

   This helps us compile the usage report.
2. Test your pages for HTML syntax. The weblint(1) Perl script is good for this. It has a man page.
3. Test your pages for correct linkage. You can force Mosaic (i.e. xwww at UBC) or netscape to start up on a file in the current directory by entering its full path name on the command line. For example, to start up netscape on a file "foo.html" in the current directory, enter

       % netscape `pwd`/foo.html
   

   For convenience in testing and to avoid networked filesystem problems, we recommend all links in the HTML files you're adding that refer to other files you're adding be relative. A link in your file "foo.html" to your file "bar" in subdirectory "baz" of the directory containing "foo.html" should refer to "baz/bar", not "//www.cs.ubc.ca/imager/nest/contributions/{whatever}/baz/bar".
4. If you don't already have a contributions directory, contact Bob Lewis or Rob Scharein to create one for you. If your login name is "pongo", your contributions directory will be "/imager/local/generic/web/contributions/pongo" (or "~imager/web/contributions/pongo" for short).
5. Move your HTML and other files, along with any directory hierarchy you find convenient, to your contributions directory. This directory will be owned by you, so you can put whatever you like in or under it at any time. Please try to be consistent, though. One way to do this is to keep your own hierarchy of files elsewhere that gets copied all at once to your contributions directory just after it's been tested. make(1) can help here.
6. Negotiate with Bob or Rob as to where the Imager pages should link into your pages. This will require modification of the upper pages, which are owned by the "imager" user.