From 141b847e97b695230fde1a5c5362fc71d7a76a0d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Lohrer?= Date: Wed, 1 Oct 2025 10:22:32 +0200 Subject: [PATCH] =?UTF-8?q?Docs:=20Bekannte=20Einschr=C3=A4nkungen=20dokum?= =?UTF-8?q?entieren?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hinzugefügt in README.md (prominent am Anfang): - ⚠️ Bekannte Einschränkungen-Sektion - Autor-Zuordnung: Aktuell nur zum importierenden User - Forgejo-Batch: Noch nicht ausreichend getestet - Empfehlung: Start mit einzelnen URLs Aktualisiert in QUICKSTART.md: - Hinweis auf Autor-Zuordnung - Modus 3 (Forgejo) als 'Experimentell' markiert - Empfehlung für Modus 1 (einzelne URL) hervorgehoben Erweitert in CHANGELOG.md: - Geplante Features nach Priorität sortiert - Autor-Mapping als Hoch-Priorität - Robuste Forgejo-API als Hoch-Priorität - Neue Features: Dry-Run-Modus, Mehrsprachigkeit --- CHANGELOG.md | 14 ++++++++++++-- QUICKSTART.md | 14 +++++++++++--- README.md | 14 ++++++++++++++ 3 files changed, 37 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d57b8a6..ab250b0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -142,9 +142,19 @@ Keine. ## Geplante Features +## Geplante Features + +### Hoch-Priorität +- [ ] **Autor-Mapping:** WordPress-User aus Frontmatter-Autor automatisch zuordnen oder manuelles Mapping +- [ ] **Robuste Forgejo-API:** Bessere Fehlerbehandlung, Progress-Tracking für Batch-Imports + +### Mittel-Priorität - [ ] GitHub-Repository Support (zusätzlich zu Forgejo) -- [ ] Autor-Mapping (WordPress-User aus Frontmatter-Autor) - [ ] Batch-Update (bestehende Posts aktualisieren statt nur überspringen) -- [ ] Featured Image aus Markdown-Content extrahieren (erstes Bild) +- [ ] Featured Image aus Markdown-Content extrahieren (erstes Bild falls kein Frontmatter-Image) + +### Niedrig-Priorität - [ ] Custom Post Types Support - [ ] Zeitzone-Unterstützung für Veröffentlichungsdatum +- [ ] Mehrsprachige Beiträge (WPML/Polylang Support) +- [ ] Dry-Run-Modus (zeigt was passieren würde ohne zu erstellen) diff --git a/QUICKSTART.md b/QUICKSTART.md index 8e058cb..0ee30cd 100644 --- a/QUICKSTART.md +++ b/QUICKSTART.md @@ -1,5 +1,11 @@ # Schnellstart-Anleitung +## ⚠️ Wichtige Hinweise + +**Autor-Zuordnung:** Beiträge werden dem importierenden WordPress-Benutzer zugeordnet (nicht dem Autor aus dem Frontmatter). + +**Empfehlung:** Starten Sie mit **einzelnen URLs** zum Testen, bevor Sie Batch-Imports durchführen. + ## Überblick Das System extrahiert **automatisch alle Metadaten aus dem YAML-Frontmatter** Ihrer Markdown-Dateien: @@ -8,13 +14,13 @@ Das System extrahiert **automatisch alle Metadaten aus dem YAML-Frontmatter** Ih - **image** → Beitragsbild - **tags** → WordPress-Tags - **categories** → WordPress-Kategorien -- **author** → WordPress-Autor +- **author** → WordPress-Autor (aktuell nur extrahiert, nicht zugeordnet) Sie müssen nur noch die **URL zur Markdown-Datei** angeben! ## Drei Verwendungsmodi -### 1. Einzelne URL (Am einfachsten!) +### 1. Einzelne URL (Am einfachsten! ⭐ Empfohlen zum Testen) ```bash source .venv/bin/activate @@ -37,13 +43,15 @@ source .venv/bin/activate python workflow.py posts.yaml ``` -### 3. Ganzes Repository (Forgejo/Gitea) +### 3. Ganzes Repository (Forgejo/Gitea) ⚠️ Experimentell ```bash source .venv/bin/activate python workflow.py --repo "https://codeberg.org/user/repo" main ``` +**Hinweis:** Diese Funktion wurde noch nicht ausgiebig getestet. Nutzen Sie zunächst Modus 1 oder 2. + ## Schnellstart-Schritte ## 1. Virtuelle Umgebung aktivieren diff --git a/README.md b/README.md index f2899fb..2176a92 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,20 @@ Automatisierter Workflow zum Erstellen von WordPress-Beiträgen aus Markdown-Dat **Neu:** Metadaten werden automatisch aus dem YAML-Frontmatter der Markdown-Dateien extrahiert! +## ⚠️ Bekannte Einschränkungen + +**Autor-Zuordnung:** +- Beiträge werden aktuell immer dem importierenden WordPress-Benutzer zugeordnet +- Der `author` aus dem Frontmatter wird extrahiert, aber nicht mit WordPress-Benutzern abgeglichen +- **Zu entwickeln:** Automatisches Mapping von Frontmatter-Autoren zu WordPress-User-IDs oder manuelle Zuordnungs-Konfiguration + +**Forgejo-Repository-Import:** +- Die Batch-Verarbeitung ganzer Repositories wurde noch nicht ausreichend getestet +- **Empfehlung:** Beginnen Sie mit einzelnen URLs: `python workflow.py "https://url.de/artikel.md"` +- **Zu entwickeln:** Robustere Forgejo-API-Integration mit besserer Fehlerbehandlung und Progress-Tracking + +**Empfohlener Workflow:** Testen Sie zunächst mit einzelnen Markdown-URLs, bevor Sie größere Batch-Imports durchführen. + ## Features - ✅ **Automatische Metadaten-Extraktion**: name, description, tags, image, author aus YAML-Frontmatter