EBOOK-CONVERT(1)

NAME
ebook-convert - ebook-convert

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

Виконати перетворення електронної книги з одного формату до іншого.

вхідний_файл є назвою початкового файла, а вихідний_файл — файла результатів . Обидва слід вказати як перші два аргументи команди.

Формат перетворення електронної книги визначається за суфіксом назви файла вихідний_файл. вихідний_файл також можна вказати у особливому форматі — .EXT, де EXT є його суфіксом назви. У цьому випадку назви вхідного і вихідного файлів будуть збігатися. Врахуйте, що назви файлів не можуть починатися з дефіса. В результаті, якщо вихідний_файл не має суфікса назви, він визначається як каталог, — до цього каталогу буде записано дані у форматі "open ebook" (OEB), що складається з фалів HTML. Ці файли, як правило, надсилаються до модуля виведення даних.

Після визначення вхідного та вихідного файлів ви можете налаштувати перетворення, вказавши різні параметри. Доступні параметри залежать від формату вхідного і вихідного файлів. Для отримання довідки вкажіть вхідний і вихідний файл, потім скористайтеся параметром -h.

Для отримання повної інформації щодо системи перетворення ознайомтеся з conversion

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

Параметри і типові значення параметрів можуть бути різними, залежно від формату вхідних і вихідних даних. Отже, завжди варто спочатку з ними ознайомитися за допомогою такої команди:

ebook-convert myfile.input_format myfile.output_format -h

Нижче наведено параметри, які є спільними для усіх перетворень, а далі, параметри, які є специфічними для кожного з форматів вхідних та вихідних даних.

•   ВХІДНІ ПАРАМЕТРИ

•   ВИХІДНІ ПАРАМЕТРИ

•   ВИГЛЯД І ПОВЕДІНКА

•   ЕВРИСТИЧНА ОБРОБКА

•   ПОШУК З ЗАМІНОЮ

•   ВИЯВЛЕННЯ СТРУКТУРИ

•   ЗМІСТ

•   МЕТАДАНІ

•   ДІАГНОСТИКА

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

--input-profile
    Вкажіть профіль введення. Профіль введення вказує засобу перетворення, як інтерпретувати різну інформацію всередині вхідного документа. Наприклад, роздільна здатність залежить від довжини (довжини в пікселях). Варіанти:cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900

--list-recipes
    Показати список назв вбудованих рецептів. Ви можете створити електронну книгу на основі вбудованого рецепту ось так: ebook-convert "Назва рецепту.recipe" файл_результату.epub

--output-profile
    Вкажіть вихідний профіль. Вихідний профіль вказує засобу перетворення, як оптимізувати створений документ для вказаного пристрою (зокрема, шляхом зміни розмірів зображень відповідно до розмірів екрана пристрою), втім, потреба у такій оптимізації виникає нечасто. Варіанти:cybookg3, cybook_opus, default, generic_eink, generic_eink_hd, generic_eink_large, hanlinv3, hanlinv5, illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_pw, kindle_pw3, kindle_voyage, kobo, msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, tablet

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

ВХІДНІ ПАРАМЕТРИ

Параметри для керування опрацюванням вхідного файла mobi

--input-encoding
    Вкажіть кодування знаків для вхідного документа. Якщо кодування вказано тут, то це перезапише всі кодування, які мав документ в собі. Особливо придатно для документів, які не мають вказаного кодування, або ж мають вказане неправильне кодування.

ВИХІДНІ ПАРАМЕТРИ

Параметри для керування опрацюванням вихідного файла epub

--dont-split-on-page-breaks
    Вимкнути розрізання на межах сторінок. Зазвичай, файли вхідних даних автоматично поділяються на два файли у місці кожної межі сторінки. Таким чином можна отримувати електронні книжки, які швидше обробляються і потребують для читання менше ресурсів. Розрізання є доволі повільною процедурою, тому якщо у вашому файлі дуже багато меж сторінок, вам слід вимкнути розрізання на межі сторінок.

