uni/README.md

Uni Slides - DHBW + HdM

Combined presentation slides for DHBW and HdM Stuttgart courses, built with Marp.

Courses

Code	Title	Origin	Fokus
223015b	Dateiformate, Schnittstellen, Speichermedien	HdM	Dateien und Inhalte
223015c	Internettechnologien	HdM	Internet und Web
dhbw	Technik I – Grundlagen IT	DHBW	Grundlagen

Didaktisches Fundament (HdM)

Drei Meta-Lernziele bilden den Maßstab für jede inhaltliche Entscheidung:

1. Gelernte Hilflosigkeit ablegen — Technik ist kein Mysterium. Keine Insider-Sprache ohne Erklärung; abstrakte Konzepte über konkrete Beispiele.
2. Berührungspunkte schaffen — Inhalte mit der Lebenswelt der Studierenden verknüpfen. Jedes Kapitel braucht mindestens einen Alltags-Anker.
3. Erstes fundiertes Wissen und Gefühl für Technik — kein Auswendiglernen, sondern ein belastbarer mentaler Bauplan. Lieber drei Konzepte in Tiefe als zwölf in Breite.

Die operative Umsetzung (Werkzeuge, Validierungs-Kriterien, Anti-Pattern) ist in CLAUDE.md dokumentiert und gilt für alle Beiträge — menschlich wie agentisch.

Project Structure

slides/
├── 223015b/          # HdM: Dateiformate
├── 223015c/          # HdM: Internettechnik
├── dhbw/              # DHBW slides (TBD)
scripts/              # Build scripts
build/                # Generated output (gitignored)

Development

make hdm-dev          # Live server all HdM courses (port 1312, HMR)
make hdm-dev-b       # 223015b only (port 1313, HMR)
make hdm-dev-c       # 223015c only (port 1314, HMR)
make dhbw-dev        # DHBW (not yet configured)

Build

make hdm-build        # Build all HdM courses (HTML + PDF)
make hdm-build-b     # 223015b only
make hdm-build-c     # 223015c only
make hdm-html        # HTML only all HdM
make hdm-pdf         # PDF only all HdM

Klausur Folien

Extract exam slides (<!-- _class: klausur -->) into single file:

make hdm-klausur      # All HdM courses
make hdm-klausur-b    # 223015b only
make hdm-klausur-c    # 223015c only

Output: slides/<course>/klausurfolien.md

Tools

make qr URL=https://example.com              # Generate QR code
make qr-slides COURSE=223015b                 # QR for course URL
make optimize-images COURSE=223015b          # Resize images

Deploy

make hdm-deploy        # Deploy all HdM courses
make hdm-deploy-b     # 223015b only
make hdm-deploy-c     # 223015c only
make deploy           # Full deploy (all courses)

Marking Slides as Klausur-Relevant

Add this comment block after the slide separator:

---

<!-- _class: klausur -->
<!-- _header: '' -->
<!-- _footer: '' -->
<!-- _backgroundColor: #e3f2fd -->

# Your Slide Title

Content here...

The klausur class adds a visual indicator (diagonal stripes) during presentation.