Overview
========

**pdf2djvu** creates DjVu_ files from PDF files.

It's able to extract:

- graphics,
- text layer,
- hyperlinks,
- document outline (bookmarks),
- metadata (including XMP_ metadata).

pdf2djvu is developed primarily for Unix-like systems,
but a Windows distribution is available too.

.. _DjVu:
   http://djvu.org/
.. _XMP:
   https://www.adobe.com/products/xmp.html

Prerequisites
=============

The following software is required to build pdf2djvu:

* C++11 compiler;
* GNU make;
* DjVuLibre_ (≥ 3.5.25), both the library and the command line tools;
* Poppler_ (≥ 0.35), including xpdf headers;
* pkg-config_.

The following software is recommended:

* gettext_ for internationalization;
* Exiv2_ (≥ 0.21) and libuuid (part of util-linux or e2fsprogs)
  for correctly dealing with XMP metadata;
* GraphicsMagick_ for the ``--fg-colors=N`` option.

For the ``-j``/``--jobs`` option, the compiler must support OpenMP_.

To run the tests, the following software is needed:

* Python 2.7;
* nose_.

To correctly convert some PDF files (mostly in Chinese, Japanese or
Korean), the poppler-data_ package must be installed.

.. ---------------------------------------------------------------------

.. _DjVuLibre:
   http://djvu.sourceforge.net/
.. _poppler:
   https://poppler.freedesktop.org/
.. _pkg-config:
   https://www.freedesktop.org/wiki/Software/pkg-config/
.. _gettext:
   https://www.gnu.org/software/gettext/
.. _Exiv2:
   https://www.exiv2.org/
.. _GraphicsMagick:
   http://www.graphicsmagick.org/
.. _OpenMP:
   https://www.openmp.org/
.. _nose:
   https://nose.readthedocs.io/
.. _poppler-data:
   https://poppler.freedesktop.org/poppler-data-0.4.9.tar.gz

.. vim:ft=rst ts=3 sts=3 sw=3 et tw=72
