Справка — Редактор параграфов

1. Что это за редактор

Это однофайловая веб-программа для создания книг-игр. Вся работа происходит в браузере — без интернета, без установки, без регистрации.

Результат — это один HTML-файл. Его можно открыть в любом браузере, отправить по почте, положить на диск или в облако.

Автор создаёт игру здесь, читатель играет в созданном файле.

2. Первый запуск

1. Сохраните файл редактора как editor.html (или любым именем с расширением .html).
2. Откройте его двойным щелчком в Firefox, Chrome или Edge.
3. Увидите панель с кнопками и серую область под ней.
4. Нажмите Загрузить HTML или markdown.txt и выберите файл вашей игры (либо создайте новый параграф).

3. Кнопки главного экрана

3.1. Работа с файлом

Загрузить HTML или markdown.txt
Открывает диалог выбора файла. Поддерживает:

• HTML — полный файл игры с кубиками и листом персонажа;
• markdown.txt — текстовый файл с разметкой (см. раздел 11).

Сохранить HTML
Сохраняет игру в текущем состоянии. Кубики, лист персонажа, закладки — всё остаётся в файле. Заголовок файла берётся из названия игры.

Сохранить как
Открывает окно с выбором формата:

• TXT с Markdown-разметкой — для чтения и переноса в другие системы;
• DOC — для Word;
• RTF — универсальный формат;
• PDF — откроет диалог печати.

3.2. Работа с параграфами

Создать новый параграф
Добавляет новый пустой параграф в конец списка и сразу открывает его на редактирование.

Перемешать параграфы
Переставляет параграфы случайным образом и автоматически перенумеровывает все ссылки так, чтобы они вели к тем же параграфам.

3.3. Инструменты

Добавить кубики
Включает скрипт кубиков в игру. В игре появится кнопка «Показать кубики». Если скрипт уже добавлен — кнопка называется Удалить кубики.

Лист персонажа
Открывает редактор параметров персонажа: можно создавать разделы с полями, добавлять разделы «Инвентарь», «Секретные слова», «Блокнот». Все данные сохраняются в браузере читателя. Подробнее — раздел 7.

Выходные данные
Название игры, автор, описание, различные разделы (пролог, правила). Появляется перед первым параграфом. Подробнее — раздел 8.

Таблица переходов
Открывает в новом окне таблицу всех параграфов игры. Каждая строка имеет четыре столбца: номер параграфа, его краткая суть, куда этот параграф ведёт и откуда к нему приходят ссылки. Таблица помогает быстро найти «тупики» (параграфы без выхода) и «сироты» (параграфы, к которым никто не ведёт). Подробное описание — в разделе 5.

Закладки и заметки
Открывает список отмеченных параграфов. Подробнее — раздел 6.

3.4. Проверка и настройки

▶ Просмотреть игру
Генерирует чистый HTML-файл игры (без следов редактора) и открывает его в новом окне браузера. Ссылки там работают как в обычном HTML. Это режим чтения — чтобы проверить, как увидит игру читатель.

Вверху окна просмотра есть кнопка Подгрузить обновления. Если вы изменили игру в редакторе и сохранили, нажмите её — и увидите обновлённую версию без закрытия окна. Это удобно, когда вы держите игру открытой для игрока и периодически обновляете её.

Настройки
Открывает окно с выбором темы (светлая или тёмная) и языка интерфейса. Здесь же — кнопка Справка.

4. Редактирование параграфа

Чтобы начать редактирование, нажмите кнопку редактировать параграф N рядом с заголовком нужного параграфа.

Откроется форма:

4.1. Поле «Номер параграфа»

Здесь меняется номер. Если такой номер уже занят — программа спросит, заменить ли.

4.2. Абзацы

Каждое поле — отдельный абзац текста. Кнопка Добавить абзац создаёт новый. Кнопка Удалить рядом с абзацем — убирает его.

4.3. Действия

Каждое действие — это строка из трёх частей:

• Текст действия — что видит читатель, например «идти на север»;
• Номер цели — к какому параграфу ведёт это действие;
• Заметка — служебная пометка для вас (читатель её не увидит).

Кнопка Добавить действие создаёт новую строку.

