<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE refentry PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN' 'http://www.docbook.org/xml/4.5/docbookx.dtd'
[
    <!ENTITY p 'pdf2djvu'>
    <!ENTITY version '0.8.2'>
]>

<refentry lang='uk'>

<refentryinfo>
    <title>керівництво з &p;</title>
<productname>&p;</productname> <author> <firstname>Jakub</firstname>
<surname>Wilk</surname> <email>jwilk@jwilk.net</email> </author></refentryinfo>

<refmeta>
    <refentrytitle>&p;</refentrytitle>
    <manvolnum>1</manvolnum>
    <refmiscinfo class='version'>&version;</refmiscinfo>
</refmeta>

<refnamediv>
    <refname>&p;</refname>
    <refpurpose>створює DjVu-файли з PDF-файлів</refpurpose>
</refnamediv>

<refsynopsisdiv>
    <cmdsynopsis>
<command>&p;</command> <arg choice='opt'> <group choice='req'> <arg
choice='plain'><option>-o</option></arg> <arg
choice='plain'><option>--output</option></arg> </group> <arg
choice='plain'><replaceable>результуючий_djvu-файл</replaceable></arg>
</arg> <arg choice='opt'
rep='repeat'><replaceable>параметр</replaceable></arg> <arg choice='plain'
rep='repeat'><replaceable>pdf-файл</replaceable></arg></cmdsynopsis>
    <cmdsynopsis>
<command>&p;</command> <arg choice='plain'> <group choice='req'> <arg
choice='plain'><option>-i</option></arg> <arg
choice='plain'><option>--indirect</option></arg> </group> <arg
choice='plain'><replaceable>файл-djvu-індексу</replaceable></arg> </arg>
<arg choice='opt' rep='repeat'><replaceable>параметр</replaceable></arg>
<arg choice='plain' rep='repeat'><replaceable>pdf-файл</replaceable></arg></cmdsynopsis>
    <cmdsynopsis>
<command>&p;</command> <group choice='req'> <arg
choice='plain'><option>--version</option></arg> <arg
choice='plain'><option>--help</option></arg> <arg
choice='plain'><option>-h</option></arg> </group></cmdsynopsis>
</refsynopsisdiv>

<refsection>
    <title>Опис</title>
    <para>
        Програма створює DjVu-файл з одного чи декількох Portable Document Format
файлів.
    </para>
</refsection>

<refsection>
    <title>Параметри</title>
    <para>
        <command>&p;</command> допускає наступні параметри:
    </para>
    <refsection>
        <title>Тип документу, назви файлів</title>
        <variablelist>
        <varlistentry>
            <term><option>-o</option></term>
            <term><option>--output=<filename><replaceable>результуючий_djvu-файл</replaceable></filename></option></term>
            <listitem>
                <para>
                    Створити об’єднаний багатосторінковий документ. Записати файл у
<filename><replaceable>результируючий_djvu-файл</replaceable></filename>
замість стандартного виводу.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>-i</option></term>
            <term><option>--indirect=<filename><replaceable>файл_djvu-індексу</replaceable></filename></option></term>
            <listitem>
                <para>
                    Створити роздільний багатосторінковий документ. Використовувати
<filename><replaceable>файл_djvu-індексу</replaceable></filename> як назву
файлу індексу; розмістити файли-компоненти в одну й ту ж теку. Тека повинна
існувати та мати дозвіл на запис.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--pageid-template=<replaceable>шаблон</replaceable></option></term>
            <listitem>
                <para>
                    Встановлює схему найменування ідентифікаторів сторінок. Зверніться за
довідкою до <quote><link linkend='template-language'
endterm='template-language.title'/></quote> розділу опису мови шаблонів.
                </para>
                <para>
                    Шаблон за умовчанням <quote><literal>p{page:04*}.djvu</literal></quote>.
                </para>
                <para>
                    З причини переносимості ідентифікатор сторінки:
                    <itemizedlist>
                        <listitem>
                            <para>
                                повинен складатися лише з рядкових ASCII-букв, цифр, <literal>_</literal>,
