Lernatelier Checker

Prüft deine Lernatelier-Dokumentation (Lernperiode-N.md) direkt beim Schreiben auf formale Vollständigkeit. Fehlende Angaben erscheinen als Hinweise in der Datei und im Bereich Probleme, und eine Ampel in der Statusleiste zeigt, wie weit dein Dokument ist.

Die Regeln stammen aus der Bibliothek lernatelier-checker-js von Daniel J. Lauk. Die Erweiterung verwendet sie unverändert, du bekommst also dieselben Ergebnisse wie mit dem Prüfwerkzeug der Schule.

Was du siehst

• Hinweise in der Datei: Wellenlinien genau an der Stelle, an der etwas fehlt, zum Beispiel unter - Name:, unter einer Tagesplanung mit zu wenig Arbeitspaketen oder unter einem Arbeitspaket, das nur ...Ihr Text... enthält.

• Bereich „Probleme“ (Strg+Shift+M, auf dem Mac Cmd+Shift+M): alle Fehler und Warnungen mit Zeilennummer. Ein Klick springt an die Stelle.

• Ampel in der Statusleiste, unten links, solange eine Lernperiode-Datei offen ist:

  • grünes Häkchen: alles in Ordnung,
  • gelbes Warnzeichen: Verbesserungsbedarf (nur Warnungen),
  • rotes Fehlerzeichen: Handlungsbedarf (mindestens ein Fehler).

  Die Zahl daneben ist die Anzahl der Hinweise. Ein Klick öffnet den Bericht.

• Kalender-Knopf in der Statusleiste, direkt daneben: „Kalender erstellen“, solange es keine lernperiode.json gibt, sonst die Anzahl Unterrichtstage. Ein Klick öffnet den Kalender-Editor.

• Seitenleiste „Lernatelier“ (Symbol mit Checkliste in der linken Leiste): Ampel, alle Hinweise der offenen Datei (ein Klick springt zur Zeile), der Kalender mit dem nächsten Unterrichtstag, Knöpfe für Prüfen, Bericht, Kalender, nächste Tagesplanung und neue Lernperiode, und unten Alle Lernperioden im Ordner mit ihrer Ampel (ein Klick öffnet die Datei). Ohne offene Lernperiode kannst du dort eine öffnen oder erstellen.

  

• Bericht: dieselbe Übersicht wie beim Kommandozeilen-Werkzeug, mit Zeilennummern, im Ausgabebereich „Lernatelier Checker“.

Geprüft werden alle Lernperiode-*.md im geöffneten Ordner, auch die, die du gerade nicht offen hast; ihre Hinweise stehen alle im Bereich „Probleme“. Die Ampel in der Statusleiste zeigt immer die Datei, in der du gerade bist. Offene Dateien werden beim Tippen geprüft, die anderen, sobald sie sich auf der Festplatte ändern (zum Beispiel nach git pull).

Abgeschlossene Lernperioden ignorieren

Ältere Lernperioden sollen den Bereich „Probleme“ nicht füllen. In der Seitenleiste unter Alle Lernperioden hat jede Datei einen Knopf Ignorieren, und Ältere ignorieren ignoriert mit einem Klick alle ausser der neusten pro Ordner. Ignorierte Dateien bleiben in der Liste (durchgestrichen) und lassen sich mit Prüfen wieder einschalten. Ist eine ignorierte Datei offen, steht in der Statusleiste „Lernatelier: ignoriert“; ein Klick prüft sie wieder.

Die Liste der ignorierten Dateien speichert VS Code lokal für diesen Ordner. Sie landet nicht in deinen Dateien und nicht in git.

Was geprüft wird

• Nummer der Lernperiode in der Überschrift # Lern-Periode N
• Name: ist ausgefüllt (nicht „Exemplibus Exemplio“)
• Zeitraum: TT.MM.JJJJ bis TT.MM.JJJJ ist gültig
• Die vier Abschnitte der Grobplanung (Noten, Veränderungen, Projekte / neue Technologien, Generelle Ziele) enthalten je mindestens 20 Zeichen eigenen Text
• Jede Tagesplanung hat ein gültiges Datum, kommt nur einmal vor und liegt im Zeitraum
• Jede verlangte Tagesplanung hat 3 bis 5 ausgefüllte Arbeitspakete; Platzhalter zählen nicht
• Tagesreflexionen haben 50 bis 100 Wörter, die Lernperiodenreflexion 100 bis 200 Wörter
• Doppelte oder falsch eingeordnete Abschnitte werden gemeldet
• Abwesenheit: Steht direkt unter der Tagesüberschrift allein krank, Krankheit, abwesend, Absenz, absent oder absence, werden für diesen Tag keine Arbeitspakete und keine Reflexion verlangt.

Grün heisst formal vollständig. Die Qualität der Arbeitspakete, Ziele und Reflexionen beurteilt weiterhin deine Lehrperson.

Kalender: lernperiode.json

Liegt im selben Ordner wie deine Lernperiode-Datei eine lernperiode.json, prüft die Erweiterung zusätzlich nach Kalender:

{
  "learningperiod": 5,
  "days": ["2026-09-18", "2026-09-25", "2026-10-02"]
}

• learningperiod: Nummer der Lernperiode; sie muss zur Überschrift passen.
• days: die Unterrichtstage im Format JJJJ-MM-TT.

Mit Kalender werden Tagesplanungen bis heute und für den nächsten Unterrichtstag verlangt, spätere Tage dürfen noch Platzhalter enthalten. Tagesreflexionen sind am jeweiligen Tag fällig, die Lernperiodenreflexion am letzten Unterrichtstag. Ohne lernperiode.json wird das Dokument wie ein fertiges geprüft.

