diff --git a/web/website-maintenance-de.htm4 b/web/website-maintenance-de.htm4 index 9eb2c30b..ad485eef 100644 --- a/web/website-maintenance-de.htm4 +++ b/web/website-maintenance-de.htm4 @@ -1,91 +1,71 @@ m4_dnl -*-html-*- m4_include(`template.m4') m4_dnl $Id$ m4_define(`DE') m4_define(`EN_FILE', `website-maintenance.html') m4_define(`MAIN', `community') m4_define(`TITLE', `Website pflegen') PAGE_START

Website von Gpg4win pflegen

Eine regelmäßige Aufgabe ist die Aktualisierung der Gpg4win-Website. Die Pflege ist einfach, da vieles automatisiert ist. Was man beherrschen sollte: einen Text-Editor, HTML, SSH und GIT.

Typische Aufgaben

Typische Aufgaben der Website-Pflege sind:

Zunächst anonym reinschnuppern

  1. Die Quellen zur Website auschecken: 
    git clone git://git.gnupg.org/gpg4win.git -b website
  2. Die Website lokal bauen: 
     cd web
 make
    und im Browser anschauen (z.B. Datei index-de.html).
  3. Die README-Datei der Website lesen, nach belieben Änderungen vornehmen und die Website dann wieder neu bauen und anschauen.
-

Was man vorbereitend nur einmal machen muss um aktiver Mitentwickler zu werden

- -Ein vorheriges "Hallo" auf einer der Gpg4win-Mailingliste -und der Wunsch, dass man gerne mitmachen möchte, ist natürlich immer sinnvoll. +

Wie man die Website aktualisiert und online schaltet

    -
  1. Auf wald.intevation.de ein - Benutzerkonto - einrichten.
    - Das geht schnell, denn es ist ein vollautomatischer Prozess. - -
  2. Mitgliedschaft beim Projekt Gpg4win - beantragen.
    - Das dauert ein wenig, da einer der Projektadministoren den Antrag - persönlich bearbeitet. - -
  3. Einen SSH-Schlüssel erzeugen und auf wald.intevation.de - hochladen. -
  4. Die Quellen zur Website holen:
    git clone git://git.gnupg.org/gpg4win.git -b website - -
- -

Wie man die Website aktualisiert und online schaltet

- -
  1. Gewünschte Änderungen in dem per git geholten Verzeichnis /web durchführen. Zum besseren Verständnis ggf. die Datei README vorher durchlesen.
  2. Lokale Version zum Anschauen herstellen:
    make
    und im Browser anschauen.
  3. Sind die Änderungen in Ordnung, sollte man sie noch mal prüfen:
    git diff | less
    - und können dann mit möglichst sinnvollen Kommentaren committen - und einen Patch an die Mailingliste senden:
    - git commit -a und - git format-patch -k --stdout >draft
    +
  4. Dann werden die Änderungen mit möglichst sinnvollen Kommentaren committet:
    + git commit -a +
  5. Mit folgendem Befehl wird ein Patch erstellt, der daraufhin an die Mailingliste + Gpg4win-devel gesendet werden muss (Ein vorheriges "Hallo" auf einer der Gpg4win-Mailinglisten und der Wunsch, dass man gerne mitmachen möchte, ist natürlich immer sinnvoll.):
    + git format-patch HEAD~1 --stdout > draft.patch
    + Die Zahl hinter "HEAD~" müssen Sie dabei durch die Anzahl der Commits ersetzen, die + zu diesem Patch gehören.
  6. Der letzte Schritt ist das online schalten:
    make online
diff --git a/web/website-maintenance.htm4 b/web/website-maintenance.htm4 index 56d061f4..fbf5483b 100644 --- a/web/website-maintenance.htm4 +++ b/web/website-maintenance.htm4 @@ -1,97 +1,79 @@ m4_dnl -*-html-*- m4_include(`template.m4') m4_dnl $Id$ m4_define(`EN') m4_define(`DE_FILE', `website-maintenance-de.html') m4_define(`MAIN', `community') m4_define(`TITLE', `Website maintenance') PAGE_START

Maintaining the Gpg4win website

The maintenance of the website is actually quite simply because many processes are automated. What you should be (or should become) familiar with: a text editor, HTML, SSH and GIT.

Typical tasks

Typical tasks of maintaining the website are:

Take a first look

  1. Get the sources for the website 
    git clone git://git.gnupg.org/gpg4win.git -b website
  2. Build the website locally: 
     cd web
 make
    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. +

How to update the website and put it online

    -
  1. At wald.intevation.de you - should - create - a user account.
    - This is established quickly because it is an automated 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:
    git clone git://git.gnupg.org/gpg4win.git -b website - -
- -

How to update the website and put it online

- -
  1. Apply your desired changes in the directory /web which you retrieved via GIT. The file README in the top directory will provide you some helpful hints.
  2. Create local version:
    make
    and open file index.html in your browser. + +
  3. Before commiting the changes you should check them:
    + git diff | less
  4. If your changes are complete, commit them as usual. For example you can simply do:
    git commit -a
    - and then prepare a patch to be - send to the mailing list:
    - git format-patch -k --stdout >draft. + +
  5. Then prepare a patch to be send to the mailing list Gpg4win-devel + (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.):
    + git format-patch HEAD~1 --stdout > draft.patch
    + You have to replace the number behind "HEAD~" with the number of commits + you made for the patch.
  6. The last step is to put the new version online:
    make online