Configuració: exercicis

#Estils d'exercici

La propietat exerciseStyles declara els estils amb nom que un exercici tria amb :::exercise{style="…"}. Un estil és la forma d'una família d'exercicis; les preguntes i les respostes es queden al Markdown (vegeu Exercicis). Per defecte s'inclou un estil, exercise, de manera que el bloc funciona sense cap configuració; si declares exerciseStyles, el substitueixes, i el primer estil declarat és el que pren un exercici sense style. Tots els camps són opcionals, i els valors per defecte segueixen la llengua del document allà on les escoles fan les coses de manera diferent: les etiquetes de les opcions, les lletres de vertader o fals, la manera de disposar la divisió i les paraules que s'imprimeixen.

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

#Número

number defineix el número de l'exercici. Un número sol va en negreta, en el color principal, seguit d'un punt; un número dins d'una forma és una xifra blanca sobre un cercle, un quadrat o un quadrat arrodonit del color principal, sense res al darrere.

#Enunciat

instruction defineix els paràgrafs inicials de l'exercici. Els camps sense valor prenen el del text.

#Opcions

options defineix les opcions d'una pregunta d'opció múltiple (- [ ] …).

#Buits

blank defineix com s'imprimeix un [[…]] al text de l'alumne: un espai de la mida de la resposta amb una línia, punts o una caixa, sense pintar la resposta.

#Vertader o fals

trueFalse defineix les respostes del final d'una afirmació.

#Relacionar

match defineix un exercici de parelles.

#Banc de paraules

bank defineix la caixa de paraules d'un exercici de buits amb bank o ::bank[…], i de tots els exercicis de classificar. La caixa va on és escrita la línia ::bank; sense línia, sota l'enunciat.

#Espai per escriure

area defineix l'espai que hi ha sota una pregunta oberta, sota una frase desordenada i a les columnes d'un exercici de classificar.

#Graelles

grid defineix les caselles de les sopes de lletres, els mots encreuats i les operacions en columna.

#Operacions

arithmetic defineix les operacions en columna.

#Dificultat

level defineix les marques que el level d'un bloc imprimeix després del número, en una mida més petita.

#Icones

icons associa un id a una icona d'activitat (oral, escrita, en parella, d'escoltar, amb calculadora), que s'imprimeix després del número quan un bloc l'anomena: icon="pair".

Una icona s'imprimeix com un símbol en línia després del número: la imatge de resourceId si n'anomena una, i si no el glyph en fontFamily i en color (el del text si no s'indica). Recolza en la línia de base de l'enunciat, fa size em d'alçada i el seu alt es llegeix al seu lloc.

#Respostes

answers defineix les respostes allà on es mostren: una edició del professorat, l'element model d'un exercici amb example, els cercles i les caselles plenes, les línies entre parelles, les lletres i les xifres de les graelles.

#Colors a la pantalla

digital defineix com mostren una resposta comprovada el visor HTML i els llibres EPUB.

#Paràmetres del llibre

La propietat exercises conté els paràmetres de tot el llibre: l'edició, on s'imprimeixen les solucions, la llavor de totes les barreges i les edicions en pantalla. Un llibre que no fixa ni exercises ni exerciseStyles es compon i dona el mateix hash que abans.

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

#Solucions

exercises.solutions val per a tot el llibre; el solutions d'un estil hi canvia el que calgui per als exercicis d'aquell estil.

#Edicions en pantalla

exercises.digital defineix com es comporten els exercicis al visor HTML i als llibres EPUB.

La pantalla pot tenir uns paràmetres d'exercicis propis: htmlViewer.overrides també accepta exercises i exerciseStyles, que es fusionen amb els del llibre abans que el visor HTML faci la maquetació. Així, la impressió pot mantenir les solucions al final del capítol mentre la pantalla les amaga, o la pantalla pot prescindir dels espais per escriure, que en pantalla no fan cap servei.

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