calibre web

Калибр-Веб

Calibre-Web — это веб-приложение, которое предлагает чистый и интуитивно понятный интерфейс для просмотра, чтения и загрузки электронных книг с использованием действующей базы данных Caliber.

Оглавление (нажмите, чтобы развернуть)

1. О
2. Функции
3. Установка
   • Установка через pip (рекомендуется)
   • Быстрый старт
   • Требования
4. Изображения Докера
5. Поиск неисправностей
6. Признание вкладчика
7. Контакт
8. Вклад в Caliber-Web

Это программное обеспечение является ответвлением библиотеки и распространяется по лицензии GPL v3.

Функции

• Современный и отзывчивый интерфейс Bootstrap 3 HTML5.
• Полная графическая настройка
• Комплексное управление пользователями с детальными разрешениями для каждого пользователя.
• Интерфейс администратора
• Многоязычный пользовательский интерфейс, поддерживающий более 20 языков (поддерживаемые языки)
• Канал OPDS для приложений для чтения электронных книг
• Расширенные возможности поиска и фильтрации
• Создание индивидуальной коллекции книг (полок)
• Поддержка редактирования и удаления метаданных электронных книг
• Загрузка метаданных из различных источников (расширяется с помощью плагинов)
• Преобразование электронных книг с помощью двоичных файлов Caliber
• Ограничение загрузки электронных книг для зарегистрированных пользователей
• Поддержка публичной регистрации пользователей
• Отправляйте электронные книги на устройства для чтения электронных книг одним щелчком мыши
• Синхронизируйте устройства Kobo с вашей библиотекой Caliber.
• Поддержка чтения электронных книг в браузере в нескольких форматах
• Загружайте новые книги в различных форматах, включая аудиоформаты.
• Поддержка пользовательских столбцов Caliber
• Скрытие контента на основе категорий и содержимого настраиваемых столбцов для каждого пользователя.
• Возможность самостоятельного обновления
• Логин «Magic Link» для быстрого доступа к устройствам для чтения электронных книг
• Поддержка LDAP, Google/GitHub OAuth и прокси-аутентификации.

Установка

Установка через pip (рекомендуется)

1. Создайте виртуальную среду . Очень важно изолировать вашу установку Calibre-Web, чтобы избежать конфликтов зависимостей. Вы можете создать виртуальную среду, запустив:

    python3 -m venv calibre-web-env
   

2. Активируйте виртуальную среду :

    source calibre-web-env/bin/activate
   

3. Установите Caliber-Web : используйте pip для установки приложения:

    pip install calibreweb
   

4. Установите дополнительные функции . Для получения дополнительных функций может потребоваться установка дополнительных функций. На этой странице вы найдете подробную информацию о том, что можно установить.
5. Запустите Caliber-Web : после установки вы можете запустить приложение с помощью:

    cps
   

Примечание. Пользователи ОС Raspberry Pi могут столкнуться с проблемами при установке. Если да, попробуйте обновить pip и/или установить груз следующим образом:

 ./venv/bin/python3 -m pip install --upgrade pip
sudo apt install cargo

Важные ссылки

• Для получения дополнительных примеров установки проверьте следующее:
  • Ручная установка
  • Установка Linux Mint
  • Настройка облачного провайдера

Быстрый старт

1. Доступ к Calibre-Web : откройте браузер и перейдите к:

    http://localhost:8083
   

   или для каталога OPDS:

    http://localhost:8083/opds
   

2. Войдите в систему : используйте учетные данные администратора по умолчанию:
   • Имя пользователя: admin
   • Пароль: admin123
3. Настройка базы данных : Если у вас нет базы данных Caliber, загрузите образец по адресу:

    https://github.com/janeczku/calibre-web/raw/master/library/metadata.db
   

   Переместите его из папки Calibre-Web, чтобы избежать перезаписи во время обновлений.
4. Настройте базу данных Caliber : в интерфейсе администратора установите Location of Calibre database путь к папке, содержащей вашу библиотеку Caliber (где находится metadata.db ), и нажмите «Сохранить».
5. Интеграция с Google Диском . Чтобы разместить библиотеку Caliber на Google Диске, обратитесь к руководству по интеграции с Google Диском.
6. Конфигурация администратора : настройте свой экземпляр через страницу администратора, обратившись к руководствам по базовой конфигурации и настройке пользовательского интерфейса.

