EBOOK-POLISH(1)

NAME
ebook-polish - ebook-polish

            ebook-polish [параметри] файл_вхідних_даних [файл_результатів]

Покращення книг — це процедура, подібна до полірування дорогоцінного каміння, до якого подібні ретельно зібрані книги

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

Цим інструментом слід користуватися на останньому кроці створення вашої електронної книги.

Зауважте, що покращення працює лише для файлів у форматах AZW3 або EPUB або KEPUB.

Якщо ви передаєте аргументи ebook-polish, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces»

[ПАРАМЕТРИ]

    --add-soft-hyphens, -H
        Додати м'які переноси до усіх слів у книзі. Такі переноси поліпшують вигляд книг із вирівнюванням тексту за шириною сторінки на засобах для читання, де не передбачено автоматичного перенесення слів.

    --compress-images, -i
        Без втрати стиснути зображення у книзі для зменшення розміру вайла без втрати якості зображень.

    --cover, -c
        Шлях до зображення обкладинки Цим файлом буде замінено обкладинку, визначену у книзі. Якщо обкладинки немає або обкладинку не визначено належним чином, вставляє нову обкладинку.

    --download-external-resources, -d
        Отримати зовнішні ресурси, зокрема зображення, таблиці стилів тощо, на які вказують адреси, замість файлів у книзі. Усі такі ресурси буде отримано і додано до книги, щоб у книзі не було посилань на зовнішні ресурси.

    --embed-fonts, -e
        Вбудувати усі шрифти, які використано у документі і ще не вбудовано до нього. Програма виконає пошук шрифтів на вашому комп’ютері і, якщо шрифти буде знайдено, вбудує їх до документа. Будь ласка, зважте на умови ліцензування, пов’язані з вбудовуванням шрифтів до цього документа.

    --help, -h
        показати це довідкове повідомлення і завершити роботу

    --jacket, -j
        Вставити сторінку «суперобкладинки» на початку книги. Ця сторінка міститиме всі метадані книги, зокрема назву, мітки авторів, цикл, коментарі тощо. Всі попередні параметри «суперобкладинки» буде збережено.

    --opf, -o
        Шлях до файла OPF. Метадані у книзі оновлено на основі даних з файла OPF.

    --remove-jacket
        Вилучити попередньо вставлену сторінку суперобкладинки.

    --remove-soft-hyphens
        Вилучити м'які переноси з усього тексту книги.

    --remove-unused-css, -u
        Вилучити усі невикористані правила CSS з таблиць стилів та теґів <style>. У деяких книгах, створених на основі шаблонів, багато зайвих правил CSS, які не використовуються для форматування даних. Ці правила можуть уповільнити обробку програмами для читання.

    --smarten-punctuation, -p
        Виконати перетворення звичайних дефісів, багатокрапок, тире з декількох дефісів тощо відповідно до типографських стандартів. Зауважте, що використання цього алгоритму може іноді призводити до некоректних результатів, особливо якщо на початку фрагментів тексту використано одинарні лапки.

    --subset-fonts, -f
        Обрізання шрифтів до підмножин означає, що у вбудованому шрифті міститимуться лише символи, які використано у книзі. За допомогою такого обрізання можна значно зменшити розмір файлів шрифтів (типовим є зменшення приблизно удвічі). Наприклад, якщо у книзі використано специфічний шрифт для заголовків, обрізання призведе до того, що у вбудованому шрифті залишаться дані лише щодо символів, які було використано у заголовках книги. Якщо ж у книгу вбудовано напівжирну та курсивну версії шрифту, але напівжирне та курсивне написання трапляється у ній доволі нечасто або його і взагалі немає, шрифти для напівжирного та курсивного тексту може бути зменшено до декількох символів або і повністю вилучено. Єдиною незручністю, яка може трапитися після обрізання шрифтів є те, що якщо пізніше ви захочете додати текст до книги деяких його символів може не бути у обрізаній підмножині вбудованого шрифту.

    --upgrade-book, -U
        Оновити внутрішню структуру книги, якщо це можливо. Наприклад, можна оновити книги EPUB 2 до версії формату EPUB 3.

    --verbose
        Вивести докладніші повідомлення, корисно для діагностування помилок.

    --version
        показати дані щодо версії програми і завершити роботу

Author
Kovid Goyal

Copyright
Kovid Goyal