--epub-flatten
    Цей пункт може знадобитися, лише якщо ви маєте намір використовувати EPUB для читання у FBReaderJ. Програма спростить файлову систему у EPUB, розташувавши всі файли на верхньому рівні.

--epub-inline-toc
    Вставити вбудований зміст, який буде показано як частину основного вмісту книги.

--epub-toc-at-end
    Розташувати вбудований зміст наприкінці книги, а не на її початку.

--extract-to
    Видобути вміст створеного файла EPUB до вказаного каталогу. Перед видобуванням вміст каталогу буде вилучено, тому вам слід бути обережними.

--flow-size
    Розділяти на частини усі файли HTML більшого розміру, аніж вказано тут (у кБ). Це необхідно, оскільки більшість пристроїв читання EPUB не можуть працювати з файлами великих розмірів. Типовий розмір у 260 кБ — це розмір, сумісний з Adobe Digital Editions. Встановіть значення 0, щоб вимкнути поділ на основі розміру.

--no-default-epub-cover
    Зазвичай, якщо у файлі вхідних даних не міститься зображення обкладинки, а ви не вказали цього зображення явно, буде створено стандартну обкладинка з назвою, іменем автора тощо. За допомогою цього пункту можна вимкнути створення таких обкладинок.

--no-svg-cover
    Не використовувати зображення SVG для обкладинок книжок. Позначте цей пункт, якщо створений файл EPUB буде використано на пристрої, на якому не передбачено підтримки SVG, зокрема на iPhone або JetBook Lite. Якщо цей пункт не буде позначено, на таких пристроях обкладинку буде показано як порожню сторінку.

--preserve-cover-aspect-ratio
    Якщо буде позначено цей пункт, у разі використання зображення обкладинки у форматі SVG масштаб буде підібрано так, щоб зображення займало максимальну площу екрана, але без зміни співвідношення його розмірів (відношення ширини до висоти). Це може призвести до появи білих смуг з боків або згори і знизу, але зображення не буде викривлено. Якщо пункт не буде позначено, можливі невеликі викривлення, але білих смуг навколо зображення не буде.

--pretty-print
    Якщо вказано, додаток виведення даних спробує створити зручні для читання виведені дані. Може не мати жодного ефекту для деяких додатків виведення даних.

--toc-title
    Заголовок для будь-якого згенерованого in-line змісту.

ВИГЛЯД І ПОВЕДІНКА

Параметри для керування за зовнішнім виглядом вихідного файла

--asciiize
    Перетворити символи Unicode на символи ASCII. Будьте обережні з використанням цієї можливості, оскільки всі символи Unicode буде замінено на символи ASCII. Наприклад, «Михаил Горбачёв» буде замінено на «Mikhail Gorbachiov». Крім того, зауважте, що якщо у певного символу є декілька представлень (наприклад, спільні символи китайської та японської мов), представлення буде виконано відповідно до поточної мови інтерфейсу calibre.

--base-font-size
    Розмір основного шрифту у пунктах. На основі цього розміру буде визначено масштаб всіх інших шрифтів у книзі. Якщо буде вибрано більший розмір, всі шрифти у результаті будуть більшими. Типово розмір основного шрифту буде вибрано на основі вибраного вами профілю виведення даних.

--change-justification
    Змінити текст вирівнювання. У разі визначення значення «Ліворуч» перетворює всі вирівняні фрагменти тексту на вирівняні ліворуч (тобто невирівняні) фрагменти. У разі визначення значення «Вирівняти» перетворює всі невирівняні фрагменти на вирівняні. У разі визначення значення «Оригінал» (типове) початкове вирівнювання тексту не буде змінено. Зауважте, що можливість вирівнювання передбачено лише у деяких з форматів виведення даних.

--disable-font-rescaling
    Заборонити масштабування шрифтів.

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

--embed-font-family
    Вбудувати до електронної книги вказану гарнітуру шрифтів. Таким чином можна визначити «основний» шрифт, який буде використано у книзі. Якщо у документі з вхідними даними визначаються власні шрифти, вони матимуть вищий за основний шрифт пріоритет. Для вилучення шрифтів з вхідних даних ви можете скористатися пунктом фільтрування даних щодо стилю. Зауважте, що вбудовування шрифтів працює лише у деяких форматах виведення даних, зокрема EPUB, AZW3 та DOCX.