<literal>+</literal>, <literal>-</literal> та крапки,
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                не може починатися з <literal>+</literal>, <literal>-</literal> чи крапки,
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                не може включати дві послідовні крапки,
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                повинен завершуватися розширенням <literal>.djvu</literal> чи
<literal>.djv</literal>.
                            </para>
                        </listitem>
                    </itemizedlist>
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--pageid-prefix=<replaceable>префікс</replaceable></option></term>
            <listitem>
                <para>
                    Еквівалентно
<quote><literal>--pageid-template=<replaceable>префікс</replaceable>{page:04*}.djvu</literal></quote>.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--page-title-template=<replaceable>шаблон</replaceable></option></term>
            <listitem>
                <para>
                    Встановлює шаблон заголовків сторінок. Зверніться за довідкою до розділу
опису мови шаблонів <quote><link linkend='template-language'
endterm='template-language.title'/></quote>.
                </para>
                <para>
                    За умовчанням заголовок не встановлюється.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Роздільна здатність, розмір сторінки</title>
        <variablelist>
        <varlistentry>
            <term><option>-d</option></term>
            <term><option>--dpi=<replaceable>роздільна_здатність</replaceable></option></term>
            <listitem>
                <para>
                    Встанолює бажану <replaceable>роздільну_здатність</replaceable> крапок на
дюйм. За умовчанням 300 dpi. Дозволений діапазон: 72 ≤
<replaceable>роздільна_здатність</replaceable> ≤ 6000.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--media-box</option></term>
            <listitem>
                <para>
                    Використовувати <firstterm>MediaBox</firstterm> для визначення розміру
сторінки. За умовчанням використовується <firstterm>CropBox</firstterm>.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--page-size=<replaceable>ширина</replaceable>×<replaceable>висота</replaceable></option></term>
            <listitem>
                <para>
                    Встановлює бажаний розмір сторінки у <replaceable>ширина</replaceable>
пікселів × <replaceable>висота</replaceable> пікселів. Дійсний розмір
сторінки може змінюватися для дотримання співвідношення та через обмеження
DjVu. (Цей параметр має пріоритет над
<option>-d</option>/<option>--dpi</option>.)
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--guess-dpi</option></term>
            <listitem>
                <para>
                    Спробувати передбачити оригінальну роздільну здатність перевіряючи вбудовані
зображення. Використовуйте з обережністю.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Якість зображення</title>
        <variablelist>
        <varlistentry>
            <term><option>--bg-slices=<replaceable>n</replaceable>+<replaceable>…</replaceable>+<replaceable>n</replaceable></option></term>
            <term><option>--bg-slices=<replaceable>n</replaceable>,<replaceable>…</replaceable>,<replaceable>n</replaceable></option></term>
            <listitem>
                <para>
                    Встановлює якість кодування фонового шару IW44. Цей параметр схожий на
параметр <option>-slice</option> для <command>c44</command>. Зверніться за
довідкою до man-сторінки <citerefentry> <refentrytitle>c44</refentrytitle>
<manvolnum>1</manvolnum> </citerefentry>. За умовчанням
<literal>72+11+10+10</literal>.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--bg-subsample=<replaceable>n</replaceable></option></term>
            <listitem>
                <para>
                    Встановлює відношення підвибірки фону. За умовчанням 3. Допустимі значення
знаходяться між 1 та 12 включно.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--fg-colors=default</option></term>
            <listitem>
                <para>
                    Спробувати зберегти усі кольори переднього плану. Використовується за
умовчанням.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--fg-colors=web</option></term>
            <listitem>
                <para>
                    Зменшити кількість кольорів переднього плану до веб-палітри (216
кольорів). Не рекомендується використовувати.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--fg-colors=<replaceable>n</replaceable></option></term>
            <listitem>
                <para>
                    Використовує GraphicsMagick для зменшення кількості явних кольорів у шарі
