kim
/
dlw-frontend
1
0
Fork 0
Code Issues 15 Pull Requests Packages Projects Releases Wiki Activity

README.md aktualisiert

This commit is contained in:
Kim Diallo 2026-01-03 02:45:30 +01:00
parent ded91f1b10
commit 804b10f33e
1 changed files with 13 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
README.md
View File

@ -1,37 +1,24 @@
# Forgejo Blog Manager (v0.1.3)
> **Ansatz:** Documentation-Driven Development (DDD)
> **Stack:** Python, Pelican, Flask, Marvin API (Uberspace 8)
> **Paradigma:** Documentation-Driven Development (DDD)
> **Sicherheit:** SSH-Auth via Ed25519
---
## 📝 Ü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.
---
[cite_start]Automatisierter Workflow für Uberspace 8. Das Tool verwaltet Inhalte, Assets und triggert via Git-Push die Forgejo Actions Pipeline[cite: 80, 81].
## 🏗 Struktur
* [cite_start]`src/dlw/admin.py`: Flask Interface[cite: 93, 248].
* [cite_start]`src/dlw/git_ops.py`: Git-Steuerung[cite: 199, 418].
* [cite_start]`src/dlw/marvin_ops.py`: Marvin API Client[cite: 203].
* [cite_start]`.github/workflows/deploy.yml`: CI/CD Pipeline[cite: 55, 56].
* `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`.
## ⚙️ Secrets in Forgejo
[cite_start]Hinterlege folgende Secrets für das Deployment[cite: 65, 239]:
* `SSH_PRIVATE_KEY`: Dein **Ed25519** Private Key.
* `UBERSPACE_USER`: Dein Username.
* `UBERSPACE_HOST`: Dein Uberspace-Server.
---
## 🚀 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*
*Letztes Update: 2026-01-03*