Требования

• Версия Python : убедитесь, что у вас установлена ​​версия Python 3.7 или новее.
• Imagemagick : требуется для извлечения обложек из файлов EPUB. Пользователям Windows также может потребоваться установить Ghostscript для извлечения обложек PDF.
• Дополнительные инструменты :
  • Настольная программа Caliber : рекомендуется для оперативного преобразования и редактирования метаданных. Укажите путь к конвертеру Caliber на странице настройки.
  • Инструмент Kepubify : необходим для поддержки устройств Kobo. Загрузите инструмент и поместите двоичный файл в /opt/kepubify в Linux или C:Program Fileskepubify в Windows.

Изображения Докера

Доступны готовые образы Docker:

LinuxServer — x64, aarch64

• Docker Hub : linuxserver/калибровка-веб
• GitHub : linuxserver/docker-калибровка-веб
• Дополнительный слой Caliber : linuxserver/docker-mods

Чтобы включить двоичный файл Caliber ebook-convert (только для x64), добавьте переменную среды:

 DOCKER_MODS=linuxserver/mods:universal-calibre

в вашем файле запуска/создания Docker. Опустите эту переменную для облегченного изображения.

• Конфигурация путей :
  • Установите путь к двоичным файлам Caliber как /usr/bin .
  • Установите путь к Unrar на /usr/bin/unrar .

Поиск неисправностей

• Общие проблемы :

  • Если у вас возникли проблемы с запуском приложения, проверьте файлы журналов, расположенные в каталоге logs на наличие сообщений об ошибках.
  • Если электронные книги не загружаются, убедитесь, что Location of Calibre database установлено правильно и файл базы данных доступен.

• Ошибки конфигурации : убедитесь, что ваша база данных Caliber совместима и правильно отформатирована. Инструкции по обслуживанию базы данных см. в документации Caliber.

• Проблемы с производительностью :

  • Если приложение работает медленно, рассмотрите возможность увеличения выделенных ресурсов (ЦП/ОЗУ) на вашем сервере или оптимизации базы данных Caliber путем удаления дубликатов и ненужных записей.
  • Регулярно очищайте кеш веб-браузера, чтобы сократить время загрузки.

• Проблемы с управлением пользователями . Если пользователи не могут войти в систему или зарегистрироваться, проверьте настройки разрешений пользователя в интерфейсе администратора. Убедитесь, что регистрация включена и что пользователям назначены соответствующие роли.

• Ресурсы поддержки : для получения дополнительной помощи посетите раздел часто задаваемых вопросов на вики или разместите свои вопросы в сообществе Discord.

Признание вкладчика

Мы хотели бы поблагодарить всех участников и сопровождающих Calibre-Web за их ценный вклад и преданность проекту. Ваш вклад очень ценен.

Контакт

Присоединяйтесь к нам в Discord

Для получения дополнительной информации, инструкций и часто задаваемых вопросов посетите Wiki.

Вклад в Caliber-Web

Чтобы внести свой вклад, пожалуйста, ознакомьтесь с нашими Правилами внесения вклада. Мы приветствуем проблемы, запросы функций и запросы на включение от сообщества.

Сообщить об ошибках

Если вы столкнулись с ошибками или проблемами, сообщите о них в разделе проблем репозитория. Обязательно укажите подробную информацию о вашей настройке и возникшей проблеме.

Запросы функций

Мы приветствуем предложения по новым функциям. Пожалуйста, создайте новый выпуск в репозитории, чтобы обсудить ваши идеи.

Дополнительные ресурсы

• Документация : Полная документация доступна на вики Calibre-Web.
• Вклад сообщества : изучите вклад сообщества, чтобы узнать о текущей работе и о том, как вы можете принять в ней участие.

---

Благодарим вас за использование Caliber-Web! Мы надеемся, что вам понравится управлять своей библиотекой электронных книг с помощью нашего инструмента.