Add QUICKSTART guide and .gitattributes

2025-10-01 06:17:58 +02:00 · 2025-10-01 06:17:58 +02:00 · dc5113d303
commit dc5113d303
parent 5f923d8ece
2 changed files with 126 additions and 0 deletions
--- a/.gitattributes
+++ b/.gitattributes
@ -0,0 +1,7 @@
+* text=auto eol=lf
+*.py text eol=lf
+*.md text eol=lf
+*.yaml text eol=lf
+*.yml text eol=lf
+*.txt text eol=lf
+*.sh text eol=lf
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@ -0,0 +1,119 @@
+# Schnellstart-Anleitung
+
+## 1. Abhängigkeiten installieren
+
+Die Python-Pakete sind bereits installiert. Falls Sie sie neu installieren müssen:
+
+```bash
+pip install -r requirements.txt
+```
+
+## 2. 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
+```
+
+## 3. 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"
+```
+
+## 4. Workflow ausführen
+
+```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"