mekotools/mekotools-katalog
Watch
1
0
Fork
You've already forked mekotools-katalog
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
Metadaten-Schema, Vorlagen, Generator und Dokumentations-Website des MekoTools-Katalogs.
7 commits 1 branch 0 tags 73 KiB
  • Python 58.7%
  • Shell 41.3%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Hermes 90500b044d
Some checks are pending
pruefen / pruefen (push) Waiting to run
Details
Nicht lesbarer Bau-Stand wird gemeldet statt still durchgewinkt 
Der Rot-Test des Rueckschritt-Waechters lief einmal durch, weil die Probe keine
Kennzahl lieferte und der Vergleich damit stillschweigend entfiel. Jetzt gibt es
einen ausdruecklichen Hinweis; die Pruefung nach der Uebertragung bleibt laut.
2026-10-06 19:36:13 +02:00
.forgejo/workflows Katalog-Gerüst: Schema, Vorlagen, Generator, Dokumentation 2026-10-06 16:43:07 +02:00
docs Bau-Stand mitliefern und Auslieferung pruefen 2026-10-06 19:32:15 +02:00
schema Werkzeug-Katalog aus echten Metadaten 2026-10-06 17:20:23 +02:00
scripts Bau-Stand mitliefern und Auslieferung pruefen 2026-10-06 19:32:15 +02:00
templates/tool-repo Werkzeug-Katalog aus echten Metadaten 2026-10-06 17:20:23 +02:00
web Nicht lesbarer Bau-Stand wird gemeldet statt still durchgewinkt 2026-10-06 19:36:13 +02:00
.gitignore Werkzeug-Katalog aus echten Metadaten 2026-10-06 17:20:23 +02:00
bauen.sh Begruendung im Code richtigstellen (Waechter 2 fragte zu frueh, nicht mkdocs) 2026-10-06 19:32:46 +02:00
mkdocs.yml Bau-Stand mitliefern und Auslieferung pruefen 2026-10-06 19:32:15 +02:00
quellen_holen.sh Werkzeug-Katalog aus echten Metadaten 2026-10-06 17:20:23 +02:00
README.md Katalog-Gerüst: Schema, Vorlagen, Generator, Dokumentation 2026-10-06 16:43:07 +02:00
veroeffentlichen.sh Nicht lesbarer Bau-Stand wird gemeldet statt still durchgewinkt 2026-10-06 19:36:13 +02:00

README.md

mekotools-katalog

Zentrale Sammelstelle für den MekoTools-Katalog: Metadaten-Schema, Vorlagen, Doku-Website (MkDocs) und der Generator, der aus den Tool-Repos einen durchsuchbaren Katalog baut.

MekoTools (MeKo = Medienkompetenz) ist ein One-Click-Angebot für Lehrkräfte: geprüfte Open-Source-Werkzeuge, die mit minimalem Aufwand im Unterricht einsetzbar sind — mit drei Dokumentations-Bausteinen pro Tool (Ausführung, Didaktik, Unterrichtsentwurf).

Aufbau

Pfad Zweck
schema/tool.schema.json Verbindliches Metadaten-Schema (tool.yaml), Version 1
templates/tool-repo/ Vorlage für ein neues Tool-Repo (tool.yaml, Doku-Bausteine, CI)
scripts/katalog_bauen.py liest alle tool.yaml, prüft Pflichtfelder, erzeugt web/tools.json und docs/katalog.md
scripts/pruefen.sh Schema-Prüfung + mkdocs build --strict (Link-Test)
docs/ Inhalte der Doku-Website
bauen.sh Website bauen (venv mit mkdocs-material)

Ein Tool aufnehmen (Kurzfassung)

  1. Tool-Repo anlegen (Prefix mekotools-), Vorlage aus templates/tool-repo/ übernehmen.
  2. tool.yaml ausfüllen — Pflichtfelder siehe Schema.
  3. Drei Doku-Bausteine schreiben: docs/anleitung.md, docs/didaktik.md, docs/unterrichtsentwurf.md.
  4. Bau und Veröffentlichung laufen über die CI des Tool-Repos (Image nach ghcr.io/mekotools/<tool>); der Katalog zieht die Metadaten über die Schnittstelle des jeweiligen Git-Dienstes.

Details: docs/mitmachen.md.

Entscheidungen, die hier festgeschrieben sind

  • Katalog-Oberfläche ist eigenständig — keine Coolify-Oberfläche für Lehrkräfte. Coolify bleibt eine von drei Ausführungsplattformen.
  • Drei Laufzeitumgebungen: gpu (vast.ai, Lehrer-eigener Schlüssel), browser (statisch/lokal), server (eigene Infrastruktur).
  • Bezugsquelle für Container-Abbilder ist GHCR unter ghcr.io/mekotools/*; Harbor bleibt Zweitspiegel.
  • H5P: Erstellen mit Lumi (lokal), Abspielen über einen eigenen H5P-Standalone-Baustein; ein eigenes „Studio" wird als eigenes Arbeitspaket geprüft.
  • Dokumentation für Laien — jeder Fachbegriff wird beim ersten Auftreten erklärt.

Stand

Gerüst und Schema (Version 1, Oktober 2026). Der Generator läuft, die Tool-Metadaten werden nach und nach ergänzt.