Docs: Bekannte Einschränkungen dokumentieren

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
This commit is contained in:
Jörg Lohrer 2025-10-01 10:22:32 +02:00
parent e0bcf215ab
commit 141b847e97
3 changed files with 37 additions and 5 deletions

View file

@ -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)

View file

@ -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

View file

@ -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