--expand-css
    Типово, calibre використовуватиме скорочену форму різноманітних властивостей CSS, зокрема полів, фаски, рамки тощо. За допомогою цього параметра можна наказати програмі використовувати розширену форму. Зауважте, що записи CSS завжди розгортаються під час створення файлів EPUB, якщо встановлено один з профілів виведення даних Nook, оскільки у таких профілях не передбачено обробки скорочених записів CSS.

--extra-css
    Шлях до таблиці стилів CSS або код CSS. Вказаний код CSS буде додано до правил щодо стилів з файла початкових даних, отже ним можна скористатися для змінити початкових правил.

--filter-css
    Список властивостей CSS, розділених комами, записи з якого слід вилучити з усіх правил стилів CSS. Корисно, якщо визначення даних стилів запобігає використанню параметрів вашого пристрою. Приклад: font-family,color,margin-left,margin-right

--font-size-mapping
    Список відповідності назв розмірів шрифтів у CSS розмірам шрифтів у пунктах. Приклад: 12,12,14,16,18,20,22,24. У прикладі вказано відповідність всіх розмірів від xx-малі до xx-великі, останній розмір відповідає величезному шрифту (huge). У алгоритмі масштабування шрифтів ці значення використовуються для зміни масштабів шрифтів. Типово використовується список відповідності на основі вибраного вами профілю обробки даних.

--insert-blank-line
    Вставте порожній рядок між абзацами. Не буде працювати, якщо вихідний файл не використовує абзаци (<p> або <div> теґи).

--insert-blank-line-size
    Встановити висоту вставлених порожніх рядків (у em). Висота рядків між абзацами буде вдвічі більшою за вказане тут значення.

--keep-ligatures
    Зберігати лігатури у поточному вхідному документі. Лігатура — це особливий спосіб розташовування пар символів, зокрема ff, fi, fl тощо. На більшості пристроїв для читання не передбачено підтримки лігатур у разі використання типових шрифтів, отже лігатури навряд чи буде показано відповідним чином. Типово, calibre перетворить лігатури на пари звичайних символів. Якщо буде позначено цей пункт, програма зберігатиме лігатури.

--line-height
    Висота рядка у пунктах. Визначає інтервал між послідовними рядками тексту. Використовується лише для елементів, для яких не визначено власної висоти рядка. Здебільшого, краще користуватися мінімальною висотою рядка. Типово, програма не вноситиме змін до висоти рядка.

--linearize-tables
    У деяких документах з вадами у форматуванні таблиці використовуються для керування компонуванням тексту на сторінці. Під час перетворення таких документів часто текст виповзає за сторінку або виникають інші помітні помилки у форматуванні. За допомогою цього пункту можна наказати програмі видобути вміст з таблиць і показати його у звичайному послідовному представленні.

--margin-bottom
    Вкажіть ширину нижнього поля сторінки у пунктах. Типове значення — 5.0. Визначення від’ємного значення призведе до того, що поля просто не буде (поля, визначені у початковому документі, буде збережено). Примітка: у форматах із жорстким розбиттям на сторінки, зокрема PDF і DOCX, використовуються власні параметри полів, які мають вищий пріоритет за ці.

--margin-left
    Вкажіть ширину лівого поля сторінки у пунктах. Типове значення — 5.0. Визначення від’ємного значення призведе до того, що поля просто не буде (поля, визначені у початковому документі, буде збережено). Примітка: у форматах із жорстким розбиттям на сторінки, зокрема PDF і DOCX, використовуються власні параметри полів, які мають вищий пріоритет за ці.

--margin-right
    Вкажіть ширину правого поля сторінки у пунктах. Типове значення — 5.0. Визначення від’ємного значення призведе до того, що поля просто не буде (поля, визначені у початковому документі, буде збережено). Примітка: у форматах із жорстким розбиттям на сторінки, зокрема PDF і DOCX, використовуються власні параметри полів, які мають вищий пріоритет за ці.

