# Schnellstart-Anleitung

## 1. Virtuelle Umgebung aktivieren

Aktivieren Sie zuerst die Python-Umgebung:

```bash
source .venv/bin/activate
```

Sie sollten jetzt `(.venv)` am Anfang Ihrer Kommandozeile sehen.

## 2. Abhängigkeiten installieren

Die Python-Pakete sind bereits installiert. Falls Sie sie neu installieren müssen:

```bash
pip install -r requirements.txt
```

## 3. WordPress-Username eintragen

Bearbeiten Sie die `.env`-Datei und tragen Sie Ihren WordPress-Benutzernamen ein:

```env
WORDPRESS_URL=https://news.rpi-virtuell.de
WORDPRESS_USERNAME=IHR_USERNAME_HIER  # ← Hier eintragen!
WORDPRESS_APP_PASSWORD=UIVI 4Tdy oojL 9iZG g3X2 iAn5
```

## 4. posts.yaml anpassen

Bearbeiten Sie `posts.yaml` und fügen Sie Ihre Beiträge hinzu:

```yaml
posts:
  - title: "Ihr Beitragstitel"
    markdown_url: "https://ihre-url.de/artikel.md"
    # ODER für lokale Dateien:
    # markdown_file: "content/ihr-artikel.md"
    status: "draft"
    categories:
      - "Ihre Kategorie"
    tags:
      - "Ihr Tag"
```

## 5. Workflow ausführen

Stellen Sie sicher, dass die virtuelle Umgebung aktiviert ist (siehe Schritt 1), dann:

```bash
python workflow.py
```

## Testen mit dem Beispiel-Beitrag

Ein Test-Beitrag ist bereits in `content/beispiel-beitrag.md` vorhanden.

Um diesen zu verwenden, passen Sie `posts.yaml` an:

```yaml
posts:
  - title: "Test: Beispiel-Beitrag"
    markdown_file: "content/beispiel-beitrag.md"
    status: "draft"
    categories:
      - "Test"
```

Dann führen Sie aus:

```bash
python workflow.py
```

## Was passiert beim Ausführen?

1. ✅ System liest die `posts.yaml`
2. ✅ Für jeden Beitrag:
   - Lädt Markdown-Inhalt (von URL oder lokal)
   - Konvertiert Markdown zu HTML
   - Prüft ob Beitrag bereits existiert (nach Titel)
   - Erstellt fehlende Kategorien/Tags
   - Lädt Beitragsbilder hoch (falls vorhanden)
   - Erstellt den WordPress-Beitrag

3. ✅ Zeigt Zusammenfassung an

## Wichtige Hinweise

- **Duplikate**: Beiträge mit gleichem Titel werden NICHT doppelt erstellt
- **Medien**: Bilder mit gleichem Dateinamen werden NICHT doppelt hochgeladen
- **Status**: Standard ist "draft" - Sie können dies auf "publish" ändern
- **Sicherheit**: Die `.env`-Datei ist in `.gitignore` und wird nicht committed

## Beispiel-Ausgabe

```
Lade Konfiguration aus: posts.yaml

Verbinde mit WordPress: https://news.rpi-virtuell.de

Verarbeite 1 Beitrag/Beiträge...

============================================================
Verarbeite Beitrag: Test: Beispiel-Beitrag
============================================================
Lese lokale Markdown-Datei: content/beispiel-beitrag.md
Beitrag 'Test: Beispiel-Beitrag' erstellt (ID: 123, Status: draft)

============================================================
ZUSAMMENFASSUNG
============================================================
Erfolgreich: 1
Fehler: 0
Gesamt: 1
============================================================
```

## Nächste Schritte

1. Testen Sie mit dem Beispiel-Beitrag
2. Passen Sie `posts.yaml` für Ihre echten Beiträge an
3. Führen Sie `python workflow.py` aus
4. Überprüfen Sie die Beiträge in WordPress
5. Bei Erfolg: Ändern Sie `status: "draft"` zu `status: "publish"`

## Hilfe

Bei Problemen siehe `README.md` → Abschnitt "Fehlerbehebung"