# Gitea: Projekt hochladen & als „GitHub-Seite“ nutzen

In Gitea (https://git.example.com) lässt sich ein Projekt genauso verwalten wie
auf GitHub: Du legst ein Repository an, pusht lokale Änderungen und nutzt die
README als Projekt-Startseite.

---

## 1. Repository in Gitea anlegen

1. In Gitea einloggen (https://git.example.com).
2. Rechts oben auf das **+** bzw. **Neues Repository** klicken.
3. Werte einstellen:
   - **Name:** z. B. `ftptui`
   - **Sichtbarkeit:** öffentlich/private (nach Bedarf)
   - **README initialisieren:** aktiv (optional)
4. **Repository erstellen** klicken.

Das Repo ist jetzt unter `https://git.example.com/<benutzer>/<name>` erreichbar.

---

## 2. Lokal einrichten & hochladen (Push)

### Variante A: Neues Projekt, bereits existierendes Repo klonen

```bash
git clone https://git.example.com/<benutzer>/<name>.git
cd <name>
# ... Dateien hinzufügen ...
git add -A
git commit -m "Erster Commit"
git push
```

### Variante B: Bestehendes lokales Projekt anbinden

```bash
cd /pfad/zum/projekt
git init
git add -A
git commit -m "Erster Commit"
git branch -M main
git remote add origin https://git.example.com/<benutzer>/<name>.git
git push -u origin main
```

> Aus der `shell`-Umgebung von `example.com` ist das Repo auch per **SSH**
> erreichbar: `<E-MAIL>:<benutzer>/<name>.git`
> (vorher unter **Einstellungen → SSH-Schlüssel** einen öffentlichen Schlüssel hinterlegen).

---

## 3. README als Projekt-Startseite

Die `README.md` im Stammverzeichnis des Repos wird auf der Projektseite in Gitea
automatisch gerendert – genau wie die Projektseite bei GitHub. Diese Repo-Seite
folgt dabei **Markdown**.

### README minimal aufbauen

```markdown
# Projektname

> Kurzbeschreibung in einem Satz.

## Funktionsumfang
- ...

## Installation
```bash
pip install .
```

## Verwendung
```bash
projektbefehl
```

## Lizenz
MIT
```