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>

http://dive4elements.wald.intevation.org