--margin-top
    Вкажіть ширину верхнього поля сторінки у пунктах. Типове значення — 5.0. Визначення від’ємного значення призведе до того, що поля просто не буде (поля, визначені у початковому документі, буде збережено). Примітка: у форматах із жорстким розбиттям на сторінки, зокрема PDF і DOCX, використовуються власні параметри полів, які мають вищий пріоритет за ці.

--minimum-line-height
    Мінімальна висота рядка у відсотках від обчисленого розміру шрифту елемента. calibre визначити висоту рядків так, щоб вона була більшою за це значення, незалежно від параметрів, визначених у вхідному документі. Встановлення нульового значення вимикає використання мінімальної висоти. Типовим значенням є 120%. Цьому пункту слід надавати перевагу перед безпосереднім визначенням висоти рядка. Ви, наприклад, можете встановити подвійний інтервал між рядками, якщо встановите тут значення 240.

--remove-paragraph-spacing
    Вилучати інтервали між абзацами. Також встановити відступ абзацу у значення 1,5 em. Вилучення інтервалів не працюватиме, якщо у файлі початкових даних не використовуються абзаци (теґи <p> і <div>).

--remove-paragraph-spacing-indent-size
    Під час вилучення calibre порожніх рядків між абзацами для полегшення читання автоматично встановлюється відступ абзацу. За допомогою цього пункту можна змінити ширину цього відступу (у одиницях em). Якщо встановити це значення від'ємним, використовуватиметься відступ, вказаний у початковому документі, тобто calibre його не змінюватиме.

--smarten-punctuation
    Перетворити звичайні лапки, дефіси та багатокрапки на належні типографські відповідники. Докладніше про перетворення можна дізнатися зі сторінки https://daringfireball.net/projects/smartypants

--subset-embedded-fonts
    Обмежувати кількість символів у всіх вбудованих шрифтах. Множину символів шрифту буде обмежено до тієї, яка використовується у документі. Таким чином, файли шрифтів ставатимуть меншими. Корисно, якщо виконується вбудовування шрифту зі значним набором символів, з яких використовується лише незначна частина.

--transform-css-rules
    Шлях до файла, що містить правила перетворення стилів CSS у цій книзі. Найпростішим способом створення такого файла є використання майстра для створення правил із графічного інтерфейсу calibre. Пункт цього майстра у діалоговому вікні перетворення: «Вигляд і поведінка -> Перетворити стилі». Після створення правил, ви можете скористатися кнопкою «Експортувати» для збереження правил до файла.

--unsmarten-punctuation
    Перетворити форматовані лапки, тире та трикрапки на звичайні еквіваленти.

ЕВРИСТИЧНА ОБРОБКА

Внести зміни до тексту або структури документа за допомогою типових взірців. Типово вимкнено. Скористайтеся --enable-heuristics, щоб увімкнути. Окремі дії можна буде вимкнути за допомогою параметрів --disable-
*
.

--disable-dehyphenate
    Виконати аналіз слів з дефісами у документі. Для визначення дії, яку слід виконати з дефісом (зберегти чи вилучити) як словник використовуватиметься сам текст документа.

--disable-delete-blank-paragraphs
    Вилучити з документа порожні абзаци, якщо їх розташовано між будь-якими іншими абзацами

--disable-fix-indents
    Перетворити відступи, створені за допомогою декількох нероздільних об’єктів пробілів, у відступи, відповідні таблиці стилів CSS.

--disable-format-scene-breaks
    Вирівняні ліворуч роздільники сцен буде вирівняно за центром. Гнучкі розриви сцен декількома порожніми рядками буде замінено горизонтальними лініями.

--disable-italicize-common-cases
    Знайти типові слова та взірці, які позначають курсив, і відтворити курсив у тексті.

--disable-markup-chapter-headings
    Виявити неформатовані заголовки і підзаголовки глав. Ці заголовки буде замінено теґами h2 і h3. Позначення цього пункту не призведе до створення змісту, але ним можна скористатися у поєднанні з пунктом виявлення структури для створення змісту.

