Даведка — Рэдактар параграфаў

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

Калі вы актыўна працуеце над структурай гульні, зручна трымаць табліцу пераходаў у асобным акне. Пасля кожнай сур'ёзнай змены націскайце «Абнавіць табліцу» — і ў вас заўсёды будзе свежая карціна пераходаў перад вачыма.