Quest Ladder
TeachFORGE.ai
Quest Ladder / Componenti intelligenti
Componenti intelligenti: logica e ripetizioni dentro una domanda
Quando una domanda serve un elenco, una tabella o una frase la cui lunghezza dipende dai numeri generati.
Un valore è un valore. Questo è un valore che si assembla da solo.
A cosa servono
Una variabile colloca un valore. A volte una domanda serve qualcosa la cui forma dipende dai valori: un elenco di cinque termini quando N è cinque, una tabella con una riga per elemento, una frase che dice e prima dell'ultimo di quanti oggetti ci siano.
Un componente intelligente è una piccola routine con nome che produce quel contenuto. Lo costruisci una volta nella Libreria dei componenti intelligenti, poi lo inserisci ovunque — il testo della domanda, un suggerimento, uno step di soluzione, un blocco di apprendimento attivo — e si espande sul posto.
Ognuno è una riga a fisarmonica nella libreria: aprine uno per modificarlo, chiudilo per lavorarne un altro. Aggiungi componente intelligente ne crea uno, e Duplica è il modo più rapido per una variante.
Nominarne uno
Un componente ha un Nome visualizzato per te, un Id interno usato nel token che lo inserisce, e un facoltativo Scopo. Tieni l'id breve: è ciò che leggerai dentro un blocco di testo della domanda quando ci tornerai.
I dieci tipi di step
Un componente è un elenco di step che vengono eseguiti in ordine. Cinque sono quelli di tutti i giorni.
| Passo | Fa |
|---|---|
| Aggiungi testo | Emette testo, in forma semplice, Markdown, LaTeX o codice. |
| Mostra molte volte | Ripete qualcosa un certo numero di volte — un'immagine, un simbolo, una frase. |
| Sequenza numerica (una riga) | Emette una serie di numeri su una riga, con un separatore che scegli. |
| Se questo è vero… | Emette una cosa o un'altra a seconda di una condizione. |
| Ripeti per ogni numero… | Conta da un valore a un altro, emettendo ogni volta. |
Altri cinque ci sono quando ti servono: Valore calcolato temporaneo, Blocco espressione matematica, Per ogni elemento dell'elenco…, Finché la condizione vale… e Tabella da elenco.
I loro campi si leggono tanto chiaramente quanto i nomi — Quando questo è vero, Allora fai…, Altrimenti fai…, Nome del contatore, Da, A, Dimensione dello step, Quanti?, Spazio tra ciascuno, Separatore. Stai descrivendo il contenuto, non scrivendo codice.
Usarne uno
Una volta salvato un componente, il menu a discesa Componenti intelligenti del vassoio Inserisci lo offre. In linea nel testo inserisce il token al cursore così si espande nella frase che stai scrivendo; devi prima cliccare in un campo di testo, e l'editor te lo dice se non l'hai fatto.
Costruisci il componente, salva la bozza, e solo allora cercalo nel vassoio. Il menu legge la libreria salvata, quindi un componente appena digitato e non salvato non c'è ancora — il che sembra un bug e non lo è.
Quando non usarli
Un componente vale la pena quando il contenuto varia davvero di forma. Quando varia solo di valore, una variabile semplice è più semplice e più facile da leggere sei mesi dopo.
La guida integrata nell'app Guida alla costruzione manuale ha esempi funzionanti di ciascun tipo di step, ed è il posto dove andare quando vuoi vederne uno assemblato piuttosto che descritto.