====== Wie arbeite ich in Gitea unterstützt durch Git Extensions ======

Der typische Git/Gitea‑Arbeitsablauf besteht aus sechs klaren Phasen – Repository anlegen, lokal klonen, arbeiten, committen, branchen, mergen, pushen.

===== Neues Repository in Gitea anlegen =====
  * In Gitea einloggen
  * //**New Repository**// → Name, Beschreibung, Sichtbarkeit
  * Optional: README, .gitignore, Lizenz automatisch erzeugen
  * Ergebnis: Du hast eine Remote‑URL wie<code bash>https://gitea.hoeglinger.name/eugen/meinprojekt.git</code>

===== Repository auf den Rechner holen (Git Extensions) =====
Git Extensions → Clone Repository
  * **Repository URL:** die Gitea‑URL
  * **Destination:** lokaler Ordner
  * **Subdirectory:** automatisch\\ → Clone
Damit hast du eine vollständige lokale Arbeitskopie.

===== Dateien bearbeiten =====
Du arbeitest im lokalen Ordner mit deinem Editor (Visual Studio, VS Code, Notepad++, FreeCAD, …).
Git Extensions überwacht Änderungen automatisch.

===== Änderungen committen =====
Git Extensions → Commit
  * Geänderte Dateien auswählen
  * Commit‑Message schreiben
  * Commit
__Wichtig:__ Commit speichert **nur lokal**.

===== Änderungen nach Gitea pushen =====
Git Extensions → Push
  * Branch auswählen (meist ''main'')
  * Push
Jetzt sind die Änderungen im Gitea‑Server sichtbar.

===== Neuen Branch anlegen =====
Warum?
Für neue Features, Experimente, Bugfixes.
Git Extensions → Branch
  * Name: z. B. ''feature-login''
  * Create branch
  * Checkout branch
Du arbeitest jetzt isoliert vom ''main''.

===== Auf dem Branch arbeiten =====
  * Dateien ändern
  * Committen
  * Pushen (der Branch wird automatisch auf Gitea angelegt)

===== Branches zusammenführen (Merge) =====
==== Variante A: Merge lokal in Git Extensions ====
  * Auf ''main'' wechseln
  * Merge → Branch auswählen
  * Konflikte lösen
  * Commit
  * Push
==== Variante B: Merge über Gitea Pull Request ====
Empfohlen bei größeren Projekten:
In Gitea → New Pull Request
Quelle: dein Feature‑Branch
Ziel: ''main''
Review, Merge, Delete Branch

===== Lokale Kopie aktualisieren (Pull) =====
Wenn du auf einem anderen Rechner arbeitest oder nach einem Merge:
//Git Extensions// → //**Pull**//  
Holt alle Änderungen aus Gitea.

===== Neue Dateien hinzufügen =====
Einfach Datei in den Ordner legen → Git Extensions erkennt sie → //**Commit**// → //**Push**//.

===== Typischer Tagesablauf (kompakt) =====
  - //**Pull**// (immer zuerst)
  - Arbeiten
  - //**Commit**//
  - //**Push**//
  - Bei Features: auf eigenem Branch arbeiten
  - Merge über Pull Request oder lokal

===== Vollständiger Workflow als Infoblatt (druckbar) =====
  - **Repository anlegen** (Gitea)
  - //**Clone**// (Git Extensions)
  - **Editieren** (lokal)
  - //**Commit**// (Git Extensions)
  - //**Push**// nach Gitea Git Extensions)
  - Branch erstellen (Git Extensions)
  - **Auf Branch arbeiten**
  - **Branch pushen**
  - **Merge** (lokal oder Pull Request)
  - //**Pull**// (lokale Kopie aktualisieren)