amb

Allgemeines Metadatenprofil für Bildungsressourcen


English description

A schema.org/LRMI-based profile for describing learning resources.


Ein schema.org-/LRMI-basiertes Metadatenprofil für die Beschreibung von Lehr- und Lernressourcen mit Fokus auf den deutschsprachigen Raum.

Status

Publiziert

Zum Entwicklungsprozess

Siehe auch die StöberSpecs-Prozesse.

Implementierungen

In der implementations.md sammeln wir Akteure, die das Profil verwenden. Falls du weitere Akteure kennst, trage sie dort gerne ein oder melde dich bei uns.

Frequently Asked Questions

In unserem FAQ beantworten wir häufig gestellte Fragen.

Beteiligte Personen

Lokales Setup

Installation der notwendigen Packete

Über npm install kannst du die für die Entwicklung notwendigen Packete installieren.

Ansicht der HTML-Spezifikation im Browser

Um die index.html-Datei lokal editieren und anzeigen zu können, klone das Repo und wechsle in das amb-Verzeichnis:

git clone git@github.com:dini-ag-kim/amb.git ; cd amb

Lasse einen Server im amb-Verzeichnis laufen:

python3 -m http.server

Dann lässt sich die Spezifikation im Web-Browser anschauen unter http://localhost:8000.

Tests

Schema-Tests werden gegen valide (draft/examples/valid) und invalide (draft/examples/invalid) Beispiel-Dateien durchgeführt. Lokal können die Tests mit $ sh test.sh oder mit npm run test ausgeführt werden. Durch die inkrementelle Ergänzung von invaliden Beispielen soll das Schema stetig genauer werden, um in der Praxis die Einhaltung des Profils zu gewährleisten.

Um die Tests laufen lassen zu können, müssen die NPM Packete ajv-cli und ajv-formats installiert sein, was du über npm install erreichst.

Formatierung

Über npm run format kannst du die Dateien in diesem Repository formatieren. Zur Formatierung nutzen wir prettier, siehe .prettierrc.json für unsere Konfigurationseinstellungen. Für prettier gibt es auch Integrationsmöglichkeiten in vielen Editoren.

Weiterführende Informationen