This repository has been archived by the owner on Mar 15, 2020. It is now read-only.
Описание опций командной строки
dnkorpushov edited this page Oct 4, 2018
·
24 revisions
Общий формат запуска конвертера из командной строки показан ниже. Описание всех опций командной строки и примеры использования смотрите ниже.
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