переднього плану. Допустимі значення від 1 до 4080. Не рекомендується
використовувати.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--fg-colors=black</option></term>
            <listitem>
                <para>
                    Не використовувати будь-яку інформацію про кольори з шару переднього плану.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--monochrome</option></term>
            <listitem>
                <para>
                    Промальовувати сторінки як монохромні зображення. З цим параметром опції
<option>--bg-<replaceable>…</replaceable></option> та
<option>--fg-<replaceable>…</replaceable></option> не беруться до уваги.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--loss-level=<replaceable>n</replaceable></option></term>
            <listitem>
                <para>
                    <!-- https://bitbucket.org/jwilk/pdf2djvu/issue/86 -->
Specifies the aggressiveness of the lossy compression. The default is 0
(lossless).  Valid values are integers between 0 and 200, inclusive. This
option is similar to the <option>-losslevel</option> option of
<command>cjb2</command>; consult the <citerefentry>
<refentrytitle>cjb2</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>
manual page for details.  This option can be used only if the
<option>--monochrome</option> option is also enabled.
                    
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--lossy</option></term>
            <listitem>
                <para>
                    Рівносильно <option>--loss-level=100</option>.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--anti-alias</option></term>
            <listitem>
                <para>
                    Дозволити згладжування шрифтів й векторної графіки. Не рекомендується
використовувати.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Витягнення</title>
        <variablelist>
        <varlistentry>
            <term><option>--no-metadata</option></term>
            <listitem>
                <para>
                    Не витягувати метадані.
                </para>
                <para>
                    За умовчанням:
                    <itemizedlist>
                        <listitem>
                            <para>
                                Витягуються наступні значення інформації документа:
<literal>Title</literal>, <literal>Author</literal>,
<literal>Subject</literal>, <literal>Creator</literal>,
<literal>Producer</literal>, <literal>CreationDate</literal>,
<literal>ModDate</literal>. Часові позначки форматуються відповідно до
стандарту <ulink url='https://www.ietf.org/rfc/rfc3339'>RFC
3999</ulink>. Дата і час розділені одиночним пропуском.
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                Відповідно витягуються (чи створюються) й оновлюються метадані XMP.
                            </para>
                        </listitem>
                    </itemizedlist>
                </para>
                <note>
                    <para>
                        У випадку декількох вхідних документів використовуються лише метадані з
першого.
                    </para>
                </note>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--verbatim-metadata</option></term>
            <listitem>
                <para>
                    Зберігати метадані недоторканими.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--no-outline</option></term>
            <listitem>
                <para>
                    Не витягувати зміст документу.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--hyperlinks=border-avis</option></term>
            <listitem>
                <para>
                    Робити межі посилань завжди видимими.
                </para>
                <para>
                    За умовчанням межі посилань стають видимими лише при наведенні на посилання
мишкою.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--hyperlinks=#<replaceable>RRGGBB</replaceable></option></term>
            <listitem>
                <para>
                    Примусово використовувати заданий колір для межі посилань.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--no-hyperlinks</option></term>
            <term><option>--hyperlinks=none</option></term>
            <listitem>
                <para>
                    Не витягувати посилання.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--no-text</option></term>
            <listitem>
                <para>
                    Не витягувати текст.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry><term>
            <option>--words</option></term>
            <listitem>
                <para>
                    Витягти текст. Записати розташування кожного слова. Використовується за
умовчанням.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--lines</option></term>
            <listitem>
                <para>
                    Витягти текст. Записати розташування кожного рядка, а не слова.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--crop-text</option></term>
            <listitem>
                <para>
                    Не витягувати текст, який знаходиться за межами сторінки.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--no-nfkc</option></term>
            <listitem>
                <para>
                    Do not apply <ulink url='http://unicode.org/reports/tr15/'>NFKC</ulink>
