88 lines
7.0 KiB
Markdown
88 lines
7.0 KiB
Markdown
# Страницы манги и читалка
|
||
|
||
Сайт: http://localhost:8080/
|
||
|
||
## Добавление главы
|
||
|
||
1. Открой папку сериала в dist/manga/.
|
||
2. Внутри используй папки chapter-001, chapter-002 и т. д.
|
||
3. Положи в папку главы 16 одиночных изображений с номерами 1–16 в порядке чтения. Например, 01.png, 02.png, ... 16.png. Имена 010.png ... 016.png тоже допустимы. Развороты склеивать не нужно.
|
||
4. Обнови страницу сериала или читалки. Локальный сервер автоматически перечитает папки и обновит библиотеку. Перезапуск и ручная индексация на localhost не нужны.
|
||
|
||
Пример:
|
||
|
||
dist/manga/
|
||
LORD_OF_CHEAP_LUNCH/
|
||
series.json
|
||
chapter-001/
|
||
01.png
|
||
...
|
||
16.png
|
||
chapter-002/
|
||
01.jpg
|
||
...
|
||
16.jpg
|
||
LAST_PORT/
|
||
series.json
|
||
chapter-001/
|
||
...
|
||
|
||
Поддерживаются JPG, JPEG, PNG, WebP и AVIF. Регистр расширения не важен. Можно смешивать форматы. Номер может иметь ведущие нули: 1.jpg, 01.jpg, 001.jpg. Но один номер должен встречаться только один раз. Имена page-01.jpg не подходят.
|
||
|
||
Глава открывается при наличии ровно 16 непустых изображений с номерами от 1 до 16. Пропуск, дубликат, лишний номер или неправильно названное изображение оставляют главу в состоянии «Скоро». Причину можно увидеть через update-library.cmd или в .local-server-output.log. Изображения индексатор не меняет. При повреждённом файле читалка покажет ошибку и кнопку повторной загрузки.
|
||
|
||
## Папки сериалов
|
||
|
||
- LORD_OF_CHEAP_LUNCH — Повелитель дешёвого обеда
|
||
- LAST_PORT — Нулевой причал
|
||
- LAST_VERANDA — Последняя веранда
|
||
- DREAM_REALTOR — Риелтор грёз
|
||
- SECOND_TOUCH — Второе касание
|
||
- WHILE_THE_HOUSE_IS_WARM — Пока в доме тепло
|
||
- DRY_SIDE — Сухая сторона
|
||
- BAR_BAR — БАР-БАР
|
||
|
||
Папки манги называются английскими ЗАГЛАВНЫМИ буквами, цифрами и нижними подчёркиваниями, как LAST_PORT. Стабильный id внутри series.json у существующих сериалов менять не нужно: он сохраняет прежние ссылки и прогресс чтения.
|
||
|
||
{"id":"food","title":"Повелитель дешёвого обеда"}
|
||
|
||
Читалка принимает как старый id, так и новое имя папки:
|
||
|
||
http://localhost:8080/reader.html?series=LORD_OF_CHEAP_LUNCH&chapter=chapter-001
|
||
|
||
Старая ссылка series=food тоже работает. Для своего названия главы положи рядом с изображениями chapter.json:
|
||
|
||
{"title":"Глава 01 — Начало истории"}
|
||
|
||
Новую папку главы индексатор добавит в список автоматически. Для совершенно новой манги нужен series.json, а карточка в основном каталоге добавляется отдельно в scripts/build-product.py.
|
||
|
||
## Обновление библиотеки
|
||
|
||
На локальном сервере библиотека автоматически обновляется при HTTP-запросе manga/library.json — при открытии или обновлении страницы сериала и читалки. Это работает на сетевом диске без файловых наблюдателей. Неизменившийся каталог повторно не записывается.
|
||
|
||
Для публикации на другом обычном статическом хостинге сначала запусти update-library.cmd, затем перенеси всю папку dist/, включая manga/. На таком хостинге PowerShell-индексатор сам по себе не запускается.
|
||
|
||
## Управление
|
||
|
||
- Постранично: одна страница или разворот справа налево. Первая страница отдельно, затем пары 02–03, 04–05 и т. д.
|
||
- Лентой: все страницы сверху вниз. На небольшом экране этот режим выбран по умолчанию до первого выбора читателя.
|
||
- Клавиша ← — дальше, → — назад. Home и End — начало и конец главы.
|
||
- В постраничном режиме поддерживаются свайпы. При масштабе выше 100% свайп не перехватывается, чтобы можно было перемещать изображение.
|
||
- Масштаб 70–150%, выбор страницы, переход между опубликованными главами и полный экран в поддерживаемых браузерах.
|
||
- Тема переключается в футере сайта и читалки. Закреплённой кнопки внизу нет. Цвета изображений манги не меняются.
|
||
- Прогресс отдельно для каждой главы, тема и настройки сохраняются в текущем браузере. Параметр page в ссылке открывает указанную страницу.
|
||
|
||
## Файлы и проверки
|
||
|
||
- dist/reader.html, reader.js, reader.css — читалка.
|
||
- dist/theme.js, theme.css — общая тема сайта.
|
||
- dist/library.js — список глав на странице сериала.
|
||
- scripts/index-manga.ps1 — индексатор папок.
|
||
- dist/manga/library.json — автоматически сформированный каталог; вручную не редактировать.
|
||
- scripts/reader-template.html — исходник разметки читалки для генератора сайта.
|
||
|
||
Проверки:
|
||
|
||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\test-reader.ps1
|
||
|
||
Для JavaScript-проверок нужен Node.js или установленный VS Code. Для работы самого сайта они не требуются. Тестовый контент создаётся во временной папке и не попадает в библиотеку читателей. |