Если оставить поле «номер» пустым — программа автоматически назначит новый номер и создаст параграф.

4.4. Кнопки внизу формы

📌 Сохранить и не менять номер
Сохраняет параграф и закрепляет его номер. Такой параграф не изменит номер при «Перемешать параграфы». Полезно для секретных параграфов, на которые есть ссылки из текста.

Сохранить параграф
Обычное сохранение. Номер может измениться при перемешивании.

Отменить
Закрывает форму без сохранения.

Удалить параграф
Полностью удаляет этот параграф. Ссылки на него в других параграфах останутся, но будут вести в никуда.

4.5. Обратные ссылки

Под каждым параграфом в редакторе есть курсивная строка вида «вернуться на предыдущий параграф 23, вернуться на предыдущий параграф 56». Это обратные ссылки — перечень тех параграфов, которые ведут к текущему.

Зачем это нужно:

• вы редактируете параграф 87 и не помните, что привело к нему в игре;
• кликаете на «вернуться на предыдущий параграф 34» — и попадаете в параграф 34;
• там тоже есть своя строка обратных ссылок — так можно идти всё глубже и глубже, до самого начала игры.

4.6. Переходы по ссылкам внутри редактора

В режиме просмотра редактора (то есть когда параграф не открыт на редактирование) вы можете кликать по действиям прямо внутри параграфа. Например, видите «идти на север - 15» — нажмите, и редактор прокрутит вас к параграфу 15. Так можно ходить по игре, не выходя из редактора, — это быстрее, чем открывать отдельное окно просмотра.

5. Таблица переходов

Таблица переходов — это инструмент для анализа структуры игры. Она показывает все параграфы и связи между ними. Открывается с главного экрана кнопкой Таблица переходов.

5.1. Что показывает таблица

Каждая строка — это один параграф. Столбцы:

• Номер — номер параграфа. Если параграф закреплён, рядом появляется значок 📌.
• Суть — первое предложение текста параграфа. Если в параграфе есть ваша заметка, она тоже добавляется через тире.
• Куда переходим — все параграфы, к которым ведёт этот. Если переходов нет, показывается красное «нет переходов».
• Откуда пришли — все параграфы, которые ведут к этому. Если таких нет, тоже красное «нет переходов».

5.2. Сортировка

Вверху окна есть несколько кнопок. Нажмите любую — и таблица сразу перестроится.

• Параграфы по порядку — обычный вид: строки идут по номерам от меньшего к большему.
• Сортировать по столбцу «Куда переходим» (пустые сверху) — наверх поднимаются строки, в которых в столбце «Куда переходим» стоит «нет переходов». Это быстрый способ найти «тупики».
• Сортировать по столбцу «Откуда пришли» (пустые сверху) — наверх поднимаются строки, к которым никто не ведёт. Это параграфы-«сироты», к которым читатель не доберётся.
• Сортировать по столбцу «Суть» (пустые сверху) — наверх поднимаются строки с пустой сутью. Это помогает найти параграфы, которые вы создали, но забыли заполнить текстом.
• Обновить таблицу — перечитывает данные из редактора. Если вы изменили что-то в редакторе, а таблица уже открыта — нажмите эту кнопку, и таблица обновится без закрытия окна.

5.3. Пример использования

Вы дописали новую ветку. Откройте таблицу, нажмите «Сортировать по столбцу „Откуда пришли"». Вверху окажутся параграфы, к которым пока никто не ведёт. Если среди них есть ваши новые — значит, вы забыли добавить к ним ссылку с предыдущих параграфов. Это быстрее, чем проверять вручную.

6. Закладки и заметки

Используются, чтобы пометить незавершённые ветки и вернуться к ним позже.

6.1. Как поставить закладку или заметку

1. Откройте параграф на редактирование.
2. Нажмите 📑 Сделать закладку — параграф попадёт в список.
3. Нажмите 📝 Сделать заметку для памяти — откроется поле для короткого текста.
4. Напишите, что нужно сделать, например «доработать тролля».
5. Нажмите Сохранить заметку, затем Сохранить параграф.

6.2. Как найти закладки

Кнопка Закладки и заметки на главном экране открывает список. Каждая строка показывает:

