Files
MangaBom/MANGA.md
2026-11-02 04:08:02 +03:00

88 lines
7.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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