Konfiguration: Übungen

#Übungsstile

Die Eigenschaft exerciseStyles legt die benannten Stile fest, die eine Übung mit :::exercise{style="…"} auswählt. Ein Stil ist die Form einer Familie von Übungen; Fragen und Lösungen bleiben im Markdown (siehe Übungen). Ein Stil, exercise, ist standardmäßig dabei, sodass der Block ohne jede Konfiguration funktioniert; wer exerciseStyles angibt, ersetzt ihn, und der erste angegebene Stil gilt für jede Übung ohne style. Alle Felder sind optional, und wo sich die Schulen unterscheiden, folgen die Standardwerte der Dokumentsprache: Kennbuchstaben der Antworten, Buchstaben für richtig und falsch, die Form der schriftlichen Division, die gedruckten Wörter.

const config: PostextConfig = {
  exerciseStyles: [
    {
      id: 'activity',
      box: 'activity-frame',
      number: { shape: 'disc', background: { hex: '#2a5ea8', model: 'hex' } },
      instruction: { fontFamily: 'Source Sans 3' },
      options: { marker: 'circle' },
      blank: { look: 'dots', width: 'answer' },
      area: { kind: 'grid', lines: 4 },
      level: { glyph: '★', empty: '☆' },
      icons: { pair: { glyph: '👥' } },
    },
    { id: 'quiz', extends: 'activity', options: { layout: 'row', columns: 4 } },
  ],
};

#Nummer

number legt die Nummer der Übung fest. Eine freistehende Nummer ist fett, in der Hauptfarbe, mit einem Punkt dahinter; eine Nummer in einer Form ist eine weiße Ziffer in einem Kreis, einem Quadrat oder einem abgerundeten Quadrat in der Hauptfarbe, ohne Zeichen dahinter.

#Arbeitsanweisung

instruction legt die einleitenden Absätze der Übung fest. Nicht gesetzte Felder übernehmen die Werte des Grundtexts.

#Antwortmöglichkeiten

options legt die Antwortmöglichkeiten einer Auswahlfrage fest (- [ ] …).

#Lücken

blank legt fest, wie ein [[…]] im Schülertext gedruckt wird: Raum in der Größe der Lösung mit einer Linie, Punkten oder einem Kästchen, ohne die Lösung selbst.

#Richtig oder falsch

trueFalse legt die Antworten am Ende einer Aussage fest.

#Zuordnen

match legt eine Übung mit Paaren fest.

#Wortspeicher

bank legt den Kasten mit Wörtern eines Lückentexts mit bank oder ::bank[…] und jeder Sortierübung fest. Der Kasten steht dort, wo die Zeile ::bank geschrieben ist, sonst unter der Arbeitsanweisung.

#Schreibfläche

area legt den Raum unter einer offenen Frage, unter einem Satz aus Wortteilen und in den Spalten einer Sortierübung fest.

#Gitter

grid legt die Felder von Wortsuchrätseln, Kreuzworträtseln und schriftlichen Rechnungen fest.

#Rechnen

arithmetic legt schriftliche Rechnungen fest.

#Schwierigkeit

level legt die Zeichen fest, die das level eines Blocks nach der Nummer druckt, in kleinerer Größe.

#Symbole

icons ordnet einer ID ein Arbeitsform-Symbol zu (mündlich, schriftlich, Partnerarbeit, Hören, Taschenrechner), das nach der Nummer gedruckt wird, wenn ein Block es nennt: icon="pair".

Ein Symbol wird als Inline-Symbol nach der Nummer gedruckt: das Bild von resourceId, wenn es eines nennt, sonst das glyph in fontFamily und in color (sonst in der Textfarbe). Es steht auf der Grundlinie der Arbeitsanweisung, ist size em hoch, und sein alt wird an seiner Stelle gelesen.

#Antworten

answers legt die Lösungen überall dort fest, wo sie erscheinen: in einer Lehrerausgabe, im Mustereintrag einer Übung mit example, als Kreise und gefüllte Kästchen, als Linien zwischen Paaren, als Buchstaben und Ziffern in Gittern.

#Bildschirmfarben

digital legt fest, wie der HTML-Betrachter und EPUB-Bücher eine geprüfte Antwort zeigen.

#Bucheinstellungen

Die Eigenschaft exercises enthält die Einstellungen für das ganze Buch: die Ausgabe, wo die Lösungen stehen, den Startwert jedes Mischens und die Bildschirmausgaben. Ein Buch, das weder exercises noch exerciseStyles setzt, wird gesetzt und gehasht wie bisher.

const config: PostextConfig = {
  exercises: {
    edition: 'student',
    solutions: { placement: 'chapterEnd', layout: 'key' },
    seed: 3,
    digital: { check: 'instant' },
  },
};

#Lösungen

exercises.solutions, und darüber das solutions eines Stils für die Übungen dieses Stils.

#Bildschirmausgaben

exercises.digital legt fest, wie sich Übungen im HTML-Betrachter und in EPUB-Büchern verhalten.

Der Bildschirm kann eigene Übungseinstellungen haben: htmlViewer.overrides nimmt auch exercises und exerciseStyles auf, die über die des Buchs gelegt werden, bevor der HTML-Betrachter setzt. So behält der Druck seine Lösungen am Kapitelende, während der Bildschirm sie ausblendet, oder der Bildschirm verzichtet auf die Schreibflächen, mit denen man dort nichts anfangen kann.

const config: PostextConfig = {
  htmlViewer: {
    overrides: {
      exercises: { solutions: { placement: 'none' } },
      exerciseStyles: [{ id: 'exercise', area: { kind: 'none' }, blank: { minWidth: { value: 6, unit: 'em' } } }],
    },
  },
};