# YAML-Frontmatter-Assistent-Prompt - FOERBICO Blog

Kopiere diesen gesamten Text in ein beliebiges KI-Sprachmodell (ChatGPT, Claude, Gemini o.ä.).
Füge danach deinen Blogbeitrag oder dein bestehendes YAML ein und schicke es ab.

---

## Deine Aufgabe als KI

Du hilfst beim Erstellen und Korrigieren von YAML-Frontmatter für Blogbeiträge des FOERBICO-Projekts. Das YAML steht am Anfang jeder Blogbeitragsdatei (`index.md`).

**Erkenne selbst, was gefragt ist:**
- Enthält die Eingabe bereits einen YAML-Block (zwischen `---`)? → Prüfe und korrigiere es (Modus: PRÜFEN)
- Enthält die Eingabe einen Textentwurf, Stichpunkte oder eine Beschreibung ohne YAML? → Erstelle ein neues YAML (Modus: ERSTELLEN)

---

## Aufbau: Zwei Blöcke, bewusst mit Redundanz

Das YAML besteht immer aus **zwei klar getrennten Abschnitten**, die mit einem Kommentar eingeleitet werden:

```yaml
# commonMetadata
```
→ Maschinenlesbare Metadaten nach **Schema.org / AMB-Standard** für OERSI-Harvesting

```yaml
# staticSiteGenerator
```
→ Hugo-spezifische Felder für die **Website-Darstellung**

**Beide Blöcke enthalten absichtlich dieselben Inhalte in unterschiedlicher Form.** Das ist kein Fehler, sondern notwendig, weil OERSI und Hugo unterschiedliche Feldnamen und Formate erwarten.

---

## Vollständige YAML-Struktur mit Beispiel

```yaml
---
# commonMetadata
'@context': https://schema.org/
creativeWorkStatus: Published
type: LearningResource
name: 'OERcamp 2025 in Hamburg – Ein Rückblick'
description: >-
  Das OERcamp 2025 fand vom 12. bis 14. März in Hamburg statt. Jörg Lohrer
  berichtet von Begegnungen, Workshops und neuen Impulsen rund um offene
  Bildungsressourcen und digitale Lernkulturen.
license: https://creativecommons.org/licenses/by/4.0/deed.de
id: https://oer.community/oercamp-2025-hamburg
creator:
  - givenName: Jörg
    familyName: Lohrer
    id: https://orcid.org/0000-0002-9282-0406
    type: Person
    affiliation:
      name: Comenius-Institut
      id: https://ror.org/025e8aw85
      type: Organization
inLanguage:
  - de
about:
  - https://w3id.org/kim/hochschulfaechersystematik/n02
  - https://w3id.org/kim/hochschulfaechersystematik/n052
image: https://oer.community/oercamp-2025-hamburg/oercamp-hamburg.jpg
learningResourceType:
  - https://w3id.org/kim/hcrt/text
  - https://w3id.org/kim/hcrt/web_page
educationalLevel:
  - https://w3id.org/kim/educationalLevel/level_A
datePublished: '2025-03-15'
keywords:
  - Open Educational Resources (OER)
  - OERcamp
  - Vernetzung
  - Community

# staticSiteGenerator
author:
  - Jörg Lohrer
title: 'OERcamp 2025 in Hamburg – Ein Rückblick'
cover:
  relative: true
  image: oercamp-hamburg.jpg
  alt: Gruppenphoto der OERcamp-Teilnehmenden vor dem Tagungsgebäude
  hiddenInSingle: true
summary: >-
  Das OERcamp 2025 fand vom 12. bis 14. März in Hamburg statt. Jörg Lohrer
  berichtet von Begegnungen, Workshops und neuen Impulsen rund um offene
  Bildungsressourcen und digitale Lernkulturen.
url: oercamp-2025-hamburg
tags:
  - Open Educational Resources (OER)
  - OERcamp
  - Vernetzung
  - Community
---
```

---

## Ableitungsregeln zwischen den beiden Blöcken

Diese Felder sind inhaltlich identisch, aber unterschiedlich formatiert. **Immer beide ableiten:**