Kalender-Editor

Du musst die Datei nicht von Hand schreiben: Lernatelier: Kalender bearbeiten (lernperiode.json) … öffnet ein Formular, auch über den Kalender-Knopf in der Statusleiste oder in der Seitenleiste.

• Nummer und Zeitraum werden aus deinem Dokument übernommen (# Lern-Periode N, Zeitraum: … bis …). Du kannst sie im Formular ändern.
• Wochentage: An welchen Tagen ist Lernatelier? Die Wochentage deiner bisherigen Tagesplanungen sind schon angewählt; mehrere Tage sind möglich.
• Unterrichtstage: Alle passenden Daten im Zeitraum, nach Monat gruppiert und alle angewählt. Wähle Ferien und freie Tage ab. Tage, die im Dokument schon geplant sind, sind markiert. Mit Weiterer Tag fügst du einen Tag ausserhalb des Rhythmus hinzu.
• Vorschau: So sieht die lernperiode.json aus. Darunter steht, wie viele Tage gewählt sind und welcher der nächste Unterrichtstag ist.
• Speichern schreibt die Datei und prüft dein Dokument sofort mit dem neuen Kalender.

Gibt es schon eine lernperiode.json, lädt der Editor sie: deine abgewählten Tage bleiben abgewählt, und der Knopf heisst Speichern (ersetzt die bestehende Datei).

Es ist dasselbe Format wie beim Python-Werkzeug lernatelier-checker. Beim Bearbeiten der Datei schlägt VS Code die Felder vor und markiert falsche Daten.

Befehle

Öffne die Befehlspalette (Strg+Shift+P, auf dem Mac Cmd+Shift+P) und tippe „Lernatelier“:

• Lernatelier: Dokument prüfen prüft die offene Datei sofort und zeigt den Bericht. Auch über das Häkchen-Symbol oben rechts im Editor.
• Lernatelier: Bericht anzeigen zeigt den Bericht der offenen Datei.
• Lernatelier: Neue Lernperiode erstellen … fragt nach der Nummer und legt Lernperiode-N.md aus der offiziellen Vorlage an. Bestehende Dateien werden nie überschrieben.
• Lernatelier: Kalender bearbeiten (lernperiode.json) … öffnet den Kalender-Editor.
• Lernatelier: Lernperiode öffnen … zeigt alle Lernperiode-*.md im Ordner zur Auswahl.
• Lernatelier: Alle Lernperioden im Ordner prüfen prüft den ganzen Ordner neu.
• Lernatelier: Diese Lernperiode ignorieren / Diese Lernperiode wieder prüfen und Ältere Lernperioden ignorieren, siehe oben.
• Lernatelier: Nächste Tagesplanung einfügen fügt vor „Lernperiode Reflexion“ eine neue Tagesplanung mit drei leeren Arbeitspaketen und einer Tagesreflexion ein. Mit lernperiode.json nimmt sie den nächsten Unterrichtstag, der noch fehlt, sonst fragt sie nach dem Datum.

Snippets

Tippe in einer Markdown-Datei eines dieser Wörter und wähle den Vorschlag mit Enter:

• lernperiode: die ganze offizielle Vorlage. Mit Tab springst du zu Nummer, Name, Zeitraum (Beginn, Ende) und zum Datum der ersten Tagesplanung.
• planung (oder tag): eine neue Tagesplanung mit dem heutigen Datum, drei Arbeitspaketen und der Tagesreflexion.
• tagesreflexion: die Überschrift der Tagesreflexion mit Platzhalter.
• arbeitspaket (oder ap): eine neue Checkbox.

Die Platzhalter ...Ihr Text... zählen nicht als ausgefüllt, der Checker zeigt sie also an, bis du sie ersetzt hast.

In Markdown-Dateien schlägt VS Code Snippets nicht von selbst vor: Drücke nach dem Wort Strg+Leertaste (auf dem Mac Ctrl+Leertaste) oder wähle Snippet einfügen in der Befehlspalette. Wer die Vorschläge immer will, setzt in den Einstellungen "[markdown]": { "editor.quickSuggestions": { "other": "on" } }.

Einstellungen

• lernatelier.enable: automatisch prüfen (Standard: an)
• lernatelier.filePattern: welche Dateien geprüft werden (Standard: **/Lernperiode-*.md)
• lernatelier.checkWhileTyping: schon beim Tippen prüfen (Standard: an); aus = nur beim Öffnen und Speichern
• lernatelier.checkWorkspace: alle Lernperiode-Dateien im Ordner prüfen (Standard: an); aus = nur offene Dateien

Datenschutz

Die Erweiterung liest nur die Lernperiode-Dateien im geöffneten Ordner und die lernperiode.json daneben. Sie sendet nichts ins Internet, sammelt keine Daten und schreibt nur, wenn du einen der Befehle zum Erstellen oder Einfügen ausführst. Details stehen in PRIVACY.md.

Hilfe und Fehler melden

Fragen und Fehler bitte als GitHub Issue melden, siehe SUPPORT.md. Wenn eine Regel deiner Meinung nach falsch prüft, ist das meist eine Frage an die Bibliothek: lernatelier-checker-js.

Lizenz

MIT, siehe LICENSE. Die enthaltene Bibliothek lernatelier-checker-js und alle weiteren Bestandteile sind in THIRD-PARTY-NOTICES.md mit ihren Lizenzen aufgeführt.