Quest Ladder
TeachFORGE.ai
Quest Ladder / Complementos inteligentes
Complementos inteligentes: lógica e repetições dentro de uma pergunta
Quando uma pergunta precisa de uma lista, uma tabela ou uma frase cujo comprimento depende dos números gerados.
Um valor é um valor. Este é um valor que se monta sozinho.
Para que servem
Uma variável coloca um valor. Às vezes uma pergunta precisa de algo cuja forma depende dos valores: uma lista de cinco termos quando n é cinco, uma tabela com uma linha por item, uma frase que diz e antes do último de quantas coisas houver.
Um complemento inteligente é uma pequena rotina nomeada que produz esse conteúdo. Você o monta uma vez na Biblioteca de complementos inteligentes, depois o insere em qualquer lugar — o texto da pergunta, uma dica, um passo de solução, um bloco de aprendizagem ativa — e ele se expande no lugar.
Cada um é uma linha em acordeão na biblioteca: abra um para editá-lo, feche-o para trabalhar em outro. Adicionar complemento inteligente cria um, e Duplicar é o jeito mais rápido de chegar a uma variante.
Nomeando um
Um complemento tem um Nome de exibição para você, um Id interno usado no token que o insere, e um opcional Propósito. Mantenha o id curto: é o que você lerá dentro de um bloco de texto da pergunta quando voltar a ele.
Os dez tipos de passo
Um complemento é uma lista de passos que rodam em ordem. Cinco são os do dia a dia.
| Passo | Faz |
|---|---|
| Adicionar texto | Emite texto, em forma simples, Markdown, LaTeX ou código. |
| Mostrar muitas vezes | Repete algo um número de vezes — uma imagem, um símbolo, uma frase. |
| Sequência numérica (uma linha) | Emite uma sequência de números em uma linha, com um separador que você escolhe. |
| Se isto for verdadeiro… | Emite uma coisa ou outra dependendo de uma condição. |
| Repetir para cada número… | Conta de um valor a outro, emitindo a cada vez. |
Mais cinco estão aí quando você precisar: Valor calculado temporário, Bloco de expressão matemática, Para cada item da lista…, Enquanto a condição valer… e Tabela a partir de lista.
Os campos leem tão claramente quanto os nomes — Quando isto for verdadeiro, Então faça…, Caso contrário faça…, Nome do contador, De, Até, Tamanho do passo, Quantos?, Espaço entre cada, Separador. Você está descrevendo o conteúdo, não escrevendo código.
Usando um
Depois que um complemento é salvo, o Complementos inteligentes da bandeja Inserir o oferece. Em linha no texto insere o token no cursor para expandir dentro da frase que você está escrevendo; é preciso clicar em um campo de texto primeiro, e o editor diz isso se você não tiver feito.
Monte o complemento, salve o rascunho, e só então vá procurá-lo na bandeja. O menu lê a biblioteca salva, então um complemento que você acabou de digitar e não salvou ainda não está lá — o que parece um bug e não é.
Quando não usar
Um complemento vale a pena quando o conteúdo de fato varia na forma. Quando varia só no valor, uma variável simples é mais simples e mais fácil de ler seis meses depois.
O Guia de construção manual tem exemplos resolvidos de cada tipo de passo, e é o lugar a ir quando você quer ver um montado em vez de descrito.