3.7. 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.7.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.7.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. Das gesamte JSON-Schema der Metadaten ist am Ende der Seite einzusehen
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:
Felder#
Im Folgenden werden die wichtigsten Felder des QUADRIGA-Metadatenschemas beschrieben. Pflichtfelder sind mit ⭐ gekennzeichnet.
schema-version⭐#
Versionsnummer des QUADRIGA-Metadatenschemas. Es gibt ein kontrolliertes Vokabular möglicher Versionen (aktuell: “1.1”, “1.1-beta”, “1.1-beta2”). Wird das QUADRIGA-Metadatenschema verändert/erweitert, so wird eine neue Version in das kontrollierte Vokabular aufgenommen.
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.7.3. metadata.yml der vorliegenden OER#
1# yaml-language-server: $schema=quadriga-schema.json
2schema-version: 1.1-beta2
3book-version: 0.55.1
4title: 'QUADRIGA OERs: erstellen und gestalten mit Jupyter Book. QUADRIGA Open Educational
5 Resources: Template'
6description:
7 introduction: Diese OER führt in die Erstellung von QUADRIGA-OERs ein, bietet Inhalte
8 für Nutzer:innen der OERs und dient gleichzeitig als Template für die Erstellung
9 eigener OERs auf Basis der QUADRIGA-Empfehlungen.
10 table-of-contents: '- Präambel
11
12 - Struktur und didaktisches Konzept
13
14 - Technologie
15
16 - Formatierungs- und Darstellungsmöglichkeiten
17
18 - Lernstandskontrolle (Assessment)
19
20 - Reflexion und Resümee
21
22 - Epilog'
23discipline:
24- übergreifend
25duration: 10h
26type-of-research-object:
27- übergreifend
28identifier: https://doi.org/10.5281/zenodo.14970672
29url: https://quadriga-dk.github.io/Book_Template/
30git: https://github.com/quadriga-dk/Book_Template
31license:
32 code: https://opensource.org/licenses/AGPL-3.0
33 content:
34 url: https://creativecommons.org/licenses/by-sa/4.0/
35 name: CC BY-SA 4.0
36date-of-last-change: '2025-04-16'
37publication-date: 2024-05-06
38target-group:
39- Forschende (PostDoc)
40- Forschende (Projektleitung)
41- Promovierende
42- Hochschullehrende
43authors:
44- given-names: Hannes
45 family-names: Schnaitter
46 orcid: https://orcid.org/0000-0002-1602-6032
47 affiliation: Humboldt-Universität zu Berlin, Institut für Bibliotheks- und Informationswissenschaft
48 credit:
49 - Writing
50 - Software
51- given-names: Evgenia
52 family-names: Samoilova
53 orcid: https://orcid.org/0000-0003-3858-901X
54 affiliation: Universität Potsdam
55 credit:
56 - Writing
57- given-names: Lamia
58 family-names: Islam
59 affiliation: Universität Potsdam
60 credit:
61 - Software
62chapters:
63- title: Präambel
64 url: https://quadriga-dk.github.io/Book_Template/präambel/toc.html
65 description: Präambel des Templates. Gibt grundlegende Informationen zu Lernzielen,
66 Voraussetzungen und Vorkenntnissen.
67 learning-goal: Überblick über Template
68 duration: 15min
69 learning-objectives:
70 - learning-objective: Verständnis der Lernziele des Templates
71 competency: 1 Basiskompetenz
72 data-flow: Grundlagen
73 focus: Wissen
74 blooms-category: 1 Erinnern
75- title: Struktur und didaktisches Konzept
76 url: https://quadriga-dk.github.io/Book_Template/struktur_didaktisches_konzept/einleitung.html
77 description: Dieses Kapitel stellt die Struktur des Templates und das zugrunde liegende
78 didaktische Konzept vor.
79 learning-goal: Fallstudienbasiertes didaktisches Konzept von QUADRIGA
80 learning-objectives:
81 - learning-objective: Der forschungsgeleitete Ansatz der QUADRIGA OERs kann erläutert
82 und der Beitrag von Fallstudien zur Datenkompetenzvermittlung erklärt werden.
83 competency: 1 Basiskompetenz
84 focus: Wissen
85 data-flow: Grundlagen
86 blooms-category: 1 Erinnern
87 - learning-objective: Die hierarchische Struktur der Lernziele in QUADRIGA OERs
88 kann beschrieben und der Zusammenhang zwischen Fallstudienstruktur, Datenlebenszyklus
89 und Lernzielen erläutert werden.
90 competency: 1 Basiskompetenz
91 focus: Wissen
92 data-flow: Grundlagen
93 blooms-category: 1 Erinnern
94 - learning-objective: Die zentralen didaktischen Komponenten einer QUADRIGA OER
95 können identifiziert und deren Funktion im Lernprozess erklärt werden.
96 competency: 1 Basiskompetenz
97 focus: Wissen
98 data-flow: Grundlagen
99 blooms-category: 1 Erinnern
100- title: Technologie
101 url: https://quadriga-dk.github.io/Book_Template/technologie/einleitung.html
102 description: Es werden die verschiedenen Bestandteile des Templates sowie die Technologien,
103 welche genutzt werden, vorgestellt. Besonderes Augenmerk liegt auf dem Zusammenspiel
104 der einzelnen Elemente.
105 learning-goal: Technische Umsetzung der QUADRIGA OERs
106 learning-objectives:
107 - learning-objective: Die Bestandteile der Entwicklungsumgebung (Git, Python, Jupyter
108 Book, Editor) können identifiziert und deren Funktionen im OER-Entwicklungsprozess
109 erläutert werden.
110 competency: 1 Basiskompetenz
111 focus: Wissen
112 data-flow: Grundlagen
113 blooms-category: 1 Erinnern
114 - learning-objective: Der Unterschied zwischen Jupyter Book und Jupyter Notebook
115 kann erklärt und deren jeweilige Rolle im Entwicklungsworkflow beschrieben werden.
116 competency: 1 Basiskompetenz
117 focus: Wissen
118 data-flow: Grundlagen
119 blooms-category: 1 Erinnern
120 - learning-objective: Die automatische Website-Erstellung über GitHub Actions kann
121 erklärt und der Vorteil gegenüber manueller lokaler Entwicklung bewertet werden.
122 competency: 1 Basiskompetenz
123 focus: Wissen
124 data-flow: Grundlagen
125 blooms-category: 1 Erinnern
126 - learning-objective: Die Installation und Einrichtung einer lokalen Entwicklungsumgebung
127 mit Python/Anaconda kann durchgeführt und Virtual Environments für projektspezifische
128 Anforderungen erstellt werden.
129 competency: 1 Basiskompetenz
130 focus: Wissen
131 data-flow: Grundlagen
132 blooms-category: 1 Erinnern
133 - learning-objective: Der Unterschied zwischen Texteditoren und Textprozessoren
134 für die Code-Entwicklung kann erklärt und geeignete Editoren wie VS Code für
135 die OER-Entwicklung ausgewählt werden.
136 competency: 1 Basiskompetenz
137 focus: Wissen
138 data-flow: Grundlagen
139 blooms-category: 1 Erinnern
140- title: Formatierungs- und Darstellungsmöglichkeiten
141 url: https://quadriga-dk.github.io/Book_Template/formatierung/einleitung.html
142 description: Spezifische Ausführungen und Anleitungen zu Markdown- und Jupyter-Noteboook-Dateien
143 und Formatierungsmöglichkeiten. Empfehlungen für deren einheitliche Nutzung in
144 QUADRIGA OERs.
145 learning-goal: Schreiben und Formatieren von Inhalten nach den Empfehlungen von
146 QUADRIGA
147 learning-objectives:
148 - learning-objective: Kenntnis, Auswahl und Nutzung verschiedener möglicher Dateiformate
149 und Programmiersprachen
150 competency: 1 Basiskompetenz
151 focus: Wissen
152 data-flow: Grundlagen
153 blooms-category: 1 Erinnern
154 - learning-objective: Kenntnis, Auswahl und Nutzung spezifischer Auszeichungs- und
155 Formatierungsoptionen
156 competency: 1 Basiskompetenz
157 focus: Wissen
158 data-flow: Grundlagen
159 blooms-category: 1 Erinnern
160- title: Lernstandskontrolle (Assessment)
161 url: https://quadriga-dk.github.io/Book_Template/assessment/toc.html
162 description: Assessment-Konzept und dessen konkrete Ausgestaltung in Jupyter Books,
163 die den QUADRIGA-Empfehlungen folgen
164 learning-goal: Gestaltung und Implementierung von Assessments
165 learning-objectives:
166 - learning-objective: Verständnis des Assessmentkonzepts von QUADRIGA
167 competency: 1 Basiskompetenz
168 focus: Wissen
169 data-flow: Grundlagen
170 blooms-category: 1 Erinnern
171 - learning-objective: Auswahl und Implementierung spezifischer Assessment-Formate
172 competency: 1 Basiskompetenz
173 focus: Wissen
174 data-flow: Grundlagen
175 blooms-category: 1 Erinnern
176- title: Reflexion und Resümee
177 url: https://quadriga-dk.github.io/Book_Template/reflexion_und_resümee/toc.html
178 description: Zusammenfassung und Wiederholung der wichtigsten Inhalte des Buchs.
179 Hinweise auf weiterführende Inhalte.
180 learning-goal: Festigung der erlernten Inhalte
181 learning-objectives:
182 - learning-objective: Kenntnis der wichtigsten Inhalte des Templates und dessen
183 Nutzung
184 competency: 1 Basiskompetenz
185 focus: Wissen
186 data-flow: Grundlagen
187 blooms-category: 1 Erinnern
188context-of-creation: 'Die vorliegenden Open Educational Resources wurden durch das
189 Datenkompetenzzentrum QUADRIGA erstellt.
190
191 Förderkennzeichen: 16DKZ1034'
3.7.4. JSON-Schema[3]#
1{
2 "$schema": "https://json-schema.org/draft/2020-12/schema",
3 "$id": "tag:quadriga-dk.de,2025:quadriga",
4 "title": "QUADRIGA OER",
5 "description": "Ein Jupyter Book (Buch, Sammlung von OERs), das nach dem QUADRIGA-Metadatenschema beschrieben wird.",
6 "@context": {
7 "dct": "http://purl.org/dc/terms/",
8 "schema": "http://schema.org/"
9 },
10 "type": "object",
11 "required": [
12 "authors",
13 "chapters",
14 "context-of-creation",
15 "date-of-last-change",
16 "description",
17 "discipline",
18 "duration",
19 "identifier",
20 "book-version",
21 "publication-date",
22 "schema-version",
23 "target-group",
24 "title",
25 "type-of-research-object"
26 ],
27 "properties": {
28 "authors": {
29 "description": "Liste der Autor:innen des Buchs.",
30 "type": "array",
31 "minItems": 1,
32 "uniqueItems": true,
33 "items": {
34 "$ref": "#/$defs/person",
35 "@id": "dct:author"
36 }
37 },
38 "chapters": {
39 "description": "Liste der Kapitel.",
40 "type": "array",
41 "minItems": 1,
42 "uniqueItems": true,
43 "items": {
44 "type": "object",
45 "required": [
46 "title",
47 "description",
48 "learning-objectives",
49 "learning-goal"
50 ],
51 "properties": {
52 "title": {
53 "description": "Kapitelüberschrift",
54 "$ref": "#/$defs/multilingual-text"
55 },
56 "description": {
57 "description": "Beschreibung des Kapitelinhalts.",
58 "$ref": "#/$defs/multilingual-text"
59 },
60 "url": {
61 "description": "URL zum direkten Zugriff auf die erste Seite der 'Leseansicht' (Website) des Kapitel.",
62 "type": "string",
63 "format": "uri"
64 },
65 "duration": {
66 "description": "Angedachte Bearbeitungsdauer für Lernende.",
67 "type": "string",
68 "format": "duration",
69 "@id": "schema:timeRequired"
70 },
71 "learning-objectives": {
72 "description": "Liste der Feinlernziele des Kapitels",
73 "$ref": "#/$defs/learning-objectives"
74 },
75 "learning-goal": {
76 "$ref": "#/$defs/multilingual-text",
77 "description": "Kurze Benennung des Groblernziels des Kapitels."
78 },
79 "supplemented-by": {
80 "description": "Liste von Verweisen und jeweils einer kurzen Beschreibung zu zusätzlichen, weiterführenden Inhalten o.ä.",
81 "type": "array",
82 "items": {
83 "type": "object",
84 "required": [
85 "link",
86 "description"
87 ],
88 "properties": {
89 "description": {
90 "description": "Beschreibung des verlinkten Werks und dessen Beziehung zur OER/zum Kapitel.",
91 "$ref": "#/$defs/multilingual-text"
92 },
93 "url": {
94 "type": "string",
95 "format": "uri",
96 "@id": "dct:relation"
97 }
98 },
99 "additionalProperties": false
100 }
101 }
102 }
103 }
104 },
105 "context-of-creation": {
106 "description": "Verweis auf QUADRIGA",
107 "$ref": "#/$defs/multilingual-text"
108 },
109 "date-of-last-change": {
110 "type": "string",
111 "format": "date",
112 "description": "Datum der letzten (großen, inhaltlich umfangreichen) Änderung. Sollte immer mit einer Versionsänderung einhergehen.",
113 "@id": "dct:modified"
114 },
115 "description": {
116 "description": "Beschreibung des Buchs.",
117 "type": "object",
118 "@id": "dct:description",
119 "required": [
120 "introduction",
121 "table-of-contents"
122 ],
123 "properties": {
124 "introduction": {
125 "description": "Einleitung des Buchs.",
126 "$ref": "#/$defs/multilingual-text"
127 },
128 "table-of-contents": {
129 "description": "Inhaltsverzeichnis des Buchs.",
130 "$ref": "#/$defs/multilingual-text",
131 "@id": "dct:tableOfContents"
132 }
133 },
134 "additionalProperties": false
135 },
136 "discipline": {
137 "description": "Nennung der Disziplinen, die bei der Erstellung im Fokus standen.",
138 "type": "array",
139 "minItems": 1,
140 "maxItems": 5,
141 "items": {
142 "enum": [
143 "Verwaltungswissenschaften",
144 "Digital Humanities",
145 "Informatik",
146 "Informationswissenschaft",
147 "übergreifend"
148 ]
149 }
150 },
151 "duration": {
152 "description": "Angedachte Bearbeitungsdauer für Lernende.",
153 "type": "string",
154 "format": "duration",
155 "@id": "schema:timeRequired"
156 },
157 "git": {
158 "description": "Git-Repositorium, in dem die Buch/OER-Inhalte zu finden sind.",
159 "type": "string",
160 "format": "uri",
161 "@id": "schema:codeRepository"
162 },
163 "has-predecessor": {
164 "oneOf": [
165 {
166 "enum": [
167 false
168 ]
169 },
170 {
171 "type": "string",
172 "format": "uri",
173 "description": "Link zum Vorgänger"
174 }
175 ],
176 "@id": "dct:relation"
177 },
178 "has-successor": {
179 "oneOf": [
180 {
181 "enum": [
182 false
183 ]
184 },
185 {
186 "type": "string",
187 "format": "uri",
188 "description": "Link zum Vorgänger"
189 }
190 ],
191 "@id": "dct:relation"
192 },
193 "identifier": {
194 "description": "Eindeutiger Identifier in Form einer DOI. Die DOI identifiziert das gesamte Buch.",
195 "type": "string",
196 "format": "uri",
197 "@id": "dct:identifier"
198 },
199 "keywords": {
200 "description": "Liste von Schlag-/Stichwörtern, welche das Buch und dessen (Lern-)Inhalte beschreiben.",
201 "type": "array",
202 "minItems": 1,
203 "items": {
204 "description": "Ein Schlag-/Stichwort; als (ggf. mehrsprachiger) Text oder als URI",
205 "oneOf": [
206 {
207 "$ref": "#/$defs/multilingual-text"
208 },
209 {
210 "type": "string",
211 "format": "uri"
212 }
213 ],
214 "@id": "dct:subject"
215 }
216 },
217 "language": {
218 "description": "Sprache des Buchs als ISO639-1 Sprachcode.",
219 "type": "string",
220 "@id": "dct:language"
221 },
222 "license": {
223 "description": "Lizenz des Buchs und des Codes jeweils als URL oder als Kombination aus Lizenznname und URL.",
224 "type": "object",
225 "required": [
226 "content"
227 ],
228 "additionalProperties": false,
229 "properties": {
230 "content": {
231 "description": "Lizenz des Buchs",
232 "oneOf": [
233 {
234 "@id": "dct:license",
235 "description": "URL zur Lizenz des Buchs",
236 "type": "string",
237 "format": "uri"
238 },
239 {
240 "description": "Lizenzname und URL zur Lizenz des Buchs",
241 "type": "object",
242 "properties": {
243 "name": {
244 "type": "string"
245 },
246 "url": {
247 "@id": "dct:license",
248 "type": "string",
249 "format": "uri"
250 }
251 },
252 "required": [
253 "name",
254 "url"
255 ],
256 "additionalProperties": false
257 }
258 ]
259 },
260 "code": {
261 "description": "Lizenz des Codes",
262 "oneOf": [
263 {
264 "@id": "dct:license",
265 "description": "URL zur Lizenz des Codes",
266 "type": "string",
267 "format": "uri"
268 },
269 {
270 "description": "Lizenzname und URL zur Lizenz des Codes",
271 "type": "object",
272 "properties": {
273 "name": {
274 "type": "string"
275 },
276 "url": {
277 "@id": "dct:license",
278 "type": "string",
279 "format": "uri"
280 }
281 },
282 "required": [
283 "name",
284 "url"
285 ],
286 "additionalProperties": false
287 }
288 ]
289 }
290 }
291 },
292 "book-version": {
293 "description": "Version des Buchs.",
294 "$ref": "#/$defs/semver"
295 },
296 "prerequisites": {
297 "description": "Liste von Voraussetzungen und deren jeweiliger Einordnung in der Bloomschen Taxonomie, welche Lernende für die erfolgreiche Bearbeitung des Buchs mitbringen sollten.",
298 "type": "array",
299 "minItems": 1,
300 "uniqueItems": true,
301 "items": {
302 "description": "Eine Voraussetzung.",
303 "type": "object",
304 "properties": {
305 "description": {
306 "$ref": "#/$defs/multilingual-text"
307 },
308 "blooms-category": {
309 "description": "Kategorie der Bloomschen Taxonomie, der die Voraussetzung zugeordnet ist.",
310 "enum": [
311 "1 Erinnern",
312 "2 Verstehen",
313 "3 Anwenden",
314 "4 Analysieren",
315 "5 Bewerten",
316 "6 Erschaffen"
317 ]
318 }
319 },
320 "required": [
321 "description",
322 "blooms-category"
323 ],
324 "additionalProperties": false
325 }
326 },
327 "publication-date": {
328 "type": "string",
329 "format": "date",
330 "@id": "dct:issued"
331 },
332 "quality-assurance": {
333 "type": "array",
334 "minItems": 1,
335 "items": {
336 "type": "object",
337 "required": [
338 "person",
339 "date"
340 ],
341 "properties": {
342 "person": {
343 "$ref": "#/$defs/person"
344 },
345 "date": {
346 "type": "string",
347 "format": "date"
348 },
349 "description": {
350 "$ref": "#/$defs/multilingual-text"
351 }
352 }
353 }
354 },
355 "related-works": {
356 "description": "Eine Liste von Verweisen und jeweils einer kurzen Beschreibung zu zusätzlichen, weiterführenden Inhalten o.ä.",
357 "type": "array",
358 "items": {
359 "type": "object",
360 "required": [
361 "url",
362 "description"
363 ],
364 "properties": {
365 "description": {
366 "description": "Beschreibung des verlinkten Werks und dessen Beziehung zum Buch.",
367 "$ref": "#/$defs/multilingual-text"
368 },
369 "url": {
370 "type": "string",
371 "format": "uri"
372 }
373 },
374 "additionalProperties": false
375 }
376 },
377 "schema-version": {
378 "description": "Versionsnummer des QUADRIGA-Metadatenschemas",
379 "enum": [
380 "1.1",
381 "1.1-beta",
382 "1.1-beta2"
383 ]
384 },
385 "target-group": {
386 "description": "Zielgruppe",
387 "type": "array",
388 "minItems": 1,
389 "items": {
390 "enum": [
391 "Forschende (PostDoc)",
392 "Forschende (Projektleitung)",
393 "Promovierende",
394 "Hochschullehrende"
395 ]
396 },
397 "@id": "dct:audience"
398 },
399 "title": {
400 "description": "Titel des Buchs",
401 "type": "string",
402 "@id": "dct:title"
403 },
404 "type-of-learning-resource": {
405 "enum": [
406 "Jupyter Book"
407 ]
408 },
409 "type-of-research-object": {
410 "description": "Nennung des Datentyps, der vorrangig im Buch behandelt wird.",
411 "type": "array",
412 "minItems": 1,
413 "maxItems": 2,
414 "items": {
415 "enum": [
416 "Text",
417 "Tabelle",
418 "Bewegtes Bild",
419 "übergreifend"
420 ]
421 }
422 },
423 "url": {
424 "description": "URL des Buchs.",
425 "type": "string",
426 "format": "uri"
427 },
428 "used-tools": {
429 "description": "Liste von Tools, die bei der Erstellung des Buchs verwendet wurden.",
430 "type": "array",
431 "minItems": 1,
432 "items": {
433 "oneOf": [
434 {
435 "type": "string",
436 "format": "uri"
437 },
438 {
439 "description": "Strukturierte Angabe des Tools",
440 "@id": "schema:softwareApplication",
441 "properties": {
442 "name": {
443 "$ref": "#/$defs/multilingual-text"
444 },
445 "url": {
446 "type": "string",
447 "format": "uri"
448 }
449 }
450 }
451 ]
452 }
453 }
454 },
455 "additionalProperties": false,
456 "$defs": {
457 "learning-objectives": {
458 "description": "Eine Liste von Lernzielen.",
459 "type": "array",
460 "minItems": 1,
461 "uniqueItems": true,
462 "items": {
463 "type": "object",
464 "required": [
465 "learning-objective",
466 "competency",
467 "data-flow",
468 "focus",
469 "blooms-category"
470 ],
471 "properties": {
472 "learning-objective": {
473 "description": "Formulierung des Lernziels.",
474 "$ref": "#/$defs/multilingual-text"
475 },
476 "competency": {
477 "description": "Im Lernziel adressierte Kompetenz nach dem QUADRIGA Datenkompetenzframework.",
478 "enum": [
479 "1 Basiskompetenz",
480 "2 Identifikation",
481 "3 Qualitätssicherung",
482 "4 Ethik und Recht",
483 "5 Erhebung",
484 "6 Validierung",
485 "7 Aufbereitung",
486 "8 Management",
487 "9 Erschließung",
488 "10 Datenanalyse",
489 "11 Visualisierung",
490 "12 Interpretation",
491 "13 Aufbereitung",
492 "14 Datenpublikation",
493 "15 Kommunikation"
494 ]
495 },
496 "focus": {
497 "description": "Fokus des Lernziels auf den Aspekt \"Wissen\", \"Fähigkeit\" oder \"Haltung\" der Kompetenz.",
498 "enum": [
499 "Wissen",
500 "Fähigkeit",
501 "Haltung"
502 ]
503 },
504 "data-flow": {
505 "description": "Schritt im Datenfluss, dem die Kompetenz zugeordnet ist.",
506 "enum": [
507 "Grundlagen",
508 "Planung",
509 "Erhebung und Aufbereitung",
510 "Management",
511 "Analyse",
512 "Publikation und Nachnutzung"
513 ]
514 },
515 "blooms-category": {
516 "description": "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.",
517 "enum": [
518 "1 Erinnern",
519 "2 Verstehen",
520 "3 Anwenden",
521 "4 Analysieren",
522 "5 Bewerten",
523 "6 Erschaffen"
524 ]
525 },
526 "assessment": {
527 "description": "Beschreibung der Art der Überprüfung des Lernziels.",
528 "$ref": "#/$defs/multilingual-text"
529 }
530 },
531 "additionalProperties": false
532 }
533 },
534 "multilingual-text": {
535 "oneOf": [
536 {
537 "type": "string"
538 },
539 {
540 "description": "Sollen Metadaten mehrsprachig definiert werden, so wird als Key der Sprachcode nach ISO639-1 verwendet.",
541 "type": "object",
542 "patternProperties": {
543 "^[a-z][a-z]$": {
544 "type": "string"
545 }
546 },
547 "additionalProperties": false
548 }
549 ]
550 },
551 "person": {
552 "description": "Eine Person, die an der Erstellung des Buchs beteiligt war.",
553 "@id": "schema:person",
554 "oneOf": [
555 {
556 "type": "string",
557 "description": "Vollständiger Name der Person."
558 },
559 {
560 "description": "Strukturierte Angabe der Person bestehend mindestens aus Vor- und Nachname.",
561 "$comment": "Andere Schlüssel können nach Bedarf angelegt werden.",
562 "type": "object",
563 "required": [
564 "given-names",
565 "family-names"
566 ],
567 "properties": {
568 "given-names": {
569 "description": "Vorname(n) der Person",
570 "type": "string",
571 "@id": "schema:givenName"
572 },
573 "family-names": {
574 "description": "Nachname(n) der Person",
575 "type": "string",
576 "@id": "schema:familyName"
577 },
578 "orcid": {
579 "description": "ORCID der Autor:in als URI (https://orcid.org/XXXX-XXXX-XXXX-XXXX)",
580 "type": "string",
581 "format": "uri",
582 "pattern": "^https://orcid.org/[0-9]{4}-[0-9]{4}-[0-9]{4}-[0-9]{3}[0-9X]$"
583 },
584 "credit": {
585 "description": "Rolle der Person nach CRediT (siehe https://credit.niso.org.",
586 "type": "array",
587 "items": {
588 "enum": [
589 "Conceptualization",
590 "Data curation",
591 "Formal analysis",
592 "Funding acquisition",
593 "Investigation",
594 "Methodology",
595 "Project administration",
596 "Software",
597 "Resources",
598 "Supervision",
599 "Validation",
600 "Visualization",
601 "Writing",
602 "Writing – original draft",
603 "Writing – review & editing"
604 ]
605 }
606 }
607 },
608 "additionalProperties": true
609 }
610 ]
611 },
612 "semver": {
613 "type": "string",
614 "description": "Semantic Versioning 2.0.0 (https://semver.org)",
615 "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$"
616 }
617 }
618}