Quest Ladder
TeachFORGE.ai
Quest Ladder / Умные дополнения
Умные дополнения: логика и повторы внутри вопроса
Когда вопросу нужен список, таблица или предложение, чья длина зависит от сгенерированных чисел.
Значение — значение. Это значение, которое собирает себя само.
Для чего они
Переменная ставит одно значение. Иногда вопросу нужно то, чья форма зависит от значений: список из пяти членов, когда n равно пяти, таблица со строкой на элемент, предложение, которое говорит и перед последним из скольких угодно вещей.
Умное дополнение — небольшая именованная процедура, которая производит этот контент. Соберите один раз в Библиотеке умных дополнений, затем вставьте куда угодно — текст вопроса, подсказку, шаг решения, блок активного обучения — и оно развернётся на месте.
Каждое — строка-аккордеон в библиотеке: откройте, чтобы править, закройте, чтобы работать над другим. Добавить умное дополнение создаёт одно, а Дублировать — самый быстрый путь к варианту.
Как назвать
У дополнения есть Отображаемое имя для вас, Внутренний id , используемый в токене вставки, и необязательный Назначение. Держите id коротким: его вы будете читать внутри блока текста вопроса, когда вернётесь.
Десять видов шагов
Дополнение — список шагов по порядку. Пять — повседневные.
| Шаг | Делает |
|---|---|
| Добавить текст | Выдаёт текст — простой, Markdown, LaTeX или код. |
| Показать много раз | Повторяет что-то несколько раз — картинку, символ, фразу. |
| Числовая последовательность (одна строка) | Выдаёт ряд чисел в одну строку с выбранным разделителем. |
| Если это верно… | Выдаёт одно или другое в зависимости от условия. |
| Повторить для каждого числа… | Считает от одного значения до другого, выдавая каждый раз. |
Ещё пять — когда нужны: Временное вычисляемое значение, Блок математического выражения, Для каждого элемента списка…, Пока условие верно… и Таблица из списка.
Их поля читаются так же прямо, как имена — Когда это верно, Тогда сделать…, Иначе сделать…, Имя счётчика, Из, До, Шаг, Сколько?, Промежуток между, Разделитель. Вы описываете контент, а не пишете код.
Как пользоваться
Когда дополнение сохранено, в лотке Insert выпадающий список Умные дополнения предлагает его. Встроенно в текст ставит токен в курсор, чтобы развернуть внутри предложения; сначала нужно кликнуть в текстовое поле — редактор так и скажет, если вы этого не сделали.
Соберите дополнение, сохраните черновик — и только потом ищите его в лотке. Выпадающий список читает сохранённую библиотеку, поэтому только что набранное и не сохранённое ещё не там — похоже на баг и им не является.
Когда не стоит
Дополнение стоит того, когда контент реально меняет форму. Когда меняется только значение — простая переменная проще и читаемее через полгода.
Встроенное Руководство по ручной сборке есть разобранные примеры каждого вида шага — туда, когда хотите увидеть собранное, а не описанное.