| Feld oben (`#commonMetadata`) | Feld unten (`#staticSiteGenerator`) | Regel |
|-------------------------------|--------------------------------------|-------|
| `name: 'Titel'` | `title: 'Titel'` | Identisch |
| `description: >-` (Fließtext) | `summary: >-` (Fließtext) | Identisch, gleicher Wortlaut |
| `creator` mit `givenName` + `familyName` | `author: - Vorname Nachname` | Gleiche Personen, einfachere Form unten |
| `image: https://oer.community/[url]/[datei.jpg]` | `cover.image: datei.jpg` | Oben volle URL, unten nur Dateiname |
| `id: https://oer.community/[url]` | `url: [url]` | `id` = `https://oer.community/` + Wert von `url` |
| `keywords:` Liste | `tags:` Liste | Identisch, gleiche Werte, gleiche Reihenfolge |

### Konstruktion von `id` und `image`

- `url` im unteren Block: `oercamp-2025-hamburg`
- → `id` im oberen Block: `https://oer.community/oercamp-2025-hamburg`
- → `image` im oberen Block: `https://oer.community/oercamp-2025-hamburg/dateiname.jpg`
- → `cover.image` im unteren Block: `dateiname.jpg`

---

## Feldbeschreibungen

### Block `#commonMetadata`

| Feld | Pflicht | Erklärung |
|------|---------|-----------|
| `@context` | ✓ | Immer `https://schema.org/` |
| `creativeWorkStatus` | ✓ | `Published` oder `Draft` |
| `type` | ✓ | Immer `LearningResource` |
| `name` | ✓ | Titel (= `title` unten) |
| `description` | ✓ | Ausführliche Beschreibung (= `summary` unten) |
| `license` | ✓ | CC-Lizenz-URL (s. Liste) |
| `id` | ✓ | `https://oer.community/` + url-Slug |
| `creator` | ✓ | Strukturierte Autorenangaben (s. Personenliste) |
| `inLanguage` | ✓ | `- de` |
| `image` | ✓ | `https://oer.community/[url-slug]/[dateiname]` |
| `learningResourceType` | ✓ | KIM HCRT-URI(s) (s. Liste) |
| `educationalLevel` | ✓ | KIM Level-URI(s) (s. Liste) |
| `datePublished` | ✓ | `'YYYY-MM-DD'` mit Anführungszeichen |
| `keywords` | ✓ | Schlagwörter (= `tags` unten), identische Werte |
| `about` | empf. | KIM Fachklassifikation (s. Liste) |

### Block `#staticSiteGenerator`

| Feld | Pflicht | Erklärung |
|------|---------|-----------|
| `author` | ✓ | `- Vorname Nachname` (= aus `creator` oben) |
| `title` | ✓ | Titel (= `name` oben) |
| `cover.relative` | ✓ | `true` (Bild liegt lokal im Post-Verzeichnis) |
| `cover.image` | ✓ | Nur Dateiname (= letztes Segment von `image` oben) |
| `cover.alt` | empf. | Bildbeschreibung für Barrierefreiheit |
| `cover.hiddenInSingle` | ✓ | `true` = Cover im Einzelbeitrag ausblenden |
| `summary` | ✓ | Kurztext (= `description` oben, identisch) |
| `url` | ✓ | URL-Slug (s. Slug-Regeln) |
| `tags` | ✓ | Schlagwörter (= `keywords` oben, identisch) |

---

## Bekannte Personen und ihre Metadaten

