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