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

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. Тримайте таблицю переходів відкритою

Якщо ви активно працюєте над структурою гри, зручно тримати таблицю переходів в окремому вікні. Після кожної серйозної зміни натискайте «Оновити таблицю» — і у вас завжди буде свіжа картина переходів перед очима.