Michael Czechowski
9e12447528
- simplify development: single marp server on port 3000 instead of 3 processes - rename klausur to klausurfolien for better naming - update extract script to use 00-intro.md as template when no 01-*.md exists - update makefile and package.json for new workflow - add comprehensive AGENTS.md guidelines
98 lines
2.2 KiB
Markdown
98 lines
2.2 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 development server (hot reload)
|
|
make dev # Single server for all courses (port 3000)
|
|
|
|
# Access individual courses:
|
|
# 223015b: http://localhost:3000/223015b/
|
|
# 223015c: http://localhost:3000/223015c/
|
|
```
|
|
|
|
## 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 Folien
|
|
|
|
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>/klausurfolien.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.
|