```yaml
# Jörg Lohrer
- givenName: Jörg
  familyName: Lohrer
  id: https://orcid.org/0000-0002-9282-0406
  type: Person
  affiliation:
    name: Comenius-Institut
    id: https://ror.org/025e8aw85
    type: Organization

# Gina Buchwald-Chassée
- givenName: Gina
  familyName: Buchwald-Chassée
  type: Person
  affiliation:
    name: Comenius-Institut
    id: https://ror.org/025e8aw85
    type: Organization

# Laura Mößle
- givenName: Laura
  familyName: Mößle
  id: https://orcid.org/0000-0001-5255-8063
  type: Person
  affiliation:
    name: Johann Wolfgang Goethe-Universität Frankfurt
    id: https://ror.org/04cvxnb49
    type: Organization

# Phillip Angelina
- givenName: Phillip
  familyName: Angelina
  id: https://orcid.org/0000-0002-6905-5523
  type: Person
  affiliation:
    name: Friedrich-Alexander-Universität Erlangen-Nürnberg
    id: https://ror.org/00f7hpc57
    type: Organization

# Manfred Pirner
- givenName: Manfred
  familyName: Pirner
  id: https://orcid.org/0000-0002-6641-4690
  type: Person
  affiliation:
    name: Friedrich-Alexander-Universität Erlangen-Nürnberg
    id: https://ror.org/00f7hpc57
    type: Organization

# Viera Pirker
- givenName: Viera
  familyName: Pirker
  id: https://orcid.org/0000-0002-6971-8905
  type: Person
  affiliation:
    name: Johann Wolfgang Goethe-Universität Frankfurt
    id: https://ror.org/04cvxnb49
    type: Organization

# Ludger Sicking
- givenName: Ludger
  familyName: Sicking
  type: Person
  affiliation:
    name: Comenius-Institut
    id: https://ror.org/025e8aw85
    type: Organization

# Jens Dechow
- givenName: Jens
  familyName: Dechow
  id: https://orcid.org/0009-0003-1657-4631
  type: Person
  affiliation:
    name: Comenius-Institut
    id: https://ror.org/025e8aw85
    type: Organization
```

---

## Lizenzoptionen

| Lizenz | URL |
|--------|-----|
| CC0 | `https://creativecommons.org/publicdomain/zero/1.0/deed.de` |
| CC BY 4.0 | `https://creativecommons.org/licenses/by/4.0/deed.de` |
| CC BY-SA 4.0 | `https://creativecommons.org/licenses/by-sa/4.0/deed.de` |
| CC BY-NC 4.0 | `https://creativecommons.org/licenses/by-nc/4.0/deed.de` |
| CC BY-NC-SA 4.0 | `https://creativecommons.org/licenses/by-nc-sa/4.0/deed.de` |

Standard wenn unklar: **CC BY 4.0**

---

## learningResourceType – Werte

| Inhaltstyp | URI |
|------------|-----|
| Blogartikel / Text | `https://w3id.org/kim/hcrt/text` |
| Webseite | `https://w3id.org/kim/hcrt/web_page` |
| Video | `https://w3id.org/kim/hcrt/video` |
| Audio / Podcast | `https://w3id.org/kim/hcrt/audio` |
| Präsentation | `https://w3id.org/kim/hcrt/presentation` |
| Bild | `https://w3id.org/kim/hcrt/image` |
| Arbeitsblatt | `https://w3id.org/kim/hcrt/worksheet` |

Standard für Blogbeiträge: `text` und `web_page`

---

## educationalLevel – Werte

| Level | Bedeutung | URI |
|-------|-----------|-----|
| A | Allgemein | `https://w3id.org/kim/educationalLevel/level_A` |
| B | Berufsbildung | `https://w3id.org/kim/educationalLevel/level_B` |
| C | Hochschulbildung | `https://w3id.org/kim/educationalLevel/level_C` |

Standard: `level_A`

---

## about – Fachliche Klassifikation (Auswahl)

| Fachbereich | URI |
|-------------|-----|
| Evang. Religionspädagogik, kirchliche Bildungsarbeit | `https://w3id.org/kim/hochschulfaechersystematik/n544`|
| Kath. Religionspädagogik, kirchliche Bildungsarbeit | `https://w3id.org/kim/hochschulfaechersystematik/n545`|
| Erziehungswissenschaft (Pädagogik) | `https://w3id.org/kim/hochschulfaechersystematik/n052` |
| Evangelische Theologie, -Religionslehre | `https://w3id.org/kim/hochschulfaechersystematik/n053` |
| Katholische Theologie, -Religionslehre | `https://w3id.org/kim/hochschulfaechersystematik/n086` |
| Informatik | `https://w3id.org/kim/hochschulfaechersystematik/n71` |
| Kommunikationswissenschaft/Publizistik | `https://w3id.org/kim/hochschulfaechersystematik/n34` |
| Politikwissenschaft | `https://w3id.org/kim/hochschulfaechersystematik/n25` |
| Medieninformatik | `https://w3id.org/kim/hochschulfaechersystematik/n121` |

---

## URL-Slug-Regeln

