Configuración: ejercicios

#Estilos de ejercicio

La propiedad exerciseStyles declara los estilos con nombre que un ejercicio elige con :::exercise{style="…"}. Un estilo es la forma de una familia de ejercicios; las preguntas y las respuestas siguen en el Markdown (consulta Ejercicios). Por defecto se incluye un estilo, exercise, así que el contenedor funciona sin configuración; declarar exerciseStyles lo sustituye, y el primer estilo declarado es el que toma un ejercicio sin style. Todos los campos son opcionales, y los valores por defecto siguen el idioma del documento allí donde las escuelas no coinciden: las letras de las opciones, las letras de verdadero o falso, la disposición de la división y las palabras que se imprimen.

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 fija el número del ejercicio. Un número suelto va en negrita, en el color principal y seguido de punto; uno con forma es una cifra blanca dentro de un círculo, un cuadrado o un cuadrado redondeado del color principal, sin nada detrás.

#Enunciado

instruction fija los párrafos con los que empieza el ejercicio. Los campos sin fijar toman los del texto base.

#Opciones

options fija las opciones de una pregunta de opción múltiple (- [ ] …).

#Huecos

blank fija cómo se imprime un [[…]] en el texto del alumno: un espacio del tamaño de la respuesta, con una línea, puntos o una caja, sin pintar la respuesta.

#Verdadero o falso

trueFalse fija las respuestas que van al final de una afirmación.

#Relacionar

match fija un ejercicio de parejas.

#Banco de palabras

bank fija el recuadro de palabras de un ejercicio de huecos con bank o ::bank[…], y de todo ejercicio de clasificar. El recuadro va donde está escrita la línea ::bank; sin ella, bajo el enunciado.

#Espacio para escribir

area fija el espacio que queda bajo una pregunta abierta, bajo una frase desordenada y en las columnas de un ejercicio de clasificar.

#Cuadrículas

grid fija las casillas de las sopas de letras, los crucigramas y las operaciones en columnas.

#Operaciones

arithmetic fija las operaciones en columnas.

#Dificultad

level fija las marcas que el atributo level de un contenedor imprime detrás del número, en un cuerpo menor.

#Iconos

icons asocia un id a un icono de actividad (oral, escrita, en pareja, de escucha, con calculadora), que se imprime detrás del número cuando un contenedor lo nombra: icon="pair".

Un icono se imprime como un símbolo en línea tras el número: la imagen de resourceId si nombra una, y si no el glyph en fontFamily y en color (el del texto si no se indica). Se apoya en la línea de base del enunciado, mide size em de alto y su alt se lee en su lugar.

#Respuestas

answers fija el aspecto de las respuestas allí donde aparecen: la edición del profesor, el elemento modelo de un ejercicio con example, los círculos y las casillas rellenas, las líneas trazadas entre parejas, y las letras y cifras de las cuadrículas.

#Colores en pantalla

digital fija cómo muestran el visor HTML y los libros EPUB una respuesta corregida.

#Ajustes del libro

La propiedad exercises reúne los ajustes de todo el libro: la edición, dónde se imprimen las soluciones, la semilla de todos los desórdenes y las ediciones en pantalla. Un libro que no fija ni exercises ni exerciseStyles se compone igual que antes y conserva el mismo hash.

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

#Soluciones

exercises.solutions, y por encima, para los ejercicios de un estilo, el solutions de ese estilo.

#Ediciones en pantalla

exercises.digital fija cómo se comportan los ejercicios en el visor HTML y en los libros EPUB.

La pantalla puede tener sus propios ajustes de ejercicios: htmlViewer.overrides admite también exercises y exerciseStyles, que se combinan con los del libro antes de que el visor HTML maquete. Así el papel puede llevar las soluciones al final del capítulo mientras la pantalla las oculta, o la pantalla puede prescindir de los espacios para escribir, que al lector no le sirven.

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