Описание опций командной строки

Содержание

• Общий формат командной строки
• Список опции командной строки
• Примеры использования

Общий формат командной строки

Общий формат запуска конвертера из командной строки показан ниже. Описание всех опций командной строки и примеры использования смотрите ниже.

fb2mobi.exe [-h] [-c CONFIG_FILE] [-i INPUTDIR] [-o OUTPUTDIR]
            [-f OUTPUTFORMAT] [-r] [-s] [--delete-source-file]
            [--delete-input-dir] [-d] [--log LOG]
            [--log-level LOGLEVEL] [--console-level CONSOLELEVEL]
            [--apnx {eInk,PC}] [--hyphenate | --no-hyphenate]
            [--transliterate | --no-transliterate]
            [--transliterate-author-and-title | --no-transliterate-author-and-title]
            [--screen-width SCREEN_WIDTH]
            [--screen-height SCREEN_HEIGHT]
            [--kindle-compression-level KINDLECOMPRESSIONLEVEL]
            [-p PROFILE] [--no-MOBI-optimization] [--css CSS]
            [--xslt XSLT] [--dropcaps {Simple,Smart,None}] [-l]
            [--notes-mode {default,inline,block,float}]
            [--notes-bodies NOTESBODIES]
            [--annotation-title ANNOTATIONTITLE]
            [--chapter-level CHAPTERLEVEL] [--open-book-from-cover]
            [--chapter-on-new-page | --no-chapter-on-new-page]
            [--send-to-kindle | --no-send-to-kindle]
            [--series-positions SERIESPOSITIONS]
            [--toc-before-body | --toc-after-body]
            [--toc-title TOCTITLE] [--toc-type {Flat,Kindle,Normal}]
            [--toc-max-level TOCMAXLEVEL]
            [--toc-kindle-level TOCKINDLELEVEL]
            [--remove-png-transparency | --no-remove-png-transparency]
            [--stamp-cover {Top,Center,Bottom,None}]
            [--scale-images IMAGESCALE] [-nc] [-cl] [-us] [-nt]
            [infile] [outfile]

Список опции командной строки

Опции командной строки условно можно разделить на два вида. Первый - опции управления режимами конвертирования (одиночный файл, пакетная обработка каталогов). Второй - опции для переопределения параметров, настроенных в файле конфигурации fb2mobi.config. Для второго вида опций в таблице указано, какой параметр файла fb2mobi.config она переопределяет. Соответственно, назначение этого параметра смотрите в разделе Настройка fb2mobi.config. Если для опции указано, что она переопределяет значение какого-либо параметра текущего профиля (в виде profile/Имя настройки), имеется ввиду либо профиль по умолчанию, либо профиль, указанный в командной строке с помощью опции -p.

