Git/Aufgaben/02_Repository.md

Ein Repository erstellen

In dieser Aufgabe lernst du, wie du ein eigenes Git-Repository über die Konsole anlegst und grundlegende Git-Befehle verwendest.

Repository auf Gitty anlegen

1. Besuche das Gitty der Hochschule.
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".
4. Gib im Feld Repository-Name den Namen pr1_git_kurs ein.
5. Belasse alle anderen Einstellungen bei ihren Standardwerten.
6. Klicke auf "Repository erstellen".

Du solltest nun im Webinterface deines frisch erstellten Repositories landen.

Repository befüllen

1. Klicke im Repository-Webinterface auf "Neue Datei".
2. Gib als Dateinamen README.md ein.
3. Füge folgenden Text als Inhalt ein:

# Meine erste Readme

Dies ist eine einfache README.md-Datei, die grundlegende Markdown-Syntax verwendet.

## Abschnitt 1: Überschrift

Das ist ein Abschnitt mit einer größeren Überschrift. Hier kannst du allgemeine Informationen zu deinem Projekt angeben.

## Abschnitt 2: Liste
- Dies ist der erste Punkt in einer Liste.
- Und hier ist ein weiterer Punkt in der Liste.

Du kannst auch nummerierte Listen verwenden:
1. Erster Schritt
2. Zweiter Schritt

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 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 clonen

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:

# Mac & 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:

git clone <repository_url>

5. Wechsle anschließend in das geklonte Verzeichnis:

cd pr1_git_kurs

6. Stelle sicher, dass dort die README.md existiert:

# Mac & Linux
ls

# Windows
dir