normalization on the text, except for characters from the <ulink
url='http://unicode.org/charts/PDF/UFB00.pdf'>Alphabetic Presentation Forms
block</ulink> (U+FB00–U+FB4F), which are normalized unconditionally.
                </para>
                <para>
                    The default is to apply NFKC normalization on all characters.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--filter-text=<replaceable>командний_рядок</replaceable></option></term>
            <listitem>
                <para>
                    Фільтрувати текст через <replaceable>командний_рядок</replaceable>. Даний
фільтр повинен зберегти пробіли, керуючі символи й десяткові цифри.
                </para>
                <para>
                    Цей параметр передбачає <option>--no-nfkc</option>.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>-p</option></term>
            <term><option>--pages=<replaceable>діапазон_сторінок</replaceable></option></term>
            <listitem>
                <para>
                    Specifies pages to convert. <replaceable>page-range</replaceable> is a
comma-separated list of sub-ranges. Each sub-range is either a single page
(e.g. <literal>17</literal>) or a contiguous range of pages
(e.g. <literal>37-42</literal>).  Duplicate page numbers are not allowed.
Pages are numbered from 1.
                </para>
                <para>
                    За умовчанням конвертуються усі сторінки.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Продуктивність</title>
        <variablelist>
        <varlistentry>
            <term><option>-j</option></term>
            <term><option>--jobs=<replaceable>n</replaceable></option></term>
            <listitem>
                <para>
                    Використовувати <replaceable>n</replaceable> потоків для конвертації. За
умовчанням використовується один потік.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>-j0</option></term>
            <term><option>--jobs=0</option></term>
            <listitem>
                <para>
                    Визначити автоматично, скільки потоків використовувати для конвертації.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Подробиці, довідка</title>
        <variablelist>
        <varlistentry>
            <term><option>-v</option></term>
            <term><option>--verbose</option></term>
            <listitem>
                <para>
                    Показувати більше інформаційних повідомлень при конвертації файлу.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>-q</option></term>
            <term><option>--quiet</option></term>
            <listitem>
                <para>
                    Не показувати інформаційні повідомлення при конвертації файлу.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>--version</option></term>
            <listitem>
                <para>Вивести інформацію про версію та вийти.</para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><option>-h</option></term>
            <term><option>--help</option></term>
            <listitem>
                <para>Показати довідку та вийти.</para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsection>
</refsection>

<refsection>
    <title>Оточення</title>
    <para>
        Наступні змінні оточення впливають на <command>&p;</command>  в
Unix-системах: <variablelist>
        <varlistentry>
            <term><varname>OMP_<replaceable>*</replaceable></varname></term>
            <listitem>
            <para>
                Поведінкою, з точки зору розпаралелювання, можна керувати за допомогою
кількох змінних оточення. За деталями зверніться до <ulink
url='http://openmp.org/wp/openmp-specifications/'>специфікації OpenMP
API</ulink>.
            </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><varname>TMPDIR</varname></term>
            
            <!-- As per IEEE Std 1003.1, 2004 Edition, “8.3 Other Environment Variables”:
            http://www.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap08.html#tag_08_03
            -->
<listitem>
                <para>
                    <command>&p;</command> інтенсивно використовує тимчасові файли. програма
зберігає їх у теці, заданій цією змінною. За умовчанням
<filename>/tmp</filename>.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </para>
</refsection>

<refsection id='template-language'>
    <title id='template-language.title'>Мова шаблонів</title>
    <refsection>
        <title>Синтаксис шаблонів</title>
        <para>
            Мова шаблонів використовує як зразок <ulink
url='https://docs.python.org/library/string.html#format-string-syntax'>синтаксис
форматування рядків у Python-і</ulink>.
        </para>
        <para>
            Шаблон — це текст, який містить <firstterm>поля</firstterm>, оточені
