Files
buryan-infra/docs/library/INSTRUCTION-POLINA.md
T
root 60866cd2b6 Каталог книг: сервис со статистикой; поиск расширен (7 источников); инструкции в Matrix
СЕРВИС КАТАЛОГА: https://books.buryans.ru/catalog/ за единым входом.
  * 181 книга, 45 серий, 25 книг к поиску;
  * страницы «Обзор», «Серии», «Книги», «Что искать»;
  * API /api/summary и /health;
  * профили читателей (сейчас Полина);
  * написан на стандартной библиотеке Python — нечему ломаться.

СХЕМА: nginx /catalog/ -> oauth2-proxy-catalog :9990 -> catalog :9200.

ПОИСК РАСШИРЕН ДО 7 ИСТОЧНИКОВ: ЛитРес (цены), Open Library (ISBN),
ФантЛаб, Google Books — напрямую; archive.org, libgen, Флибуста — через
VPN-шлюз, потому что в России заблокированы. ЛитРес через VPN НЕ ходит
(блокирует зарубежные адреса). Результат: находки у 15 из 25 книг,
libgen добавил ещё совпадения.

ИНСТРУКЦИИ ОТПРАВЛЕНЫ В MATRIX в личные чаты: Akadmin — как устроено,
как проверить, где что лежит, как обновить; Полина — как войти, искать,
загружать книги. Matrix требует метод PUT (на POST вернул 405).

МОИ ОШИБКИ: путь к каталогу не совпал (нули на странице); обновлённый
файл не попал в контейнер, а я собрал образ из старого; проверка входа
заголовком не проходит — нужна настоящая сессия.
2026-10-18 20:54:17 +03:00

4.8 KiB
Raw Blame History

Библиотека Buryans Hub — как пользоваться

Здравствуйте, Полина!

Теперь у вас есть своя онлайн-библиотека. Всё в одном месте: каталог прочитанного, поиск книг и сами книги.

С чего начать

1. Адрес библиотеки: https://books.buryans.ru

Откроется страница входа. Войдите тем же аккаунтом, что и в остальные сервисы (единый вход) — отдельный пароль не нужен.

2. Ваш каталог чтения: https://books.buryans.ru/catalog/

Там собрано всё, что вы прочитали:

Что видно Значение
Книг в каталоге 181
Серий 45
Прочитано 181
Книг к поиску 25

Разделы:

  • Обзор — сколько прочитано, состояние серий;
  • Серии — по каждой серии: сколько прочитано, вышла ли следующая книга;
  • Книги — полный список;
  • Что искать — книги, которых ещё нет, со ссылками на поиск.

Как найти книгу

В разделе «Что искать» у каждой книги есть кнопки:

Кнопка Что делает
ЛитРес магазин: цена и покупка
Bookmate подписка на книги
Open Library мировой каталог: описание и ISBN
archive.org большой архив, много старых книг
ФантЛаб карточка книги, отзывы, серия
Гутенберг бесплатные книги со свободными правами
Флибуста, libgen, КулЛиб, ЛитМир библиотеки, где часто есть переводы

Один поиск — везде сразу. Не нужно самой обходить десять сайтов.

Как положить книгу в библиотеку

Способ 1 (простой): скачайте файл, откройте https://books.buryans.ru и нажмите кнопку загрузки. Книги принимаются в форматах EPUB, FB2, PDF, MOBI, AZW3.

Способ 2 (ещё проще): если книгу присылает программа-загрузчик — она попадёт в библиотеку сама, через автоматическую папку приёма.

После загрузки библиотека сама:

  • прочитает название и автора из файла;
  • подтянет описание и обложку;
  • разложит по авторам и сериям.

Что можно делать с книгой

Действие Где
Скачать кнопка «Скачать» в карточке книги
Читать онлайн кнопка «Читать»
Отправить на читалку кнопка «Отправить на Kindle/Kobo»
Изменить название или обложку «Редактировать» (вы — администратор библиотеки)

Если книги нет

  1. Откройте «Что искать» — там список того, что вы ещё не читали.
  2. Нажмите «ЛитРес» — если книга переведена, она там есть с ценой.
  3. Если перевода нет — смотрите Флибусту или libgen.
  4. Можно попросить: напишите в чат, и книгу добавят.

Про статистику

Каталог считает сам:

  • сколько книг прочитано;
  • в каких сериях вы отстаёте (следующая книга уже вышла);
  • где ждём перевод;
  • какие линии закрыты.

Это чтобы не терять нить по длинным сериям вроде Blood and Ash или Royal Elite.

Важные напоминания

  • Один вход на все сервисы — пароль от библиотеки отдельно не нужен.
  • Книги не теряются: библиотека резервируется вместе с остальными сервисами (копии делаются ежедневно).
  • Доступ только у вас и администратора — домен закрыт единым входом.

Если что-то не работает — напишите, разберёмся.