Configurazione: esercizi

#Stili degli esercizi

La proprietà exerciseStyles dichiara gli stili con nome che un esercizio sceglie con :::exercise{style="…"}. Uno stile è la forma di una famiglia di esercizi; domande e risposte restano nel Markdown (vedi Esercizi). Per impostazione predefinita è incluso uno stile, exercise, così il blocco funziona senza alcuna configurazione; dichiarare exerciseStyles lo sostituisce, e il primo stile dichiarato è quello che prende un esercizio senza style. Ogni campo è facoltativo, e i valori predefiniti seguono la lingua del documento dove le scuole hanno usi diversi: lettere delle opzioni, lettere di vero/falso, disposizione della divisione in colonna, parole stampate.

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 } },
  ],
};

#Numero

number imposta il numero dell’esercizio. Un numero semplice è in grassetto, nel colore principale, seguito da un punto; un numero in una forma è una cifra bianca dentro un cerchio, un quadrato o un quadrato arrotondato del colore principale, senza nulla dopo.

#Consegna

instruction imposta i paragrafi iniziali dell’esercizio. I campi non impostati prendono i valori del testo corrente.

#Opzioni

options imposta le opzioni di una domanda a scelta multipla (- [ ] …).

#Spazi da completare

blank imposta come si stampa un [[…]] nel testo dell’alunno: uno spazio della misura della risposta con una riga, dei puntini o una casella, senza disegnare la risposta.

#Vero o falso

trueFalse imposta le risposte alla fine di un’affermazione.

#Collegamento

match imposta un esercizio di coppie.

#Riquadro di parole

bank imposta il riquadro di parole di un completamento con bank o ::bank[…], e di ogni esercizio di classificazione. Il riquadro sta dove è scritta la riga ::bank, altrimenti sotto la consegna.

#Area di scrittura

area imposta lo spazio sotto una domanda aperta, sotto una frase da riordinare e nelle colonne di un esercizio di classificazione.

#Schemi

grid imposta le caselle di cerca parole, cruciverba e operazioni in colonna.

#Operazioni in colonna

arithmetic imposta le operazioni in colonna.

#Difficoltà

level imposta i segni che l’attributo level di un blocco stampa dopo il numero, in un corpo minore.

#Icone

icons associa un id a un’icona di attività (orale, scritta, a coppie, ascolto, calcolatrice), stampata dopo il numero quando un blocco la richiama: icon="pair".

Un’icona si stampa come simbolo in linea dopo il numero: l’immagine di resourceId se ne nomina una, altrimenti il glyph in fontFamily e in color (quello del testo se non indicato). Poggia sulla linea di base della consegna, alta size em, e il suo alt si legge al suo posto.

#Risposte

answers imposta le risposte ovunque compaiano: nella guida per l’insegnante, nell’elemento modello di un esercizio con example, nei cerchi e nelle caselle piene, nelle linee tracciate tra le coppie, nelle lettere e nelle cifre degli schemi.

#Colori a schermo

digital imposta come il visualizzatore HTML e i libri EPUB mostrano una risposta controllata.

#Impostazioni del libro

La proprietà exercises raccoglie le impostazioni di tutto il libro: l’edizione, la posizione delle soluzioni, il seme di ogni mescolamento e le edizioni a schermo. Un libro che non imposta né exercises né exerciseStyles si impagina e produce lo stesso hash di prima.

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

#Soluzioni

exercises.solutions, e sopra di esso il solutions di uno stile per gli esercizi di quello stile.

#Edizioni a schermo

exercises.digital imposta il comportamento degli esercizi nel visualizzatore HTML e nei libri EPUB.

Lo schermo può avere impostazioni degli esercizi proprie: htmlViewer.overrides accetta anche exercises ed exerciseStyles, che si sovrappongono a quelli del libro prima che il visualizzatore HTML impagini. Così la stampa tiene le soluzioni alla fine del capitolo mentre lo schermo le nasconde, oppure lo schermo toglie le aree di scrittura che a chi legge non servono.

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