Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- faecher:informatik:oberstufe:git:erstes_repo:start [29.10.2023 19:35] – Frank Schiebel
+++ faecher:informatik:oberstufe:git:erstes_repo:start [05.03.2025 14:11] (aktuell) – [Initialisieren] Frank Schiebel
@@ Zeile 1: / Zeile 1: @@
-===== Das erste Repo =====
+===== Erste Schritte mit git=====
 ===== Initialisieren =====
-Um die Abläufe und die Funktionsweise zu erproben, wollen wir zunächst ein Verzeichnis unter Versionskontrolle stellen, in dem wir ein Tagebuch anlegen. Wir erstellen also ein Verzeichnis ''tagebuch'' und initialisieren dort ein Git-Repository:
+Um die Abläufe und die Funktionsweise zu erproben, wollen wir zunächst ein Verzeichnis unter Versionskontrolle stellen, in dem wir ein **Tagebuch** anlegen. Wir erstellen also ein Verzeichnis ''tagebuch'' und initialisieren dort ein Git-Repository:
 <code>
-frank@pike:~$ mkdir tagebuch
+max@pc:~$ mkdir tagebuch
-frank@pike:~$ cd tagebuch/
+max@pc:~$ cd tagebuch/
-frank@pike:~/tagebuch$ git init
+max@pc:~$ git init
-Leeres Git-Repository in /home/frank/tagebuch/.git/ initialisiert
+Leeres Git-Repository in /home/max/tagebuch/.git/ initialisiert
 </code>
@@ Zeile 17: / Zeile 17: @@
 $ ls -la
 insgesamt 132
-drwxr-xr-x  3 frank frank   4096 24. Okt 13:32 .
+drwxr-xr-x  3 max max   4096 24. Okt 13:32 .
-drwxr-xr-x 21 frank frank 122880 24. Okt 13:32 ..
+drwxr-xr-x 21 max max 122880 24. Okt 13:32 ..
-drwxr-xr-x  7 frank frank   4096 24. Okt 13:32 .git
+drwxr-xr-x  7 max max   4096 24. Okt 13:32 .git
 </code>
 ===== Repository Status anzeigen lassen =====
+Das Verzeichnis ''tagebuch'' ist jetzt ein "git-Repository" - es wird von git "beobachtet", so dass man von nun an Änderungen in diesem Verzeichnis und seinen Unterverzeichnissen nachverfolgen kann.
-Mit dem Befehl ''git status'' kann man sich den aktuellen Status des Repos anzeigen lassen:
+Mit dem Befehl ''git status'' kann man sich den aktuellen Status des "Repos" anzeigen lassen:
 <code bash>
-frank@pike:~/tagebuch$ git status
+max@pc:~/tagebuch$ git status
 Auf Branch main
@@ Zeile 35: / Zeile 36: @@
 Sie "git add" zum Versionieren)
 </code>
+((Bei älteren git-Versionen heißt der Hauptbranch, der hier angezeigt wird gelegentlich ''master'', in diesem Fall muss man sich für das vorliegende Tutorial stets ''main'' durch ''master'' ersetzt denken -- und in den Befehlen schreiben.))
 ===== Ein erster Tagebucheintrag =====
 {{ :faecher:informatik:oberstufe:git:erstes_repo:2023-10-29_20-02.png?400|}}
-Lege mit einem Texteditor((**Nicht** mit Word oder Writer!)) eine Datei ''aufstehen.txt'' an. Du kannst in diese Datei z.B. hineinschreiben, wie du geschlafen hast und wann du aufgestanden bist. Das folgende Beispiel verwendet den Editor ''nano'' unter Linux, du kannst aber auch Notepad++ unter Windows oder Kate unter LInux verwenden, diese Editoren haben eine GUI. Wichtig ist, dass du die Datei im Verzeichnis ''tagebuch'' abspeicherst.
+Lege mit einem Texteditor((**Nicht** mit Word oder Writer!)) eine Datei ''aufstehen.txt'' an. Du kannst in diese Datei z.B. hineinschreiben, wie du geschlafen hast und wann du aufgestanden bist. Das folgende Beispiel verwendet den Editor ''nano'' unter Linux, du kannst aber auch Notepad++ unter Windows oder Kate unter Linux verwenden, diese Editoren haben eine GUI. Wichtig ist, dass du die Datei im Verzeichnis ''tagebuch'' abspeicherst.
 <code bash>