--disable-renumber-headings
    Шукати послідовності з теґів <h1> або <h2>. Такі теґи має бути перенумеровано, щоб запобігти поділу тексту посередині заголовків глави.

--disable-unwrap-lines
    Скасувати перенесення рядків на основі пунктуації та іншого форматування.

--enable-heuristics
    Увімкнути евристичну обробку. Цей пункт має бути позначено, щоб програма могла виконувати будь-яку евристичну обробку.

--html-unwrap-factor
    Коефіцієнт, який буде використано для визначення довжини рядків, які слід з’єднувати. Коректні значення лежать у діапазоні від 0 до 1. Типовим є значення 0,4, трошки менше за половину довжини рядка. Якщо з’єднанню підлягають лише декілька рядків у документі, вам слід вибрати менше значення.

--replace-scene-breaks
    Замінити роздільник сцен вказаним текстом. Типово буде використано текст з вхідного документа.

ПОШУК З ЗАМІНОЮ

Внести зміни до тексту або структури документа за допомогою визначених користувачем взірців.

--search-replace
    Шлях до файла, який містить формальні вирази для пошуку із заміною. У файлі мають міститися один за одним рядки, у одному з яких має бути вказано формальний вираз, а у іншому — шаблон заміни (може бути порожнім). У формальному виразі має бути використано синтаксичні правила побудови формальних виразів Python. Слід також використовувати у файлі кодування UTF-8.

--sr1-replace
    Замінник тексту, знайденого за допомогою sr1-пошуку.

--sr1-search
    Шаблон пошуку (формальний вираз), який буде замінено під час sr1-пошуку.

--sr2-replace
    Замінник тексту, знайденого за допомогою sr2-пошуку.

--sr2-search
    Шаблон пошуку (формальний вираз), який буде замінено під час sr2-пошуку.

--sr3-replace
    Замінник тексту, знайденого за допомогою sr3-пошуку.

--sr3-search
    Шаблон пошуку (формальний вираз), який буде замінено під час sr3-пошуку.

ВИЯВЛЕННЯ СТРУКТУРИ

Контроль автоматичного визначення структури документа.

--chapter
    Вираз XPath для виявлення заголовків глав. Типово теґи <h1> або <h2>, які містять слова «chapter», «book», «section», «prologue», «epilogue» або «part», а також теґи, що містять class="chapter", вважатимуться теґами заголовків глав. Вказаний вираз має оброблятися як список елементів. Щоб вимкнути виявлення глав, скористайтеся виразом «/». Докладніший опис цієї можливості можна знайти у настановах щодо XPath у підручнику користувача calibre.

--chapter-mark
    Вкажіть спосіб позначення виявлених глав. Значення "pagebreak" призведе до вставлення розривів сторінок перед главами. Значення "rule" призведе до вставлення лінії перед главами. Значення "none" призведе до вимикання позначення глав, а значення "both" — до використання розривів сторінок і ліній для позначення глав.

--disable-remove-fake-margins
    У деяких документах поля сторінки визначаються за допомогою лівого і правого поля для кожного з абзаців. calibre намагатиметься виявити і вилучити такі поля. Іноді може призвести до вилучення полів, які не слід вилучати. У такому разі ви можете вимкнути вилучення.

--insert-metadata
    Вставити метадані книги на початку книги. Корисне, якщо на вашому пристрої для читання електронних книжок не передбачено можливості безпосереднього показу метаданих або пошуку за метаданими.

--page-breaks-before
    Вираз XPath. Розриви сторінок буде вставлено до вказаних елементів. Щоб вимкнути, вкажіть такий вираз: /

--prefer-metadata-cover
    Використати обкладинку з початкового файла, а не вказану обкладинку.

--remove-first-image
    Вилучати перше зображення з початкової електронної книги Корисно, якщо у початковому документі першим зображенням є зображення обкладинки, яке не позначено відповідним чином. Збереження такого зображення призведе до появи у перетвореній книзі двох зображень обкладинок: початкового і створеного calibre.

