Configuration : exercices

#Styles d’exercice

La propriété exerciseStyles déclare les styles nommés qu’un exercice choisit avec :::exercise{style="…"}. Un style est la forme d’une famille d’exercices ; les questions et les réponses restent dans le Markdown (voir Exercices). Un style, exercise, est fourni par défaut : le délimiteur fonctionne donc sans aucune configuration. Déclarer exerciseStyles le remplace, et le premier style déclaré est celui que prend un exercice sans style. Tous les champs sont facultatifs, et les valeurs par défaut suivent la langue du document là où les usages scolaires diffèrent : lettres des propositions, lettres vrai/faux, disposition de la division posée, mots imprimés.

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

#Numéro

number règle le numéro de l’exercice. Un numéro nu est en gras, dans la couleur principale, suivi d’un point ; un numéro dans une forme est un chiffre blanc dans un disque, un carré ou un carré arrondi de la couleur principale, sans rien après.

#Consigne

instruction règle les paragraphes qui ouvrent l’exercice. Les champs non définis prennent la valeur du texte courant.

#Propositions

options règle les propositions d’une question à choix (- [ ] …).

#Trous

blank règle l’impression d’un [[…]] dans le texte de l’élève : un espace à la taille de la réponse, avec une ligne, des pointillés ou une case, la réponse elle-même n’étant pas peinte.

#Vrai ou faux

trueFalse règle les réponses en fin d’affirmation.

#Relier

match règle un exercice de paires.

#Banque de mots

bank règle la boîte de mots d’un exercice à trous avec bank ou ::bank[…], et de tout exercice de classement. La boîte se place là où est écrite la ligne ::bank, sinon sous la consigne.

#Zone d’écriture

area règle l’espace sous une question à réponse libre, sous une phrase en désordre et dans les colonnes d’un exercice de classement.

#Grilles

grid règle les cases des mots mêlés, des mots croisés et des opérations posées.

#Calcul posé

arithmetic règle les opérations posées.

#Difficulté

level règle les marques que l’attribut level d’un délimiteur imprime après le numéro, en plus petit corps.

#Icônes

icons associe un identifiant à une icône d’activité (oral, écrit, travail en binôme, écoute, calculatrice), imprimée après le numéro quand un délimiteur la nomme : icon="binome".

Une icône s’imprime comme un symbole en ligne après le numéro : l’image de resourceId si elle en nomme une, sinon le glyph dans fontFamily et en color (celle du texte par défaut). Elle repose sur la ligne de base de la consigne, haute de size em, et son alt est lu à sa place.

#Réponses

answers règle les réponses partout où elles apparaissent : livre du professeur, item modèle d’un exercice avec example, ronds et cases noircies, traits entre les paires, lettres et chiffres dans les grilles.

#Couleurs à l’écran

digital règle l’affichage d’une réponse vérifiée dans la visionneuse HTML et les livres EPUB.

#Réglages du livre

La propriété exercises contient les réglages de tout le livre : l’édition, l’emplacement des solutions, la graine de tous les mélanges et les éditions à l’écran. Un livre qui ne fixe ni exercises ni exerciseStyles se met en page et se hache comme avant.

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

#Solutions

exercises.solutions, et le solutions d’un style par-dessus pour les exercices de ce style.

#Éditions à l’écran

exercises.digital règle le comportement des exercices dans la visionneuse HTML et dans les livres EPUB.

L’écran peut avoir ses propres réglages d’exercices : htmlViewer.overrides accepte aussi exercises et exerciseStyles, fusionnés avec ceux du livre avant la mise en page de la visionneuse HTML. L’imprimé peut ainsi garder ses solutions en fin de chapitre pendant que l’écran les cache, ou l’écran peut supprimer les zones d’écriture dont un lecteur n’a que faire.

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