Michael Czechowski
a8343c9937
- rename slide files: YYYY-MM-DD-termin-N-topic.md → NN-topic.md - flatten folders: courses/X/slides/ → slides/X/ - replace "Termin" with "Kapitel" in all content - add klausur extraction script (make klausur) - update Makefile, generate-index.sh, dev-server.sh - add README.md with full documentation
96 lines
2.1 KiB
Markdown
96 lines
2.1 KiB
Markdown
# HdM Slides
|
|
|
|
Presentation slides for HdM Stuttgart courses, built with [Marp](https://marp.app/).
|
|
|
|
## Courses
|
|
|
|
| Code | Title | Kapitel |
|
|
|------|-------|---------|
|
|
| 223015b | Dateiformate, Schnittstellen, Speichermedien | 6 |
|
|
| 223015c | Internettechnologien | 3 |
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
slides/
|
|
├── 223015b/ # Dateiformate course
|
|
│ ├── 00-intro.md
|
|
│ ├── 01-grundlagen-text-audio.md
|
|
│ └── ...
|
|
└── 223015c/ # Internettechnik course
|
|
├── 01-geschichte-grundlagen-html.md
|
|
└── ...
|
|
scripts/ # Build scripts
|
|
build/ # Generated output (gitignored)
|
|
```
|
|
|
|
## Development
|
|
|
|
```bash
|
|
# Start dev servers (hot reload)
|
|
make dev # All courses + index
|
|
make dev-b # 223015b only (port 1311)
|
|
make dev-c # 223015c only (port 1312)
|
|
```
|
|
|
|
## Build
|
|
|
|
```bash
|
|
make build # Build all (HTML + PDF)
|
|
make build-b # Build 223015b only
|
|
make build-c # Build 223015c only
|
|
make html # HTML only
|
|
make pdf # PDF only
|
|
```
|
|
|
|
## Klausur Slides
|
|
|
|
Extract exam-relevant slides (marked with `<!-- _class: klausur -->`) into a single file:
|
|
|
|
```bash
|
|
make klausur # Extract all courses
|
|
make klausur-b # 223015b only
|
|
make klausur-c # 223015c only
|
|
```
|
|
|
|
Output: `slides/<course>/klausur.md`
|
|
|
|
The generated file includes:
|
|
- A title slide per kapitel for orientation
|
|
- All slides marked with `<!-- _class: klausur -->`
|
|
|
|
## Tools
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
make deploy # Deploy all courses
|
|
make deploy-b # Deploy 223015b only
|
|
make deploy-c # Deploy 223015c only
|
|
```
|
|
|
|
## Marking Slides as Klausur-Relevant
|
|
|
|
Add this comment block after the slide separator:
|
|
|
|
```markdown
|
|
---
|
|
|
|
<!-- _class: klausur -->
|
|
<!-- _header: '' -->
|
|
<!-- _footer: '' -->
|
|
<!-- _backgroundColor: #e3f2fd -->
|
|
|
|
# Your Slide Title
|
|
|
|
Content here...
|
|
```
|
|
|
|
The `klausur` class adds a visual indicator (diagonal stripes) during presentation.
|