Skip to content

Установка программы

Dmitrii edited this page Jan 17, 2023 · 12 revisions

Microsoft Windows

Программа поддерживает работу в ОС MS Windows 10 и выше. Для Microsoft Windows программа поставляется в двух видах:

  • в виде zip-архива;
  • в виде инсталлятора.

Установка из zip-архива

Распакуйте архив libro2.win32.zip в нужную папку. В папке libro2 запустите файл libro2.exe. При первом запуске, возможно, потребуется предоставить программе разрешение для запуска.

Установка из инсталлятора

Запустите инсталлятор libro2.win32.installer.exe. Следуйте инструкциям. После установки программы, в меню "Пуск" появится ярлык для запуска Libro2.

Портативная версия

Скачайте дистрибутив в виде архива libro2.win32.zip, разархивируйте в нужную папку. В папке libro2, где расположен исполняемый файл libro2.exe, любым текстовым редактором создайте пустой файл с именем portable.

После запуска libro2 будет работать в портативном режиме (файл конфигурации settings.json будет хранится в папке с программой).

Для полной портативности поместите конвертер fb2converter и его файл конфигурации внутрь папки libro2. В настройках libro2 укажите пути к конвертеру и файлу конфигурации относительно к основной папке libro2.

Например, если вы поместили файлы конвертера прямо в папку libro2, укажите путь к конвертеру "fb2c.exe", путь к файлу конфигурации "configuration.toml". Если поместили файлы конвертера в подпапку fb2converter в папке libro2, укажите путь к конвертеру "fb2converter\fb2c.exe", путь к файлу конфигурации "fb2converter\configuration.toml".

Чтобы portable-версию превратить в обычную, удалите файл portable.

MacOS

Откройте файл libro2.macos.dmg. Перетащите иконку программы на ярлык папки Applications. После установки программы в Launchpad появится иконка Libro2.

Linux (на примере Ubuntu 22.04)

Описанный сценарий проверен на Ubuntu 22.04. На других дистрибутивах возможны ошибки. Установите PyQt5, lxml, pip3, git:

sudo apt install python3-pyqt5 python3-pyqt5.qtsql python3-lxml python3-pip git

Установите pyinstaller и ebookmeta:

pip3 install --user pyinstaller ebookmeta

Загрузите текущую версию Libro2:

git clone https://github.com/dnkorpushov/libro2.git

Установите программу:

cd libro2
python3 build.py install

В меню приложений должна появиться иконка Libro2. Также можете запустить Libro2 из командной строки.

./libro2.sh

Для удобства, можете добавить путь к программе в переменную PATH.

Для настройки внешнего вида программы в Gnome3 можно использовать, например, стандартную тему Gnome3 adwaita. Для этого установите тему adwaita для QT5:

sudo apt install adwaita-qt 
export QT_STYLE_OVERRIDE=adwaita

Добавьте строку export QT_STYLE_OVERRIDE=adwaita в файл ~/.profile.

Либо установите менеджер тем приложений QT5:

sudo apt install qt5-style-kvantum qt5-style-kvantum-themes
kvantummanager

Например, для стандартной темы Ubuntu подойдет стиль KvYaru.

Установка из исходников

Программа написана на python с использование GUI-библиотеки PyQt5. Перед установкой убедитесь, что у вас установлен интерпретатор python. Рекомендуется версия 3.9 и выше. На версиях ниже 3.9 работоспособность возможна, но не гарантируется.

Из исходников лучше устанавливать программу с помощью инструментария git. Перед запуском программы необходимо установить необходимые пакеты python

git clone https://github.com/dnkorpushov/libro2.git
cd libro2
pip3 install -r requirements.txt

Для запуска программы можете воспользоваться командами

python3 build.py run

или

python3 src/python/libro2/main.py