3.10. Metadaten#
Achtung: Baustelle
Die hier beschriebenen Inhalte werden aktiv überarbeitet!
In diesem Kapitel wird Ihnen zuerst das Metadatenschema für QUADRIGA-OERs vorgestellt. Anschließend wird präsentiert, wie dieses in der Datei metadata.yml konkret umgesetzt wird. Zum Abschluss werden die tatsächlichen Metadaten der vorliegenden OER präsentiert.
3.10.1. Das QUADRIGA Metadatenschema#
Das QUADRIGA Metadatenschema basiert in Teilen auf DALIA[1] sowie weiteren etablierten Metadatenstandards. Es wurde speziell für Open Educational Resources (OERs) entwickelt, die im Rahmen des QUADRIGA-Projekts erstellt werden und umfasst spezifische Felder zur Beschreibung von Lernzielen, Kompetenzen und didaktischen Elementen.
3.10.2. Struktur und Felder der metadata.yml#
Für die technische Umsetzung des Metadatenschemas wurde YAML[2] gewählt, da es durch OER-Autor:innen einfach geschrieben und gleichzeitig gut automatisch verarbeitet werden kann.
Die Metadaten können theoretisch auch in anderen YAML-Dateien als eigenständiges YAML-Dokument eingebettet werden, jedoch empfehlen wir die Nutzung einer eigenständigen Datei. Komplexere Funktionalitäten von YAML wie Referenzen und Tags werden nicht genutzt.
Eine Metadatenbeschreibung nach dem QUADRIGA Metadatenschema wird als valide betrachtet, wenn sie mindestens alle Pflichtfelder beinhaltet und technisch korrekt umgesetzt wurde. Das Metadatenschema ist in JSON-Schema[3] implementiert.
Im Abschnitt Felder werden alle optionalen sowie verpflichtenden Felder präsentiert. Dabei wird jeweils angegeben, ob sie verpflichtend sind sowie welche Datentypen als Wert zugelassen sind.
Struktur#
Eine minimal kleine valide Metadatenbeschreibung sieht strukturell wie folgt aus:
schema-version:
book-version:
title:
description:
introduction:
table-of-contents:
discipline:
duration:
type-of-research-object:
identifier:
url:
date-of-last-change:
publication-date:
target-group:
authors:
- given-names:
family-names:
chapters:
- title:
description:
learning-objectives:
- learning-objective:
competency:
focus:
data-flow:
blooms-category:
learning-goal:
context-of-creation:
Eine minimale Metadatendatei als Startpunkt finden Sie auch im Repositorium zum QUADRIGA-Metadaten-Schema.
Felder#
Im Folgenden werden die wichtigsten Felder des QUADRIGA-Metadatenschemas beschrieben. Pflichtfelder sind mit ⭐ gekennzeichnet. Nutzen Sie auch die interaktive Darstellung des Schemas.
schema-version⭐#
Versionsnummer des QUADRIGA-Metadatenschemas. Es gibt ein kontrolliertes Vokabular möglicher Versionen (aktuell: “1.0.0-alpha”). Wird das QUADRIGA-Metadatenschema verändert/erweitert, so wird eine neue Version definiert.
book-version⭐#
Version des Buchs im SemVer[4]-Format. Eine Versionsänderung korrespondiert auch immer mit einer Änderung von date-of-last-change⭐.
title⭐#
Titel der OER.
description⭐#
Beschreibung der OER. Enthält die verpflichtenden Unterfelder Einleitung (introduction) und Inhaltsverzeichnis (table-of-contents).
discipline⭐#
Nennung der Disziplinen, die bei der Erstellung der OER im Fokus standen. Mögliche Disziplinen sind in einem kontrollierten Vokabular definiert.
duration⭐#
Angedachte Bearbeitungsdauer für Lernende.
type-of-research-object⭐#
Nennung des Datentyps, der vorrangig in der OER behandelt wird. Es können ein bis zwei Typen aus einem kontrollierten Vokabular ausgewählt werden.
identifier⭐#
Eindeutiger Identifier in Form einer DOI. Die DOI identifiziert das gesamte Buch.
url⭐#
URL der Website-Ansicht des Buchs.
git#
Git-Repositorium, in dem die OER-Inhalte zu finden sind.
has-predecessor#
Link zur Vorgänger-OER oder false. Verweis auf eine Vorgänger-OER, in der z.B. vorausgesetzte Inhalte erklärt werden.
has-successor#
Link zur Nachfolger-OER oder false. Verweis auf eine Nachfolger-OER, in der z.B. Inhalte aus der aktuellen OER weiterentwickelt werden.
date-of-last-change⭐#
Datum der letzten (großen, inhaltlich umfangreichen) Änderung. Sollte immer mit einer Versionsänderung (book-version⭐) einhergehen.
publication-date⭐#
Datum der Erstveröffentlichung.
target-group⭐#
Zielgruppe des Buchs. Es können eine oder mehrere Zielgruppen aus einem kontrollierten Vokabular ausgewählt werden.
chapters⭐#
Liste der Kapitel des Buchs. Jedes Kapitel enthält einen Titel (title⭐ (in chapters)), eine Beschreibung (description⭐ (in chapters)), eine Liste von Lernzielen (learning-objectives⭐ (in chapters)) und ein Groblernziel (learning-goal⭐ (in chapters)). Optional können auch eine URL zum direkten Zugriff auf die Kapitelseite und eine Bearbeitungsdauer angegeben werden.
learning-objectives⭐ (in chapters)#
Eine Liste von Lernzielen. Jedes Lernziel umfasst eine Formulierung des Lernziels (learning-objective), die adressierte Kompetenz (competency⭐ (in learning-objectives)), einen Kompetenz-Fokus (focus⭐ (in learning-objectives)), eine Einordnung im Datenfluss (data-flow⭐ (in learning-objectives)) und eine Kategorie aus der Bloomschen Taxonomie (blooms-category).
learning-goal⭐ (in chapters)#
Kurze Benennung des Groblernziels des Kapitels.
context-of-creation⭐#
Eine Beschreibung des Entstehungskontextes. Im konkreten Fall ein natürlichsprachlicher Verweis auf das QUADRIGA-Projekt.
keywords#
Liste von Schlag-/Stichwörtern, welche das Buch und dessen (Lern-)Inhalte beschreiben.
language#
Sprache der OER als ISO639-1 Sprachcode.
license#
Lizenz des Buchs und des Codes jeweils als URL oder als Kombination aus Lizenzname und URL. Mindestens die Informationen zur Lizenz des Inhalts (content) sind erforderlich, optional können auch Angaben zur Lizenz des Codes (code) gemacht werden.
prerequisites#
Liste von Voraussetzungen und deren jeweiliger Einordnung in der Bloomschen Taxonomie, welche Lernende für die erfolgreiche Bearbeitung des Buchs mitbringen sollten.
quality-assurance#
Eine Liste von Qualitätssicherungs-Ereignissen. Jedes Ereignis enthält eine Person, ein Datum und optional eine Beschreibung der durchgeführten Qualitätssicherungsmaßnahme.
supplemented-by#
Liste von Verweisen und jeweils einer kurzen Beschreibung zu zusätzlichen, weiterführenden Inhalten o.ä., die in einem Kapitel verwendet werden. Jeder Eintrag enthält eine Beschreibung (description) und eine URL (url).
type-of-learning-resource#
Beschreibung der Materialart der OER. Aktuell ist nur “Jupyter Book” als Wert vorgesehen.
used-tools#
Liste von Tools, die bei der Erstellung des Buchs verwendet wurden. Diese können als einfache URI oder als strukturierte Angabe mit Namen und URL angegeben werden.
data-flow⭐ (in learning-objectives)#
Schritt im Datenfluss, dem die Kompetenz zugeordnet ist. Muss aus einem kontrollierten Vokabular ausgewählt werden: “Grundlagen”, “Planung”, “Erhebung und Aufbereitung”, “Management”, “Analyse” sowie “Publikation und Nachnutzung”.
competency⭐ (in learning-objectives)#
Im Lernziel adressierte Kompetenz nach dem QUADRIGA Datenkompetenzframework. Muss aus einem kontrollierten Vokabular ausgewählt werden.
blooms-category⭐ (in learning-objectives)#
Kategorie der Bloomschen Taxonomie, welcher das Lernziel zugeordnet ist. Aus der Kombination der Zuordnungen der Lernziele eines Kapitels lässt sich ein allgemeines Kompetenzniveau (“Basis”, “Fortgeschritten”, “Expert:in”) ableiten. Muss aus einem kontrollierten Vokabular ausgewählt werden.
focus⭐ (in learning-objectives)#
Fokus des Lernziels auf den Aspekt “Wissen”, “Fähigkeit” oder “Haltung” der Kompetenz.
semver#
Ein Bezeichner nach dem Semantic Versioning 2.0.0 Format[4]. Wird bei der Versionierung des Schemas und der OER verwendet. Besteht aus Major-, Minor- und Patch-Version (z.B. “1.1.0”), optional gefolgt von Pre-Release-Identifikatoren und Build-Metadaten.
multilingual-text#
Natürlichsprachlicher Text wird standardmäßig auf Deutsch verfasst. Soll dies explizit gemacht werden und/oder sollen andere Sprachen verwendet werden, so kann hier statt einer Zeichenkette (string) ein Mapping (object) von ISO639-1 Sprachcodes und dem Text in der entsprechenden Sprache verwendet werden.
person#
Eine Person kann entweder als einfache Zeichenkette oder als Mapping, das mindestens Schlüssel für Vor- und Nachname (given-names, family-names) enthält modelliert werden.
Es wird empfohlen eine ORCID[5] anzugeben. Zusätzlich können Rollen nach dem CRediT-System (Contributor Roles Taxonomy) für die Person angegeben werden.
title⭐ (in chapters)#
Kapitelüberschrift, die für dieses Kapitel verwendet wird. Kann als einfacher Text oder als mehrsprachiger Text angegeben werden.
description⭐ (in chapters)#
Beschreibung des Kapitelinhalts. Bietet eine Übersicht darüber, was in diesem Kapitel behandelt wird.
url (in chapters)#
URL zum direkten Zugriff auf die erste Seite der ‘Leseansicht’ (Website) des Kapitels.
duration (in chapters)#
Angedachte Bearbeitungsdauer für Lernende, spezifisch für dieses Kapitel.
3.10.3. metadata.yml der vorliegenden OER#
1# yaml-language-server: $schema=https://quadriga-dk.github.io/quadriga-schema/v1.0.0-beta/schema.json
2schema-version: 1.0.0-beta
3book-version: 0.57.0
4title: 'QUADRIGA OERs: erstellen und gestalten mit Jupyter Book. QUADRIGA Open Educational
5 Resources: Template'
6identifier: https://doi.org/10.5281/zenodo.14970672
7authors:
8- given-names: Hannes
9 family-names: Schnaitter
10 orcid: https://orcid.org/0000-0002-1602-6032
11 affiliation: Humboldt-Universität zu Berlin, Institut für Bibliotheks- und Informationswissenschaft
12 credit:
13 - Writing
14 - Software
15- given-names: Evgenia
16 family-names: Samoilova
17 orcid: https://orcid.org/0000-0003-3858-901X
18 affiliation: Universität Potsdam
19 credit:
20 - Writing
21- given-names: Lamia
22 family-names: Islam
23 affiliation: Universität Potsdam
24 credit:
25 - Software
26contributors:
27- Zhang, Yue
28table-of-contents: '- Präambel
29
30 - Struktur und didaktisches Konzept
31
32 - Technologie
33
34 - Formatierungs- und Darstellungsmöglichkeiten
35
36 - Lernstandskontrolle (Assessment)
37
38 - Reflexion und Resümee
39
40 - Epilog'
41description: Diese OER führt in die Erstellung von QUADRIGA-OERs ein, bietet Inhalte
42 für Nutzer:innen der OERs und dient gleichzeitig als Template für die Erstellung
43 eigener OERs auf Basis der QUADRIGA-Empfehlungen.
44discipline:
45- übergreifend
46research-object-type:
47- übergreifend
48chapters:
49- title: Präambel
50 url: https://quadriga-dk.github.io/Book_Template/präambel/toc.html
51 description: Präambel des Templates. Gibt grundlegende Informationen zu Lernzielen,
52 Voraussetzungen und Vorkenntnissen.
53 learning-goal: Überblick über Template
54 duration: 15min
55 learning-objectives:
56 - learning-objective: Verständnis der Lernziele des Templates
57 competency: 1 Basiskompetenz
58 data-flow: Grundlagen
59 focus: Wissen
60 blooms-category: 1 Erinnern
61- title: Struktur und didaktisches Konzept
62 url: https://quadriga-dk.github.io/Book_Template/struktur_didaktisches_konzept/einleitung.html
63 description: Dieses Kapitel stellt die Struktur des Templates und das zugrunde liegende
64 didaktische Konzept vor.
65 duration: 1h
66 learning-goal: Fallstudienbasiertes didaktisches Konzept von QUADRIGA
67 learning-objectives:
68 - learning-objective: Der forschungsgeleitete Ansatz der QUADRIGA OERs kann erläutert
69 und der Beitrag von Fallstudien zur Datenkompetenzvermittlung erklärt werden.
70 competency: 1 Basiskompetenz
71 focus: Wissen
72 data-flow: Grundlagen
73 blooms-category: 1 Erinnern
74 - learning-objective: Die hierarchische Struktur der Lernziele in QUADRIGA OERs
75 kann beschrieben und der Zusammenhang zwischen Fallstudienstruktur, Datenlebenszyklus
76 und Lernzielen erläutert werden.
77 competency: 1 Basiskompetenz
78 focus: Wissen
79 data-flow: Grundlagen
80 blooms-category: 1 Erinnern
81 - learning-objective: Die zentralen didaktischen Komponenten einer QUADRIGA OER
82 können identifiziert und deren Funktion im Lernprozess erklärt werden.
83 competency: 1 Basiskompetenz
84 focus: Wissen
85 data-flow: Grundlagen
86 blooms-category: 1 Erinnern
87- title: Technologie
88 url: https://quadriga-dk.github.io/Book_Template/technologie/einleitung.html
89 description: Es werden die verschiedenen Bestandteile des Templates sowie die Technologien,
90 welche genutzt werden, vorgestellt. Besonderes Augenmerk liegt auf dem Zusammenspiel
91 der einzelnen Elemente.
92 duration: 1h
93 learning-goal: Technische Umsetzung der QUADRIGA OERs
94 learning-objectives:
95 - learning-objective: Die Bestandteile der Entwicklungsumgebung (Git, Python, Jupyter
96 Book, Editor) können identifiziert und deren Funktionen im OER-Entwicklungsprozess
97 erläutert werden.
98 competency: 1 Basiskompetenz
99 focus: Wissen
100 data-flow: Grundlagen
101 blooms-category: 1 Erinnern
102 - learning-objective: Der Unterschied zwischen Jupyter Book und Jupyter Notebook
103 kann erklärt und deren jeweilige Rolle im Entwicklungsworkflow beschrieben werden.
104 competency: 1 Basiskompetenz
105 focus: Wissen
106 data-flow: Grundlagen
107 blooms-category: 1 Erinnern
108 - learning-objective: Die automatische Website-Erstellung über GitHub Actions kann
109 erklärt und der Vorteil gegenüber manueller lokaler Entwicklung bewertet werden.
110 competency: 1 Basiskompetenz
111 focus: Wissen
112 data-flow: Grundlagen
113 blooms-category: 1 Erinnern
114 - learning-objective: Die Installation und Einrichtung einer lokalen Entwicklungsumgebung
115 mit Python/Anaconda kann durchgeführt und Virtual Environments für projektspezifische
116 Anforderungen erstellt werden.
117 competency: 1 Basiskompetenz
118 focus: Wissen
119 data-flow: Grundlagen
120 blooms-category: 1 Erinnern
121 - learning-objective: Der Unterschied zwischen Texteditoren und Textprozessoren
122 für die Code-Entwicklung kann erklärt und geeignete Editoren wie VS Code für
123 die OER-Entwicklung ausgewählt werden.
124 competency: 1 Basiskompetenz
125 focus: Wissen
126 data-flow: Grundlagen
127 blooms-category: 1 Erinnern
128- title: Formatierungs- und Darstellungsmöglichkeiten
129 url: https://quadriga-dk.github.io/Book_Template/formatierung/einleitung.html
130 duration: 1h
131 description: Spezifische Ausführungen und Anleitungen zu Markdown- und Jupyter-Noteboook-Dateien
132 und Formatierungsmöglichkeiten. Empfehlungen für deren einheitliche Nutzung in
133 QUADRIGA OERs.
134 learning-goal: Schreiben und Formatieren von Inhalten nach den Empfehlungen von
135 QUADRIGA
136 learning-objectives:
137 - learning-objective: Kenntnis, Auswahl und Nutzung verschiedener möglicher Dateiformate
138 und Programmiersprachen
139 competency: 1 Basiskompetenz
140 focus: Wissen
141 data-flow: Grundlagen
142 blooms-category: 1 Erinnern
143 - learning-objective: Kenntnis, Auswahl und Nutzung spezifischer Auszeichungs- und
144 Formatierungsoptionen
145 competency: 1 Basiskompetenz
146 focus: Wissen
147 data-flow: Grundlagen
148 blooms-category: 1 Erinnern
149- title: Lernstandskontrolle (Assessment)
150 url: https://quadriga-dk.github.io/Book_Template/assessment/toc.html
151 description: Assessment-Konzept und dessen konkrete Ausgestaltung in Jupyter Books,
152 die den QUADRIGA-Empfehlungen folgen
153 learning-goal: Gestaltung und Implementierung von Assessments
154 duration: 1h
155 learning-objectives:
156 - learning-objective: Verständnis des Assessmentkonzepts von QUADRIGA
157 competency: 1 Basiskompetenz
158 focus: Wissen
159 data-flow: Grundlagen
160 blooms-category: 1 Erinnern
161 - learning-objective: Auswahl und Implementierung spezifischer Assessment-Formate
162 competency: 1 Basiskompetenz
163 focus: Wissen
164 data-flow: Grundlagen
165 blooms-category: 1 Erinnern
166- title: Reflexion und Resümee
167 url: https://quadriga-dk.github.io/Book_Template/reflexion_und_resümee/toc.html
168 description: Zusammenfassung und Wiederholung der wichtigsten Inhalte des Buchs.
169 Hinweise auf weiterführende Inhalte.
170 learning-goal: Festigung der erlernten Inhalte
171 duration: 1h
172 learning-objectives:
173 - learning-objective: Kenntnis der wichtigsten Inhalte des Templates und dessen
174 Nutzung
175 competency: 1 Basiskompetenz
176 focus: Wissen
177 data-flow: Grundlagen
178 blooms-category: 1 Erinnern
179target-group:
180- Forschende (PostDoc)
181- Forschende (Projektleitung)
182- Promovierende
183- Hochschullehrende
184duration: 10h
185date-published: '2024-05-06'
186date-modified: '2025-07-04'
187context-of-creation: 'Die vorliegenden Open Educational Resources wurden durch das
188 Datenkompetenzzentrum QUADRIGA erstellt.
189
190 Förderkennzeichen: 16DKZ2034'
191url: https://quadriga-dk.github.io/Book_Template/
192git: https://github.com/quadriga-dk/Book_Template
193license:
194 code: https://opensource.org/licenses/AGPL-3.0
195 content:
196 url: https://creativecommons.org/licenses/by-sa/4.0/
197 name: CC BY-SA 4.0
3.10.4. JSON-Schema[3]#
Das JSON-Schema ist definiert im Repositorium quadriga-schema. Auf Basis dieses Repositoriums wird eine interaktive Darstellung sowie der Einstieg für die Nutzung in anderen Schemas oder in Verifikationstools (schema.json) generiert.