DjVu encoder with foreground/background separation (Python 3 fork)
Project description
Overview
didjvu uses the Gamera framework to separate foreground/background layers, which can be then encoded into a DjVu file.
Prerequisites
The following software is required:
Python 3 (≥ 3.6)
Gamera-4 (≥ 4.0) (not available on PyPI)
DjVuLibre (≥ 3.5.22)
minidjvu (≥ 0.8) for the --pages-per-dict/-p option
Additionally, one of the following libraries is needed for the --xmp option:
-
Due to the repository being archived, this backend might lead to issues. Starting at Python 3.12, distutils is not available anymore, thus breaking the (default) installation.
Installation
The easiest way to install didjvu is from PyPI:
pip install didjvu
Alternatively, you can use didjvu without installing it, straight out of an unpacked source tarball or a VCS checkout.
It’s also possible to install it from source for the current interpreter with:
pip install .
The man pages can be deployed using:
make install_manpage
By default, make install_manpage installs them to /usr/local/. You can specify a different installation prefix by setting the PREFIX variable, e.g.:
make install PREFIX="$HOME/.local"
About this fork
This repository is a port of the original repository to Python 3.
The process involved the 2to3 tool and manual fixes afterwards to get the existing tests to pass. Some of the error reports and fixes arising from the early porting process have been contributed by @rmast.
At the moment there are no plans to submit a pull request to the upstream repository, which would probably require some changes to my code as well. This is mostly due to the corresponding upstream issue being marked as wontfix: Issue #13.
I will try to keep this fork/port in sync with the upstream changes where necessary. Please note that I do not have any plans on implementing completely new features for now. Feature requests and bugs which can be reproduced in the original version as well should be reported at both places in the best case.
Differences from upstream
Package requires Python ≥ 3.6.
Drop old Gamera workarounds.
Migrate from nose to plain unittest stdlib module.
Conform to PEP8 coding style.
Use standardized setup.py-based installation.
Rename lib to didjvu and migrate didjvu binary to __main__.py and console script version.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