Опция	Описание
-h	Выводит на экран список доступных опций командной строки.
-c CONFIG_FILE	Путь к конфигурационному файлу. Может быть указан относительно директории, из которой происходит запуск программы. Если указан - должен существовать. Если не указан - программа будет искать fb2mobi.config в домашней директории и, в качестве последней попытки, в директории запуска. Если fb2mobi.config не найден - нужные файлы будут созданы в домашней директории.
-i INPUTDIR	Для пакетной конвертации файлов. Имя входного каталога, содержащего файлы fb2, fb2.zip. Также см. опции -o, -r, -s
-o OUTPUTDIR	Имя выходного каталога, куда помещаются сконвертированные файлы.
-f OUTPUTFORMAT	Формат выходных файлов. Возможные значения mobi, azw3, epub. Переопределяет outputFormat.
-r	Для пакетной конвертации файлов. Рекурсивная обработка входного каталога. Если во входном каталоге есть подкаталоги, содержащие файлы для конвертации, укажите эту опцию. Также см. опцию -s.
-s	Для пакетной конвертации. Позволяет сохранить структуру подкаталогов входного каталога, указанного в опции -i, в выходном каталоге, указанном в опции -o. Имеет смысл указывать совместно с опцией -r.
--delete-source-file	Удалять входной файл при успешной конвертации
--delete-input-dir	Удалять входной каталог при успешной конвертации
-d	Режим отладки. В данном режиме конвертер создает в каталоге выходного файла каталог, содержащий промежуточные файлы. По сути, содержимое каталога представляет собой распакованную книгу в формате epub, которая в последствие поступает на вход утилиты kindlegen, либо пакуется в файл epub. Переопределяет debug.
--log LOG	Имя лог-файла. Переопределяет logFile.
--log-level LOGLEVEL	Уровень логирования при записи в лог-файл. Возможные значения DEBUG, INFO, ERROR, CRITICAL. Переопределяет logLevel.
--console-level CONSOLELEVEL	Уровень логирования при выводе в консоль. Возможные значения DEBUG, INFO, ERROR, CRITICAL. Переопределяет consoleLevel.
--apnx APNX	Генерация индексного файла для поддержки нумерации страниц в файлах формата mobi и azw3. Возможные значения eInk, PC. Переопределяет profile/generateAPNX.
--hyphenate --no-hyphenate	Включить/выключить расстановку "мягким" переносов. Переопределяет profile/hyphens.
--transliterate --no-transliterate	Включить/выключить транслитерацию имени конечного файла. Переопределяет transliterate.
--transliterate-author-and-title --no-transliterate-author-and-title	Включить/выключить транслитерацию метаданных конечного файла. Переопределяет profile/transliterateAuthorAndTitle.
--screen-width SCREEN_WIDTH	Ширина экрана устройства чтения в пикселях. Переопределяет screenWidth.
--screen-height SCREEN_HEIGHT	Высота экрана устройства чтения в пикселях. Переопределяет screenWidth.
-kindle-compression-level KINDLECOMPRESSIONLEVEL	Уровень сжатия конечного файла в формате mobi. Переопределяет kindleCompressionLevel.
-p PROFILE	Имя профиля для конвертации. Можете указать профиль из преднастроенных в файле fb2mobi.config. Переопределяет defaultProfile.
--no-MOBI-optimization	Отключить режим оптимизации конечного файла в формате mobi. Переопределяет noMOBIoptimization.
--css CSS	Имя файла CSS, содержащего описание стилей CSS для конвертации. Переопределяет profile/css
--xslt XSLT	Имя файла xsl, содержащего инструкции xslt-преобразований при конвертации. Переопределяет profile/xslt
--dropcaps DROPCAPS	Режим вставки буквицы. Возможные значения Simple, Smart, None. Переопределяет profile/dropcaps.
-l	Вывести на консоль список профилей, определенных в файле настроек fb2mobi.config.
--notes-mode NOTESMODE	Режим формирования сносок. Возможные значения default, inline, block, float. Переопределяет profile/notesMode.
--notes-bodies NOTESBODIE	Содержит список разделов файла fb2, определяемых конвертером, как разделы, содержащие тексты сносок. Переопределяет profile/notesBodies.
--annotation-title ANNOTATIONTITLE	Определяет название страницы аннотации книги. Переопределяет profile/annotationTitle.
--chapter-level CHAPTERLEVEL	Определяет на каком уровне вложенности секции fb2 считаются главами. Переопределяет profile/chapterLevel.
--open-book-from-cover	Открывать книгу с обложки для устройств Kindle. Переопределяет profile/openBookFromCover.
--chapter-on-new-page --no-chapter-on-new-page	Указывает конвертеру начинать ли главу с новой страницы. Переопределяет profile/chapterOnNewPage.
--send-to-kindle --no-send-to-kindle	Включить/выключить отправку книг на устройство Kindle по e-mail. Предварительно необходимо настроить параметры отправки в разделе sendToKindle файла fb2mobi.config. Переопределяет sendToKindle/send.
--series-positions SERIESPOSITIONS	Количество знаков для номера книги в серии. См. настройку bookTitleFormat fb2mobi.config. Переопределяет profile/seriesPositions.
--toc-before-body --toc-after-body	Указывает положение страницы оглавления книги - в начале книги, либо в конце. Переопределяет 'profile/tocBeforeBody'.
--toc-title TOCTITLE	Определяет название страницы оглавления. Переопределяет profile/tocTitle.
--toc-type TOCTYPE	Управляет стилем оглавления, доступным через средства навигации, встроенных в устройство чтения. Возможные значения Flat, Kindle, Normal. Переопределяет profile/tocType.
--toc-max-level TOCMAXLEVEL	Максимальный уровень вложенности заголовка (секции) для помещения на страницу оглавления книги. Переопределяет profile/tocMaxLevel.
--toc-kindle-level TOCKINDLELEVEL	Ограничивает уровень иерархии оглавления для устройств Kindle. Переопределяет profile/tocKindleLevel.
--remove-png-transparency --no-remove-png-transparency	Контролирует преобразование прозрачных PNG картинок в непрозрачные. Переопределяет profile/removePngTransparency.
--stamp-cover POSITION	Контролирует печать информации о книге на обложке. Возможные значения None, Top, Center, Bottom. Если включена требует наличия coverFont в активном профиле. Cover page, подставляемая при ее отсутствии в оригинале всегда штампуется.
--scale-images IMAGESCALE	Если специфицировано положительное не нулевое рациональное число, размер всех JPEG и PNG изображений (кроме cover image) из оригинального FB2 будет принудительно изменен с указанным кофициентом. Если в оригинальном изображении не было специфицировано DPI - будет использовано (300, 300), если было - оно будет сохранено.
-nc, -cl, -us, -nt	Набор опций для совместимости с MyHomeLib. Конвертером никак не обрабатываются.
infile	Имя входного файла. Конвертер принимает на вход файлы в формате fb2 и fb2.zip.
outfile	Имя выходного файла. По умолчанию конвертер формирует имя выходного файла на основании имени входного файла и указанного формата выходного файла в файле настроек или через опцию -f. Вы можете переопределить имя и формат выходного файла, указав значение этой опции. Формат выходного файла указывается в виде его расширения. Например outfile.mobi. Возможные расширения mobi, azw3, epub.

Примеры использования

В примерах используются следующие обозначения:

• входной_файл - путь к файлу в формате fb2 или fb2.zip
• выходной_файл - путь к файлу в формате mobi, azw3 или epub.
• входной_каталог - путь к каталогу, содержащему файлы fb2 или fb2.zip для конвертации
• выходной_каталог - путь к каталогу, куда конвертер помещает выходные файлы.

Конвертирование одного файла с профилем и форматом по умолчанию. Выходной файл создается в каталоге, где расположен входной файл.

fb2mobi <входной_файл>

Конвертирование одного файла с указанием формата через опцию -f и указанием выходного каталога.

fb2mobi <входной_файл> -f mobi -o <выходной_каталог>

Конвертирование одного файла с указанием формата через расширение имени выходного файла.

fb2mobi <входной_файл> <выходной_файл>.azw3

Пакетная конвертация файлов из входного каталога. Будут сконвертированы файлы, лежащие в каталоге <входной_каталог>, результирующие файлы будут помещены в выходной каталог.

fb2mobi -i <входной_каталог> -o <выходной_каталог>

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

fb2mobi -i <входной_каталог> -o <выходной_каталог> -r -s