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

7.0 KiB
Raw Blame History

Страницы манги и читалка

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