Browse Source

Dokument „Verwendung.md“ in kleinere Unterdokumente aufgeteilt

master
Stephan Richter 3 years ago
parent
commit
732719fc2b
  1. 2
      README.md
  2. 80
      Verwendung.md
  3. 0
      Verwendung/Bilder/checkout01.png
  4. 0
      Verwendung/Bilder/checkout02.png
  5. 0
      Verwendung/Bilder/checkout03.png
  6. 0
      Verwendung/Bilder/compare01.png
  7. 0
      Verwendung/Bilder/compare02.png
  8. 0
      Verwendung/Bilder/create01.png
  9. 0
      Verwendung/Bilder/create02.png
  10. 0
      Verwendung/Bilder/create03.png
  11. 0
      Verwendung/Bilder/create04.png
  12. 0
      Verwendung/Bilder/history01.png
  13. 0
      Verwendung/Bilder/history02.png
  14. 0
      Verwendung/Bilder/pull01.png
  15. 0
      Verwendung/Bilder/pull02.png
  16. 11
      Verwendung/checkout.md
  17. 12
      Verwendung/diff.md
  18. 13
      Verwendung/init.md
  19. 10
      Verwendung/log.md
  20. 10
      Verwendung/pull.md

2
README.md

@ -36,7 +36,7 @@ Kernaufgaben der Software sind die Versions-, Revisions- und Sourcekontrolle. To @@ -36,7 +36,7 @@ Kernaufgaben der Software sind die Versions-, Revisions- und Sourcekontrolle. To
## Umstellung von SVN zu GIT
Für den Wechsel von SVN zu GIT gibt es einen [Fahrplan](Umstellung-Fahrplan.md), der ein Nahtloses wechseln ermöglichen sollte.
Für den Wechsel von SVN zu GIT gibt es einen [Fahrplan](Umstellung-Fahrplan.md), der ein nahtloses Wechseln ermöglichen sollte.
## Installation auf den rbeitsplatzrechnern/Clients

80
Verwendung.md

@ -1,72 +1,12 @@ @@ -1,72 +1,12 @@
# Benutzung von GIT mittels TortoiseGIT
## 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)
## 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)
## 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.
## 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.
## Ä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.
## eine neue Version einer Datei fixieren
## eine neue Datei zur Versionierung hinzufügen
## einen alten Stand eines Projekts abrufen
## eine Datei mit einer älteren Version vergleichen
## Arbeitskopie eines Projektes verwerfen
* [ein vorhandenes Projekt auschecken](Verwendung/checkout.md)
* [Historie eines Projekts anzeigen](Verwendung/log.md)
* [ein neues Projekt erzeugen](Verwendung/init.md)
* [eine Arbeitskopie aktualisieren](Verwendung/pull.md)
* [Änderungen mit letzter Version vergleichen](Verwendung/diff.md)
* eine neue Version einer Datei fixieren
* eine neue Datei zur Versionierung hinzufügen
* einen alten Stand eines Projekts abrufen
* eine Datei mit einer älteren Version vergleichen
* Arbeitskopie eines Projektes verwerfen

0
Bilder/checkout01.png → Verwendung/Bilder/checkout01.png

Before

Width:  |  Height:  |  Size: 71 KiB

After

Width:  |  Height:  |  Size: 71 KiB

0
Bilder/checkout02.png → Verwendung/Bilder/checkout02.png

Before

Width:  |  Height:  |  Size: 62 KiB

After

Width:  |  Height:  |  Size: 62 KiB

0
Bilder/checkout03.png → Verwendung/Bilder/checkout03.png

Before

Width:  |  Height:  |  Size: 78 KiB

After

Width:  |  Height:  |  Size: 78 KiB

0
Bilder/compare01.png → Verwendung/Bilder/compare01.png

Before

Width:  |  Height:  |  Size: 57 KiB

After

Width:  |  Height:  |  Size: 57 KiB

0
Bilder/compare02.png → Verwendung/Bilder/compare02.png

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 38 KiB

0
Bilder/create01.png → Verwendung/Bilder/create01.png

Before

Width:  |  Height:  |  Size: 57 KiB

After

Width:  |  Height:  |  Size: 57 KiB

0
Bilder/create02.png → Verwendung/Bilder/create02.png

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 61 KiB

0
Bilder/create03.png → Verwendung/Bilder/create03.png

Before

Width:  |  Height:  |  Size: 76 KiB

After

Width:  |  Height:  |  Size: 76 KiB

0
Bilder/create04.png → Verwendung/Bilder/create04.png

Before

Width:  |  Height:  |  Size: 71 KiB

After

Width:  |  Height:  |  Size: 71 KiB

0
Bilder/history01.png → Verwendung/Bilder/history01.png

Before

Width:  |  Height:  |  Size: 105 KiB

After

Width:  |  Height:  |  Size: 105 KiB

0
Bilder/history02.png → Verwendung/Bilder/history02.png

Before

Width:  |  Height:  |  Size: 77 KiB

After

Width:  |  Height:  |  Size: 77 KiB

0
Bilder/pull01.png → Verwendung/Bilder/pull01.png

Before

Width:  |  Height:  |  Size: 56 KiB

After

Width:  |  Height:  |  Size: 56 KiB

0
Bilder/pull02.png → Verwendung/Bilder/pull02.png

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 31 KiB

11
Verwendung/checkout.md

@ -0,0 +1,11 @@ @@ -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)

12
Verwendung/diff.md

@ -0,0 +1,12 @@ @@ -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.

13
Verwendung/init.md

@ -0,0 +1,13 @@ @@ -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.

10
Verwendung/log.md

@ -0,0 +1,10 @@ @@ -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)

10
Verwendung/pull.md

@ -0,0 +1,10 @@ @@ -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.
Loading…
Cancel
Save