967 views
# 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>