====== Git-Befehle für Windows ======
Die Befehle werden auf der //Kommandozeile// bzw. in der //PowerShell// ausgeführt.

===== Repository‑Grundbefehle =====
| Repository klonen (von Gitea holen)             | git clone <url>                         |
| Neues Repository initialisieren (lokal)         | git init                                |
| Remote‑Server hinzufügen (Gitea)                | git remote add origin <url>             |
| Remote‑Server anzeigen                          | git remote -v                           |

===== Dateien verwalten =====
| Status anzeigen (was ist geändert?)             | git status                              |
| Alle Änderungen zum Commit vormerken            | git add .                               |
| Einzelne Datei vormerken                        | git add <datei>                         |
| Datei aus dem Staging entfernen                 | git restore --staged <datei>            |

===== Commits =====
| Commit erstellen                                | git commit -m "Beschreibung"            |
| Letzten Commit überschreiben (Nachricht ändern) | git commit --amend                      |

===== Push & Pull =====
| Änderungen zum Server (Gitea) senden            | git push                                |
| Erster Push (Upstream setzen)                   | git push -u origin main                 |
| Änderungen vom Server holen                     | git pull                                |

===== Branches =====
| Alle Branches anzeigen                          | git branch                              |
| Neuen Branch erstellen                          | git branch <name>                       |
| Branch wechseln                                 | git checkout <name>                     |
| Branch erstellen + wechseln                     | git checkout -b <name>                  |
| Branch löschen (lokal)                          | git branch -d <name>                    |

===== Merge & Konflikte =====
| Branch in aktuellen Branch mergen               | git merge <branch>                      |
| Konflikte anzeigen                              | git status                              |
| Konflikte nach Bearbeitung als gelöst markieren | git add <datei>                         |

===== Historie & Wiederherstellung =====
| Commit‑Verlauf anzeigen                         | git log --oneline --graph --decorate    |
| Einzelnen Commit rückgängig machen (sicher)     | git revert <commit-id>                  |
| Zu einem früheren Commit springen (gefährlich)  | git reset --hard <commit-id>            |
| Nur HEAD zurücksetzen, Dateien behalten         | git reset --soft <commit-id>            |

===== Aufräumen =====
| Nicht getrackte Dateien löschen (VORSICHT)      | git clean -f                            |
| Nicht getrackte Ordner löschen                  | git clean -fd                           |

===== SSH‑Key für Gitea (Windows) =====
| SSH‑Key erzeugen                                | ssh-keygen -t ed25519 -C "<deine-mail>" |
| SSH‑Agent starten                               | eval $(ssh-agent -s)                    |
| Key hinzufügen                                  | ssh-add ~/.ssh/id_ed25519               |

===== Typische Fehler & schnelle Lösungen =====
| Push verweigert (non-fast-forward)              | git pull → Konflikte lösen → git push   |
| Falscher Branch                                 | git checkout <richtiger-branch>         |
| Datei versehentlich gelöscht                    | git restore <datei>                     |
| Staging rückgängig machen                       | git restore --staged <datei>            |