weiter aufgeräumt, Links korrigiert

Anleitungen/INSTALLATION.md

@@ -0,0 +1,111 @@
+# Installation von GIT unter Windows
+
+Empfohlen wird die Installation der folgenden drei Software-Komponenten:
+
+* Git-for-Windows
+* Notepad++
+* Tortoise-Git
+
+Mehr Informationen dazu gibt es im Text-Dokument [README.md](../README.md)
+
+## Git-for-Windows
+
+Das Programm kann unter [gitforwindows.org](https://gitforwindows.org) heruntergeladen werden:
+
+1. Öffne [gitforwindows.org](https://gitforwindows.org) im Webbrowser
+2. Klicke auf **Download**
+3. Speichere die `.exe`-Datei
+4. Starte das Setup durch Ausführen der heruntergeladenen `.exe`-Datei  
+Das Setup erfolgt auf englisch.
+5. Klicke auf **Next**.
+6. Auf der Seite _Select Destination Location_ kann ein anderer als der Standard-Ordner ausgewählt werden, es wird jedoch empfohlen bei der Vorgabe zu bleiben.  
+Klicke wiederum auf **Next**.
+7. Auf der Seite _Select Components_ wird empfohlen die Vorgaben zu übernehmen.  
+Klicke wiederum auf **Next**.
+8. Auf der Seite _Select Start Menu Folder_ kann das Häkchen bei **Don't create a Start Menu folder** gesetzt werden. Muss aber nicht.  
+Klicke wiederum auf **Next**.
+9. Bei *Choosing the default editor used by Git* wird empfohlen, _Notepad++_ zu wählen[^Anmerkung1].  
+Klicke wiederum auf **Next**.
+10. _Adjusting the name of the initial branch in new repositories_:  
+Hier wird ebenso die Standardeinstellung empfohlen. Klicke wiederum auf **Next**.
+11. _Adjusting your PATH environment_:   
+Hier wird ebenso die Standardeinstellung empfohlen. Klicke wiederum auf **Next**.
+12. _Choosing HTTPS transport backend_:    
+Hier wird ebenso die Standardeinstellung empfohlen. Klicke wiederum auf **Next**.
+13. _Configuring the line enconding conversions_:  
+Hier wird ebenso die Standardeinstellung empfohlen. Klicke wiederum auf **Next**.
+14. _Configuring the terminal emulator to use with Git Bash_:  
+Hier wird ebenso die Standardeinstellung empfohlen. Klicke wiederum auf **Next**.
+15. _Choose the default behavior of \`git pull\`_:  
+Hier wird ebenso die Standardeinstellung empfohlen. Klicke wiederum auf **Next**.
+16. _Choose a credential helper_:  
+Hier wird ebenso die Standardeinstellung empfohlen. Klicke wiederum auf **Next**.
+17. _Configuring extra options_:  
+Hier wird ebenso die Standardeinstellung empfohlen. Klicke wiederum auf **Next**.
+18. _Configuring experimental options_:  
+Hier wird ebenso die Standardeinstellung (nichts aktiviert) empfohlen.  
+19. Klicke auf **Install** um die Installation mit den gewählten Optionen zu starten.
+
+[^Anmerkung1]: Falls einer der anderen Editoren aus der Auswahlliste bereits auf dem System installiert ist, kann auch dieser verwendet werden.
+
+## Notepad++
+
+Das Programm kann unter [notepad-plus-plus.org](https://notepad-plus-plus.org/downloads) heruntergladen werden.
+
+1. Auf der _Downloads_-Seite klickt man auf den obersten Link (Notepad++ x.x.x release)
+2. Dann wählt man im Abschnitt **Download 64-bit x64** den **Installer**-Link.
+3. Speichere die `.exe`-Datei
+4. Starte das Setup durch Ausführen der heruntergeladenen `.exe`-Datei  
+5. Im ersten Dialog des Setups kann man die Sprache auswählen, das dürfte wohl _Deutsch_ sein. 
+6. Im _Willkommen_-Dialog klickt man auf **Weiter >**
+7. Beim _Lizenzabkommen_ muss man auf **Annehmen** klicken.
+8. Im Dialog _Zielverzeichnis auswählen_ wird die Vorgabe empfohlen, jeder andere Pfad sollte aber auch ok sein.  
+Anschließend auf **Weiter >** klicken
+9. Im Dialog _Komponenten auswählen_ wird empfohlen die Standardeinstellungen zu übernehmen und auf **Weiter >** zu klicken.
+10. Auf der nächsten Seite auf **Installieren** klicken, danach auf **Fertigstellen**.
+
+## Tortoise-GIT
+
+Das Programm kann unter [tortoisegit.org](https://tortoisegit.org) heruntergeladen werden.
+
+1. Dazu geht man auf der Homepage auf **Download**.
+2. Auf der Download-Seite wählte man den Download **for 64-bit Windows** und klickt den entsprechenden Link.
+3. Speichere die `.msi`-Datei
+4. Es wird weiterhin empfohlen, die deutsche Sprachdatei („German“) aus der Liste darunter – ebenfalls in der 64-bit-Version – ebenfalls herunterzuladen.
+
+### Installation der Software
+
+Anschließend wird das Setup durch Ausführen der Datei `TortoiseGit-2.xx.x.x-64bit.msi` gestartet.
+
+1. Auf der _Welcome to TortoiseGit_-Seite auf **Next** klicken
+2. Auf der folgenden _Information_-Seite wieder auf **Next** klicken
+3. Auf der _Custom Setup_-Seite wird das Übernehmen der Standardoptionen empfohlen. **Next**
+4. Auf der Seite _Ready to Install_ klickt man auf **Install**
+5. Auf der Seite _Completing the TortoiseGit Setup Wizard_ deaktiviert man das Häkchen bei _Run first start wizard_ und klickt auf **Finish**.
+
+### Installation des Sprachpakets
+
+Nun kann man das Sprachpaket installieren, dazu startet man die heruntergeladene Datei `TortoiseGit-LanguagePack-2.xx.x.x-64bit-de.msi`.
+
+1. Auf der _Willkommen_-Seite klickt man auf **Weiter**
+2. Auf der Seite _Der Setup-Assistent… wurde abgeschlossen_ setzt man das Häkchen bei _Configure TortoiseGit to use this language_. Dann klickt man auf **Fertig stellen**
+
+### Einrichtung
+
+Um Tortoise (jetzt auf Deutsch) einzurichten, startet man abermals die Datei `TortoiseGit-2.xx.x.x-64bit.msi`.
+
+1. Auf der _Welcome to TortoiseGit_-Seite auf **Next** klicken
+2. Auf der Seite _Modify, Repair or Remove installation_ wählt man **Repair**.
+3. auf der nächsten Seite klickt man nochmals auf **Repair**.
+4. Auf der Seite _Completing the TortoiseGit Setup Wizard_ **aktiviert** man das Häkchen bei _Run first start wizard_ und klickt auf **Finish**.
+5. Auf der nächsten Seite wählt man seine bevorzugte Sprache (Deutsch) und klickt auf **Weiter**
+6. Auf der nächsten _Willkommen bei TortoiseGit!_-Seite klickt man auf **Weiter**
+7. Auf der Seite _Git.exe_ einrichten sollte schon ein Wert im Feld _Git.exe Pfad_ erscheinen, sicherheitshalber kann man nochmal auf den Knopf **Jetzt prüfen** klicken. Danach geht es **Weiter**
+8. Auf der Seite _Benutzerdaten einrichten_ sollten die Daten des Benutzers des Rechners eingegeben werden.[^Anmerkung2] Dann auf **Weiter** klicken.
+9. Auf der Seite _Authentifizierung und Anmeldeinformationen speichern_ kann alles bei den Standardeinstellungen gelassen werden. **Fertig stellen** klicken.
+
+Tortoise-Git ist nun einsatzbereit.
+
+Lesen Sie auch: [Übersicht](../README.md) oder [Verwendung](Verwendung.md)
+
+[^Anmerkung2]: Später wird, immer wenn der Benutzer einen neuen Stand eines Dokumentsversioniert, diese Version mit den Benutzerdaten gekennzeichnet

Anleitungen/Umstellung-Fahrplan.md

@@ -0,0 +1,56 @@
+# Fahrplan zur Umstellung von SVN zu GIT
+
+## Vorbereitungen
+
+Wenn für die zukünftige Arbeit GIT verwendet werden soll, muss ein zentraler Ort geschaffen werden, an welchem die Projektpflege erfolgt („Projektarchiv“). Dies kann im einfachsten Fall ein Netzlaufwerk sein; für erweiterte Funktionen wird ein Git-Server wie [GitLab] oder [Gitea] empfohlen.
+
+Außerdem wird dringend empfohlen für das zentrale Projektarchiv einen automatischen **Backup**-Mechanismus einzurichten – dies ist jedoch nicht Teil dieses Dokuments.
+
+[GitLab]: https://gitlab.com
+[Gitea]: https://gitea.io/en-us
+
+## Software-Anforderungen
+
+Vor der Umstellung muss geprüft werden, ob alle Arbeitsplatzrechner die notwendigen Anforderungen erfüllen, um die Programme
+
+* Git-for-Windows
+* Notepad++
+* Tortoise-Git
+
+auszuführen.  
+
+> Die Installation der Programme auf den Clients ist an dieser Stelle noch nicht nötig und wird nicht empfohlen.
+
+Im Falle von Windows sollte das ab Windows 7 gegeben sein. Altsysteme mit Windows 2000 oder früher sollten aktualisiert werden.
+
+## Erfassung der aktuell verwendeten Projekte
+
+Als nächstes muss erfasst werden, welche Projekte aktuell von den Mitarbeitern benutzt werden:
+
+Bei der Migration werden die Ordner aus dem SVN-Zentralarchiv in einzelne Git-Archive konvertiert.
+Dies wird voraussichtlich mehrere Tage dauern.
+Während das passiert können die Mitarbeiter weiter an ihren Projekten arbeiten und Änderungen noch in das bestehende SVN-Zentralarchiv übertragen.
+Damit kann es aber dazu kommen, dass die entsprechenden Projekte im GIT-Zentralarchiv nach Abschluss der Konvertierung nicht mehr auf dem letzten Stand sind, und aktualisiert werden müssen. Und genau dafür muss die Liste der aktiven Projekte während der Konvertierung erfasst werden.
+
+## Start der Konvertierung
+
+Auf dem Linux-Server wird im Verzeichnis [Scripte](../Scripte) dieses Projekts das Zielverzeichnis für die Konvertierung ins [Makefile](../Scripte/Makefile) eingetragen.
+Anschließend wird `make` gestartet, woraufhin die Konvertierung aller Projekte erfolgt.
+Dies wird voraussichtlich mehrere Tage dauern, während der an Projekten weiter gearbeitet werden kann.
+
+## Abschluss und Aktualisierung
+
+Dann müssen alle _zwischenzeitlich bearbeiteten_ Projekte nochmal ins SVN-Zentralarchiv synchronisiert werden.
+
+Nach Abschluss der ersten Konvertierung ist es notwendig, das SVN-Zentralarchiv gegen weitere Änderungen zu sperren. Dies kann durch Deaktivieren des Apache-SVN-Servers geschehen.
+Ab jetzt dürfen in den Arbeitskopien keine Änderungen mehr vorgenommen werden; diese würden verloren gehen.
+Dann werden die veränderten Projekte nochmal neu zu GIT konvertiert, um auch die zuletzt gemachten Änderungen einzufangen.
+
+## Umstellung der Arbeitsplätze/Clients
+
+Auf den Arbeitsplätzen sind danach folgende Schritte auszuführen:
+
+1. Entfernen der alten Projektordner, die noch SVN verwenden: Änderungen darin können nicht mehr ins alte Zentralarchiv übermittelt werden.
+2. Entfernen der Software Tortoise-SVN.
+3. Installation des Tortoise-Git-Stacks wie unter [INSTALLATION.md](INSTALLATION.md) beschrieben
+4. Holen der benötigten Arbeitskopien der zu bearbeitenden Projekte vom neuen Git-Zentralarchiv, wie unter [Verwendung.md](Verwendung.md) beschrieben.

Anleitungen/Verwendung.md

@@ -0,0 +1,12 @@
+# Benutzung von GIT mittels TortoiseGIT
+
+1.  [ein vorhandenes Projekt auschecken](checkout.md)
+2.  [Historie eines Projekts anzeigen](log.md)
+3.  [ein neues Projekt erzeugen](init.md)
+4.  [eine Arbeitskopie aktualisieren](pull.md)
+5.  [Änderungen mit letzter Version vergleichen](diff.md)
+6.  [eine neue Version einer Datei fixieren](commit.md)
+7.  eine neue Datei zur Versionierung hinzufügen
+8.  einen alten Stand eines Projekts abrufen
+9.  eine Datei mit einer älteren Version vergleichen
+10. Arbeitskopie eines Projektes verwerfen

Anleitungen/checkout.md

@@ -0,0 +1,11 @@
+# ein vorhandenes Projekt auschecken
+
+Um ein vorhandenes Projekt aus einem Projektarchiv („Repository“) auf den Desktop zu bekommen, geht man wie folgt vor:
+
+1. Gehe in den Ordner, in welchem die Arbeitskopie des Projektordners abgelegt werden soll. 
+2. Dort mittels Rechtsklick auf den Hintergrund das Kontextmenü öffnen und **Git Klonen…** auswählen:  
+![Kontextmenü](Bilder/checkout01.png)  
+3. **Url** der Quelle eingeben, oder mittels **Suchen…** das Projektarchiv vom Netzlaufwerk auswählen  
+![Quelle wählen](Bilder/checkout02.png)
+4. **Ok** klicken. Tortoise wird nun einen neuen Ordner für das Projekt anlegen und den letzten Stand des Projektes dort hinein kopieren („auschecken“).    
+![Ausgechecktes Projekt](Bilder/checkout03.png)

Anleitungen/commit.md

@@ -0,0 +1,29 @@
+# eine neue Version einer Datei fixieren
+
+Wenn Sie in ihrer Arbeitskopie Änderungen an einer Datei vorgenommen haben, die bereits von der Versionsverwaltung erfast wurde, muss diese Änderung ins Projektarchiv übernommen werden.
+
+Dies geht wie folgt:
+
+1. Klicken Sie mit rechts auf den Projektordner, oder klicken Sie im Projektordner mit der rechten Maustaste in den Hintergrund, wählen Sie **Git Eintragen -> …**  
+![Änderungen vormerken](Bilder/stage01.png)  
+Es öffnet sich ein Fenster, in welchem untern die veränderten Dateien aufgelistet werden.  
+<br/>
+Mit einem Doppelklick auf eine der aufgelisteten Dateien können Sie die Unterschiede zur Vor-Version betrachten.
+
+2. Setzen Sie Häkchen bei den Dateien, deren aktueller Stand ins Projektverzeichnis übertragen werden soll. Deaktivieren Sie das Häkchen bei Dateien, die im Moment **nicht** versioniert werden sollen:  
+![Auswahl der Dateien für die Versionierung](Bilder/commit01.png)  
+
+3. Das Eintragen ins Projektarchiv kann erst erfolgen, wenn eine Meldung oben eingegeben wurde. Beschreiben Sie hier also kurz, was verändert wurde:  
+![Eingeben einer Commit-Nachricht](Bilder/commit02.png)  
+
+4. Das Eintragen in die Historie der _lokalen_ Arbeitskopie erfolgt mit einem Klick auf **Eintragen**.
+Dies wird die Daten nicht ans zentrale Projektarchiv übertragen (siehe unten). Klicken Sie daher auf den Pfeil neben dem Knopf und wählen dort **Eintragen & Versenden**:  
+![Versenden](Bilder/push01.png)
+Damit wird ihre Lokale Arbeitskopie **und das Zentralarchiv** aktualisiert.  
+
+5. Falls Sie versehentlich doch auf Eintragen geklickt haben, also die Version nur lokal erfasst wurde, ist es notwendig, anschließend diesen Stand noch an das zentrale Projektarchiv zu übertragen:  
+Öffnen Sie wieder das Kontextmenü, wählen Sie **TortoiseGit** und dann **Versenden**.  
+![Versenden](Bilder/push02.png)
+
+6. Drücken Sie im erscheinenden Dialog auf OK, um die Änderungen ins zentrale Archiv zu schreiben.  
+![Versenden](Bilder/push03.png)

Anleitungen/diff.md

@@ -0,0 +1,12 @@
+# Änderungen mit letzter Version vergleichen
+
+Hat man im Projekt gearbeitet und möchte sich einen Überblick verschaffen, welche Datei(en) verändert wurden, geht das wie folgt:
+
+1. Rechtsklick auf die Arbeitskopie. Im Menü wählt man **TortoiseGit** → **Vergleich**:  
+![Stand mit letzter Version vergleichen](Bilder/compare01.png)
+2. Danach werden einem die Unterschiede zur letzten fixierten Version des Projekts/der Datei angezeigt:  
+![Geänderte Dateien](Bilder/compare02.png)
+
+Im obigen Beispiel wurde die Datei `Bilder/checkout01.png` in `Bilder/umbenannt.png` umbenannt. Außerdem wurde die Datei `Verwendung.md` bearbeitet.
+
+Wenn man möchte, kann man aus diesem Dialog heraus mittels **Eintragen** auch gleich die Änderungen zum Fixieren vorbereiten. Dies wird in den folgenden Abschnitten gesondert erklärt.

Anleitungen/init.md

@@ -0,0 +1,13 @@
+# ein neues Projekt erzeugen
+
+Um ein neues Projekt auf dem Netzlaufwerk (oder einem anderen Ort) zu erstellen, geht man wie folgt vor:
+
+1. Man navigiert im Explorer zu dem Ordner, in welchem das neue Projekt-Verzeichnis angelegt werden soll:  
+![Zielordner auswählen](Bilder/create01.png)  
+2. Dort legt man einen neuen Ordner an, und gibt ihm einen sinnvollen Namen. Um kenntlich zu machen, dass es sich um einen Projekt-Ordner handelt, wird empfohlen, die Dateiendung `.git` an den Ordnernamen anzuhängen:  
+![Projekt-Verzeichnis anlegen](Bilder/create02.png)  
+3. Anschließend klickt man mit der rechten Maustaste auf den neuen Ordner und wählt aus dem Kontextmenü die Option **Git Projektarchiv hier erstellen…**:  
+![Git init](Bilder/create03.png)  
+4. Im erscheinenden Dialog setzt man das Häkchen bei _Erstelle bare-Repository_ und klickt **OK**:  
+![Bare-Repo](Bilder/create04.png)  
+5. Anschließend kann eine Arbeitskopie des Projekts, wie unter **ein vorhandenes Projekt auschecken** beschrieben, in einen beliebigen Ordner geholt werden.

Anleitungen/log.md

@@ -0,0 +1,10 @@
+# Historie eines Projekts anzeigen
+
+Will man den Verlauf eines Projekts (oder einer Datei in einem Projekt) betrachten, geht man wie folgt vor:
+
+1. Man geht im Explorer in den Ordner, in welchem sich der Projektordner (oder die Datei von Interesse befindet) und klickt mit der rechten Maustaste auf diesen.
+2. Im sich öffnenden Kontext-Menü wählt man **TortoiseGit** → **Zeige Log**  
+![History öffnen](Bilder/history01.png)
+
+Es wird die Liste der Commits angezeigt:  
+![History](Bilder/history02.png)

Anleitungen/pull.md

@@ -0,0 +1,10 @@
+# eine Arbeitskopie aktualisieren
+
+Bevor man seine Arbeit an einem bereits ausgecheckten Projekt beginnt/fortsetzt, sollte man sicherstellen, dass die Arbeitskopie des Projekts auf dem aktuellen Stand ist:
+
+1. Rechtsklick auf den Projektordner der Arbeitskopie. Im Menü wählt man **TortoiseGit** → **Aktualisieren**:  
+![Aktualisieren](Bilder/pull01.png)  
+2. Im folgenden Dialog klickt man auf **OK**:  
+![Aktualisieren](Bilder/pull02.png)  
+
+Git wird nun die Arbeitskopie auf den aktuellen Stand bringen. Danach kann man mit der Arbeit im Projekt beginnen.