aheinecke@7749: Diese Anleitung erklärt wie man Änderungen an der Codebasis von
aheinecke@7749: D4E-River unter Windows durchführen kann. In dieser Anleitung
aheinecke@7749: wird dazu TortoiseHg und Putty verwendet.
aheinecke@7749: 
aheinecke@7749: Hintergrund:
aheinecke@7749: D4E-River wird mit dem Versionskontrollsystem Mercurial
aheinecke@7749: ( http://de.wikipedia.org/wiki/Mercurial ) verwaltet und ist auf
aheinecke@7749: der Plattform "Wald" ( http://wald.intevation.org/ ) gehostet.
aheinecke@7749: TortoiseHg ist eine Windows Explorer Erweiterung um ein graphisches
aheinecke@7749: Frontend für Mercurial zu bieten.
aheinecke@7749: 
aheinecke@7749: 
aheinecke@7749: Schritte 1-3 sind einmalig auszuführen. Schritt 4 muss immer wenn
aheinecke@7749: man eine Änderung durchführen möchte geschehen.
aheinecke@7749: 
aheinecke@7749: Schritt 1: Registrieren eines Benutzerkontos auf wald.intevation.de
aheinecke@7749: 
aheinecke@7749: * Browser öffnen auf Seite https://www.wald.intevation.org/account/register.php
aheinecke@7749:   Das zugehörige Wurzelzertifikat kann unter https://ssl.intevation.de
aheinecke@7749:   (Root CA 2010) beschafft werden.
aheinecke@7749: * Accountdetails eintragen (Nur Felder mit * müssen beachtet werden)
aheinecke@7749: * Registrieren drücken.
aheinecke@7749: -> Ihnen wird eine E-Mail mit einem Link zur Bestätigung gesendet.
aheinecke@7749: * Link aus der E-Mail öffnen.
aheinecke@7749: * Unter: https://wald.intevation.org/projects/dive4elements/ einen Beitrittsgesuch
aheinecke@7749:   (Link dafür ist Rechts unten auf der Seite unter den Mitgliedern)
aheinecke@7749:   Knappen Kommentar einfügen: "Beitrittsgesuch Frau Mustermann" o.Ä.
aheinecke@7749: -> Ein Admin in diesem Projekt muss Sie nun manuell freischalten.
aheinecke@7749: 
aheinecke@7749: Schritt 2: SSH Schlüssel erstellen und in Wald hinterlegen
aheinecke@7749: 
aheinecke@7749: (Dieser Teil geht davon aus das Putty bereits installiert ist)
aheinecke@7749: * Puttygen starten
aheinecke@7749: * "Generate a public/private key pair" Ausführen
aheinecke@7749: * ggf. Einen Key Comment z.B. "Wald Schluessel" angeben.
aheinecke@7749: * ggf. Eine passphrase angeben
aheinecke@7749: * Save private key -> Schlüssel abspeichern z.B: c:\Benutzer\name\wald-schluessel.ppk
aheinecke@7749: * Save public key -> Öffentlichen Schlüssel abspeichern z.B: c:\Benutzer\name\wald-schluessel-pub.txt
aheinecke@7749: * Kopieren Sie den Inhalt des Bereichs "Public key for pasting into OpenSSH authorized_keys file:"
aheinecke@7749: * Fügen Sie den öffentlichen Schlüssel in dem Eingabefeld unter:
aheinecke@7749:   http://wald.intevation.org/account/editsshkeys.php
aheinecke@7749:   ein.
aheinecke@7749: * Speichern des Schlüssels durch drücken auf den Button "Aktualisierung".
aheinecke@7749: 
aheinecke@7749: ! Achtung: Es kann bis zu einer Stunde dauern bis der Schlüssel im System
aheinecke@7749:   synchronisiert ist.
aheinecke@7749: 
aheinecke@7749: 
aheinecke@7749: Schritt 3: TortoiseHg (Software zur Versionskontrolle) installieren
aheinecke@7749: * Unter: http://tortoisehg.bitbucket.org/ TortoiseHg herunterladen
aheinecke@7749:   Die passende Version hängt von der Architektur ihres Systems (32/64-Bit ab)
aheinecke@7749: * TortoiseHg installieren. Die Standardoptionen sind ausreichend.
aheinecke@7749: * Fügen Sie nun den Privaten Schlüssel den Sie in Schritt 2 generiert haben
aheinecke@7749:   in Pageant ein.
aheinecke@7749:   (Wenn Pageant noch nicht installiert ist kann auch der Pageant aus TortoiseHg
aheinecke@7749:   verwendet werden. z.B. Installiert in (C:\Programme\TortoiseHg\Pageant.exe)
aheinecke@7749: * Navigieren Sie im Windows Explorer in ein Verzeichnis in welchem
aheinecke@7749:   das D4E-River Repository angelegt werden soll.
aheinecke@7749: * Rechtsklick im Windows Explorer zeigt nun neue Kontext Optionen für TortoiseHg.
aheinecke@7749:   TortoiseHg -> clone
aheinecke@7749: * Tragen Sie als Quelle ssh://<ihrbenutzername>@scm.wald.intevation.org/hg/dive4elements/river/
aheinecke@7749:   ein. Als Ziel einen Ordnernamen für ihr Lokales Repository.
aheinecke@7749: -> Bei der ersten Verbindung werden Sie darauf hingewiesen das der Host Key des Servers
aheinecke@7749:    noch unbekannt ist. Der RSA Fingerprint von Wald ist:
aheinecke@7749:    24:d2:13:1f:fa:02:54:f1:79:4f:5d:a0:aa:d3:ed
aheinecke@7749: 
aheinecke@7749: Tritt kein Fehler auf haben Sie nun einen Authentifizierten Klon des D4E-River
aheinecke@7749: Repositories.
aheinecke@7749: 
aheinecke@7749: 
aheinecke@7749: Schritt 4: Änderungen durchführen.
aheinecke@7749: * Sicherstellen das Pageant gestartet ist und den Key enthält.
aheinecke@7749: * Aktualisieren der lokalen Kopie im Ordner des Repositories
aheinecke@7749:   - Rechtsklick -> TortoiseHg -> Synchronize
aheinecke@7749:   - Auswählen "Nach dem Abfurfen" -> Update
aheinecke@7749:   - Eingehende Änderungen von der ausgewählten URL abrufen
aheinecke@7749: * Änderungen an den Dateien durchführen.
aheinecke@7749: * Rechtsklick auf die geänderte Datei -> Hg Commit...
aheinecke@7749: * Eine Versionsmeldung im Fenster die knapp zusammenfasst was / warum
aheinecke@7749:   Sie etwas geändert haben. (Am liebsten in Englisch)
aheinecke@7749:   z.B.: "Corrected usage of the word 'fixation' in english translations"
aheinecke@7749: * Änderungen zum Server übertragen
aheinecke@7749:  - Rechtsklick -> TortoiseHg -> Synchronize
aheinecke@7749:  - Ausgehende Änderungen an die ausgewählte URL übertragen
aheinecke@7749: 
aheinecke@7749: Hinweis: Beim ersten "Commit" werden Sie gebeten sich zu Identifizieren.
aheinecke@7749: Im darauffolgenden Einstellungs Fenster müssen Sie dann einen Benutzernamen
aheinecke@7749: Angeben. Dieser sollte das Format vorname nachname <email> haben.
aheinecke@7749: z.B.: Andre Heinecke <aheinecke@intevation.de>