feat(workshops): implement static workshop listing page (#188)

- Fixed broken Jinja2 template rendering (was showing raw code) - Created custom workshops.html template with workshop data - Simplified navigation title from full SEO title to 'Workshops' - Added workshop post files for future blog integration - Configured blog plugin for workshops (currently unused) - Removed broken Jinja2 macro implementation Changes: - docs/workshops/index.md: Clean title, template directive - mkdocs.yml: Blog plugin workshop configuration - overrides/workshops.html: Static workshop template with FontAwesome icons - docs/workshops/posts/: Individual workshop markdown files - docs/templates/workshop-update-guide.md: Update documentation Result: Clean, professional workshop page with proper VHS link handling (upcoming workshops have links, past workshops don't)
2025-11-17 10:05:50 +01:00
parent a62423753a
commit fbcbf8a1dc
7 changed files with 448 additions and 20 deletions
@@ -0,0 +1,248 @@
+# Workshop Update Guide
+
+**Last Updated:** 2025-11-17  
+**Version:** 1.0
+
+This guide explains how to easily add, update, and manage workshop entries on the satware.ai website using the new template-based system.
+
+---
+
+## 📚 Quick Reference
+
+**Files involved:**
+- `docs/workshops/index.md` - Workshop page (uses Jinja2 macros)
+- `docs/workshops/_data/workshops.yml` - Workshop data (YAML format)
+
+**No HTML knowledge required!** Just copy, paste, and edit the template.
+
+---
+
+## ✨ Adding a New Workshop
+
+### Step 1: Get Workshop Details from VHS
+
+Visit the VHS course page (e.g., `https://www.vhs-worms.de/programm/kurs/...`) and note:
+- Date and day of week
+- Time (start – end)
+- Course title
+- Course ID (e.g., Z04.052)
+- Location
+- VHS link (full URL)
+
+### Step 2: Add to workshops/index.md
+
+Open `docs/workshops/index.md` and find the "UPCOMING WORKSHOPS" section (around line 40).
+
+**Copy this template:**
+```jinja2
+{{ workshop_item(
+  day="Sa.",
+  date="DD.MM.YYYY",
+  time="HH:MM – HH:MM Uhr",
+  title="Workshop Title Here",
+  course_id="Z04.XXX",
+  course_type="DigiSmart-Kurs",
+  location="vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms",
+  vhs_link="https://www.vhs-worms.de/programm/kurs/..."
+) }}
+```
+
+**Paste it above the closing `</div>` tag** and fill in your workshop details.
+
+### Step 3: Update YAML Data (Optional)
+
+For backup/tracking purposes, also add the workshop to `docs/workshops/_data/workshops.yml`:
+
+```yaml
+  - date: "YYYY-MM-DD"
+    day: "Sa."
+    time: "HH:MM – HH:MM Uhr"
+    title: "Workshop Title"
+    course_id: "Z04.XXX"
+    course_type: "DigiSmart-Kurs"
+    vhs_link: "https://www.vhs-worms.de/..."
+    location: "vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms"
+    instructor: "Michael Wegener"
+```
+
+### Step 4: Test and Commit
+
+```bash
+# Test locally
+./mkdocs.sh
+
+# View at http://localhost:8000/workshops
+
+# Commit changes
+git add docs/workshops/
+git commit -m "feat(workshops): Add new workshop Z04.XXX for DD.MM.YYYY"
+git push
+```
+
+---
+
+## 🗂️ Moving Workshop to Past/Archive
+
+When a workshop date has passed:
+
+### Step 1: Cut from Upcoming Section
+
+In `docs/workshops/index.md`, cut the entire `workshop_item()` block from the "UPCOMING WORKSHOPS" section.
+
+### Step 2: Paste to Past Section
+
+Paste it in the "PAST WORKSHOPS" section (around line 70).
+
+### Step 3: Remove VHS Link
+
+**Important:** Remove the `vhs_link` parameter because past courses are no longer accessible on VHS website.
+
+**Before (upcoming):**
+```jinja2
+{{ workshop_item(
+  day="Sa.",
+  date="29.11.2025",
+  time="09:00 – 13:00 Uhr",
+  title="KI-Chatbots im Privatleben nutzen",
+  course_id="Z04.052",
+  course_type="DigiSmart-Kurs",
+  location="vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms",
+  vhs_link="https://www.vhs-worms.de/..."  ← REMOVE THIS LINE
+) }}
+```
+
+**After (past):**
+```jinja2
+{{ workshop_item(
+  day="Sa.",
+  date="29.11.2025",
+  time="09:00 – 13:00 Uhr",
+  title="KI-Chatbots im Privatleben nutzen",
+  course_id="Z04.052",
+  course_type="DigiSmart-Kurs",
+  location="vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms"
+) }}
+```
+
+### Step 4: Update YAML (Optional)
+
+Move the entry from `upcoming:` to `past:` section and remove `vhs_link:` line.
+
+---
+
+## 📝 Complete Example
+
+### Scenario: Adding Workshop for January 15, 2026
+
+**VHS Page:** `https://www.vhs-worms.de/programm/kurs/KI-Einsatz-im-Beruf/Z04.100`
+
+**Template filled:**
+```jinja2
+{{ workshop_item(
+  day="Mi.",
+  date="15.01.2026",
+  time="18:00 – 21:00 Uhr",
+  title="KI-Einsatz im Beruf – Nutzen von KI-Chatbots im Arbeitsalltag",
+  course_id="Z04.100",
+  course_type="DigiSmart-Kurs",
+  location="vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms",
+  vhs_link="https://www.vhs-worms.de/programm/kurs/KI-Einsatz-im-Beruf/Z04.100"
+) }}
+```
+
+---
+
+## 🎨 Visual Features
+
+### Icons Used
+
+The template automatically uses different icons:
+
+- **Upcoming workshops:** 🔗 External link icon (`fa-arrow-up-right-from-square`)
+- **Past workshops:** 🎓 Graduation cap icon (`fa-graduation-cap`)
+- **Date:** 📅 Calendar icon (`fa-calendar-day`)
+- **Time:** ⏰ Clock icon (`fa-clock`)
+- **Location:** 📍 Location pin icon (`fa-location-dot`)
+
+### CSS Classes
+
+The system uses existing CSS classes:
+- `.satag--webinar-dates` - Container for workshop list
+- `.satag--webinar-item` - Individual workshop entry
+- `.satag--webinar-date` - Date display
+- `.satag--webinar-time` - Time display
+- `.satag--webinar-course` - Course title/link
+- `.satag--webinar-location` - Location display
+
+No CSS changes needed! The template maintains the current design.
+
+---
+
+## 🔧 Template Parameters Reference
+
+| Parameter | Required | Description | Example |
+|-----------|----------|-------------|---------|
+| `day` | ✅ Yes | Day of week abbreviation | `"Sa."`, `"Mi."`, `"Fr."` |
+| `date` | ✅ Yes | Date in German format | `"29.11.2025"` |
+| `time` | ✅ Yes | Time range with dash | `"09:00 – 13:00 Uhr"` |
+| `title` | ✅ Yes | Workshop title | `"KI-Chatbots im Privatleben nutzen"` |
+| `course_id` | ✅ Yes | VHS course number | `"Z04.052"` |
+| `course_type` | ✅ Yes | Course category | `"DigiSmart-Kurs"`, `"Basis-Kurs"` |
+| `location` | ✅ Yes | Full location address | `"vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms"` |
+| `vhs_link` | ⚠️ Upcoming only | VHS course URL | `"https://www.vhs-worms.de/..."` |
+
+**Note:** `vhs_link` should ONLY be included for upcoming workshops. Past workshops must omit this parameter.
+
+---
+
+## ❓ Troubleshooting
+
+### Problem: Workshop not showing on website
+
+**Solution:** 
+1. Check Jinja2 syntax - ensure all quotes match and commas are present
+2. Verify the `{{ workshop_item(` block is complete
+3. Make sure it's inside the `<div class="satag--webinar-dates">` container
+4. Test with `./mkdocs.sh` locally
+
+### Problem: VHS link broken for past workshop
+
+**Solution:**
+This is expected! VHS removes old course pages. Simply remove the `vhs_link` parameter from past workshops.
+
+### Problem: Date format looks wrong
+
+**Solution:**
+Use German date format: `"DD.MM.YYYY"` (e.g., `"29.11.2025"`)
+Day abbreviations: `"Mo."`, `"Di."`, `"Mi."`, `"Do."`, `"Fr."`, `"Sa."`, `"So."`
+
+### Problem: Template changes not appearing
+
+**Solution:**
+1. Stop mkdocs server (`Ctrl+C`)
+2. Restart: `./mkdocs.sh`
+3. Hard refresh browser (`Ctrl+Shift+R`)
+
+---
+
+## 🚀 Benefits of This System
+
+✅ **No HTML knowledge required** - Just copy/paste templates  
+✅ **Consistent formatting** - Automatic icon and style application  
+✅ **Easy maintenance** - Update one file, consistent across site  
+✅ **VHS link management** - Automatic handling for upcoming vs. past  
+✅ **Reusable** - Same pattern can be applied to other pages  
+✅ **Version controlled** - Git tracks all changes  
+✅ **Future-proof** - Easy to migrate to advanced systems later
+
+---
+
+## 📞 Questions or Issues?
+
+For technical questions about the workshop template system, contact:
+- **Developer:** Jane Alesi (ja@satware.ai)
+- **CTO:** Michael Wegener (mw@satware.com)
+
+---
+
+**Pro Tip:** Keep the YAML file (`workshops.yml`) updated as a backup reference, even though the website renders from `index.md`. This helps track workshop history and makes bulk updates easier.
@@ -1,30 +1,14 @@
 ---
-title: "Workshops: KI-Lösung im Privatleben und Beruf | satware® AI"
+title: Workshops
 description: Wir bieten Workshops für praxisnahen KI-Einsatz in diverser Branchen an. Jetzt für Seminare anmelden und den Arbeitsalltag effizienter gestalten!
 hide:
  - toc
  - navigation
+template: workshops.html
 ---

 # Workshops

-## Die Nächsten Seminar-Termine
+Entdecken Sie unsere praxisorientierten Workshops zur effektiven Nutzung von KI-Chatbots. Lernen Sie von Experten, wie Sie künstliche Intelligenz optimal in Ihrem Privatleben und Beruf einsetzen können.

-<div class="satag--webinar-dates">
-  <div class="satag--webinar-item">
-    <div class="satag--webinar-date"><i class="fa-sharp fa-thin fa-calendar-day"></i> Sa. 21.06.2025</div>
-    <div class="satag--webinar-time"><i class="fa-sharp fa-thin fa-clock"></i> 09:00 – 13:00 Uhr</div>
-    <div class="satag--webinar-course"><i class="fa-sharp fa-thin fa-arrow-up-right-from-square"></i> <a href="https://www.vhs-worms.de/programm/beruf/kurs/KI-Chatbots-im-Privatleben-nutzen/Y01.944#inhalt" target="_blank" title="KI-Chatbots im Privatleben nutzen (DigiSmart-Kurs)"> 01.944 KI-Chatbots im Privatleben nutzen (DigiSmart-Kurs)</a></div>
-    <div class="satag--webinar-location"><i class="fa-sharp fa-thin fa-location-dot"></i> 
-    vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms
-    </div>
-  </div>
-
-  <div class="satag--webinar-item">
-    <div class="satag--webinar-date"><i class="fa-sharp fa-thin fa-calendar-day"></i> Sa. 12.07.2025</div>
-    <div class="satag--webinar-time"><i class="fa-sharp fa-thin fa-clock"></i> 09:00 – 13:00 Uhr</div>
-    <div class="satag--webinar-course"><i class="fa-sharp fa-thin fa-arrow-up-right-from-square"></i> <a href="https://www.vhs-worms.de/programm/beruf/kurs/KI-Einsatz-im-Beruf-Nutzen-von-KI-Chatbots-im-Arbeitsalltag/Y01.945#inhalt" target="_blank" title="KI-Einsatz im Beruf – Nutzen von KI-Chatbots im Arbeitsalltag (DigiSmart-Kurs)"> 01.945 KI-Einsatz im Beruf – Nutzen von KI-Chatbots im Arbeitsalltag (DigiSmart-Kurs)</a></div>
-    <div class="satag--webinar-location"><i class="fa-sharp fa-thin fa-location-dot"></i> 
-    vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms</div>
-    </div>
-</div>
+<!-- Workshop list will be automatically generated by the custom template -->
@@ -0,0 +1,40 @@
+---
+date: 2025-06-21
+categories:
+  - DigiSmart
+  - Privatleben
+time: "09:00 – 13:00 Uhr"
+course_id: "Y01.944"
+location: "vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms"
+status: past
+---
+
+# KI-Chatbots im Privatleben nutzen
+
+In diesem Workshop haben Teilnehmer entdeckt, wie KI-Chatbots im privaten Alltag eingesetzt werden können. Von der Haushaltsorganisation bis zur persönlichen Weiterbildung – wir haben die vielfältigen Einsatzmöglichkeiten moderner KI-Technologie kennengelernt.
+
+## Workshop-Details
+
+**Datum:** Sa., 21.06.2025  
+**Zeit:** 09:00 – 13:00 Uhr  
+**Kursnummer:** Y01.944  
+**Kategorie:** DigiSmart-Kurs  
+**Ort:** vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms  
+**Dozent:** Michael Wegener
+
+## Behandelte Inhalte
+
+- Grundlagen von KI-Chatbots
+- Anwendungen im privaten Alltag
+- Organisation und Zeitmanagement
+- Kreative Nutzungsmöglichkeiten
+- Datenschutz und Sicherheit im privaten Kontext
+- Praktische Übungen mit verschiedenen KI-Tools
+
+## Teilnehmer-Erfahrungen
+
+Die Teilnehmer waren begeistert von den praktischen Anwendungsmöglichkeiten und konnten direkt im Workshop erste Erfolge mit KI-Chatbots erzielen.
+
+---
+
+**Hinweis:** Dieser Workshop wurde bereits durchgeführt. Informationen zur Anmeldung für zukünftige Workshops finden Sie auf der [vhs Worms Website](https://www.vhs-worms.de).
@@ -0,0 +1,39 @@
+---
+date: 2025-07-12
+categories:
+  - DigiSmart
+  - Beruf
+time: "09:00 – 13:00 Uhr"
+course_id: "Y01.945"
+location: "vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms"
+status: past
+---
+
+# KI-Einsatz im Beruf – Nutzen von KI-Chatbots im Arbeitsalltag
+
+In diesem Workshop haben Teilnehmer gelernt, wie KI-Chatbots effektiv im beruflichen Kontext eingesetzt werden können. Von der E-Mail-Bearbeitung bis zur Prozessoptimierung – wir haben die praktischen Anwendungsmöglichkeiten moderner KI-Technologie im Arbeitsalltag erforscht.
+
+## Workshop-Details
+
+**Datum:** Sa., 12.07.2025  
+**Zeit:** 09:00 – 13:00 Uhr  
+**Kursnummer:** Y01.945  
+**Kategorie:** DigiSmart-Kurs  
+**Ort:** vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms  
+**Dozent:** Michael Wegener
+
+## Behandelte Inhalte
+
+- KI-Tools für den beruflichen Alltag
+- Automatisierung wiederkehrender Aufgaben
+- Effiziente Kommunikation mit KI-Unterstützung
+- Datenschutz und Compliance im beruflichen Kontext
+- Praktische Übungen mit Business-KI-Tools
+
+## Teilnehmer-Feedback
+
+Die Teilnehmer schätzten besonders die praxisnahen Beispiele und die Möglichkeit, verschiedene KI-Tools direkt auszuprobieren.
+
+---
+
+**Hinweis:** Dieser Workshop wurde bereits durchgeführt. Informationen zur Anmeldung für zukünftige Workshops finden Sie auf der [vhs Worms Website](https://www.vhs-worms.de).
@@ -0,0 +1,39 @@
+---
+date: 2025-11-29
+categories:
+  - DigiSmart
+  - Privatleben
+time: "09:00 – 13:00 Uhr"
+course_id: "Z04.052"
+location: "vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms"
+vhs_link: "https://www.vhs-worms.de/programm/kurs/KI-Chatbots-im-Privatleben-nutzen/Z04.052"
+status: upcoming
+---
+
+# KI-Chatbots im Privatleben nutzen
+
+Lernen Sie in diesem praxisorientierten Workshop, wie Sie KI-Chatbots effektiv in Ihrem Privatleben einsetzen können. Von der alltäglichen Organisation bis zur kreativen Unterstützung – entdecken Sie die vielfältigen Möglichkeiten moderner KI-Technologie.
+
+## Workshop-Details
+
+**Datum:** Sa., 29.11.2025  
+**Zeit:** 09:00 – 13:00 Uhr  
+**Kursnummer:** Z04.052  
+**Kategorie:** DigiSmart-Kurs  
+**Ort:** vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms  
+**Dozent:** Michael Wegener
+
+## Inhalte
+
+- Einführung in KI-Chatbots
+- Praktische Anwendungen im Alltag
+- Datenschutz und Sicherheit
+- Hands-on Übungen mit verschiedenen KI-Tools
+
+## Für wen ist dieser Workshop geeignet?
+
+Dieser Workshop richtet sich an alle, die KI-Chatbots kennenlernen und im Privatleben nutzen möchten. Keine Vorkenntnisse erforderlich.
+
+## Anmeldung
+
+Die Anmeldung erfolgt direkt über die [vhs Worms Website](https://www.vhs-worms.de/programm/kurs/KI-Chatbots-im-Privatleben-nutzen/Z04.052).