Startseite mit Anleitung, letzte Aktualisierung, README ergänzt

This commit is contained in:
2026-01-29 13:30:42 +01:00
parent bb43f7c63a
commit abd64fd961
4 changed files with 344 additions and 10 deletions

View File

@@ -58,6 +58,14 @@ Die Termine erscheinen mit der Zeitzone Europe/Berlin um 12:00 Uhr mit allen fü
Der Speiseplan kann als **externer Kalender** per URL angeboten werden. Ein Flask-Server liefert die iCal-Daten; Google Kalender und andere Clients können die URL direkt abonnieren. Im Hintergrund wird täglich nach neuen Speiseplan-PDFs gesucht und der Kalender aktualisiert.
**Startseite:** Unter der Stamm-URL (`/`) liefert der Server eine **Startseite** mit:
- der Abo-URL zum Kopieren (inkl. „Kopieren“-Button),
- einer Anleitung zur Einbettung in **Google Kalender** (Schritt für Schritt),
- Kurzhinweisen für **andere Kalender-Apps** (Outlook, Apple Kalender, Thunderbird, Android/iOS),
- der Angabe, **wann die Speisepläne zuletzt aktualisiert** wurden.
Die eigentliche iCal-Datei für Abos und direkten Download ist unter `/calendar.ics` erreichbar.
**Voraussetzung:** Für „Von URL hinzufügen“ in Google Kalender muss die Server-URL von außen erreichbar sein (öffentliche IP, Reverse-Proxy oder z. B. ngrok für Tests).
1. Abhängigkeiten installieren (inkl. Flask): `pip install -r requirements.txt`
@@ -66,8 +74,9 @@ Der Speiseplan kann als **externer Kalender** per URL angeboten werden. Ein Flas
python app.py
```
Oder mit Flask-CLI: `flask --app app run --host 0.0.0.0 --port 5000`
3. Abo-URL für Google Kalender: `http://<host>:5000/calendar.ics` (bzw. Port 5000 durch Ihren Host/Port ersetzen).
4. In Google Kalender: „Andere Kalender hinzufügen“ → „Von URL“ → obige URL eintragen.
3. Im Browser die **Startseite** aufrufen: `http://<host>:5000/` dort die Abo-URL kopieren und die Anleitung nutzen.
4. Direkte Abo-URL: `http://<host>:5000/calendar.ics` (bzw. Port durch Ihren Host ersetzen).
5. In Google Kalender: „Andere Kalender hinzufügen“ → „Von URL“ → Abo-URL eintragen.
**Konfiguration (optional, Umgebungsvariablen):**
@@ -86,7 +95,8 @@ docker build -t kantine2ical .
docker run -p 8000:8000 kantine2ical
```
Abo-URL: `http://<host>:8000/calendar.ics`
- **Startseite** (Anleitung + Abo-URL): `http://<host>:8000/`
- **iCal-Abo:** `http://<host>:8000/calendar.ics`
**Mit Docker Compose:**
```bash