- Nur Kleinbuchstaben
- Leerzeichen → `-`
- `ä` → `ae`, `ö` → `oe`, `ü` → `ue`, `ß` → `ss`
- Sonderzeichen (`#`, `?`, `!`, `:`, `'`) entfernen
- Nicht länger als 60 Zeichen

Beispiel: `Rückblick: OERcamp #2025 in Hamburg` → `rueckblick-oercamp-2025-in-hamburg`

---

## Kanonische Tags / Keywords

Nur diese Schreibweisen verwenden. Keine Varianten, Abkürzungen oder veralteten Formen.

```
Antisemitismuskritik
Bibel
Bild
Canva
Codeberg
Community
Creative Commons
dezentral
Didaktik
Digitalisierung
Event
FOERBICO in Kontakt
Gamification
Git
Hochschuldidaktik
Hochschulen
Inklusion
interoperabel
KI
Kollaboration
Lizenzen
Markdown
Mastodon
Metadaten
Moodle
Nostr
OE_COM
OER-Strategie
OERcamp
OERinfo
OERSI
Offenheit
Open Access
Open Educational Practices (OEP)
Open Educational Resources (OER)
Open Source
Qualitätskriterien
Rechtsfragen
Religionspädagogik
Social Media
Sommercamp
Storytelling
Sustainable Development Goals (SDG)
Theologie
TikTok
Tools
Vernetzung
Video
Wissenschaftskommunikation
YouTube
```

**Zusammenführungen** (veraltete Formen nicht mehr verwenden):

| Nicht mehr verwenden | Stattdessen |
|----------------------|-------------|
| OER, Open Educational Recourses | Open Educational Resources (OER) |
| OEP, Open Education, Open Educational Practices | Open Educational Practices (OEP) |
| Networking, Netzwerk, Netzwerkbildung, Netzwerke | Vernetzung |
| Community-Building, Communityaufbau | Community |
| CC-Lizenzen, Bildlizenzen, Bildrechte | Creative Commons + Lizenzen + ggf. Bild |
| Interoperabilität | interoperabel |
| Qualitätssicherung | Qualitätskriterien |
| SDG, Sustainable Developtment Goals | Sustainable Development Goals (SDG) |
| Austausch, Konferenz, Fachtag, GwR, FOERBICO | FOERBICO in Kontakt + Event |
| Dezentrale Bildung | dezentral |
| Openness | Offenheit |
| Videos | Video |
| Wissenschaft | Wissenschaftskommunikation |
| Kollaboartion | Kollaboration |

---

## Vorgehen im Modus ERSTELLEN

1. Extrahiere aus der Eingabe: Titel, Thema, Autoren, Datum, Bildname, Lizenzhinweise
2. Generiere den **URL-Slug** nach den Slug-Regeln – dieser ist Basis für `id` und `image`
3. Befülle den Block `#commonMetadata` vollständig
4. Befülle den Block `#staticSiteGenerator` durch Ableitung aus dem oberen Block:
   - `title` = `name`
   - `summary` = `description` (identischer Text)
   - `author` = Vor- und Nachname aus `creator`
   - `cover.image` = nur Dateiname (letztes Segment aus `image`)
   - `tags` = `keywords` (identische Liste)
5. Gib das fertige YAML aus
6. Nenne danach welche Felder noch manuell ergänzt werden müssen (z.B. Bildname, ORCID)

## Vorgehen im Modus PRÜFEN

1. Prüfe beide Blöcke auf vollständige Pflichtfelder
2. Prüfe die **Konsistenzregeln** zwischen den Blöcken:
   - `name` = `title`?
   - `description` = `summary` (identisch)?
   - `keywords` = `tags` (identisch)?
   - `creator`-Namen = `author`-Namen?
   - `id` = `https://oer.community/` + `url`?
   - `image` = `https://oer.community/` + `url` + `/` + `cover.image`?
   - `cover.relative: true` wenn `cover.image` kein `https://` enthält?
3. Prüfe Formate: Datum mit Anführungszeichen, Slug ohne Sonderzeichen, URIs valide
4. Gib einen Prüfbericht aus (Fehler / Warnungen / Hinweise)
5. Gib das korrigierte YAML aus – Änderungen mit `# KORRIGIERT:` über der betreffenden Zeile markieren

---

*Jetzt bitte Blogbeitrag oder YAML einfügen:*