# 223015b – Dateiformate, Schnittstellen, Speichermedien & Distributionswege

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

**Repository:** [git.librete.ch/hdm/223015b](https://git.librete.ch/hdm/223015b)

---

## Termine

| # | Datum | Thema |
|---|-------|-------|
| 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 |

### Kompetenzen

In dieser Veranstaltung erwerben Sie folgende Kompetenzen:
- Technische Konzepte des Internets verstehen (Netzwerke, Protokolle, Client/Server)
- Dateiformate analysieren und verstehen
- Grundlagen von Kompression (Audio, Bild, Video)
- Speichermedien und Schnittstellen kennen
- APIs und Distributionswege verstehen

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

---

## Slides erstellen

### Basic Slide Structure

Slides are written in Markdown and separated by `---`:

```markdown
---
marp: true
theme: uncover
paginate: true
---

# Slide Title

Content here

---

# Next Slide

More content
```

### Frontmatter

Configure slide settings at the top:

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

### Themes

Use built-in themes:
- `default`
- `gaia`
- `uncover`

Or create custom themes in `themes/` directory.

### Images and Assets

Place images in `assets/` directory and reference them:

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

## Custom Themes

Create custom themes in `themes/` directory:

```css
/* @theme custom-theme */

@import-theme "gaia";

section {
  background-color: #f0f8ff;
  color: #2c3e50;
}

h1 {
  color: #3498db;
}
```

Apply custom theme in frontmatter:
```yaml
---
marp: true
theme: custom-theme
---
```

## Development Workflow

1. Edit slide files in `slides/` directory
2. Use `npm run dev` for live preview
3. Make changes and see updates automatically
4. Export final version with `npm run export:pdf`

## Makefile Commands

Alternative commands using Make:

```bash
make build      # Build slides
make dev        # Start development server
make pdf        # Export to PDF
make html       # Export to HTML
make watch      # Watch for changes
make clean      # Remove generated files
make deploy     # Deploy slides to server
```

## Tips

- Use `---` to separate slides
- Frontmatter controls global settings
- Images should be in `assets/` directory
- Custom themes extend built-in themes
- PDF export requires Chrome/Chromium

## Troubleshooting

- **PDF export fails**: Ensure Chrome/Chromium is installed
- **Server not starting**: Check if port 8080 is available
- **Styles not applying**: Verify theme file paths
- **Images not loading**: Check relative paths from slides directory

## Contributing

1. Follow the file structure conventions
2. Use numbered prefixes for slide files
3. Test builds before committing
4. Keep commit messages lowercase and descriptive

## License

This project is licensed under [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/).

This project uses Marp which is MIT licensed.