Quest Ladder
TeachFORGE.ai
Quest Ladder / Extensões 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. Isto é um valor que se monta a si próprio.
Para que servem
Uma variável coloca um valor. Por 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.
Uma extensão inteligente é uma pequena rotina nomeada que produz esse conteúdo. Constrói-a uma vez na Biblioteca de extensões inteligentes, depois insere-a em qualquer sítio — o texto da pergunta, uma dica, um passo de solução, um bloco de aprendizagem ativa — e expande-se no lugar.
Cada uma é uma linha de acordeão na biblioteca: abra uma para a editar, feche-a para trabalhar noutra. Adicionar extensão inteligente cria uma, e Duplicar é a forma mais rápida de uma variante.
Nomear um
Uma extensão tem um Nome de apresentação para si, um Id interno usado no token que a insere, e um opcional Propósito. Mantenha o id curto: é o que lerá dentro de um bloco de texto da pergunta quando voltar a ele.
Os dez tipos de passo
Uma extensão é uma lista de passos que correm por 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 numa linha, com um separador à sua escolha. |
| Se isto for verdade… | Emite uma coisa ou outra consoante uma condição. |
| Repetir para cada número… | Conta de um valor a outro, emitindo de cada vez. |
Há mais cinco quando precisar deles: Valor calculado temporário, Bloco de expressão matemática, Para cada item da lista…, Enquanto a condição se mantiver… e Tabela a partir de lista.
Os campos leem-se tão claramente como os nomes — Quando isto for verdade, Então fazer…, Caso contrário fazer…, Nome do contador, De, Até, Tamanho do passo, Quantos?, Espaço entre cada, Separador. Está a descrever o conteúdo, não a escrever código.
Usar um
Uma vez guardada uma extensão, o Extensões inteligentes do tabuleiro Inserir oferece-a. Em linha no texto coloca o token no cursor para que se expanda dentro da frase que está a escrever; tem de clicar primeiro num campo de texto, e o editor diz-lho se não o tiver feito.
Construa a extensão, guarde o rascunho e só depois a procure no tabuleiro. A lista pendente lê a biblioteca guardada, por isso uma extensão que acabou de escrever e não guardou ainda não está lá — o que parece um erro e não é.
Quando não usar
Uma extensão vale a pena quando o conteúdo varia genuinamente de forma. Quando varia só de valor, uma variável simples é mais simples e mais fácil de ler seis meses depois.
O Guia de construção manual tem exemplos trabalhados de cada tipo de passo, e é o sítio a ir quando quer ver um montado em vez de descrito.