фігурними дужками <literal>{</literal><literal>}</literal>. Коли шаблон
застосовується, поля замінюються відповідним чином відформатованими
значеннями. Окрім того, <literal>{{</literal> и <literal>}}</literal>
замінюється одиночними <literal>{</literal> и <literal>}</literal>
відповідно.
        </para>
    </refsection>
    <refsection>
        <title>Синтаксис полів</title>
        <para>
            Кожне поле складається з імені змінної, за яким може слідувати зсув (не
обов’язково), та специфікації формату (не обов’язково).
        </para>
        <para>
            Зсув — ціле число зі знаком (тобто починається на <literal>+</literal> чи
<literal>-</literal>).
        </para>
        <para>
            Формат специфікації включає двокрапку, а потім специфікатор ширини поля.
        </para>
        <para>
            Специфікатор ширини поля — це ціле десяткове число, що визначає мінімальну
ширину поля. Якщо не вказано, тоді ширина поля обчислюється за
вмістом. Передуючий специфікатору знак нуля (<literal>0</literal>) робить
можливим заповнення нулями.
        </para>
        <para>
            Після специфікатора ширини поля може розташовуватися знак зірочки
(<literal>*</literal>), що збільшує мінімальну ширину поля до максимально
можливої ​​довжини змінної.
        </para>
    </refsection>
    <refsection>
        <title>Доступні змінні</title>
        <variablelist>
            <varlistentry>
                <term><varname>page</varname></term>
                <term><varname>spage</varname></term>
                <listitem>
                    <para>Кількість сторінок в документі PDF.</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term><varname>dpage</varname></term>
                <listitem>
                    <para>Кількість сторінок в документі DjVu.</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
</refsection>

<refsection>
    <title>Деталі реалізації</title>
    <refsection>
        <title>Алгоритм розділення шарів</title>
        <para>
            Якщо не використовується параметр <option>--monochrome</option>, &p;
використовує наступний простий алгоритм: <orderedlist>
                <listitem>
                    <para>
                        Для кожної сторінки зробити наступне: <orderedlist>
                            <listitem>
                                <para>
                                    Перетворити сторінку в растрове зображення звичайним чином.
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    Перетворити сторінку в інше растрове зображення пропускаючи наступні
елементи сторінки:
                                    <itemizedlist>
                                        <listitem><para>текст,</para></listitem>
                                        <listitem><para>растрові зображення з глибиною 1 біт на піксель, </para></listitem>
                                        <listitem><para>векторні елементи (за винятком великих заповнених площ).</para></listitem>
                                    </itemizedlist>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    Порівняти обидва зображення, піксель за пікселем: <orderedlist>
                                        <listitem>
                                            <para>
                                                Якщо їх кольори збігаються, класифікувати піксель як частину фонового шару.
                                            </para>
                                        </listitem>
                                        <listitem>
                                            <para>
                                                У протилежному випадку класифікувати піксель як частину шару переднього
плану.
                                            </para>
                                        </listitem>
                                    </orderedlist>
                                </para>
                            </listitem>
                        </orderedlist>
                    </para>
                </listitem>
            </orderedlist>
        </para>
    </refsection>
</refsection>

<refsection>
    <title>Повідомлення про помилки</title>
    <para>
        Якщо Ви знайшли помилку у &p;, повідомте про неї на <ulink
url='https://bitbucket.org/jwilk/pdf2djvu/issues'>баг-трекер</ulink>.
    </para>
</refsection>

<refsection>
    <title>Дивіться також</title>
    <para>
        <citerefentry> <refentrytitle>djvu</refentrytitle> <manvolnum>1</manvolnum>
</citerefentry>, <citerefentry> <refentrytitle>djvudigital</refentrytitle>
<manvolnum>1</manvolnum> </citerefentry>, <citerefentry>
<refentrytitle>csepdjvu</refentrytitle> <manvolnum>1</manvolnum>
</citerefentry>
    </para>
</refsection>

</refentry>


<!-- vim:set ts=4 sts=4 sw=4 tw=120 et: -->
