MD2WordPress/USAGE_MODES.md
Jörg Lohrer 9ba1aa7b10 Bugfix: Tag-Duplikate, Post-Duplikate und Veröffentlichungsdatum
Fixes:
- Tag/Kategorie-Erstellung: Bessere Fehlerbehandlung für bereits existierende Tags
- Post-Duplikatsprüfung: Verbesserte Suche mit status='any' und case-insensitive Vergleich
- Veröffentlichungsdatum: datePublished aus Frontmatter wird als WordPress-Datum gesetzt
- Erweiterte Datumsextraktion aus verschiedenen Frontmatter-Strukturen

Neue Datei:
- USAGE_MODES.md: Übersicht der drei Verwendungsmodi
2025-10-01 08:30:07 +02:00

1.9 KiB

Verwendungs-Modi

Modus 1: Einzelne URL (Empfohlen für Tests)

python workflow.py "https://example.com/artikel.md"

oder lokale Datei:

python workflow.py "content/beispiel-beitrag.md"

Vorteile:

  • Schnellster Weg zum Testen
  • Keine YAML-Konfiguration nötig
  • Alle Metadaten aus Frontmatter

Modus 2: YAML-Batch (Für kuratierte Listen)

Erstellen Sie posts.yaml:

posts:
  - url: "https://example.com/artikel1.md"
  - url: "https://example.com/artikel2.md"
  - file: "content/artikel3.md"
  
settings:
  default_status: "draft"

Dann:

python workflow.py posts.yaml

Vorteile:

  • Kontrollierte Liste von Beiträgen
  • Metadaten können überschrieben werden
  • Wiederverwendbar

Modus 3: Forgejo-Repository (Für Bulk-Import)

python workflow.py --repo "https://codeberg.org/user/repo" main

Vorteile:

  • Alle Markdown-Dateien eines Repos auf einmal
  • Perfekt für bestehende Dokumentationen
  • Automatische Erkennung aller .md-Dateien

Kombinationen

Test → Produktion Workflow

  1. Einzelne URL testen:

    python workflow.py "https://example.com/test-artikel.md"
    
  2. Bei Erfolg: YAML für mehrere erstellen

  3. Bei Erfolg: Status auf "publish" setzen

Repository → Kuratierte Liste

  1. Repository scannen:

    python workflow.py --repo "https://codeberg.org/user/repo" main
    
  2. Prüfen welche Beiträge erstellt wurden

  3. Gewünschte in YAML übertragen für Feinabstimmung

Empfohlener Workflow

  1. Test mit Beispiel-Beitrag:

    python workflow.py "content/beispiel-beitrag.md"
    
  2. Test mit eigener URL:

    python workflow.py "https://ihre-url.de/artikel.md"
    
  3. Bei Erfolg: Batch oder Repo-Import

  4. In WordPress überprüfen

  5. Status auf "publish" setzen (in .yaml oder Frontmatter)