# Wie meine Metadaten bereit stellen?
Link zum Dokument: <https://kurzelinks.de/wie-metadaten-bereitstellen>
Dieses Dokument ist im Rahmen des BMBF geförderten Projektes [JOINTLY](http://jointly.info) entstanden. Es ist als praktischer Leitfaden für Entwickler:innen gedacht, die Metadaten für Lernressourcen auf ihren Webseiten hinterlegen wollen.
Der Leitfaden empfiehlt eine Einbettung von JSON-LD in einem `script`-Tag (s.u.). Außerdem wird die Orientierung an LRMI und den dort verwendeten Typen und Eigenschaften von schema.org empfohlen.
**Lizenz**: Dieses Dokument ist veröffentlicht unter CCO. Der Lizenzhinweis findet sich am Ende des Dokuments. Es darf gerne weiter geteilt und verbessert werden. Dafür wurde es erstellt.
## Worum geht es?
Diese Empfehlung strebt eine möglichst einheitliche Vergabe von Metadaten für im Web publizierte Lehr- und Lernmatieralien an. Konkret soll die **Nutzung gemeinsamer Properties** und – wo möglich – die **Vergabe einheitlicher Werte** unterstützt werden.
Das **Basis-Vokabular ist [schema.org](https://schema.org)**, das anerkannt und bereits in vielen Webseiten eingebettet ist. Dank der LRMI-Initiative ist die Beschreibung von Bildungsmaterialien mittels schema.org gut unterstützt.
## LRMI – Learning Resource Metadata Initiative
Siehe http://lrmi.net/about/lrmi/
LRMI war und ist eine Initiative zur Integration von Metadatenattributen und -werten zur Beschreibung von Bildungsmaterialien in schema.org. LRMI ist also eine Untermenge von schema.org, gepflegt werden die Attribute und Werte von der [LRMI Task Group](https://www.dublincore.org/groups/lrmi-task-group/) der Dublin Core Metadata Initiative (DCMI).
Einige Properties wurden auf Initiative der LRMI Task Group in schema.org ergänzt, unter anderem:
- [learningResourceType](https://schema.org/learningResourceType)
- [teaches](https://schema.org/teaches)
- [assesses](https://schema.org/assesses)
- [educationalLevel](https://schema.org/educationalLevel)
- [educationalRole](https://schema.org/educationalRole)
- [educationalUse](https://schema.org/educationalUse)
- [interactivityType](https://schema.org/interactivityType)
- [timeRequired](https://schema.org/timeRequired)
- [typicalAgeRange](https://schema.org/typicalAgeRange)
- [isBasedOn](https://schema.org/isBasedOn)
- [license](https://schema.org/license)
Außerdem wurden einige Klassen auf Initiative von LRMI in schema.org ergänzt. Relevant in diesem Kontext sind:
- [LearningResource](https://schema.org/LearningResource)
- [EducationalAudience](https://schema.org/EducationalAudience)
## Wie darstellen?
### [JSON-LD](https://www.w3.org/TR/json-ld/)
In [Googles Guide zur Einbettung strukturierter Daten](https://developers.google.com/search/docs/guides/intro-structured-data) wird die Nutzung von JSON-LD empfohlen. Dies geschieht durch ergänzen von JSON-LD in einem `script`-Tag auf der jeweiligen Seite.([Beispiel ZOERR](https://uni-tuebingen.oerbw.de/edu-sharing/components/render/907ca040-2d0c-4a89-a122-177d02df7685)):
```html
<script type="application/ld+json">{
"@context": "http://schema.org/",
"@type": [
"LearningResource",
"MediaObject"
],
"identifier": "907ca040-2d0c-4a89-a122-177d02df7685",
"creator": [
{
"@type": "Person",
"givenName": "Anja",
"familyName": "Schreiber"
},
{
"@type": "Person",
"givenName": "Katharina",
"familyName": "Ebrecht"
}
],
"keywords": [
"OER",
"Open Educational Resources",
"offene Lehr- und Lernmaterialien"
],
"description": "Semesteransprache über die Notwendigkeit offener Lehrmaterialien an Hochschulen",
"dateModified": "2019-07-23T11:26:01+02:00",
"version": "1.2",
"ContentSize": "2934484",
"url": "https://uni-tuebingen.oerbw.de/edu-sharing/components/render/907ca040-2d0c-4a89-a122-177d02df7685",
"datePublished": "2018-10-11T10:57:57+02:00",
"license": "https://creativecommons.org/licenses/by-sa/4.0/deed.en",
"dateCreated": "2017-11-13T16:36:34+01:00",
"name": "Warum Hochschulen offene Lehrmaterialien brauchen - OER",
"learningResourceType": "presentation",
"thumbnailUrl": "https://uni-tuebingen.oerbw.de/edu-sharing/preview?nodeId=907ca040-2d0c-4a89-a122-177d02df7685&storeProtocol=workspace&storeId=SpacesStore&dontcache=1597830623595"
}</script>
```
### Sitemap
Außerdem empfiehlt sich das Anlegen einer [Sitemap](https://developers.google.com/search/docs/advanced/sitemaps/overview), damit die relevanten Inhalte für Suchmaschinen oder Crawler direkt zu finden sind.
### Attributwerte
Um Filter- und Suchmöglichkeiten in Suchmaschinen zu verbessern, ist die Verwendung eines einheitlichen Vokabulars sinnvoll und wünschenswert. Für den Schulbereich stellt u.a. WirLernenOnline kontrollierte Vokabulare bereit unter https://vocabs.openeduhub.de/. Besonders relevant sind hier:
- [learningResourceType](http://w3id.org/openeduhub/vocabs/learningResourceType/)
- [intendedEndUserRole](http://w3id.org/openeduhub/vocabs/intendedEndUserRole/)
Ist die Erstellung eigener kontrollierter Vokabulare nötig, sollten diese mit dem Standard [SKOS ("Simple Knowledge Organization System")](https://www.w3.org/TR/skos-primer/) publiziert werden. Zur Hilfestellung gibt es eine deutschsprachige [Einführung in SKOS](https://w3id.org/kim/skos-einfuehrung/).
Zur einfachen GitHub- oder GitLab-basierten Pflege und Publikation von SKOS-Vokabularen eignet sich gut [SkoHub Vocabs](https://github.com/hbz/skohub-vocabs), das selbst lokal aufgesetzt oder als Service unter https://skohub.io/ genutzt werden kann.
## Editor
- https://github.com/hbz/skohub-extension
- Skohub-Projekt: http://skohub.io
## Vokabulare
Die [OER-Metadatengruppe](https://wiki.dnb.de/display/DINIAGKIM/OER-Metadatengruppe) erstellt auf ihrer Seite derzeit eine Liste mit Vokabularen (https://wiki.dnb.de/display/DINIAGKIM/Wissenssammlung)
## Was unbedingt ausfüllen?
Die OER-Metadatengruppe der DINI-AG-KIM erstellt momentan ein Metadatenprofil für Lehr-und Lernmaterialien im deutschsprachigen Raum: https://github.com/dini-ag-kim/lrmi-profile. In dem Repositorium ist bereits eine JSON-Schema Datei zu finden, in der die Felder des Profils definiert sind. Eine HTML-Spezifikation wird zur Zeit erstellt.
- Liste möglicher Attribute: schema.org/CreativeWork
- die folgenden Werte werden bspw. auch im [LRMI-Profil der DINI-KIM-AG](https://github.com/dini-ag-kim/lrmi-profile) benutzt:
- `@context` zur Verlinkung des [JSON-LD-Kontext-Dokuments](https://www.w3.org/TR/json-ld/#the-context)
- `id` zur Angabe der URL/URI einer Lernressource
- `type` zur Angabe des schema.org-Typs: hier sollte mindestens `LearningResource` gesetzt werden plus Angabe genauerer Typen (`Book`, `AudioObject`, `Course` etc.) -> https://github.com/dini-ag-kim/lrmi-profile/issues/21
- [`name`](http://schema.org/name)
- [`creator`](http://schema.org/creator)
- [`description`](http://schema.org/description)
- [`about`](http://schema.org/about) (discipline):
- bestenfalls mit Verweis auf bestehendes Vokabular: https://w3id.org/openeduhub/vocabs/discipline/index.html
- [`license`](http://schema.org/license)
- [`image`](http://schema.org/image)
- [`dateCreated`](http://schema.org/dateCreated)
- [`inLanguage`](http://schema.org/inLanguage)
- [`publisher`](http://schema.org/publisher)
- [`learningResourceType`](http://schema.org/learningResourceType):
- bestenfalls mit Verweis auf bestehendes Vokabular: http://w3id.org/openeduhub/vocabs/learningResourceType/
- [`audience`](http://schema.org/audience):
- gerne mit Verweis auf bestehendes LRMI-Vokabular: https://w3id.org/openeduhub/vocabs/discipline/index.html
- [`isBasedOn`](http://schema.org/isBasedOn)
- [`mainEntityOfPage`](http://schema.org/mainEntityOfPage): enthält ein Objekt mit der Beschreibung der Herkunft (`id` & [`provider`](http://schema.org/provider)), Erstellungs- ([`dateCreated`](https://schema.org/dateCreated)) und Änderungszeitpunkt ([`dateModified`](https://schema.org/dateModified)) sowie perspektivisch die Lizenz ([`license`](https://schema.org/license)) der Metadaten
Die nachfolgenden Werte werden nicht im LRMI-Profil der DINI-KIM-AG benutzt,
sind aber u.U. vor allem im Schulbereich sinnvoll:
---
- [timeRequired](http://schema.org/timeRequired)
- *[educationalUse](http://schema.org/educationalUse)*:
- Zweck/Absicht eines Werkes, bspw. "Anleitung", "Test", "prof. Hilfestellung"; [Definition des Vokabulars bei LRMI](https://github.com/dcmi/lrmi/blob/master/lrmi_vocabs/educationalUse.ttl)
- wird momentan in wirlernenonline **nicht** verwendet
- [educationalLevel](http://schema.org/educationalLevel):
- [Definition des Vokabulars bei OpenEduHub](https://vocabs.openeduhub.de/w3id.org/openeduhub/vocabs/educationalLevel/index.html)
- [oeh:educationalContext](http://w3id.org/openeduhub/learning-resources-terms/)
- dieses Vokabular bezeichnet das Bildungsumfeld, i.e. Grundschule, Sek I...
- [hasPart](http://schema.org/hasPart)
- [typicalAgeRange](http://schema.org/typicalAgeRange)
- *interactivityType*:
- [Definition des Vokabulars bei LRMI](https://github.com/dcmi/lrmi/blob/master/lrmi_vocabs/interactivityType.ttl)
- wird momentan in wirlernenonline **nicht** verwendet
- [dateModified](http://schema.org/dateModified)
- [version](http://schema.org/version)
- [keywords](http://schema.org/keywords)
## Vollständiges Beispiel
```json
{
"@context": {
"@vocab": "http://schema.org/",
"oeh": "http://w3id.org/openeduhub/terms/",
"@language": "de"
},
"type": "Creative Work",
"id": "http://url-of-my-material.com",
"name": "Mein super Material",
"creator": {
"type": "Person",
"name": "Marina Müller",
"email": "kontakt@marina-mueller.org",
"url": "http://marina-mueller.org/about"
},
"description": {
"de": "Ein wirklich super Material mit einer tollen Beschreibung.",
"en": "Some awesome material explained very well."
},
"about": {
"type": "DefinedTerm",
"name": "Mathematik",
"url": "http://w3id.org/openeduhub/vocabs/discipline/380",
"inDefinedTermSet": "http://w3id.org/openeduhub/vocabs/discipline/"
},
"license": "https://creativecommons.org/publicdomain/zero/1.0/",
"image": "http://a-nice-image.com",
"dateCreated": "2020-08-28",
"inLanguage": "de",
"publisher": {
"type": "Organization",
"name": "Edu-Einrichtung",
"email": "supportdesk@edu-einrichtung.org",
"url": "http://edu-einrichtung/about"
},
"learningResourceType": {
"type": "DefinedTerm",
"name": "Experiment",
"url": "http://w3id.org/openeduhub/vocabs/learningResourceType/experiment",
"inDefinedTermSet": "http://w3id.org/openeduhub/vocabs/learningResourceType/"
},
"audience": {
"type": "DefinedTerm",
"name": "Lehrer/in",
"url": "http://w3id.org/openeduhub/vocabs/intendedEndUserRole/teacher",
"inDefinedTermSet": "http://w3id.org/openeduhub/vocabs/intendedEndUserRole/"
},
"isBasedOn": "http://awesome-material.com",
"mainEntityOfPage": {
"id": "https://creativecommons.org/publicdomain/zero/1.0/",
"type": "Text",
"provider": {
"id": "http://url-to-provider-of-metadata",
"name": "Tutory"
},
"dateCreated": "2020-01-01",
"dateModified": "2020-02-02"
},
"timeRequired": "PT30M",
"educationalLevel": {
"type": "DefinedTerm",
"name": "10",
"url": "http://w3id.org/openeduhub/vocabs/educationalLevel/10",
"inDefinedTermSet": "http://w3id.org/openeduhub/vocabs/educationalLevel/"
},
"oeh:educationalContext": {
"type": "DefinedTerm",
"name": "Grundschule",
"url": "https://vocabs.openeduhub.de/w3id.org/openeduhub/vocabs/educationalContext/sekundarstufe_1.html",
"inDefinedTermSet": "https://vocabs.openeduhub.de/w3id.org/openeduhub/vocabs/educationalContext/"
},
"hasPart": "http://some-other-awesome-material.com",
"version": "1.0",
"dateModified": "2020-06-28",
"keywords": [
"Mathematik",
"Pythagoras"
]
}
```
## Links
- [Vokabulare der OER-Metadatengruppe](https://wiki.dnb.de/display/DINIAGKIM/Wissenssammlung) (siehe unter Vokabulare)
- [OpenEduHub-Vokabular](http://w3id.org/openeduhub/vocabs/)
- [SkoHub](skohub.io): Tools zur Erstellung und Pflege von Vokabularen/einheitlichen Attributwerten
- [OER-Metadatengruppe](https://wiki.dnb.de/display/DINIAGKIM/OER-Metadatengruppe)
- [k12ocx](https://k12ocx.github.io/k12ocx-specs/): Projekt von Phil Barker über die Darstellung und Modellierung von Curricula und zugehörigen Contents
- [Herausforderungen für OER-Metadaten](https://kurzelinks.de/metadaten-fuer-oer) (Zusammenstellung von Jointly)
- [Wie stelle ich OER-Material auffindbar bereit](https://kurzelinks.de/oer-verbreiten) (in progress)
## Lizenzhinweis
<p xmlns:dct="http://purl.org/dc/terms/" xmlns:vcard="http://www.w3.org/2001/vcard-rdf/3.0#">
<a rel="license"
href="http://creativecommons.org/publicdomain/zero/1.0/">
<img src="http://i.creativecommons.org/p/zero/1.0/88x31.png" style="border-style: none;" alt="CC0" />
</a>
<br />
To the extent possible under law,
<a rel="dct:publisher"
href="mailto:steffen.roertgen@gwdg.de">
<span property="dct:title">Steffen Rörtgen</span></a>
has waived all copyright and related or neighboring rights to
<span property="dct:title">Wie meine Metadaten bereitstellen?</span>.
This work is published from:
<span property="vcard:Country" datatype="dct:ISO3166"
content="DE" about="mailto:steffen.roertgen@gwdg.de">
Deutschland</span>.
</p>