Content-Repos - eigenes Repository veroeffentlichen¶

Adaptive Learner liefert eine offizielle Inhaltsbibliothek mit, aber das Content-System ist offen: Du kannst dein eigenes Content-Repository auf GitHub betreiben, es in der App verbinden und es anderen Lernenden zur Verfügung stellen. Diese Seite gibt den Überblick; die ausführliche Schritt-für-Schritt-Anleitung steht im Content-Repo-Guide.

Was ist ein Content-Repo?¶

Ein Content-Repo ist ein GitHub-Repository, das Content-Sets im Adaptive-Learner-Format enthält. Ein Set ist eine Sammlung von Lektionen für ein Sprachpaar und Niveau (z. B. "Spanisch A1 für Deutschsprachige") oder für ein Sachgebiet (z. B. "Python-Grundlagen").

Die offizielle Bibliothek und alle Nutzer-Repos verwenden dasselbe Format - es gibt kein separates "offizielles" Schema. Sobald dein Repo die Validierung besteht, ist es eine vollwertige Inhaltsquelle. Du brauchst keinen eigenen Server: ein Content-Repo besteht nur aus Dateien in einem Git-Repository.

Voraussetzungen¶

Ein GitHub-Repository (öffentlich; privat ist per Repo-Token ebenfalls möglich).
Eine Wurzel-manifest.yaml, die deine Sets auflistet.
Lektionen im Lektionsformat.
Python 3 mit PyYAML, um vor dem Veroeffentlichen lokal zu validieren.

Die massgeblichen Format-Referenzen liegen im offiziellen Inhalts-Repo:

Verzeichnisbaum¶

Ein Content-Repo folgt einem festen Aufbau. Die Quellsprache (in der die Erklärungen geschrieben sind) ist der oberste Ordner, Zielsprache und Niveau bilden den nächsten:

mein-content-repo/
  manifest.yaml                  # Wurzel-Manifest: listet alle Sets
  sets/
    de/                          # Quellsprache (Deutschsprachige)
      es-a1/                     # Zielsprache + Niveau (Spanisch A1)
        manifest.yaml            # Set-Manifest: listet die Lektionen
        lessons/
          01-begruessung.json    # eine JSON-Datei je Lektion (NN-slug.json)
        assets/                  # optional: Bilder / Audio
  scripts/validate_content.py    # der Validator (aus dem Starter-Kit)

Lokal prüfen¶

pip install pyyaml
python3 scripts/validate_content.py

Exit-Code 0, wenn alle Sets bestehen, sonst 1 mit einem Bericht je Datei. Geprüft werden Schema, Verzeichnisstruktur und die Qualitäts-Mindestanforderungen (>= 5 Übungen, >= 2 Übungstypen, >= 1 Theorieschritt je Lektion, gefuellte Kartenfelder usw.).

Wie wird es in der App gelistet?¶

Sobald dein Repo validiert, verbindet ein Lernender es unter Einstellungen > Daten > Content-Repositories: URL einfügen, die App holt das Wurzel-Manifest, validiert technisch, synchronisiert und cacht die Sets. Sie erscheinen dann im Content Browser mit einem Quellen-Badge. Repos lassen sich auch per /add-repo-Link und QR-Code teilen.

In die Empfohlenen Repositories in der App kommt ein Repo nur über die kuratierte recommended-repos.json des Projektteams - das ist der Kanal für die offizielle Empfehlung (Trust 3).

Trust-Levels¶

Das Trust-Level sagt, wie stark der Inhalt geprüft wurde - es geht um Herkunft und Prüfung, nicht um ein Qualitätsurteil.

Level	Name	Bedeutung
1	Validiert	Schema korrekt, Qualitäts-Mindestanforderungen bestanden - automatisch beim Sync. Inhalt nicht einzeln geprüft.
2	Verifiziert	Von der Community beigetragen und von einem Maintainer inhaltlich geprüft.
3	Offiziell	Vom Projektteam kuratiert und qualitaetsgesichert.

Für Trust 2+ gilt ein höherer Anspruch als die technischen Minima: korrekte Übersetzungen, Artikel/Genus, vollständige Akzente, sinnvolle Progression, plausible Distraktoren und kulturelle Korrektheit. Eine optionale KI-Prüfung in der App hilft Autoren, solche Probleme vor dem Teilen zu finden (siehe EXP-033); sie ist beratend und blockiert das Teilen nie.

Gegenseitigkeit für Kurse und Webseiten (EXP-029)¶

Lektionen und Sachgebiete können Begleitmedien tragen (Videos, Podcasts, Artikel, Bücher, Kurse, Webseiten). Der Filter für kommerzielle Medien ist Gegenseitigkeit, nicht der Preis: freie Medien sind immer erlaubt; kommerzielle Kurse/Webseiten nur, wenn der Anbieter zurueckverlinkt, ein eigenes Content-Repo betreibt oder eine dokumentierte Partnerschaft besteht. So werden Content-Autoren zu Oekosystem-Partnern statt zu Werbetreibenden. Details in docs/explorations/EXP-029-media-reciprocity.md.

Starter-Kit als Vorlage¶

Der schnellste Einstieg ist das fertige Starter-Repo astrapi69/adaptive-learner-content-test: Es enthält docs/, Vorlagen je Domäne, eine vollständige Beispiel-Lektion (Inception-Effekt), ein lauffaehiges Beispiel-Set, books.yaml und den Validator. Forke es, ersetze die Beispiel-Lektion durch deine eigene, registriere sie im Wurzel-manifest.yaml, validiere und verbinde das Repo in der App.