--start-reading-at
    Вираз XPath для визначення місця у документі, з якого слід розпочати читання. У деяких програмах для читання (найвідомішою з яких є програма для читання Kindle) це місце використовується як місце, з якого слід відкривати книгу. З докладнішими довідковими даними щодо користування цією можливістю можна ознайомитися у настановах щодо XPath у «Підручнику користувача» calibre.

ЗМІСТ

Керування автоматичним створенням змісту. Типово, якщо файл має зміст, його буде використовуватися замість автоматично створеного.

--duplicate-links-in-toc
    Під час створення змісту на основі посилань у початковому документі дозволити дублювання записів, тобто дозволити використання записів з однаковим текстом, якщо ці записи посилаються на різні місця у тексті.

--level1-toc
    Вираз XPath, який визначає всі мітки, які слід додати до змісту на першому рівні. Вказаний вираз має пріоритет над усіма формами автоматичного визначення. Приклади можна знайти у настановах з XPath у підручнику для користувачів calibre.

--level2-toc
    Вираз XPath, який визначає всі мітки, які слід додати до змісту на другому рівні. Всі записи буде додано після попереднього запису першого рівня. Приклади можна знайти у настановах з XPath у підручнику для користувачів calibre.

--level3-toc
    Вираз XPath, який визначає всі мітки, які слід додати до змісту на третьому рівні. Всі записи буде додано після попереднього запису другого рівня. Приклади можна знайти у настановах з XPath у підручнику для користувачів calibre.

--max-toc-links
    Максимальна кількість посилань, які буде додано до змісту. 0 вимикає додавання. Типове значення: 50. Посилання буде додано до змісту, лише якщо буде виявлено меншу за вказану кількість глав.

--no-chapters-in-toc
    Не додавати автоматично визначені розділи до змісту.

--toc-filter
    Вилучити зі змісту записи, які відповідають вказаному формальному виразу. Відповідні записи і всі дочірні записи цих записів буде вилучено.

--toc-threshold
    Якщо буде знайдено менше цієї кількості розділів, то посилання будуть встановлені на сторінку змісту. Типове значення: 6

--use-auto-toc
    Зазвичай, якщо файл джерела вже містить дані змісту, його пріоритет буде вищим за пріоритет автоматично створеного змісту. Якщо буде використано цей пункт, завжди використовуватиметься автоматично створений зміст.

МЕТАДАНІ

Параметри для встановлення метаданих вихідного файла

--author-sort
    Рядок, що використовується для сортування за автором.

--authors
    Вказати авторів. Декілька авторів повинні бути розділені амперсандами (&).

--book-producer
    Вказати виробника (продюсера) книжки.

--comments
    Встановити опис електронної книги.

--cover
    Встановити обкладинку для вказаного файла або URL

--isbn
    Вказати ISBN книжки.

--language
    Встановити мову.

--pubdate
    Встановити дату публікації (припускається визначеною у локальному часовому поясі, окрім випадків, коли часовий пояс вказано явно)

--publisher
    Встановити запис видавця електронної книги.

--rating
    Вказати оцінку. Може бути число між 1 і 5.

--read-metadata-from-opf, --from-opf, -m
    Прочитати метадані з вказаного файла OPF. Прочитані з цього файла метадані перевизначать будь-які інші метадані у початковому файлі.

--series
    Вказати цикл, до якого належить книжка.

--series-index
    Вказати номер книги в циклі.

--tags
    Вказати мітки для книжки. Повинні бути розділені комами.

--timestamp
    Встановити часову позначку для книги (більше ніде не використовується)

--title
    Вказати заголовок

--title-sort
    Версія заголовка, що використовується для сортування.

ДІАГНОСТИКА

Параметри для полегшення зневаджування перетворення

--debug-pipeline, -d
    Зберігати виведені дані на різних кроках перетворення до вказаного каталогу. Корисно, якщо ви не впевнені, на якому кроці сталася помилка.

--verbose, -v
    Рівень докладності. Вкажіть декілька разів, якщо рівень слід збільшити. Двом параметрам відповідає максимальний рівень докладності, одному — середній рівень. Якщо параметр не вказано, рівень докладності буде найнижчим.

AUTHOR
Kovid Goyal

COPYRIGHT
Kovid Goyal