diff --git a/README.md b/README.md index 0de9487..6f52a51 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/Verwendung.md b/Verwendung.md index d14826c..6e57f7b 100644 --- a/Verwendung.md +++ b/Verwendung.md @@ -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 diff --git a/Bilder/checkout01.png b/Verwendung/Bilder/checkout01.png similarity index 100% rename from Bilder/checkout01.png rename to Verwendung/Bilder/checkout01.png diff --git a/Bilder/checkout02.png b/Verwendung/Bilder/checkout02.png similarity index 100% rename from Bilder/checkout02.png rename to Verwendung/Bilder/checkout02.png diff --git a/Bilder/checkout03.png b/Verwendung/Bilder/checkout03.png similarity index 100% rename from Bilder/checkout03.png rename to Verwendung/Bilder/checkout03.png diff --git a/Bilder/compare01.png b/Verwendung/Bilder/compare01.png similarity index 100% rename from Bilder/compare01.png rename to Verwendung/Bilder/compare01.png diff --git a/Bilder/compare02.png b/Verwendung/Bilder/compare02.png similarity index 100% rename from Bilder/compare02.png rename to Verwendung/Bilder/compare02.png diff --git a/Bilder/create01.png b/Verwendung/Bilder/create01.png similarity index 100% rename from Bilder/create01.png rename to Verwendung/Bilder/create01.png diff --git a/Bilder/create02.png b/Verwendung/Bilder/create02.png similarity index 100% rename from Bilder/create02.png rename to Verwendung/Bilder/create02.png diff --git a/Bilder/create03.png b/Verwendung/Bilder/create03.png similarity index 100% rename from Bilder/create03.png rename to Verwendung/Bilder/create03.png diff --git a/Bilder/create04.png b/Verwendung/Bilder/create04.png similarity index 100% rename from Bilder/create04.png rename to Verwendung/Bilder/create04.png diff --git a/Bilder/history01.png b/Verwendung/Bilder/history01.png similarity index 100% rename from Bilder/history01.png rename to Verwendung/Bilder/history01.png diff --git a/Bilder/history02.png b/Verwendung/Bilder/history02.png similarity index 100% rename from Bilder/history02.png rename to Verwendung/Bilder/history02.png diff --git a/Bilder/pull01.png b/Verwendung/Bilder/pull01.png similarity index 100% rename from Bilder/pull01.png rename to Verwendung/Bilder/pull01.png diff --git a/Bilder/pull02.png b/Verwendung/Bilder/pull02.png similarity index 100% rename from Bilder/pull02.png rename to Verwendung/Bilder/pull02.png diff --git a/Verwendung/checkout.md b/Verwendung/checkout.md new file mode 100644 index 0000000..953e460 --- /dev/null +++ b/Verwendung/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) diff --git a/Verwendung/diff.md b/Verwendung/diff.md new file mode 100644 index 0000000..7d30dcb --- /dev/null +++ b/Verwendung/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. \ No newline at end of file diff --git a/Verwendung/init.md b/Verwendung/init.md new file mode 100644 index 0000000..76fdaaf --- /dev/null +++ b/Verwendung/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. \ No newline at end of file diff --git a/Verwendung/log.md b/Verwendung/log.md new file mode 100644 index 0000000..e27b0ef --- /dev/null +++ b/Verwendung/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) \ No newline at end of file diff --git a/Verwendung/pull.md b/Verwendung/pull.md new file mode 100644 index 0000000..d0e6e60 --- /dev/null +++ b/Verwendung/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. \ No newline at end of file