ebook-convert

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

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

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

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

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

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

Якщо ви передаєте аргументи 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-пошуку.

--sr2-replace

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

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

--sr3-replace

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

Шаблон пошуку (формальний вираз), який буде замінено під час 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.

ЗМІСТ

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

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

--level1-toc

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

--level2-toc

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

--level3-toc

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

Максимальна кількість посилань, які буде додано до змісту. 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

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