Some more files I forgot.

docs/editing-howto.xml

@@ -0,0 +1,51 @@
+<?xml version='1.0'?>
+
+<!DOCTYPE cscpage SYSTEM "../csc.dtd">
+
+<cscpage title="CSC Website Editing Howto">
+  <header/>
+  <section title="Getting started">
+    <p>
+      In order to edit the website you will first have to get the CVS
+      repository in which it is stored. To do so, go somewhere in your
+      home directory and type:
+    </p>
+    <code>
+      export CVS_RSH=ssh<br />
+      cvs -d username@peri.uwaterloo.ca:~sjdutoit/cvsroot co www
+    </code>
+    <p>
+      Where <code>username</code> is your CSC user name. You will be
+      prompted for your password (unless you use an SSH key). After a
+      while you should have a new directory, <code>www/</code>, with
+      the CSC pages in it.
+    </p>
+    <p>
+      You will also need <code>libxslt</code> and <code>libxml</code>
+      (including development headers) from Gnome. In debian,
+      <code>apt-get install libxml2-dev libxslt1-dev</code>.
+    </p>
+  </section>
+  <section title="Compiling the website">
+    <p>
+      The CSC website is <i>compiled</i>. This means that when you
+      edit a page, you don't edit the HTML source directly, but
+      instead edit a page describing the page's <i>content</i> (and
+      some formatting) and then run a command to generate the HTML
+      page from these content description pages.
+    </p>
+    <p>
+      To generate the CSC website, make sure you are in the directory
+      into which you checked it out (the <code>www/</code> directory)
+      and enter
+    </p>
+    <code>
+      make
+    </code>
+    <p>
+      This will compile the whole website. After any changes you make
+      you will have to recompile the website in the same manner.
+    </p>
+  </section>
+  <footer />
+</cscpage>