EBOOK-CONVERT(1)

NAME
ebook-convert - ebook-convert

            ebook-convert input_file output_file [параметры]

Преобразовать электронную книгу из одного формата в другой.

input_file - это вход, а output_file - это выход. Оба должны быть указаны в качестве первых двух аргументов команды.

Выходной формат электронной книги определяется расширением файла output_file. Выходной_файл также может иметь специальный формат .EXT, где EXT - это расширение выходного файла. В этом случае имя выходного файла происходит от имени входного файла. Обратите внимание, что имена файлов не должны начинаться с дефиса. Наконец, если output_file не имеет расширения, он рассматривается как папка, и в эту папку записывается «открытая электронная книга» (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 Name.recipe" output.epub

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

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

ВХОДНЫЕ НАСТРОЙКИ

Опции для контроля обработки входного файла mobi

    --input-encoding
        Укажите кодировку исходного документа. Если установить эту опцию, то любая исходная кодировка будет переопределена. Особенно полезно для документов, в которых кодировка не указана или указана неверно.

ВЫХОДНЫЕ НАСТРОЙКИ

Настройки для контроля обработки выходного файла epub

    --dont-split-on-page-breaks
        Выключить разбиение при разрыве страниц. Обычно входные файлы автоматически разбиваются на каждый разрыв страницы на два файла. Это дает выходную электронную книгу, которая может анализироваться быстрее и с меньшими ресурсами. Однако разбиение происходит медленно, и если ваш исходный файл содержит очень большое количество разрывов страниц, вы должны отключить разбиение на разрыве страниц.

    --epub-flatten
        Этот параметр нужен только если EPUB-файл будет использован с FBReaderJ. Файловая структура внутри EPUB файла будет сплющена, все файлы разместятся в корне.

    --epub-inline-toc
        Добавить встроенное оглавление, которое появится как часть основного содержания книги.

    --epub-max-image-size
        Максимальный размер изображения (ширина x высота). Значение profile означает использование размера экрана из выходного профиля. Значение none - максимальный размер не указан. Например, значение 100x200 - изменение размера всех изображений так чтобы их ширина была не больше 100 пикселей, а высота - не больше 200 пикселей. Обратите внимание, что это влияет только на размер самих файлов изображений. Любое данное изображение может отображаться в другом размере в зависимости от стиля, примененного к нему в документе.

    --epub-toc-at-end
        Поместить встроенное оглавление в конце книги, а не в начале.

    --epub-version
        Версия файла EPUB для генерации. EPUB 2 - наиболее широко совместим, используйте EPUB 3, только если вы знаете, что он вам действительно нужен.

    --extract-to
        Распакуйте содержимое сгенерированной книги в указанную папку. Содержимое папки сначала удаляется, так что будьте осторожны.

    --flow-size
        Разбить все HTML файлы, размер которых превышает заданный (в КБ). Это необходимо сделать, поскольку большинство читалок EPUB не могут обрабатывать большие файлы. По умолчанию 260KB определяется как размер, необходимый для 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
        Заголовок любого сгенерированного встроенного оглавления.

ВИД И ФУНКЦИИ

Опции для контроля за внешним видом выходного файла

    --asciiize
        Транслитерировать символы Unicode в ASCII. Используйте с осторожностью, символы Unicode будут заменены на ASCII. Например, 'Pelé' заменится на 'Pele'. Также обратите внимание, что в случаях, когда существует несколько представлений символа (например, символов, используемых в китайском и японском языках), будет использоваться представление, основанное на текущем языке интерфейса calibre.

    --base-font-size
        Размер базового шрифта в pt. Все размеры шрифтов в выпущенной книге будут перемасштабированы на основе этого размера. Выбирая больший размер, вы можете увеличить шрифты на выходе и наоборот. По умолчанию, когда значение равно нулю, размер базового шрифта выбирается на основе выбранного профиля вывода.

    --change-justification
        Изменить выравнивание текста. Значение "Влево" преобразует все выравнивание текста из источника в выравнивание по левому краю (то есть не выравненому). Значение "Выровнять" преобразует весь не выровненный текст в выровненный. Значение "оригинал" (по умолчанию) не изменяет выравнивание в исходном файле. Обратите внимание, что только некоторые выходные форматы поддерживают выравнивание.

    --disable-font-rescaling
        Запретить масштабирование шрифтов.

    --embed-all-fonts
        Встроить каждый шрифт, который содержится в исходном документе, но ещё не встроен. Используемые шрифты - искать в вашей системе и встроить их, если найдены. Встраивание будет работать только если формат, в который вы конвертируете, поддерживает встраиваемые шрифты. Например EPUB, AZW3, DOCX и PDF. Убедитесь, что у вас есть лицензия на встраиваемые шрифты, используемые в этом документе.

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

    --expand-css
        По умолчанию calibre будет использовать сокращенную форму для различных свойств CSS, таких как margin, padding, border и т.п. Этот параметр включает использование полной расширенной формы. Обратите внимание, что CSS всегда расширяется при создании файлов EPUB с профилем вывода на Nook, поскольку 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-small до xx-large, с последним размером для огромных шрифтов. Алгоритм масштабирования шрифтов использует эти размеры для правильного масштабирования. По умолчанию используются настройки выбранного профиля.

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

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

    --keep-ligatures
        Сохраните лигатуры, присутствующие во входном документе. Лигатура — это комбинированный символ пары символов, таких как ff, fi, fl и т. д. Большинство программ чтения не поддерживают лигатуры в шрифтах по умолчанию, поэтому они вряд ли будут отображаться правильно. По умолчанию calibre превратит лигатуру в соответствующую пару обычных символов. Обратите внимание, что под лигатурами здесь подразумеваются только лигатуры Юникода, а не лигатуры, созданные с помощью CSS или стилей шрифта. Вместо этого эта опция сохранит их.

    --line-height
        Высота строки в пунктах. Определяет расстояние между двумя соседними строками текста. Применяется только к элементам, у которых не определена высота строки. В большинстве случаев лучше всего оставлять минимальное значение. По умолчанию никакие действия с высотой строк не производятся.

    --linearize-tables
        Некоторые плохо форматированные документы используют таблицы для управления расположением текста на странице. При конвертации этих документов текст зачастую становится неудобочитаемым. Эта опция указывает, что нужно извлекать содержимое из таблиц и представлять его в линейном виде.

    --margin-bottom
        Установить нижнюю границу в pt (пунктах). Умолчание - 5.0. Установка значения меньше нуля приведет к отсутствию границы (настройка полей в исходном документе будет сохранена). Примечание. Ориентированные на страницы форматы, такие как PDF и DOCX, имеют свои собственные настройки полей.

    --margin-left
        Установить левую границу в pt (пунктах). Умолчание - 5.0. Установка значения меньше нуля приведет к отсутствию границы (настройка полей в исходном документе будет сохранена). Примечание. Ориентированные на страницы форматы, такие как PDF и DOCX, имеют свои собственные настройки полей.

    --margin-right
        Установить правую границу в pt (пунктах). Умолчание - 5.0. Установка значения меньше нуля приведет к отсутствию границы (настройка полей в исходном документе будет сохранена). Примечание. Ориентированные на страницы форматы, такие как PDF и DOCX, имеют свои собственные настройки полей.

    --margin-top
        Установить верхнюю границу в pt (пунктах). Умолчание - 5.0. Установка значения меньше нуля приведет к отсутствию границы (настройка полей в исходном документе будет сохранена). Примечание. Ориентированные на страницы форматы, такие как PDF и DOCX, имеют свои собственные настройки полей.

    --minimum-line-height
        Минимальная высота строки в процентах от вычисленного размера шрифта элемента. Calibre позаботится о том, чтобы каждый элемент имел высоту строки не менее заданной, независимо от того, что указано во входящем документе. Для отключения задайте ноль. По умолчанию — 120%. Использование данной настройки предпочтительнее, чем прямое указание высоты строки, кроме случая, когда Вы точно понимаете свои действия. Например, «двойной интервал» получается при значении 240.

    --remove-paragraph-spacing
        Удалить промежутки между абзацами и установить отступ абзаца в 1.5em. Удаление промежутков не будет работать, если в исходном документе абзацы (теги <p> или <div>) не используются.

    --remove-paragraph-spacing-indent-size
        Когда Calibre удаляет пустые строки между абзацами, то автоматически расставляет красные строки, чтобы абзацы визуально выделялись. Эта опция устанавливает величину отступа (в em). Если установлена отрицательная величина, используется размер отступа, указанный в документе.

    --smarten-punctuation
        Преобразовать обычные кавычки, тире и троеточия к их типографическим эквивалентам. Более подробно, см. <https://daringfireball.net/projects/smartypants>

    --subset-embedded-fonts
        Сократить все внедрённые шрифты. Каждый внедрённый шрифт будет содержать только используемые в документе символы. Это уменьшает размер файла шрифтов. Полезно если вы внедряете объёмный шрифт с большим количеством неиспользуемых символов.

    --transform-css-rules
        Путь к файлу, содержащему правила для преобразования стилей CSS в этой книге. Самый простой способ создать такой файл - использовать мастер для создания правил в графическом интерфейсе calibre. Получите доступ к нему в разделе Оформление->Стили трансформации из диалогового окна преобразования. После создания правил вы можете использовать кнопку «Экспорт», чтобы сохранить их в файле.

    --transform-html-rules
        Путь к файлу, содержащему правила трансформации HTML в этой книге. Простейший способ создать такой файл - использовать мастер для создания правил в графическом интерфейсе calibre. Доступ к нему можно получить в разделе «Внешний вид - Преобразование HTML» диалогового окна конвертации. После создания правил вы можете использовать кнопку «Экспорт», чтобы сохранить их в файл.

    --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
        Путь к файлу, содержащему регулярные выражения для поиска и замены. Файл должен содержать чередующиеся строки регулярного выражения, за которым следует шаблон замены (который может быть пустой строкой). Регулярное выражение должно быть в синтаксисе regex Python, и файл должен быть в кодировке UTF-8.

    --sr1-replace
        Текст, на который будут заменяться найденные тексты, соответствующие первому выражению поиска.

    --sr1-search
        Шаблон поиска (регулярное выражение), заменяемый на первый текст замены.

    --sr2-replace
        Текст, на который будут заменяться найденные тексты, соответствующие второму выражению поиска.

    --sr2-search
        Шаблон поиска (регулярное выражение), заменяемый на второй текст замены.

    --sr3-replace
        Текст, на который будут заменяться найденные тексты, соответствующие третьему выражению поиска.

    --sr3-search
        Шаблон поиска (регулярное выражение), заменяемый на третий текст замены.

ОПРЕДЕЛЕНИЕ СТРУКТУРЫ

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

    --add-alt-text-to-img
        Если у <img> тега нет атрибута alt, проверьте связанный файл изображения на наличие метаданных, определяющих альтернативный текст, и используйте их для заполнения атрибута alt. Атрибут alt улучшает доступность, предоставляя текстовые описания для пользователей, которые не могут видеть или полностью интерпретировать визуальный контент.

    --chapter
        Выражение XPath для определения названий глав. По умолчанию следует учитывать теги <h1> или <h2>, содержащие слова "chapter", "book", "section", "prologue", "epilogue" или "part". В качестве заголовков глав, а также любых тегов, которые имеют класс="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