diff --git a/Aufgaben/02_Repository.md b/Aufgaben/02_Repository.md index e576c3d..46e925c 100644 --- a/Aufgaben/02_Repository.md +++ b/Aufgaben/02_Repository.md @@ -1,23 +1,23 @@ # Ein Repository erstellen -In dieser Aufgabe lernst du, wie du ein eigenes Git-Repository über die Konsole anlegst und grundlegende Git-Befehle verwendest. +In dieser Aufgabe lernst du, wie du über die Konsole ein eigenes Git-Repository anlegst und grundlegende Git-Befehle verwendest. -## Repository auf Gitty anlegen +## Repository auf Gitty erstellen 1. Besuche das [Gitty der Hochschule](https://gitty.informatik.hs-mannheim.de). -2. Logge dich mit deiner Matrikelnummer als Benutzername und deinem Hochschul-Passwort ein. -3. Klicke oben rechts auf das **Plus-Symbol** und wähle im Kontextmenü **"Neues Repository"**. +2. Logge dich mit deiner **Matrikelnummer** (als Benutzername) und deinem **Hochschul-Passwort** ein. +3. Klicke oben rechts auf das **Plus-Symbol (+)** und wähle im Dropdown-Menü **"Neues Repository"** aus. 4. Gib im Feld **Repository-Name** den Namen `pr1_git_kurs` ein. -5. Belasse alle anderen Einstellungen bei ihren Standardwerten. +5. Belasse alle anderen Einstellungen bei den Standardwerten. 6. Klicke auf **"Repository erstellen"**. Du solltest nun im Webinterface deines frisch erstellten Repositories landen. -## Repository befüllen +## Erste Datei im Repository anlegen -1. Klicke im Repository-Webinterface auf **"Neue Datei"**. +1. Klicke in deinem Repository auf **"Neue Datei"**. 2. Gib als Dateinamen `README.md` ein. -3. Füge folgenden Text als Inhalt ein: +3. Füge folgenden Inhalt ein: ```markdown # Meine erste Readme @@ -35,42 +35,43 @@ Du kannst auch nummerierte Listen verwenden: 1. Erster Schritt 2. Zweiter Schritt ``` +4. Scrolle nach unten und klicke auf **"Änderungen committen"**. +5. Kehre zur Startseite deines Repositories zurück. +6. Du solltest jetzt eine Dateiliste sehen, die deine `README.md` enthält. Darunter erscheint automatisch eine formatierte Vorschau der Datei. -4. Klicke unten auf **"Änderungen committen"**. -5. Navigiere zurück zur Startseite deines Repositories. -6. Dort solltest du nun eine Dateiliste sehen inklusive deiner `README.md`. Darunter wird automatisch eine formatierte Vorschau angezeigt. +**Hinweis:** Die `README.md` ist eine besondere Datei. Git-Plattformen wie Gitty, GitHub oder GitLab zeigen sie automatisch auf der Startseite eines Repositories an. Sie verwendet **Markdown**, eine einfache Auszeichnungssprache, die auch in Tools wie Discord, Notion oder Obsidian genutzt wird. -**Hinweis:** Die `README.md` ist eine besondere Datei in jedem Repository. Git-Plattformen wie Gitty, GitHub oder GitLab zeigen sie automatisch auf der Startseite an. Sie verwendet **Markdown-Syntax**, ein einfaches Auszeichnungssystem, das auch in Tools wie Discord, Notion oder Obsidian zum Einsatz kommt. +## Repository lokal klonen -## Repository clonen +Um lokal an deinem Repository weiterzuarbeiten, musst du es klonen – also eine Kopie auf deinem Rechner anlegen. -Jetzt willst du wahrscheinlich lokal weiterarbeiten, dafür musst du dein Repository clonen, also eine Kopie auf deinem Rechner anlegen. - -1. Öffne ein Terminal auf deinem Rechner. -2. Navigiere in ein Verzeichnis, in dem du dein Repository ablegen möchtest, z.B. mit: +1. Öffne ein Terminal (unter Windows: PowerShell oder Git Bash). +2. Wechsle in ein Verzeichnis, in dem du dein Repository speichern willst: ```bash -# Mac & Linux +# macOS / Linux cd ~ # Windows cd %USERPROFILE%\Documents ``` -3. Kopiere die HTTPS-URL deines Repositories aus Gitty. Die findest du oben auf der Repository-Seite unter dem Button "Clone" - - Du findest sie auf der Repository-Seite direkt über der Dateiansicht - - Dort siehst du die Buttons "HTTPS" und "SSH" - - Stelle sicher, dass "HTTPS" ausgewählt ist - - Rechts daneben findest du die URL in einem Textfeld, klick auf das Kopier-Icon, um sie in die Zwischenablage zu übernehmen. -4. Nutze dir kopierte URL um im Terminel mit folgendem Befehl das Repository zu clonen: +3. Kopiere die **HTTPS-URL** deines Repositories von Gitty: + - Gehe auf die Startseite deines Repositories. + - Klicke auf **"Clone"**. + - Stelle sicher, dass **"HTTPS"** ausgewählt ist. + - Kopiere die URL rechts daneben mit dem Kopier-Icon in die Zwischenablage. +4. Klone das Repository mit folgendem Befehl: ```bash git clone ``` -5. Wechsle anschließend in das geklonte Verzeichnis: -```bash +*Ersetze `` durch die kopierte URL* + +5. Wechsle in das geklonte Verzeichnis: +```bash cd pr1_git_kurs ``` -6. Stelle sicher, dass dort die `README.md` existiert: -``` -# Mac & Linux +6. Überprüfe, ob die Datei `README.md` vorhanden ist: +```bash +# macOS / Linux ls # Windows