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 oración cuya longitud depende de los números generados.
Un valor es un valor. Esto es un valor que se ensambla a sí mismo.
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 oración que dice y antes del último de la cantidad de cosas que haya.
Un complemento inteligente es una pequeña rutina con nombre que produce ese contenido. Lo construyes una vez en la Biblioteca de complementos inteligentes, y luego lo insertas donde sea: el texto de la pregunta, una pista, un paso de solución, un bloque de aprendizaje activo, y se expande ahí mismo.
Cada uno es una fila de acordeón en la biblioteca: abre uno para editarlo, cierra para trabajar en otro. Agregar complemento inteligente crea uno, y Duplicar es la forma más rápida de llegar a una variante.
Nombrar uno
Un complemento tiene un Nombre visible para ti, un Id interno usado en el token que lo inserta, y una Propósitoopcional. 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 cotidianos.
| Paso | Hace |
|---|---|
| Agregar texto | Emite texto, en formato simple, Markdown, LaTeX o código. |
| Mostrar varias veces | Repite algo una cantidad de veces: una imagen, un símbolo, una frase. |
| Secuencia numérica (una línea) | Emite una serie de números en una línea, con un separador que elijas. |
| Si esto es verdadero… | Emite una cosa u otra según una condición. |
| Repetir para cada número… | Cuenta desde un valor hasta otro, emitiendo cada vez. |
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 leen tan claramente como sus nombres — Cuando esto es verdadero, Entonces hacer…, De lo contrario, hacer…, Nombre del contador, Desde, Hasta, Tamaño del paso, ¿Cuántos?, Separación entre cada uno, Separador. Estás describiendo el contenido, no escribiendo código.
Usar uno
Una vez que se guarda un complemento, la bandeja de Insertar Complementos inteligentes lo ofrece en su menú desplegable. En línea dentro del texto coloca el token en el cursor para que se expanda dentro de la oración 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 búscalo 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 está ahí, lo cual parece un error y no lo es.
Cuándo no hacerlo
Un complemento vale la pena cuando el contenido realmente varía en forma. Cuando solo varía en valor, una variable simple es más fácil de leer seis meses después.
La guía dentro de la aplicación Guía de construcción manual tiene ejemplos resueltos de cada tipo de paso, y es el lugar al que acudir cuando quieres ver uno ensamblado en lugar de descrito.