m4_dnl -*-html-*- m4_include(`template.m4') m4_dnl $Id$ m4_define(`EN') m4_define(`DE_FILE', `website-maintenance-de.html') PAGE_START

Maintaining the Gpg4win website

The maintenance of the website is actually quite simply because many things are automized.

What you should be (or should become) familiar with: a text editor, HTML, ssh and Subversions.

Typical tasks:

Anonymously take a first look

  1. Get the sources for the website anonymously (without write access):
    svn checkout https://svn.wald.intevation.org/gpg4win/trunk/doc/website
  2. Build the website locally:
    make -f buildhtml.mk
    and open it in your browser (file index.html).
  3. Read file README, make your changes, build the website again and reopen it in your browser.

What to do initially to become an active team member

A prior "Hello" on one of the Gpg4win mailing lists and your expression of interest to join the team is of course a good idea.
  1. At wald.intevation.de you should create a user account.
    This is established quickly because it is an automatic process.
  2. Request membership for project Gpg4win.
    This takes a little time because one of the project administrators has to answer the request.
  3. Create a SSH key and upload it to wald.intevation.de
  4. Get the source for the website:
    svn checkout svn+ssh://USER@svn.wald.intevation.org/gpg4win/trunk/doc/website
    where USER is the user account at wald.intevation.de.

How to update the website and put it online

  1. Apply your desired changes in the directory website which you retrieved via SVN. The file REAMDE in this directory will provide you some helpful hints.
  2. Create local version:
    make -f buildhtml.mk
    and open file index.html in your browser.
  3. Are your changes complete, check them again:
    svn diff | less
    and then upload them with some adequate comments to the SVN repository:
    svn commit
  4. The last step is to put the new version online:
    make -f buildhtml.mk online