Add QUICKSTART guide and .gitattributes
This commit is contained in:
parent
5f923d8ece
commit
dc5113d303
2 changed files with 126 additions and 0 deletions
7
.gitattributes
vendored
Normal file
7
.gitattributes
vendored
Normal file
|
|
@ -0,0 +1,7 @@
|
||||||
|
* text=auto eol=lf
|
||||||
|
*.py text eol=lf
|
||||||
|
*.md text eol=lf
|
||||||
|
*.yaml text eol=lf
|
||||||
|
*.yml text eol=lf
|
||||||
|
*.txt text eol=lf
|
||||||
|
*.sh text eol=lf
|
||||||
119
QUICKSTART.md
Normal file
119
QUICKSTART.md
Normal file
|
|
@ -0,0 +1,119 @@
|
||||||
|
# Schnellstart-Anleitung
|
||||||
|
|
||||||
|
## 1. Abhängigkeiten installieren
|
||||||
|
|
||||||
|
Die Python-Pakete sind bereits installiert. Falls Sie sie neu installieren müssen:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
## 2. WordPress-Username eintragen
|
||||||
|
|
||||||
|
Bearbeiten Sie die `.env`-Datei und tragen Sie Ihren WordPress-Benutzernamen ein:
|
||||||
|
|
||||||
|
```env
|
||||||
|
WORDPRESS_URL=https://news.rpi-virtuell.de
|
||||||
|
WORDPRESS_USERNAME=IHR_USERNAME_HIER # ← Hier eintragen!
|
||||||
|
WORDPRESS_APP_PASSWORD=UIVI 4Tdy oojL 9iZG g3X2 iAn5
|
||||||
|
```
|
||||||
|
|
||||||
|
## 3. posts.yaml anpassen
|
||||||
|
|
||||||
|
Bearbeiten Sie `posts.yaml` und fügen Sie Ihre Beiträge hinzu:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
posts:
|
||||||
|
- title: "Ihr Beitragstitel"
|
||||||
|
markdown_url: "https://ihre-url.de/artikel.md"
|
||||||
|
# ODER für lokale Dateien:
|
||||||
|
# markdown_file: "content/ihr-artikel.md"
|
||||||
|
status: "draft"
|
||||||
|
categories:
|
||||||
|
- "Ihre Kategorie"
|
||||||
|
tags:
|
||||||
|
- "Ihr Tag"
|
||||||
|
```
|
||||||
|
|
||||||
|
## 4. Workflow ausführen
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python workflow.py
|
||||||
|
```
|
||||||
|
|
||||||
|
## Testen mit dem Beispiel-Beitrag
|
||||||
|
|
||||||
|
Ein Test-Beitrag ist bereits in `content/beispiel-beitrag.md` vorhanden.
|
||||||
|
|
||||||
|
Um diesen zu verwenden, passen Sie `posts.yaml` an:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
posts:
|
||||||
|
- title: "Test: Beispiel-Beitrag"
|
||||||
|
markdown_file: "content/beispiel-beitrag.md"
|
||||||
|
status: "draft"
|
||||||
|
categories:
|
||||||
|
- "Test"
|
||||||
|
```
|
||||||
|
|
||||||
|
Dann führen Sie aus:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python workflow.py
|
||||||
|
```
|
||||||
|
|
||||||
|
## Was passiert beim Ausführen?
|
||||||
|
|
||||||
|
1. ✅ System liest die `posts.yaml`
|
||||||
|
2. ✅ Für jeden Beitrag:
|
||||||
|
- Lädt Markdown-Inhalt (von URL oder lokal)
|
||||||
|
- Konvertiert Markdown zu HTML
|
||||||
|
- Prüft ob Beitrag bereits existiert (nach Titel)
|
||||||
|
- Erstellt fehlende Kategorien/Tags
|
||||||
|
- Lädt Beitragsbilder hoch (falls vorhanden)
|
||||||
|
- Erstellt den WordPress-Beitrag
|
||||||
|
|
||||||
|
3. ✅ Zeigt Zusammenfassung an
|
||||||
|
|
||||||
|
## Wichtige Hinweise
|
||||||
|
|
||||||
|
- **Duplikate**: Beiträge mit gleichem Titel werden NICHT doppelt erstellt
|
||||||
|
- **Medien**: Bilder mit gleichem Dateinamen werden NICHT doppelt hochgeladen
|
||||||
|
- **Status**: Standard ist "draft" - Sie können dies auf "publish" ändern
|
||||||
|
- **Sicherheit**: Die `.env`-Datei ist in `.gitignore` und wird nicht committed
|
||||||
|
|
||||||
|
## Beispiel-Ausgabe
|
||||||
|
|
||||||
|
```
|
||||||
|
Lade Konfiguration aus: posts.yaml
|
||||||
|
|
||||||
|
Verbinde mit WordPress: https://news.rpi-virtuell.de
|
||||||
|
|
||||||
|
Verarbeite 1 Beitrag/Beiträge...
|
||||||
|
|
||||||
|
============================================================
|
||||||
|
Verarbeite Beitrag: Test: Beispiel-Beitrag
|
||||||
|
============================================================
|
||||||
|
Lese lokale Markdown-Datei: content/beispiel-beitrag.md
|
||||||
|
Beitrag 'Test: Beispiel-Beitrag' erstellt (ID: 123, Status: draft)
|
||||||
|
|
||||||
|
============================================================
|
||||||
|
ZUSAMMENFASSUNG
|
||||||
|
============================================================
|
||||||
|
Erfolgreich: 1
|
||||||
|
Fehler: 0
|
||||||
|
Gesamt: 1
|
||||||
|
============================================================
|
||||||
|
```
|
||||||
|
|
||||||
|
## Nächste Schritte
|
||||||
|
|
||||||
|
1. Testen Sie mit dem Beispiel-Beitrag
|
||||||
|
2. Passen Sie `posts.yaml` für Ihre echten Beiträge an
|
||||||
|
3. Führen Sie `python workflow.py` aus
|
||||||
|
4. Überprüfen Sie die Beiträge in WordPress
|
||||||
|
5. Bei Erfolg: Ändern Sie `status: "draft"` zu `status: "publish"`
|
||||||
|
|
||||||
|
## Hilfe
|
||||||
|
|
||||||
|
Bei Problemen siehe `README.md` → Abschnitt "Fehlerbehebung"
|
||||||
Loading…
Add table
Add a link
Reference in a new issue