-frank@pike:~/tagebuch$ nano aufstehen.txt
+max@pc:~/tagebuch$ nano aufstehen.txt
-frank@pike:~/tagebuch$ cat aufstehen.txt
+max@pc:~/tagebuch$ cat aufstehen.txt
 Ich habe gut geschlafen.
 Um 6:20 bin ich aufgestanden.
@@ Zeile 65: / Zeile 66: @@
 <code bash>
-git status
+max@pc:~/tagebuch$ git status
 Auf Branch main
@@ Zeile 82: / Zeile 83: @@
 <code bash>
-frank@pike:~/tagebuch$ git add aufstehen.txt
+max@pc:~/tagebuch$ git add aufstehen.txt
-frank@pike:~/tagebuch$ git status
+max@pc:~/tagebuch$ git status
 Auf Branch main
@@ Zeile 95: / Zeile 96: @@
 {{ :faecher:informatik:oberstufe:git:erstes_repo:git_add.drawio.png?550 |}}
-Wenn man mit den im Index vorgemerkten Änderungen zufrieden ist, macht man einen "Commit"((In unserem Beispiel ist das noch sinnlos, weil wir derzeit ja nur eine Datei in unserem Tagebuch haben)).
+Wenn man mit den im Index vorgemerkten Änderungen zufrieden ist, macht man einen "Commit" und merkt sich dabei den Zustand aller im Index befindlichen Dateien.
-Mit dem Befehl  ''git commit -m "Erster Commit"'' legt man einen Commit mit einer Commit-Message an (Paramter ''-m''). Wenn man die Commit-Message nicht mit ''-m'' angibt, öffnet sich ein Editor, in dem man diese bearbeiten muss.
+Mit dem Befehl  ''git commit -m "Erster Commit: aufstehen.txt angelegt"'' legt man einen Commit mit einer Commit-Message an (Paramter ''-m''). Wenn man die Commit-Message nicht mit ''-m'' angibt, öffnet sich ein Editor, in dem man diese bearbeiten muss.
 <code bash>
-frank@pike:~/tagebuch$ git commit -m "Aufstehen!"
+max@pc:~/tagebuch$ git commit -m "Erster Commit: aufstehen.txt angelegt"
-[main (Root-Commit) 9ee8f8b] Aufstehen!
+[main (Root-Commit) 28ec5a7] Erster Commit: aufstehen.txt angelegt
 file changed, 2 insertions(+)
  create mode 100644 aufstehen.txt
@@ Zeile 113: / Zeile 112: @@
 <code>
-frank@pike:~/tagebuch$ git status
+max@pc:~/tagebuch$ git status
 Auf Branch main
 nichts zu committen, Arbeitsverzeichnis unverändert
@@ Zeile 120: / Zeile 119: @@
 Man erkennt, dass der Index wieder leer ist ("nichts zum Commit vorgemerkt").
-Nun kann man weitere Änderungen im Tagebuch vornehmen und  sich an allen wichtigen Stellen den Zustand der Dateien in einem Commit merken.
+Nun kann man weitere Änderungen im Tagebuch vornehmen und sich zu allen wichtigen Zeitpunkten den Zustand der Dateien in einem Commit merken.
 ===== Wir frühstücken =====
@@ Zeile 130: / Zeile 129: @@
   * Halte in der Datei ''fruehstueck.txt'' fest, was es zum Frühstück gab.
   * Kontrolliere mit ''git status'', dass es die Datei jetzt gibt, sie aber nicht unter Versionskontrolle steht.
-  * Füge die Datei ''fruehstuck.txt'' mit dem Befehl ''git add fuehstuck.txt'' zum Index hinzu.
+  * Füge die Datei ''fruehstueck.txt'' mit dem Befehl ''git add fuehstuck.txt'' zum Index hinzu.
   * Erstelle einen Commit für das Frühstück. Vergiss nicht die Commit-Message nach der Option ''-m''.
   * Überprüfe den Zustand deines Repositorys.
+[[.loesung01|Lösung]]
-===== Aufgaben =====
+Wir haben nun einen zweiten Commit erstellt:
+{{ :faecher:informatik:oberstufe:git:erstes_repo:zweitercommit.drawio.png?550 |}}
+<callout type="warning" title="Wichtig">
+Wir haben zwar nur die Datei ''fruehstueck.txt'' zum Commit vorgemerkt und anschließend mit ''git commit'' "commited", **ein Commit beinhaltet jedoch stets den Zustand aller unter Versionskontrolle stehender Dateien im Arbeitsverzeichnis**, also in diesem Fall ist in unserem zweiten Commit auch die (unveränderte) Datei ''aufstehen.txt'' enthalten!
+</callout>
+Man kann sich einen Commit also wie im Bild dargestellt als Archivbox vorstellen, in dem jeweils der Zustand aller versionierten Dateien festgehalten ist. Ein Commit wird durch einen Hexadezimalen "Hashwert" identifiziert, das ist gewissermaßen die eindeutige Nummer eines Commits, z.B. ''28ec5a7''.
-Erkläre, was man machen muss, um von der derzeitigen Situation ausgehende, die Datei ''style.css'' ebenfalls unter Versionskontrolle zu stellen. Welche git Befehle würdest du verwenden?
+Mit dem Befehl ''git log'' kann man sich die Commits auflisten lassen:
+<code bash>
+max@pc:~/tagebuch$ git log
+commit f9353d6278296bd173d3760e3b95e743208650e7 (HEAD -> main)
+Author: Max Mustermann <max@example.org>
+Date:   Wed Oct 2 08:58:45 2024 +0200
+    Frühstück in Datei 'fruehstueck.txt' hinzugefügt
+commit 28ec5a71bc2bce75bbbbfe5f2d336fe49b3642fa
+Author: Max Mustermann <max@example.org>
+Date:   Wed Oct 2 08:35:53 2024 +0200
+    Erster Commit: aufstehen.txt angelegt
+</code>
+Man erkennt hier auch, dass die eigentlichen Commit-Hashes sehr viel länger sind, als das Beispiel oben vermuten lässt, für die Identifizierung eines Commits reichen die ersten 7 Stellen des Hashes aus.
+===== Mittagessen =====
-----
 {{:aufgabe.png?nolink  |}}
 === (A2) ===
-Lege ein Verzeichnis ''webseite'' an,  erstelle dort die Dateien ''index.html'' Datei ein sowie zwei weitere Verzeichnisse - ''css'' und ''img'':
+  * Füge deinem Tagebuch einen Eintrag ''mittagessen.txt'' hinzu, zunächst ohne diese zu versionieren.
+  * Jetzt fällt dir ein, dass du zum Frühstück ein Stück Schokolade hattest, das du  nicht notiert hattest. Ändere die Datei ''fruehstueck.txt'' ab, so dass die Schokolade dort vermerkt ist.
+  * Überprüfe mit ''git status'' den Zustand deines Repositorys.
+Dein Repo sollte ungefähr so aussehen:
 <code bash>
-sbel@r107-ws15:~/git$ mkdir webseite
+max@pc:~/tagebuch$ nano mittagessen.txt
-sbel@r107-ws15:~/git$ cd webseite
+max@pc:~/tagebuch$ nano fruehstueck.txt
-sbel@r107-ws15:~/git/webseite$ touch index.html
+max@pc:~/tagebuch$ git status
-sbel@r107-ws15:~/git/webseite$ mkdir css
+Auf Branch main
-sbel@r107-ws15:~/git/webseite$ mkdir img
+Änderungen, die nicht zum Commit vorgemerkt sind:
-sbel@r107-ws15:~/git/webseite$ ls
+  (benutzen Sie "git add <Datei>...", um die Änderungen zum Commit vorzumerken)
-css  img  index.html
+  (benutzen Sie "git restore <Datei>...", um die Änderungen im Arbeitsverzeichnis zu verwerfen)
+        geändert:       fruehstueck.txt
+Unversionierte Dateien:
+  (benutzen Sie "git add <Datei>...", um die Änderungen zum Commit vorzumerken)
+        mittagessen.txt
+keine Änderungen zum Commit vorgemerkt (benutzen Sie "git add" und/oder "git commit -a")
 </code>
-  * Initialisisere das Verzeichnise ''webseite'' als git-Repository.
-  * Lasse dir den Status des Repos anzeigen
-  * Füge die Datei und die beiden Verzeichnisse dem Index hinzu und erstelle einen ersten Commit. Untersuche den Status deines Repos. Welche Beobachtung machst du hinsichtlich der beiden Verzeichnisse?
-Erstelle nun im Verzeichnis ''css'' eine Datei ''style.css'' mit dem folgenden Inhalt:
+Wir haben jetzt **zwei** Dinge geändert:
+  * In der Datei ''fruehstueck.txt'' haben wir eine Änderung vorgenommen.
+  * Die Datei ''mittagessen.txt'' wurde neu hinzugefügt.
-<code css>
+Wenn man nun den nächsten Commit vorbereitet, kann man mit dem Befehl ''git add'' wieder auswählen, welche Änderungen in den nächsten Commit übernommen werden. Um das zu demonstrieren, teilen wir die beiden vorgenommenen Änderungen im Folgenden auf zwei Commits auf.
-body {
-  color: #666;
-}
-h1 {
+<code bash>
- color: green;
+max@pc:~/tagebuch$ git add fruehstueck.txt
- text-decoration: underline;
+max@pc:~/tagebuch$ git status
-}
+Auf Branch main
+Zum Commit vorgemerkte Änderungen:
+  (benutzen Sie "git restore --staged <Datei>..." zum Entfernen aus der Staging-Area)
+	geändert:       fruehstueck.txt
+Unversionierte Dateien:
+  (benutzen Sie "git add <Datei>...", um die Änderungen zum Commit vorzumerken)
+	mittagessen.txt
 </code>
-Füge außerdem in die Datei ''index.html'' den folgenden Inhalt ein:
+Jetzt haben wir die Änderungen von ''fruehstueck.txt'' für den nächsten Commit vorgemerkt, die neue Datei ''mittagessen.txt'' wird allerdings nicht in diesen übernommen. Mit ''git commit -m "fruehstueck.txt geändert"'' wird der Commit ausgeführt.
-<code html>
+Der Status ist jetzt:
-<!DOCTYPE html>
+<code bash>
-<html lang="de">
+max@pc:~/tagebuch$ git status
-  <head>
+Auf Branch main
-    <meta charset="utf-8">
+Unversionierte Dateien:
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  (benutzen Sie "git add <Datei>...", um die Änderungen zum Commit vorzumerken)
-    <link rel="stylesheet" type="text/css" href="css/style.css" media="screen" />
+	mittagessen.txt
-    <title>Superwebseite!</title>
-  </head>
+nichts zum Commit vorgemerkt, aber es gibt unversionierte Dateien
-  <body>
+(benutzen Sie "git add" zum Versionieren)
-   <h1>Meine erste Webseite!</h1>
-  </body>
-</html>
 </code>
-Untersuche jetzt den Zustand deines Repos.
+Für den nächsten Commit übernehmen wir jetzt die Datei ''mittagessen.txt'':
+<code bash>
-Erstelle weiteren Commit, der die letzten Änderungen enthält. Was ist hierfür der Reihe nach zu tun?
+git add mittagessen.txt
+git commit -m "Mittagessen hinzugefügt"
+</code>
-Ändere weitere Teile deiner Webseite. Erstelle jeweils an sinnvollen Stellen weitere Commits mit entsprechenden Commit-Messages.
+<callout type="info" title="Zwischenergebnis">
+Wir haben jetzt gelernt, wie wir selektiv **Dateien** in einem Verzeichnis **unter Versionskontrolle** stellen können. Mit jedem Commit erzeugen wir einen **Snapshot** des Zustands, den die versionierten Dateien zum Zeitpunkt des Commits haben. Dateien, die man nicht mit ''git add'' unter Versionskontrolle gestellt hat, werden von git nicht beeinflusst.
-Betrachte die Ausgabe des Befehls ''git log''.
+Als nächstes wollen wir uns ansehen, wie wir uns die **Versionsgeschichte** genauer ansehen können und in der Zeit zurückreisen und **ältere Versionen betrachten** können.
+</callout>
 ===== Material =====
 {{simplefilelist>:faecher:informatik:oberstufe:git:erstes_repo:*}}