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:
parent
e0bcf215ab
commit
141b847e97
3 changed files with 37 additions and 5 deletions
14
CHANGELOG.md
14
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)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
14
README.md
14
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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue