Configuração: exercícios

#Estilos de exercício

A propriedade exerciseStyles declara os estilos nomeados que um exercício escolhe com :::exercise{style="…"}. Um estilo é a forma de uma família de exercícios; as perguntas e as respostas continuam no Markdown (veja Exercícios). Um estilo, exercise, vem por padrão, de modo que o delimitador funciona sem nenhuma configuração; declarar exerciseStyles o substitui, e o primeiro estilo declarado é o que vale para um exercício sem style. Todos os campos são opcionais, e os padrões seguem a língua do documento onde as escolas fazem diferente: rótulos das alternativas, letras de verdadeiro ou falso, a disposição da conta de dividir, as palavras impressas.

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 define o número do exercício. Um número solto sai em negrito, na cor principal, seguido de ponto; um número com forma é um algarismo branco dentro de um círculo, de um quadrado ou de um quadrado arredondado na cor principal, sem nada depois.

#Enunciado

instruction define os parágrafos iniciais do exercício. Os campos sem definir usam os do texto principal.

#Alternativas

options define as alternativas de uma pergunta de múltipla escolha (- [ ] …).

#Lacunas

blank define como um [[…]] é impresso no texto do aluno: um espaço do tamanho da resposta com uma linha, pontos ou um quadro, sem pintar a resposta.

#Verdadeiro ou falso

trueFalse define as respostas no fim de uma afirmação.

#Ligar colunas

match define um exercício de pares.

#Banco de palavras

bank define o quadro de palavras de um exercício de lacunas com bank ou ::bank[…], e de todo exercício de classificar. O quadro fica onde a linha ::bank está escrita; sem ela, sob o enunciado.

#Área de escrita

area define o espaço sob uma pergunta aberta, sob uma frase embaralhada e nas colunas de um exercício de classificar.

#Grades

grid define as casas dos caça-palavras, das cruzadas e das contas armadas.

#Contas armadas

arithmetic define as operações armadas em colunas.

#Dificuldade

level define as marcas que o level de um delimitador imprime depois do número, num tamanho menor.

#Ícones

icons associa um id a um ícone de atividade (oral, escrita, em dupla, de escuta, com calculadora), impresso depois do número quando um delimitador o indica: icon="pair".

Um ícone sai como um símbolo na linha depois do número: a imagem de resourceId quando nomeia uma, senão o glyph em fontFamily e em color (a do texto quando não indicada). Ele se apoia na linha de base do enunciado, tem size em de altura e seu alt é lido no lugar dele.

#Respostas

answers define as respostas onde quer que apareçam: numa edição do professor, no item-modelo de um exercício com example, nos círculos e quadradinhos preenchidos, nos traços entre pares, nas letras e algarismos das grades.

#Cores na tela

digital define como o visualizador HTML e os livros EPUB mostram uma resposta conferida.

#Ajustes do livro

A propriedade exercises guarda os ajustes do livro inteiro: a edição, o lugar das soluções, a semente de todos os embaralhamentos e as edições de tela. Um livro que não define exercises nem exerciseStyles é diagramado e gera o mesmo hash que antes.

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

#Soluções

exercises.solutions, e o solutions de um estilo por cima dele para os exercícios desse estilo.

#Edições na tela

exercises.digital define como os exercícios se comportam no visualizador HTML e nos livros EPUB.

A tela pode ter seus próprios ajustes de exercícios: htmlViewer.overrides também aceita exercises e exerciseStyles, mesclados sobre os do livro antes de o visualizador HTML diagramar. Assim, o impresso mantém as soluções no fim do capítulo enquanto a tela as esconde, ou a tela tira as áreas de escrita, que não servem para nada a quem lê.

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