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
|
||||||
|
|
||||||
|
## 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)
|
- [ ] GitHub-Repository Support (zusätzlich zu Forgejo)
|
||||||
- [ ] Autor-Mapping (WordPress-User aus Frontmatter-Autor)
|
|
||||||
- [ ] Batch-Update (bestehende Posts aktualisieren statt nur überspringen)
|
- [ ] 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
|
- [ ] Custom Post Types Support
|
||||||
- [ ] Zeitzone-Unterstützung für Veröffentlichungsdatum
|
- [ ] 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
|
# 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
|
## Überblick
|
||||||
|
|
||||||
Das System extrahiert **automatisch alle Metadaten aus dem YAML-Frontmatter** Ihrer Markdown-Dateien:
|
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
|
- **image** → Beitragsbild
|
||||||
- **tags** → WordPress-Tags
|
- **tags** → WordPress-Tags
|
||||||
- **categories** → WordPress-Kategorien
|
- **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!
|
Sie müssen nur noch die **URL zur Markdown-Datei** angeben!
|
||||||
|
|
||||||
## Drei Verwendungsmodi
|
## Drei Verwendungsmodi
|
||||||
|
|
||||||
### 1. Einzelne URL (Am einfachsten!)
|
### 1. Einzelne URL (Am einfachsten! ⭐ Empfohlen zum Testen)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
source .venv/bin/activate
|
source .venv/bin/activate
|
||||||
|
|
@ -37,13 +43,15 @@ source .venv/bin/activate
|
||||||
python workflow.py posts.yaml
|
python workflow.py posts.yaml
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3. Ganzes Repository (Forgejo/Gitea)
|
### 3. Ganzes Repository (Forgejo/Gitea) ⚠️ Experimentell
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
source .venv/bin/activate
|
source .venv/bin/activate
|
||||||
python workflow.py --repo "https://codeberg.org/user/repo" main
|
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
|
## Schnellstart-Schritte
|
||||||
|
|
||||||
## 1. Virtuelle Umgebung aktivieren
|
## 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!
|
**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
|
## Features
|
||||||
|
|
||||||
- ✅ **Automatische Metadaten-Extraktion**: name, description, tags, image, author aus YAML-Frontmatter
|
- ✅ **Automatische Metadaten-Extraktion**: name, description, tags, image, author aus YAML-Frontmatter
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue