Michael Czechowski
3c78c898dd
- README.md: project overview, commands, structure - CLAUDE.md: agent guidelines for slide editing
183 lines
3.1 KiB
Markdown
183 lines
3.1 KiB
Markdown
# 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
|
|
|
|
```
|
|
|
|
### Themes
|
|
|
|
Built-in: `default`, `gaia`, `uncover`
|
|
Custom: in `themes/` Verzeichnis
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
[CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
|