Initial MANGABOM website

This commit is contained in:
2026-11-02 04:08:02 +03:00
commit b86e8a9eff
150 changed files with 5728 additions and 0 deletions

88
MANGA.md Normal file
View File

@@ -0,0 +1,88 @@
# Страницы манги и читалка
Сайт: 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. Для работы самого сайта они не требуются. Тестовый контент создаётся во временной папке и не попадает в библиотеку читателей.