MD2WordPress/QUICKSTART.md
2025-10-01 06:28:35 +02:00

3.2 KiB

Schnellstart-Anleitung

1. Virtuelle Umgebung aktivieren

Aktivieren Sie zuerst die Python-Umgebung:

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:

pip install -r requirements.txt

3. WordPress-Username eintragen

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

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:

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:

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:

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

Dann führen Sie aus:

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"