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://@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 haben. aheinecke@7749: z.B.: Andre Heinecke