> **Версия 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; общие стили в