dlw-frontend/README.md

37 lines
1.2 KiB
Markdown

# Forgejo Blog Manager (v0.1.3)
> **Ansatz:** Documentation-Driven Development (DDD)
> **Stack:** Python, Pelican, Flask, Marvin API (Uberspace 8)
---
## 📝 Übersicht
Dieses Tool ermöglicht es, einen statischen Blog auf einem Uberspace 8 zu betreiben. Es bietet ein komfortables Web-Interface für die Autorin, verwaltet Assets (PDF/MP3) und automatisiert den GitOps-Workflow über Forgejo.
### Features
* **Admin-Panel:** Flask-Weboberfläche zur Artikeleingabe.
* **Asset-Management:** Automatischer Upload und Verlinkung von Downloads.
* **Uberspace 8 Ready:** Vorbereitet für die Marvin API Integration.
* **Git-Automatisierung:** Automatischer Commit & Push zur CI/CD-Triggerung.
---
## 🏗 Struktur
* `src/dlw/admin.py`: Flask-Backend & UI-Logik.
* `src/dlw/git_ops.py`: Git-Workflow-Automatisierung.
* `src/dlw/marvin_ops.py`: Marvin API Client für Uberspace.
* `src/dlw/commands.py`: CLI-Tool `blog-cli`.
---
## 🚀 Schnellstart
1. **Installation:** `pip install .`
2. **Setup:** `blog-cli setup` (Initialisiert Ordner)
3. **Start:** `blog-cli start` (Admin-Panel unter Port 5000)
---
*Letztes Update: 2026-01-03 | Status: Funktionstüchtig*