# HdM Slides

**Modul "Technik 1"** - 1. Semester - Digital- und Medienwirtschaft
Hochschule der Medien Stuttgart - Wintersemester 2025/26

---

## Kurse

### 223015b - Dateiformate, Schnittstellen, Speichermedien & Distributionswege

| # | Datum | Thema |
|---|-------|-------|
| 0 | 19.12.2025 | Intro |
| 1 | 19.12.2025 | Grundlagen, Text & Audio |
| 2 | 09.01.2026 | Bild- & Videoformate |
| 3 | 23.01.2026 | Speichermedien & Schnittstellen |
| 4 | 30.01.2026 | Distribution, APIs & Zukunft |
| 5 | TBA | Vertiefung & offene Fragen |

### 223015c - Internettechnologien

| # | Datum | Thema |
|---|-------|-------|
| 1 | 20.12.2025 | Geschichte, Grundlagen & HTML |
| 2 | 10.01.2026 | Netzwerke, Protokolle & CSS |
| 3 | 24.01.2026 | Interaktivitat & JavaScript |

**Dozent:** Michael Czechowski - mail@librete.ch

---

## Quick Start

### Mit Nix (empfohlen)

```bash
# Development shell mit allen Tools
nix develop

# Oder direkt QR-Code generieren
nix run .#qr -- "https://example.com"
nix run .#qr-slides -- 223015b
```

### Ohne Nix

```bash
npm install
make dev-b   # 223015b auf Port 1312
make dev-c   # 223015c auf Port 1313
```

---

## Development

### Dev Server starten

```bash
make dev-b   # 223015b (Dateiformate) - http://localhost:1312
make dev-c   # 223015c (Internettechnik) - http://localhost:1313
```

### Build

```bash
make build      # Alle Kurse (HTML + PDF)
make build-b    # Nur 223015b
make build-c    # Nur 223015c
make html       # Nur HTML
make pdf        # Nur PDF
```

### Deploy

```bash
make deploy     # Alle Kurse
make deploy-b   # Nur 223015b
make deploy-c   # Nur 223015c
```

---

## Tools

### QR-Code Generator

```bash
# Mit Nix
nix run .#qr -- "https://librete.ch/hdm/223015b/"
nix run .#qr -- "https://example.com" output.png

# Mit Make
make qr URL=https://example.com
make qr URL=https://example.com OUTPUT=my-qr.png

# Fur Kurse
make qr-slides COURSE=223015b
```

### Bilder optimieren

```bash
# Mit Nix
nix run .#optimize-img -- courses/223015b/slides/assets/

# Mit Make
make optimize-images COURSE=223015b
```

---

## Projektstruktur

```
hdm/
├── courses/
│   ├── 223015b/
│   │   └── slides/
│   │       ├── 2025-12-19-termin-1-grundlagen-text-audio.md
│   │       ├── assets/
│   │       └── materials/
│   └── 223015c/
│       └── slides/
│           ├── 2025-12-20-termin-1-geschichte-grundlagen-html.md
│           └── assets/
├── scripts/
│   └── generate-index.sh
├── themes/
│   └── custom-theme.css
├── build/           # Generated output
├── flake.nix        # Nix flake with tools
├── Makefile
└── package.json
```

---

## Slides erstellen

### Frontmatter

```yaml
---
marp: true
theme: uncover
paginate: true
backgroundColor: #fff
---
```

### Slide-Trennung

```markdown
# Slide 1

Content

---

# Slide 2

More content
```

### Bilder

```markdown
![Alt text](./assets/image.jpg)
```

### Themes

Built-in: `default`, `gaia`, `uncover`
Custom: in `themes/` Verzeichnis

---

## License

[CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)