didjvu uses the Gamera framework to separate foreground/background layers, which can be then encoded into a DjVu file.
The following software is required:
- Python 3 (≥ 3.6)
- Gamera-4 (≥ 4.0)
- Pillow
- DjVuLibre (≥ 3.5.22)
- minidjvu (≥ 0.8) for the
--pages-per-dict/-poption
Additionally, one of the following libraries is needed for the --xmp
option:
- GExiv2 (≥ 0.12.2) + PyGI or
- python-xmp-toolkit or
- py3exiv2
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"
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.
- 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.