From fbcbf8a1dc8ac03e86dbb75f79d29d03c700056b Mon Sep 17 00:00:00 2001 From: Jane Alesi Date: Mon, 17 Nov 2025 10:05:50 +0100 Subject: [PATCH] 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) --- docs/templates/workshop-update-guide.md | 248 ++++++++++++++++++ docs/workshops/index.md | 24 +- .../workshops/posts/2025-06-21-ki-chatbots.md | 40 +++ docs/workshops/posts/2025-07-12-ki-beruf.md | 39 +++ .../2025-11-29-ki-chatbots-privatleben.md | 39 +++ mkdocs.yml | 9 + overrides/workshops.html | 69 +++++ 7 files changed, 448 insertions(+), 20 deletions(-) create mode 100644 docs/templates/workshop-update-guide.md create mode 100644 docs/workshops/posts/2025-06-21-ki-chatbots.md create mode 100644 docs/workshops/posts/2025-07-12-ki-beruf.md create mode 100644 docs/workshops/posts/2025-11-29-ki-chatbots-privatleben.md create mode 100644 overrides/workshops.html diff --git a/docs/templates/workshop-update-guide.md b/docs/templates/workshop-update-guide.md new file mode 100644 index 0000000..0568526 --- /dev/null +++ b/docs/templates/workshop-update-guide.md @@ -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 `` 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 `
` 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. diff --git a/docs/workshops/index.md b/docs/workshops/index.md index 5bb4984..7c27abd 100644 --- a/docs/workshops/index.md +++ b/docs/workshops/index.md @@ -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. -
-
-
Sa. 21.06.2025
-
09:00 – 13:00 Uhr
-
01.944 KI-Chatbots im Privatleben nutzen (DigiSmart-Kurs)
-
- vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms -
-
- -
-
Sa. 12.07.2025
-
09:00 – 13:00 Uhr
-
01.945 KI-Einsatz im Beruf – Nutzen von KI-Chatbots im Arbeitsalltag (DigiSmart-Kurs)
-
- vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms
-
-
+ diff --git a/docs/workshops/posts/2025-06-21-ki-chatbots.md b/docs/workshops/posts/2025-06-21-ki-chatbots.md new file mode 100644 index 0000000..115aa6c --- /dev/null +++ b/docs/workshops/posts/2025-06-21-ki-chatbots.md @@ -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). diff --git a/docs/workshops/posts/2025-07-12-ki-beruf.md b/docs/workshops/posts/2025-07-12-ki-beruf.md new file mode 100644 index 0000000..da7f58a --- /dev/null +++ b/docs/workshops/posts/2025-07-12-ki-beruf.md @@ -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). diff --git a/docs/workshops/posts/2025-11-29-ki-chatbots-privatleben.md b/docs/workshops/posts/2025-11-29-ki-chatbots-privatleben.md new file mode 100644 index 0000000..2ce257a --- /dev/null +++ b/docs/workshops/posts/2025-11-29-ki-chatbots-privatleben.md @@ -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). diff --git a/mkdocs.yml b/mkdocs.yml index ad561fa..860340d 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -67,6 +67,15 @@ plugins: pagination: true archive: true authors: true + - blog: + blog_dir: workshops + blog_toc: false + post_url_format: "{slug}" + post_date_format: "dd.MM.yyyy" + archive: false + pagination: false + categories: true + categories_toc: true - search - redirects: redirect_maps: diff --git a/overrides/workshops.html b/overrides/workshops.html new file mode 100644 index 0000000..b34a00c --- /dev/null +++ b/overrides/workshops.html @@ -0,0 +1,69 @@ +{% extends "main.html" %} + +{% block content %} + {{ super() }} + + {# Simple approach: Create workshop data directly from frontmatter structure #} + {# Workshop data will be rendered manually with correct structure #} + +

Die NĂ€chsten Seminar-Termine

+ +
+
+
+ Sa., 29.11.2025 +
+
+ 09:00 – 13:00 Uhr +
+
+ + + Z04.052 KI-Chatbots im Privatleben nutzen + +
+
+ vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms +
+
+
+ +
+ +

Vergangene Workshops

+ +
+
+
+ Sa., 12.07.2025 +
+
+ 09:00 – 13:00 Uhr +
+
+ + Y01.945 KI-Einsatz im Beruf – Nutzen von KI-Chatbots im Arbeitsalltag +
+
+ vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms +
+
+ +
+
+ Sa., 21.06.2025 +
+
+ 09:00 – 13:00 Uhr +
+
+ + Y01.944 KI-Chatbots im Privatleben nutzen +
+
+ vhs, Willy-Brandt-Ring 11, Raum 1.09, 67547 Worms +
+
+
+ +{% endblock %}