.. _ebook-polish-ru:

.. raw:: html

    <style>code {font-size: 1em; background-color: transparent; font-family: sans-serif }</style>

``ebook-polish``
===================================================================

.. code-block:: none

    ebook-polish [параметры] входной_файл [выходной_файл]


 Полировка книг  - все о том, чтобы придать блеск совершенства 
Вашим тщательно обработанным электронным книгам.

Полировка пытается минимизировать изменения во внутреннем коде вашей электронной книги.
В отличие от преобразования, она не уплощает CSS, переименовывает файлы, меняет шрифт
размеры, корректирует поля и т.п. Каждое действие выполняет только минимальный набор
изменений, необходимых для желаемого эффекта.

Вы должны использовать этот инструмент в качестве последнего шага в процессе создания электронной книги.

 Обратите внимание, что полировка работает только с файлами в форматах AZW3 или EPUB. 

Когда вы передаёте аргументы с пробелами в :command:`ebook-polish`, заключайте их в кавычки. Например: "/some path/with spaces"

[опции]
----------------------------------------

.. program:: ebook-polish

.. option:: --add-soft-hyphens, -H

    Добавляет мягкие переносы во все слова в книге. Это позволит лучше выглядеть книгам с выровненным по ширине текстом в читалках, не поддерживающих переносы. 

.. option:: --compress-images, -i

    Сжать иллюстрации для уменьшения объёма, без ухудшения качества изображения. 

.. option:: --cover, -c

    Путь к обложке. Изменяет обложку, указанную в электронной книге. Если обложки нет или она неправильно идентифицирована, вставляется новая обложка.

.. option:: --embed-fonts, -e

    Внедрить шрифты, указанные в документе, но ещё не внедрённые. Будет осуществлен поиск шрифтов, доступных на компьютере; если шрифты будут найдены, то они будут внедрены в документ. Убедитесь в наличии соответствующих прав на внедрение шрифтов, используемых в документе. 

.. option:: --help, -h

    показать это сообщение и выйти

.. option:: --jacket, -j

    Вставить в начале книги страницу обложки, которая будет содержать  все метаданные: название, теги, авторов, серии, комментарии, и т.д.  Любые предыдущие обложки будут заменены.

.. option:: --opf, -o

    Путь к OPF файлу. Метаданные в книге обновлены из OPF файла.

.. option:: --remove-jacket

    Удалить предыдущую добавленную обложку. 

.. option:: --remove-soft-hyphens

    Удаляет мягкие переносы из всего текста книги. 

.. option:: --remove-unused-css, -u

    Удалить все неиспользуемые CSS правила из таблицы стилей и тегов <style>. Некоторые книги, созданные с помощью технических шаблонов, могут иметь множество дополнительных CSS правил, не совпадающих с реальным содержанием. Это замедляет работу читалок при разборе правил. 

.. option:: --smarten-punctuation, -p

    Конвертировать текстовые тире, многоточия, кавычки, множественные переносы и т.д. в их типографически верные эквиваленты. Помните, что алгоритм может иногда выдавать неверные результаты, особенно в случае одиночных кавычек в начале сокращений. 

.. option:: --subset-fonts, -f

    Сокращение шрифтов означает уменьшение внедрённых  шрифтов до необходимого набора символов, используемых  в книге. Это значительно уменьшает размер файлов  шрифтов (примерно вдвое). Например, если книга использует специальный шрифт  для заголовков, то сокращение шрифтов уменьшит этот  шрифт до символов содержащихся только в этих заголовках.  Или если в книгу включена курсивная версия шрифта,  но текст с ним встречается редко или совсем отсутствует,  то курсивный шрифт может быть сокращён всего до  нескольких символов или полностью удалён. Единственный недостаток сокращения шрифтов в том,  если позже вы пожелаете добавить больше текста в ваши  книги, то добавленный текст может быть не охвачен  сокращённым шрифтом. 

.. option:: --upgrade-book, -U

    Обновление внутренней структуры книги, по возможности. К примеру, обновление книг EPUB 2 до EPUB 3. 

.. option:: --verbose

    Более подробный вывод обработки. Полезно при отладке.

.. option:: --version

    показать версию программы и выйти