• номер параграфа;
• начало его текста;
• вашу заметку.

Клик по строке переносит к параграфу. Кнопка Удалить убирает закладку и заметку.

7. Лист персонажа

Это блок полей, которые читатель заполняет во время игры. Например: здоровье, золото, инвентарь.

7.1. Создание листа

1. Нажмите Лист персонажа.
2. Нажмите Создать раздел с параметрами.
3. Введите название раздела (например, «Параметры игрока»).
4. Добавьте параметры: название и значение по умолчанию.
5. Поставьте галочки для разделов «Инвентарь», «Секретные слова», «Блокнот», если нужно.
6. Нажмите Сохранить.

7.2. Как это выглядит у читателя

В игре появится кнопка Лист персонажа. Она открывает форму с полями. Все данные читателя сохраняются в его браузере — даже если он закроет игру.

8. Выходные данные

Это информация, которая показывается перед первым параграфом:

• название игры (записывается в заголовок файла);
• автор;
• описание игры (краткий анонс);
• дополнительная информация (любая);
• различные разделы: пролог, правила, благодарности — что угодно.

8.1. Как заполнить

1. Нажмите Выходные данные.
2. Заполните поля. Для разделов используйте кнопку Добавить новый раздел.
3. Нажмите Сохранить.

Чтобы убрать всё — Удалить все выходные данные.

9. Кубики

Кнопка Добавить кубики включает в игру скрипт с двумя кубиками: бросок одного и бросок двух одновременно.

В игре появится кнопка Показать кубики. Она открывает отдельное окно, где можно бросать кубики.

Чтобы убрать — нажмите Удалить кубики.

10. Сохранение и экспорт

10.1. Основное сохранение

Сохранить HTML — это основной формат. Он сохраняет всё: параграфы, кубики, лист персонажа, ссылки.

Имя файла берётся из названия игры (пробелы заменяются на подчёркивания).

10.2. Экспорт в другие форматы

Сохранить как — для TXT, DOC, RTF, PDF. Эти форматы предназначены для чтения или печати, а не для игры.

11. Формат файла игры

Игра сохраняется как HTML. Но для тех, кто хочет редактировать в текстовом редакторе, есть формат markdown.txt.

11.1. Правила формата

• # Название игры — заголовок первого уровня;
• ## Автор — автор;
• ## N — начало параграфа с номером N (именно две решётки!);
• - [текст - N](#pN) — действие, которое ведёт к параграфу N.

11.2. Пример

# Прогулка

## Автор

Короткая игра про путешествие.

## 1

Вы вышли из дома. На дворе хорошая погода. Стоит прогуляться.

- [Идти к калитке - 5](#p5)

## 5

Скрипнула калитка. Вы смотрите по сторонам, размышляя, куда идти дальше.

- [Вернуться в дом - 1](#p1)

12. Советы

12.1. Проверьте игру перед публикацией

1. Нажмите Таблица переходов — посмотрите, нет ли параграфов без переходов или без обратных ссылок. Используйте кнопки сортировки, чтобы вывести такие параграфы наверх.
2. Нажмите ▶ Просмотреть игру — поиграйте как читатель.
3. Проверьте все ветки до конца.

12.2. Закрепляйте секретные параграфы

Если в тексте есть фраза «перейдите на параграф 265», этот параграф нужно закрепить. Иначе после «Перемешать параграфы» ссылка 265 пойдёт не туда.

12.3. Короткие действия

Текст действия должен быть коротким: «идти на север», «открыть сундук», «поговорить со стражником». Длинные фразы тяжело читать в списке.

12.4. Сохраняйте копии

Перед крупными изменениями (например, перемешиванием) сохраните отдельную копию файла. Если что-то пойдёт не так — есть куда вернуться.

12.5. Закладки — ваш друг

Ставьте закладки на незавершённые ветки. Так вы всегда увидите, что ещё нужно дописать.

12.6. Держите таблицу переходов открытой

Если вы активно работаете над структурой игры, удобно держать таблицу переходов в отдельном окне. После каждого серьёзного изменения нажимайте «Обновить таблицу» — и у вас всегда будет свежая картина переходов перед глазами.