Quest Ladder
TeachFORGE.ai
Quest Ladder / Complementos inteligentes
Complementos inteligentes: lógica y repeticiones dentro de una pregunta
Cuando una pregunta necesita una lista, una tabla o una frase cuya longitud depende de los números generados.
Un valor es un valor. Esto es un valor que se ensambla solo.
Para qué sirven
Una variable coloca un valor. A veces una pregunta necesita algo cuya forma depende de los valores: una lista de cinco términos cuando n es cinco, una tabla con una fila por elemento, una frase que dice y antes del último de los elementos que haya, sean cuantos sean.
Un complemento inteligente es una pequeña rutina con nombre que genera ese contenido. Se construye una vez en la Biblioteca de complementos inteligentes, y después se inserta en cualquier sitio (el texto de la pregunta, una pista, un paso de solución, un bloque de aprendizaje activo) y se expande en el lugar.
Cada uno es una fila desplegable en la biblioteca: abre uno para editarlo, ciérralo para trabajar en otro. Añadir complemento inteligente crea uno, y Duplicar es la forma más rápida de conseguir una variante.
Darle nombre a uno
Un complemento tiene un Nombre visible para ti, un Id interno usado en el token que lo inserta, y una opcional Propósito. Mantén el id corto: es lo que leerás dentro de un bloque de texto de pregunta cuando vuelvas a él.
Los diez tipos de paso
Un complemento es una lista de pasos que se ejecutan en orden. Cinco son los habituales.
| Paso | Qué hace |
|---|---|
| Añadir texto | Genera texto, en formato plano, Markdown, LaTeX o código. |
| Mostrar varias veces | Repite algo un número de veces: una imagen, un símbolo, una frase. |
| Secuencia numérica (una línea) | Genera una serie de números en una línea, con un separador que eliges. |
| Si esto es cierto… | Genera una cosa u otra según una condición. |
| Repetir para cada número… | Cuenta de un valor a otro, generando contenido en cada paso. |
Hay cinco más disponibles cuando los necesites: Valor calculado temporal, Bloque de expresión matemática, Para cada elemento de la lista…, Mientras se cumpla la condición… y Tabla a partir de una lista.
Sus campos se entienden con la misma claridad que sus nombres — Cuando esto es cierto, Entonces hacer…, En caso contrario, hacer…, Nombre del contador, Desde, Hasta, Tamaño del paso, ¿Cuántos?, Distancia entre cada uno, Separador. Estás describiendo el contenido, no escribiendo código.
Usar uno
Una vez guardado un complemento, el menú desplegable Complementos inteligentes de la bandeja Insertar lo ofrece. En línea en el texto coloca el token en el cursor para que se expanda dentro de la frase que estás escribiendo; primero tienes que hacer clic en un campo de texto, y el editor te lo indica si no lo has hecho.
Construye el complemento, guarda el borrador, y solo entonces ve a buscarlo en la bandeja. El menú desplegable lee la biblioteca guardada, así que un complemento que acabas de escribir y no has guardado todavía no aparece ahí, lo cual parece un error pero no lo es.
Cuándo no usarlos
Un complemento merece la pena cuando el contenido varía realmente de forma. Cuando solo varía en valor, una variable sencilla es más simple y más fácil de leer seis meses después.
La Guía de construcción manual tiene ejemplos resueltos de cada tipo de paso, y es el lugar al que ir cuando quieres ver uno montado en lugar de descrito.