> **Версия 0.2:** HTML-интерактивы с собственным JavaScript теперь загружаются как есть и исполняются в изолированной песочнице. Руководство: [INTERACTIVES.md](INTERACTIVES.md). Описанный ниже формат `application/ipres+json` (стандартные формы) продолжает работать. # Как сделать презентацию с интерактивами Итог: одна ссылка для спикера, одна для участников. Спикер листает слайды, у участников они листаются сами. На слайде задания участники отвечают с телефона, на следующем слайде все видят результаты и разбор. Весь путь — **4 шага**: 1. [Подготовить HTML-файл презентации](#шаг-1-подготовить-html-файл) 2. [Добавить интерактивы](#шаг-2-добавить-интерактивы) 3. [Загрузить и проверить](#шаг-3-загрузить-и-проверить) 4. [Провести занятие](#шаг-4-провести-занятие) В конце — [справочник](#справочник), [готовые промпты](#промпты-для-нейросети) и [частые проблемы](#частые-проблемы). --- ## Шаг 1. Подготовить HTML-файл Выберите свой случай: | У вас есть… | Что делать | |---|---| | **HTML из Bento** (как у Андрея) | ничего — загружайте как есть, переходите к шагу 2 | | **HTML старой темы курса** (`training`) | ничего — загружайте как есть, переходите к шагу 2 | | **Любая другая HTML-презентация** | отдать нейросети с [промптом А](#а-переделать-готовую-html-презентацию) | | **PPTX, PDF или DOCX** | отдать нейросети с [промптом Б](#б-собрать-презентацию-из-pptx-pdf-docx) | | **Хотите сверстать сами** | взять шаблон [`examples/minimal-deck.html`](../examples/minimal-deck.html) | Главные правила файла (полный список — в [справочнике](#правила-вёрстки)): - каждый слайд — отдельный `
`; - слайд сверстан в фиксированных пикселях (обычно 1920×1080), а в `` указан размер: ``; - без JavaScript (его вырежут при загрузке); шрифты и картинки встроены в файл. --- ## Шаг 2. Добавить интерактивы **Интерактив** — это задание для участников: 2–5 вопросов с вариантами ответов. В презентации он занимает **два слайда**: слайд задания (сервер рисует его сам: вопросы, QR-код, счётчик ответов) и слайд результатов (статистика и разбор). Есть два способа. ### Способ 1: прямо в HTML-файле Это удобно, когда файл делает нейросеть или вы сами. Поставьте в нужное место две пустые секции, а в конце `` добавьте описание вопросов: ```html
``` ### Способ 2: отдельным JSON-файлом Так удобно с Bento и старыми темами, где HTML трогать не хочется. Файл описывает вопросы и **после какого слайда** вставить интерактив: ```json { "interactives": [ { "id": "quiz-1", "title": "…", "questions": [ … как выше … ] } ], "placements": [ { "after": "size", "ex": "quiz-1" } ] } ``` `after` — id слайда (для Bento) или его номер. Готовые примеры: [`examples/llm-intro-interactives.json`](../examples/llm-intro-interactives.json) (для Bento) и [`examples/interactives-2-1.json`](../examples/interactives-2-1.json) (для темы курса). Составить такой файл по тексту слайдов поможет [промпт В](#в-только-интерактивы-к-готовой-презентации). **Правильные ответы (`correct`) хранятся только на сервере**: участники не увидят их ни в коде страницы, ни в сети до слайда результатов. --- ## Шаг 3. Загрузить и проверить 1. Запустите сервис (`start-local.cmd`) и откройте `http://localhost:8080`. 2. Блок **«Загрузить»**: выберите HTML-файл и нажмите «Загрузить». Поле id можно оставить пустым: оно возьмётся из имени файла. 3. Если интерактивы лежат отдельным JSON: загрузите его **с тем же id**, что у презентации. 4. Прочитайте результат под кнопкой: - **✗ ошибки** — сессию не создать, пока не исправите (что значит каждая, есть в [частых проблемах](#частые-проблемы)); - **! предупреждения** — работать будет, но стоит взглянуть. 5. Нажмите **«Создать сессию»** и пройдите презентацию целиком: ссылку ведущего — на компьютере, ссылку участника — на телефоне. Ответьте на каждый интерактив сами. 6. Нашли ошибку — исправьте файл и загрузите снова **с тем же id**: слайды заменятся, интерактивы сохранятся. --- ## Шаг 4. Провести занятие ### Организатор 1. Создайте **новую сессию** под это занятие (у каждой сессии своя статистика). 2. Ссылку **«Ведущий»** отправьте спикеру лично: в ней ключ управления. Потеряли — «Новая ссылка ведущего» в списке сессий. 3. Ссылку **«Участники»** — в чат мероприятия. QR-код ещё будет на каждом слайде задания. 4. После занятия: кнопка **«CSV»** в списке сессий выгружает все ответы для Excel. ### Спикер Окно ведущего — это слайд и три кнопки: | Кнопка | Что делает | |---|---| | **▶ Презентовать** | полный экран, только слайд (клавиша **F**, выход — **Esc**) | | **Копировать ссылку** | ссылка для участников, чтобы отправить в чат | | **Открыть экран** | отдельное окно для проектора или трансляции, если нужен второй монитор | Листать — стрелками, пробелом, PageUp/PageDown или кликером. Перейти к слайду — **G** (список с поиском) или **номер + Enter**. При движении мыши снизу появляется маленькая панель с номером слайда. **Интерактив ничего не требует от спикера:** 1. Дошли до слайда задания: участники уже могут отвечать, счётчик «ответили N» растёт на экране. 2. Дали 1–2 минуты и листнули дальше, на слайд результатов: статистика видна всем сразу, участникам открываются правильные ответы и пояснения. 3. Опоздавшие могут ответить и позже, статистика обновится сама. ### Участник 1. Открыть ссылку или QR с телефона или ноутбука. Не нужны ни регистрация, ни приложение. 2. Слайды листаются сами вслед за спикером. Назад — свайпом, вернуться — кнопкой «К ведущему». 3. На слайде задания ответить и нажать **«Проверить»**: сразу видно «Молодец!» или где ошибка. 4. Учитывается **первый** ответ. Если связь пропала, ответ сохранится на телефоне и отправится сам. --- ## Справочник ### Правила вёрстки | Правило | Почему | |---|---| | Один слайд — один `
` верхнего уровня | так сервер находит слайды | | Сцена в пикселях (`1920×1080` или `1600×900`), размеры в `px`; без `vh`, `vw`, `position:fixed` | сцена масштабируется целиком под проектор и телефон | | Без JavaScript: `. Типы: single, multi (+ "pick"), order, poll (без correct), text (без correct). 2–5 вопросов, варианты до 8 слов, неверные варианты — типичные ошибки по материалу слайдов. 7. Проверь: у каждого data-interactive есть описание с тем же id; correct — из списка вариантов. Верни только итоговый HTML-файл целиком. ``` ### Б. Собрать презентацию из PPTX, PDF, DOCX ```text Сделай HTML-презентацию по приложенному материалу для сервиса интерактивных презентаций. Стиль: [цвета, шрифт, логотип или пример слайда]. Структура: титул → [N] слайдов по материалу → интерактив после каждого смыслового блока (2–3 на 40 минут) → итог. Формат: в ; каждый слайд —
1920×1080 px; общие стили в