awesome

package: awesome

title: awesome(1)

summary: потрясающий оконный менеджер

text:
# awesome(1)

## ИМЯ
awesome - потрясающий оконный менеджер

## СИНОПСИС
awesome [-v | --version] [-h | --help] [-c | --config FILE] [-k | --check] [--search DIRECTORY] [-a | --no-argb] [-r | *--replace]

## ОПИСАНИЕ
awesome — это оконный менеджер для X. Он управляет окнами, размещая их в соответствии с разными схемами (layout), такими как плавающая (floating) или мозаичная (tiled). Любая схема может быть применена динамически, оптимально подстраивая рабочую среду под текущую выполняемую задачу и приложение.

В мозаичной схеме окна размещаются в двух зонах: главная и стековая. В главной зоне размещаются окна, которые требуют основного внимания, а в стековой — все остальные. В плавающей схеме окна можно свободно перемещать и изменять их размер. Диалоговые окна всегда отображаются в плавающем режиме, вне зависимости от текущей выбранной схемы. Спиральная и уменьшающая схемы являются исключениями: окна в стековой зоне в этих схемах размещаются по спирали для первой, и в виде фрактала квадратов для второй.

Окна в awesome сгруппированы по тегам. Каждое окно может быть помечено одним или несколькими тегами. Можно выбрать один или несколько тегов, чтобы увидеть окна с этими тегами.

В awesome можно создавать вибоксы (виджет + бокс), в которых можно отображать всё, что вы хотите: все имеющиеся теги, текущая выбранная схема, заголовки видимых окон, произвольный текст и т. д.

## ОПЦИИ
-v, --version

Показать информацию о версии на стандартный вывод и выйти.

-h, --help

Показать справку и выйти.

-c, --config FILE

Использовать альтернативный конфигурационный файл вместо $XDG_CONFIG_HOME/awesome/rc.lua.

-k, --check

Проверить синтаксис конфигурационного файла.

--search

Добавить каталог в пути поиска библиотеки.

-a, --no-argb

Не использовать ARGB.

-r, --replace

Replace an existing window manager.

## НАСТРОЙКИ МЫШИ ПО-УМОЛЧАНИЮ

### Навигация
Button1 на имени тега

Выбрать тег для отображения.

Button4, Button5 на имени тега

Выбрать предыдущий или следующий тег.

Button4, Button5 на корневом окне

Выбрать предыдущий или следующий тег.

Button1, Button3, Button4, Button5 на значке схемы

Переключиться на предыдущую или следующую схему.

### Изменение схемы
Mod4 + Button1 на имени тега

Пометить текущий клиент только этим тегом.

Mod4 + Button3 на имени тега

Пометить текущий клиент этим тегом, либо убрать пометку этим тегом.

Button3 на имени тега

Добавить текущий тег для просмотра.

Mod4 + Button1 на окне клиента

Переместить окно.

Mod4 + Button3 на окне клиента

Изменить размер окна.

## НАСТРОЙКИ КЛАВИАТУРЫ ПО-УМОЛЧАНИЮ

### Справка
Mod4 + s

Показать текущие назначенные сочетания клавиш.

### Управление менеджером окон
Mod4 + Control + r

Перезапустить awesome.

Mod4 + Shift + q

Выйти из awesome.

Mod4 + r

Открыть командную строку.

Mod4 + x

Открыть командную строку для выполнения Lua-кода.

Mod4 + Return

Запустить эмулятор терминала.

Mod4 + w

Открыть главное меню.

### Клиенты
Mod4 + m

Развернуть на весь экран.

Mod4 + n

Свернуть.

Mod4 + Control + n

Восстановить.

Mod4 + f

Полноэкранный режим.

Mod4 + Shift + c

Убить выбранный клиент.

Mod4 + t

Прикрепить поверх всех.

### Навигация
Mod4 + j

Следующий клиент.

Mod4 + k

Предыдущий клиент.

Mod4 + u

Первый клиент в режиме повышенного внимания (urgent).

Mod4 + Left

Выбрать предыдущий тег.

Mod4 + Right

Выбрать следующий тег.

Mod4 + 1-9

Переключиться на тег по номеру (от 1 до 9).

Mod4 + Control + j

Следующий экран.

Mod4 + Control + k

Предыдущий экран.

Mod4 + Escape

Выбрать предыдущий выбранный набор тегов.

### Изменение схемы
Mod4 + Shift + j

Поменять текущий и следующий за ним клиенты местами.

Mod4 + Shift + k

Поменять текущий и предыдущий клиенты местами.

Mod4 + o

Отправить клиент на следующий экран.

Mod4 + h

Уменьшить главную зону на 5%.

Mod4 + l

Увеличить главную зона на 5%.

Mod4 + Shift + h

Увеличить число окон в главной зоне на 1.

Mod4 + Shift + l

Уменьшить число окон в главной зоне на 1.

Mod4 + Control + h

Увеличить число колонок для стековой зоны на 1.

Mod4 + Control + l

Уменьшить число колонок для стековой зоны на 1.

Mod4 + space

Выбрать следующую схему.

Mod4 + Shift + space

Выбрать предыдущую схему.

Mod4 + Control + space

Переключить плавающий режим для текущего клиента.

Mod4 + Control + Return

Поменять текущий и главный клиенты местами.

Mod4 + Control + 1-9

Включить/выключить тег по номеру.

Mod4 + Shift + 1-9

Пометить клиента тегом по номеру.

Mod4 + Shift + Control + 1-9

Пометить/снять пометку клиента тегом по номеру.

## НАСТРОЙКА
awesome настраивается файлом $XDG_CONFIG_HOME/awesome/rc.lua (надо создать, если его нет).

## СИГНАЛЫ
awesome может быть перезапущен сигналом SIGHUP.

## СМОТРИ ТАКЖЕ
awesomerc(5) awesome-client(1)

## БАГИ
Само собой разумеется, что в awesome багов нет. Но могут встречаться ВНЕЗАПНОСТИ.

## АВТОРЫ
Julien Danjou <julien@danjou.info> и другие.

## WWW
<https://awesomewm.org>

## ПЕРЕВОД
Это руководство переведено на русский язык Константином Степановым <kstep@p-nut.info> 13 апреля 2011 года.

branch: sisyphus


awesome-client

title: awesome-client(1)

text:
# awesome-client(1)

## ИМЯ
awesome-client - удалённое управление потрясающим оконным менеджером

## СИНОПСИС
awesome-client [-h|--help] [command [command...]]

## ОПИСАНИЕ
awesome-client — это инструмент для командной строки для удалённого выполнения команд в awesome. Он общается с awesome через D-Bus для удалённого выполнения произвольного Lua-кода.

## ИСПОЛЬЗОВАНИЕ
awesome-client читает команды из стандартного входа и посылает их на выполнения awesome через D-Bus. Если установлен «rlwrap», то он будет использован для предоставление командного интерфейса с помощью readline.

В awesome должен быть загружен модуль «awful.remote», чтобы позволить удалённое выполнение кода.

## ПРИМЕРЫ

```
$ awesome-client 'return 1+1, "Hello, world"\

   double 2

   string "Hello, world"
# Следующий пример не возвращает ничего в командную строку,
# но показывает уведомление.
$ awesome-client '
> naughty = require("naughty")
> naughty.notify({
> title="CLI Notification",
> text="Это уведомление было отправлено из командной строки!"})
> '
# Интерактивный режим (REPL)
# В данном режиме каждая строка введенная пользователем
# будет отправлена в awesome wm, точно так же, как если бы несколько команд
# были бы переданы как аргументы командной строки.
$ awesome-client
awesome# return 1+1

   double 2
awesome# return 1+1, "Hello, world"

   double 2

   string "Hello, world"
awesome#
```

## СМОТРИ ТАКЖЕ
awesome(1) awesomerc(5)

## АВТОРЫ
Julien Danjou <julien@danjou.info>

## WWW
<https://awesomewm.org>

## ПЕРЕВОД
Это руководство переведено на русский язык Константином Степановым <kstep@p-nut.info> 13 апреля 2011 года.


calibre

package: calibre

title: calibre(1)

summary: calibre

text:
# calibre(1)

## NAME
calibre - calibre

```
calibre [параметры] [path_to_ebook или calibre url ...]
```

Запустить основной графический интерфейс пользователя и, при желании, добавить электронную книгу по path_to_ebook в базу данных. Также возможно указать URL-адреса calibre для выполнения других действий. Например:

calibre://view-book/test_library/1842/epub

откроет книгу с id 1842 в формате EPUB из библиотеки "test_library" в просмотрщике электронных книг. Имена библиотек - это имена папок библиотеки с пробелами, заменёнными подчеркиванием. Полное описание действий на основе URL-адресов приведены в Руководстве пользователя.

Когда вы передаёте аргументы с пробелами в calibre, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--detach

Отвязаться от управляющего терминала (только Linux)

--help, -h

показать это сообщение и выйти

--ignore-plugins

Игнорировать пользовательские плагины. Полезно, если вы установили плагин, препятствующий запуску Calibre

--no-update-check

Не проверять наличие обновлений

--shutdown-running-calibre, -s

Завершает работу запущенного экземпляра calibre, если такой имеется. Обратите внимание, что прервутся все выполняющиеся задания, поэтому используйте с осторожностью.

--start-in-tray

Запускать свёрнутым в системный лоток.

--verbose, -v

Не учитывается, поэтому не используйте. Оставлено только для совместимости

--version

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

--with-library

Использовать библиотеку по указанному пути.

## Author
Kovid Goyal

## Copyright
Kovid Goyal


calibre-customize

title: calibre-customize(1)

summary: calibre-customize

text:
# calibre-customize(1)

## NAME
calibre-customize - calibre-customize

```
calibre-customize [опции]
```

Настроить calibre с помощью загрузки внешних плагинов.

Когда вы передаёте аргументы с пробелами в calibre-customize, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--add-plugin, -a

Добавить плагин, указав путь к содержащему его ZIP файлу.

--build-plugin, -b

Для разработчиков плагинов: путь к папке, в которой вы разрабатываете плагин. Эта команда автоматически заархивирует плагин и обновит его в calibre.

--customize-plugin

Настроить плагин. Укажите имя плагина и строку настройки через запятую. Строка настройки такая же, как и при настройке плагина в графическом интерфейсе.

--disable-plugin

Отключить указанный плагин

--enable-plugin

Включить указанный плагин

--help, -h

показать это сообщение и выйти

--list-plugins, -l

Список всех установленных плагинов

--remove-plugin, -r

Удалить пользовательский плагин по имени. Не влияет на встроенные плагины

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


calibre-debug

title: calibre-debug(1)

summary: calibre-debug

text:
# calibre-debug(1)

## NAME
calibre-debug - calibre-debug

```
calibre-debug [options]
```

Разные интерфейсы командной строки, полезные для отладки calibre. Без вариантов, эта команда запускает встроенный интерпретатор Python. Также можно запустить основной GUI calibre, просмотрщик электронных книг calibre и редактор calibre в режиме отладки.

Он также содержит интерфейсы для различных опций calibre, для которых нет отдельных инструментов командной строки, например выделение подмножества шрифтов, инструмент сравнения электронных книг и т. д.

Вы также можете использовать calibre-debug для запуска автономных скриптов. Для этого используйте его так:

calibre-debug -e myscript.py -- --option1 --option2 file1 file2 ...

Всё, что после -- передаётся в скрипт. Вы также можете использовать calibre-debug как шебанг (shebang) в скриптах, вот так:

\#!/usr/bin/env -S calibre-debug -e -- --

Когда вы передаёте аргументы с пробелами в calibre-debug, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--add-simple-plugin

Добавить простой плагин (т.е. плагин, который состоит только из .py файла), указав путь к .py файлу, содержащему код плагина.

--command, -c

Запустить Python код

--debug-device-driver, -d

Отладка обнаружения устройства

--default-programs

Добавить (убрать) Calibre в список программ по умолчанию Windows --default-programs = (register|unregister)

--diff

Запустить инструмент сравнения. Например: calibre-debug --diff file1 file2

--edit-book

Launch the calibre "Edit book" tool in debug mode. As with -g use -- to pass command line arguments.

--exec-file, -e

Запустить Python код в файле.

--explode-book, -x

Взорвать книгу в указанную папку. Использование: -x file.epub output_dir Экспортирует книгу как набор файлов HTML и метаданных, которые можно редактировать с помощью стандартных инструментов редактирования HTML. Работает с файлами EPUB, AZW3, HTMLZ и DOCX.

--export-all-calibre-data

Экспортировать все данные calibre (книги/настройки/плагины). Обычно вас попросят указать папку экспорта и библиотеки для экспорта. Вы также можете указать их в качестве аргументов командной строки, чтобы пропустить вопросы. Используйте абсолютные пути для папки экспорта и библиотек. Специальное ключевое слово all можно использовать для экспорта всех библиотек. Примеры: calibre-debug --export-all-calibre-data # для интерактивного использования calibre-debug --export-all-cale-data /путь/к/пустому/экспорту/папке /путь/к/библиотеке/папке1 /путь/к/библиотеке2 calibre-debug --export-all-dication-data /export/folder all # экспортировать все известные библиотеки

--gui, -g

Run the GUI with debugging enabled. Debug output is printed to stdout and stderr. To pass command line arguments use -- followed by the arguments, for example: calibre-debug -g -- /path/to/ebook

--gui-debug

Запустить графический интерфейс с отладочной консолью, фиксируя указанный путь. Только для внутреннего использования. Используйте ключ -g чтобы запустить графический интерфейс в отладочном режиме.

--help, -h

показать это сообщение и выйти

--implode-book, -i

Исправить ранее развернутую книгу. Использование: -i output_dir file.epub Импортировать книгу из файлов в output_dir, которые созданы предыдущим вызовом -explode-book. Используйте тот же тип файла, который был при разворачивании.

--import-calibre-data

Импорт ранее экспортированных данных calibre

--inspect-mobi, -m

Посмотреть MOBI файл(файлы) по указанному пути(путях)

--kepubify

Конвертировать указанный файл EPUB в KEPUB без полной конвертации. Это то, что делает драйвер Kobo при отправке файлов на устройство.

--paths

Вывести пути, необходимые для установки окружения для calibre

--run-plugin, -r

Запустить плагин, обеспечивающий интерфейс командной строки. Например: calibre-debug -r "Plugin name" -- file1 --option1 Всё после -- будет передано плагину в качестве параметров.

--run-test, -t

Запустить упомянутый(-е) тест(-ы). Специальное значение all - запустить все тесты. Если имя теста начинается с точки, предполагается, что это имя модуля. Если имя теста начинается с @, предполагается, что это имя категории.

--run-without-debug

Не запускать с установленным флагом DEBUG

--shutdown-running-calibre, -s

Завершает работу запущенного экземпляра calibre, если такой имеется. Обратите внимание, что прервутся все выполняющиеся задания, поэтому используйте с осторожностью.

--subset-font, -f

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

--test-build

Тест бинарных модулей в сборке

--un-kepubify

Конвертировать указанный файл KEPUB в EPUB без полной конвертации. Это то, что делает драйвер Kobo при импорте файлов с устройства.

--version

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

--viewer, -w

Run the E-book viewer in debug mode. As with -g use -- to pass command line arguments.

## Author
Kovid Goyal

## Copyright
Kovid Goyal


calibre-server

title: calibre-server(1)

summary: calibre-server

text:
# calibre-server(1)

## NAME
calibre-server - calibre-server

```
calibre-server [опции] [путь к папке библиотеки…]
```

Запустить контент-сервер calibre. Контент-сервер показывает ваши библиотеки calibre через интернет. Вы можете указать пути к папкам библиотек в качестве аргументов для calibre-server. Если вы не укажете какие-либо пути, будут использоваться все библиотеки, о которых знает основная программа calibre.

Когда вы передаёте аргументы с пробелами в calibre-server, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--access-log

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

--ajax-timeout

Время (в секундах), ожидания ответа от сервера при выполнении запросов.

--auth-mode

Выбрать тип используемой авторизации. Установка используемого сервером режима проверки подлинности HTTP. Выберите «basic», если размещаете этот сервер за SSL-прокси. Или оставьте «auto», который будет использовать «basic», если SSL настроен, а в противном случае — «digest».

--auto-reload

Автоматическая перезагрузка сервера при изменении исходного кода. Полезно в разработке. Вам также следует указать малое значение таймаута выключения.

--ban-after

Количество неудачных попыток входа в систему. Количество неудачных входов, после которого IP-адрес запрещается

--ban-for

Запретить IP-адреса с повторными ошибками входа. Временно запрещает доступ для IP-адресов с повторными ошибками входа в течение указанного количества минут. Полезно для предотвращения попыток подбора паролей. Если установлено в ноль, запрет не выполняется.

--book-list-mode

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

--compress-min-size

Мин. размер, для использования сжатия данных в ответах (в байтах).

--custom-list-template

Путь к файлу JSON, содержащему шаблон для настраиваемого режима списка книг. Простейший способ создать такой файл шаблона - перейти в calibre Настройки -> Обмен через сеть -> Шаблон списка книг , создать шаблон и экспортировать его.

--daemonize

Запустить процесс в фоне как демон (только Linux).

--displayed-fields

Ограничить отображаемые пользовательские поля. Список разделенных пользователем полей метаданных, которые будут отображаться контент-сервером в представлениях /opds и /mobile. Если вы укажете этот параметр, любые поля, не входящие в этот список, не будут отображаться. Например: my_rating,my_tags

--enable-allow-socket-preallocation, --disable-allow-socket-preallocation

Предварительное выделение сокета, например, systemd активация сокета. По умолчанию эта опция включена.

--enable-auth, --disable-auth

Аутентификация на основе пароля для доступа к серверу. Как правило, сервер неограничен, что позволяет всем получить к нему доступ. Эта опция ограничит доступ предопределенными пользователями. По умолчанию эта опция отключена.

--enable-fallback-to-detected-interface, --disable-fallback-to-detected-interface

Откат к автоматически определяемому интерфейсу. Если по какой-то причине сервер неспособен присоединиться к интерфейсу, заданному в настройке listen_on, он попробует определить интерфейс, который подключён к внешнему миру, и присоединиться к нему. По умолчанию эта опция включена.

--enable-local-write, --disable-local-write

Разрешить не аутентифицированным локальным подключениям вносить изменения. Обычно, если вы не включаете аутентификацию, сервер работает в режиме только для чтения, чтобы анонимные пользователи не вносили изменений в ваши библиотеки. Эта опция позволяет любому пользователю подключаться к серверу calibre для внесения изменений. Небезопасно запускать сервер без проверки подлинности, с использованием calibredb для внесения изменений в ваши библиотеки. Обратите внимание, что включение этой опции означает, что ЛЮБАЯ программа, запущенная на компьютере, может вносить изменения в ваши библиотеки. По умолчанию эта опция отключена.

--enable-log-not-found, --disable-log-not-found

Логировать HTTP 404 (Not Found) запросы. Обычно сервер регистрирует все HTTP-запросы для ресурсов, которые не найдены.Это может привести к большому количеству спама в журнале, если на ваш сервер нацелились боты. Используйте этот параметр, чтобы отключить логирование. По умолчанию эта опция включена.

--enable-use-bonjour, --disable-use-bonjour

Объявлять фиды OPDS через BonJour. Объявлять фиды OPDS через сервис BonJour, чтобы приложения, оперирующие с OPDS могли их определить и подключиться к серверу автоматически. По умолчанию эта опция включена.

--enable-use-sendfile, --disable-use-sendfile

Zero-copy передача файлов для увеличения производительности. Включение zero-copy для передач внутри ядра при отправке файлов по сети с целью увеличения производительности. Однако, это может привести к возникновению ошибок при передаче файлов в неверные файловые системы. Если вы столкнулись с повреждением файлов при передаче, отключите эту опцию. По умолчанию эта опция включена.

--help, -h

показать это сообщение и выйти

--ignored-fields

Игнорировать определённые пользователем поля метаданных. Список разделенных запятой пользовательских полей метаданных, не отображаемые контент-сервером в представлениях /opds и /mobile. Например: my_rating,my_tags

--listen-on

Интерфейс для прослушивания входящих соединений. По умолчанию прослушивание осуществляется на всех доступных интерфейсах IPv6 и IPv4. Вы можете изменить это, например, на "127.0.0.1", чтобы прослушивать только IPv4-соединения с локальной машины, или на "0.0.0.0", чтобы прослушивать все входящие IPv4-соединения.

--log

Путь к файлу журнала сервера. Журнал содержит информацию сервера и ошибки, а не журналы доступа. По умолчанию пишется в stdout.

--manage-users

Управляйте базой данных пользователей, которым разрешено подключаться к этому серверу. Возможно использование в автоматическом режиме добавив --. Подробнее см. calibre-server --manage-users -- help. См. также параметр --userdb.

--max-header-line-size

Макс. размер одного заголовка HTTP (в КБ).

--max-job-time

Макс. время жизни рабочих процессов. Максимально допустимое время жизни запущенного рабочего процесса (в минутах). Установите в ноль для снятия ограничения по времени.

--max-jobs

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

--max-log-size

Максимальный размер файла журнала (в МБ). Максимальный размер файлов журнала /лог-файлов/, создаваемых сервером. Как только размер лог-файла превышает заданный, содержимое файла автоматически ротируется. Установка в 0 отключает ротацию.

--max-opds-items

Максимальное число книг в фиде OPDS. Максимальное число книг, которое сервер вернёт в одном принимающем фиде OPDS.

--max-opds-ungrouped-items

Максимальное число несгрупированных элементов в фидах OPDS. Группировать элементы по категориям, таким как автор/теги по первой букве, когда элементов больше, чем это число. Установите в 0 для отключения.

--max-request-body-size

Макс. допустимый размер файлов, загружаемых на сервер (в МБ).

--num-per-page

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

--pidfile

Записать PID процесса в указанный файл

--port

Порт для входящих соединений.

--search-the-net-urls

Путь к файлу JSON, содержащему URL-адреса для функции Поиск в Интернет. Самый простой способ создать такой файл - перейти в Настройки -> Обмен через сеть -> Поиск в Интернет, создать URL-адреса и экспортировать их.

--shutdown-timeout

Общее время ожидания «чистого» отключения, в секундах .

--ssl-certfile

Путь к файлу сертификата SSL.

--ssl-keyfile

Путь к файлу секретного ключа SSL.

--timeout

Время (в секундах) до отключения холостого соединения.

--trusted-ips

Разрешить неаутентифицированным соединениям с определенных IP-адресов вносить изменения. Обычно, если вы не включаете аутентификацию, сервер работает в режиме только для чтения, чтобы анонимные пользователи не вносили изменений в ваши библиотеки. Эта опция позволяет любому пользователю подключаться к серверу calibre для внесения изменений. Должен быть список адресов или спецификаций сетей через запятую. Небезопасно запускать сервер без проверки подлинности, с использованием calibredb для внесения изменений в ваши библиотеки. Обратите внимание, что включение этой опции означает, что любой, кто подключается с указанных IP-адресов, может вносить изменения в ваши библиотеки.

--url-prefix

Префикс, добавляемый ко всем URL-ам. Полезно, если вы хотите запустить этот сервер за обратным прокси. Например, используйте /calibre в качестве префикса URL.

--userdb

Путь к пользовательской базе данных, используемой для аутентификации. База данных представляет собой SQLite-файл. Для его создания используйте --manage-users. Вы можете узнать больше об управлении пользователями по адресу: <https://manual.calibre-ebook.com/ru/server.html#managing-user-accounts-from-the-command-line-only>

--version

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

--worker-count

Количество рабочих потоков для обработки запросов.

## Author
Kovid Goyal

## Copyright
Kovid Goyal


calibre-smtp

title: calibre-smtp(1)

summary: calibre-smtp

text:
# calibre-smtp(1)

## NAME
calibre-smtp - calibre-smtp

```
calibre-smtp [опции] [от_кого кому текст]
```

Отправить почту по протоколу SMTP. В calibre-smtp два режима работы. В режиме сочинения вы указываете «от_кого», «кому» и «текст» — всё это используется для создания и отправки почтового сообщения. В режиме фильтра calibre-smtp считывает полное сообщение электронной почты из STDIN и отправляет его.

«Текст» — это содержимое сообщения электронной почты. Если «текст» не задан, полное сообщение электронной почты считывается из STDIN. «От_кого» — адрес отправителя, а «кому» — адрес электронной почты получателя. Когда полное сообщение читается из STDIN, «от_кого» и «кому» используются только в согласовании SMTP, заголовки сообщения не меняются.

Когда вы передаёте аргументы с пробелами в calibre-smtp, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--fork, -f

Ветвление и доставка сообщений в фоне. Если вы используете этот вариант, вы должны также использовать --outbox для обработки отказов доставки.

--help, -h

показать это сообщение и выйти

--localhost, -l

Имя локального хоста. Испольуется при подключении к серверу SMTP.

--outbox, -o

Путь к папке почты для хранения недоставленных сообщений.

--timeout, -t

Таймаут для соединения

--verbose, -v

Быть многословнее

--version

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

### COMPOSE MAIL
Параметры для составления письма. Игнорируются, если текст не задан

--attachment, -a

Файл для прикрепления к электронному письму

--subject, -s

Тема письма

### SMTP RELAY
Параметры для отправки почты через SMTP релей сервер. calibre попытается отправить письмо напрямую, если --relay не задан.

--cafile

Путь к файлу конкатенированных сертификатов CA в формате PEM, используемому для проверки сертификата сервера при использовании TLS. По умолчанию используются системные CA сертификаты.

--dont-verify-server-certificate

Не проверять сертификат сервера при подключении с помощью TLS. Раньше это было поведение по умолчанию в calibre до 3.27. Если вы используется релей с самоподписанным или иным образом недействительным сертификатом, вы можете использовать этот параметр для восстановления поведения до 3.27

--encryption-method, -e

Метод шифрования при подключении к релею. Выбор из TLS, SSL и NONE. По-умолчанию TLS. ВНИМАНИЕ: опция NONE крайне небезопасна

--password, -p

Пароль для релея

--port

Порт подключения к почтовому релей серверу. По-умолчанию 465, если используется SSL шифрование, иначе 25.

--relay, -r

SMTP релей сервер для отправки почты.

--username, -u

Имя для релея

## Author
Kovid Goyal

## Copyright
Kovid Goyal


calibredb

title: calibredb(1)

summary: calibredb

text:
# calibredb(1)

## NAME
calibredb - calibredb

```
calibredb команда [опции] [аргументы]
```

calibredb - это интерфейс командной строки к базе данных calibre. Оно имеет несколько подкоманд, описанных ниже.

calibredb может использоваться для управления любой базой данных calibre указывается путь или calibre Content server, работающий на на локальном компьютере или через Интернет. Вы можете запустить calibre Content server с помощью команды calibre-server или в главной программе calibre нажав Подключить/поделиться → Запустить Content server. Так как calibredb может вносить изменения в ваш calibre, вы должны сначала настроить аутентификацию на сервере. Есть два способа сделать это:

•

Если вы планируете подключаться только к серверу, работающему на том же компьютере,

вы можете просто использовать параметр --enable-local-write в контент-сервере, чтобы любая программа, включая calibredb, работала на локальный компьютер, чтобы внести изменения в данные calibre. При запуске сервера из главной программы calibre, эта опция есть в Preferences-Sharing over the net-Advanced.

•

Если вы хотите разрешить доступ через Интернет, вам следует настроить

учетные записи пользователей на сервере и использовать --username и :option:` --password` options to calibredb, чтобы предоставить доступ. Вы можете настроить аутентификацию пользователей для calibre-server с помощью` --enable-auth` вариант и используя --manage-users для создания учетных записей пользователей. Если вы запускаете сервер из главной программы calibre, используйте Preferences-Sharing over the net-Require username / password.

Чтобы подключиться к работающему серверу содержимого, передайте URL-адрес сервера в параметр: option: --with-library, см. документацию по этому параметру.

- ГЛОБАЛЬНЫЕ НАСТРОЙКИ

- list

- add

•

ДОБАВЛЕНИЕ ИЗ ПАПОК

- remove

- add_format

- remove_format

- show_metadata

- set_metadata

- export

- catalog

•

ОПЦИИ EPUB

- saved_searches

- add_custom_column

- custom_columns

- remove_custom_column

- set_custom

- restore_database

- check_library

- list_categories

- backup_metadata

- clone

- embed_metadata

- search

- fts_index

- fts_search

## ГЛОБАЛЬНЫЕ НАСТРОЙКИ
--help, -h

показать это сообщение и выйти

--library-path, --with-library

Путь к библиотеке calibre. По умолчанию используется путь, сохранённый в настройках. Также можно подключиться к контент-серверу calibre для выполнения действий в удалённых библиотеках. Для этого используйте URL-адрес: <http://hostname:port/#library_id>, например, <http://localhost:8080/#mylibrary>. Library_id - это идентификатор библиотеки библиотеки, к которой вы хотите подключиться, на контент-сервере. Можно использовать специальное значение library_id для получения списка идентификаторов библиотеки, доступных на сервере. Подробнее о настройке доступа через контент-сервер см. в разделе <https://manual.calibre-ebook.com/ru/generated/ru/calibredb.html>.

--password

Пароль для подключения к контент-серверу calibre. Чтобы прочитать пароль со стандартного ввода, используйте специальное значение: <stdin>. Чтобы прочитать пароль из файла, используйте: <f:/path/to/file> (т.е. <f: за ним следует полный путь к файлу и закрывающий >). Требуются угловые скобки в приведённом выше разделе, не забудьте экранировать их или использовать кавычки в вашем шелле.

--timeout

Тайм-аут в секундах при подключении к библиотеке calibre по сети. По умолчанию - две минуты.

--username

Имя пользователя для соединения с контент-сервером calibre

--version

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

## LIST

```
calibredb список [options]
```

Список книг в базе данных calibre.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--ascending

Сортировать результаты по возрастанию

--fields, -f

Поля, отображаемые при перечислении книг в базе данных. Должен быть разделённый запятыми список полей. Доступные поля: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid По умолчанию: title,authors. Специальное поле "all" можно использовать для выбора всех полей. В дополнение к встроенным полям, пользовательские поля также доступны как *field_name, например, для настраиваемого поля #rating, используйте имя: *rating

--for-machine

Генерирует вывод в формате JSON, более подходящем для машинного разбора. Игнорирует настройки ширины строки и разделителя.

--limit

Максимальное число результатов для отображения. По умолчанию: все

--line-width, -w

Максимальная ширина строки вывода. По умолчанию - размер экрана.

--prefix

Префикс для всех путей. По умолчанию - абсолютный путь к директории библиотеки.

--search, -s

Фильтровать результаты запроса. С форматом запроса можно ознакомиться в соответствующей документации в руководстве пользователя. По умолчанию не фильтровать.

--separator

Разделитель полей. По умолчанию это пробел.

--sort-by

The field by which to sort the results. You can specify multiple fields by separating them with commas. Available fields: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Default: id. In addition to the builtin fields above, custom fields are also available as *field_name, for example, for a custom field #rating, use the name: *rating

--template

Шаблон, который нужно запустить, если в списке полей есть "template". Обратите внимание, что шаблоны игнорируются при подключении к серверу calibre. По умолчанию: Нет

--template_file, -t

Путь к файлу, содержащему шаблон для запуска, если в списке полей есть 'template'. По умолчанию: Нет

--template_heading

Заголовок столбца шаблона. По умолчанию: template. Этот параметр игнорируется, если установлен параметр --for-machine

## ADD

```
calibredb добавить [параметры] файл1 файл2 файл3 ...
```

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

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--authors, -a

Указать авторов добавляемых книг

--automerge, -m

Если будут найдены книги с похожими названиями и авторами, автоматически объединить входящие форматы (файлы) с существующими книжными записями. Значение "ignore" - повторяющиеся форматы отбрасываются. Значение "overwrite" - повторяющиеся форматы в библиотеке перезаписываются вновь добавленными файлами. Значение "new_record" - повторяющиеся форматы помещаются в новую запись книги.

--cover, -c

Путь к обложке для использования в добавленной книге

--duplicates, -d

Добавлять книги в базу данных, даже если они уже есть. Сравнение - по названиям книг и авторам. Параметр --automerge имеет приоритет.

--empty, -e

Добавить пустую книгу (книгу без форматов)

--identifier, -I

Задать идентификаторы книги, напр. -I asin:XXX -I isbn:YYY

--isbn, -i

Указать ISBN добавляемых книг

--languages, -l

Список языков через запятую (желательно использовать языкововую кодировку ISO639, хотя могут быть распознаны и некоторые обычные названия языков)

--series, -s

Указать серию добавляемых книг

--series-index, -S

Указать номер в серии у добавляемых книг

--tags, -T

Указать теги добавляемых книг

--title, -t

Установить название добавляемой книги (книг)

### ДОБАВЛЕНИЕ ИЗ ПАПОК
Опции для управления добавлением книг из директорий. По умолчанию добавляются только файлы с расширениями известных форматов электронных книг.

--add

Шаблон имени файла (glob), файлы, соответствующие этому шаблону, будут добавлены при сканировании папок на наличие файлов, даже если они не относятся к известному типу файлов электронных книг. Можно указать несколько раз для нескольких шаблонов.

--ignore

Шаблон имени файла (glob), файлы, соответствующие этому шаблону, будут игнорироваться при сканировании папок на наличие файлов. Можно указать несколько раз для нескольких шаблонов. Например: *.pdf игнорирует все файлы PDF.

--one-book-per-directory, -1

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

--recurse, -r

Рекурсивно обрабатывать папки

## REMOVE

```
calibredb remove ids
```

Удалить книги, с определёнными идентификаторами из базы данных. Id должен быть разделенным запятыми списком идентификационных номеров (вы можете получить номера идентификаторов с помощью команды поиска). Например, 23,34,57-85 (при указании диапазона последнее число в диапазоне не включено).

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--permanent

Не использовать Корзина

## ADD_FORMAT

```
calibredb add_format [опции] id файл_электронной_книги
```

Добавьте файл_электронной_книги в доступные форматы логической книги, определённой по id. Идентификатор можно получить с помощью команды search (искать). Если формат уже существует, он заменяется, если не указана опция --dont-replace (не заменять).

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--as-extra-data-file

Добавьте файл как дополнительный файл данных в книгу, а не как электронную книгу.

--dont-replace

Не заменять формат, если он уже существует

## REMOVE_FORMAT

```
calibredb remove_format [параметры] id fmt
```

Удалить формат fmt из логической книги с идентификатором id. Получить id - команда search. fmt должен быть расширением файла, например LRF, или TXT, или EPUB. Если логическая книга не имеет доступного fmt не делать ничего.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

## SHOW_METADATA

```
calibredb show_metadata [параметры] id
```

Показывает метаданные, хранящиеся в базе данных calibre для книги, заданной идентификатором id. id - числовой идентификатор из команды search.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--as-opf

Напечатать метаданные в OPF из (XML)

## SET_METADATA

```
calibredb set_metadata [options] book_id [/path/to/metadata.opf]
```

Установить метаданные, хранящиеся в базе данных calibre для книги, указанной book_id из файла metadata.opf OPF. book_id — это идентификационный номер книги из команды поиска. Можно получить представление о формате OPF, используя --as-opf переключившись на команду show_metadata. Также можно установить метаданные отдельных полей опцией --field. Если вы используете опцию --field, нет необходимости указывать файл OPF.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--field, -f

Поле для установки. Формат название_поля:значение. Например: --field tags:tag1,tag2. Используйте --list-fields чтобы получить список названий полей. Вы можете указать эту настройку несколько раз для установки нескольких полей. Помните: для языков вы должны использовать ISO639 языковую кодировку (то есть en для English, fr для French и т.д.). Для идентификаторов, синтаксис --field identifiers:isbn:XXXX,doi:YYYYY. Для булевых (да/нет) полей используйте true и false или yes и no.

--list-fields, -l

Список названий полей метаданных, которые могут быть использованы с опцией --field.

## EXPORT

```
calibredb export [options] ids
```

Экспортировать книги, указанные идентификаторами (список, разделённый запятыми), в файловую систему. Операция экспорта сохраняет все форматы книги, её обложку и метаданные (в OPF-файл). Любые дополнительные файлы данных, связанные с книгой, также сохраняются. Вы можете получить номера идентификаторов с помощью команды поиска (search).

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--all

Экспортировать все книги в базу данных, игнорируя список id.

--dont-asciiize

calibre преобразует все неанглийские символы в английские эквиваленты имен файлов. Это полезно при сохранении в устаревшую файловую систему без полной поддержки имен файлов Unicode. Указание этого переключателя отключит данный режим.

--dont-save-cover

Обычно, calibre будет сохранять обложку в отдельном файле рядом с файлами электронной книги. Указание этого переключателя отключит данный режим.

--dont-save-extra-files

Сохранить все файлы данных, связанные с книгой, при сохранении книги. Указание этого переключателя отключит данный режим.

--dont-update-metadata

По умолчанию calibre обновляет метаданные в сохранённых файлах в библиотеке. Может замедлить запись на диск. Указание этого переключателя отключит данный режим.

--dont-write-opf

Обычно, calibre будет писать метаданные в отдельный файл OPF рядом с файлом электронной книги. Указание этого переключателя отключит данный режим.

--formats

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

--progress

Прогресс отчёта

--replace-whitespace

Заменить пробел символом подчёркивания.

--single-dir

Экспорт всех книг в одну папку

--template

Шаблон для управления именем файла и структурой папок сохраненных файлов. По умолчанию это "{author_sort}/{title}/{title} - {authors}", при котором книги будут сохраняться в подпапку для каждого автора с именами файлов, содержащими название и автора. Доступные элементы управления: {author_sort, authors, id, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, tags, timestamp, title}

--timefmt

Формат отображения дат. %d - день, %b - месяц, %m - номер месяца, %Y - год. По умолчанию: %b, %Y

--to-dir

Экспорт книг в указанную папку. По умолчанию .

--to-lowercase

Преобразовать пути в нижний регистр.

## CATALOG

```
%pкаталог rog /path/to/destination.(csv|epub|mobi|xml ...) [параметры]
```

Экспортировать каталог в формате, указанном расширением путь/к/назначению. Параметры управляют тем, как записи отображаются в сгенерированном выводе каталога. Обратите внимание, что разные форматы каталогов поддерживают разные наборы параметров. Чтобы просмотреть различные параметры, укажите имя выходного файла, а затем --help опцию.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--ids, -i

Разделённый запятыми список идентификаторов из базы данных для каталога. Если указано, --search игнорируется. По умолчанию: all

--search, -s

Фильтровать результаты по поисковому запросу. О формате поискового запроса читайте в связанной с поиском документации в руководстве пользователя. По умолчанию: no filtering (не фильтровать)

--verbose, -v

Показать детальную информацию. Используется для отладки.

### ОПЦИИ EPUB
--catalog-title

Название сгенерированного каталога, используемого как название в метаданных. По умолчанию: 'My Books' Применяется к: AZW3, EPUB, MOBI форматам вывода

--cross-reference-authors

Создание перекрестных ссылок в разделе «Авторы» для книг с несколькими авторами. По умолчанию: 'False' Применяется к: AZW3, EPUB, MOBI форматам вывода

--debug-pipeline

Сохранить вывод из разных этапов конвейера преобразования в указанную папку. Полезно, если вы не уверены, на каком этапе процесса преобразования возникает ошибка. По умолчанию: 'None' Применимо к: выходным форматам AZW3, EPUB, MOBI

--exclude-genre

Regex, описывающий теги для исключения в качестве жанров. По умолчанию: '[.+]|^+$' исключает теги в квадратных скобках, напр. '[Project Gutenberg]', и '+', умолчальный тег для чтения книг. Применяется к: AZW3, EPUB, MOBI форматам вывода

--exclusion-rules

Задать правила, используемые для исключения книг из сгенерированного каталога. Модель для правила исключения: ('<rule name>','Tags','<comma-separated list of tags>') или ('<rule name>','<custom column>','<pattern>'). Например: (('Archived books','#status','Archived'),) исключит книгу со значением 'Archived' в польз. столбце 'status'. Когда определено несколько правил, все они применятся. По умолчанию: '(('Catalogs','Tags','Catalog'),)' Применяется к: AZW3, EPUB, MOBI форматам вывода

--generate-authors

Включить раздел «Авторы» в каталог. По умолчанию: 'False' Применяется к: AZW3, EPUB, MOBI форматам вывода

--generate-descriptions

Включить раздел «Примечания» в каталог. По умолчанию: 'False' Применяется к: AZW3, EPUB, MOBI форматам вывода

--generate-genres

Включить раздел «Жанры» в каталог. По умолчанию: 'False' Применяется к: AZW3, EPUB, MOBI форматам вывода

--generate-recently-added

Включить раздел «Недавно добавленные» в каталог. По умолчанию: 'False' Применяется к: AZW3, EPUB, MOBI форматам вывода

--generate-series

Включить раздел «Серии» в каталог. По умолчанию: 'False' Применяется к: AZW3, EPUB, MOBI форматам вывода

--generate-titles

Включить раздел «Названия» в каталог. По умолчанию: 'False' Применяется к: AZW3, EPUB, MOBI форматам вывода

--genre-source-field

Исходное поле для секции 'Жанры'. Умолчание: 'Теги' Применяется к: AZW3, EPUB, MOBI форматам вывода

--header-note-source-field

Пользовательское поле, содержащее текст примечания для вставки в заголовок описания. Умолчание: '' Применяется к: AZW3, EPUB, MOBI форматам вывода

--merge-comments-rule

\#<custom field>: [before|after]:[True|False] с указанием: <custom field> Пользовательское поле, содержащее примечания для объединения с комментариями [before|after] Размещение примечаний относительно комментариев [True|False] - между примечаниями и комментариями вставляется горизонтальная линия. По умолчанию: '::' Применимо к выходным форматам AZW3, EPUB, MOBI

--output-profile

Определить профиль вывода. В некоторых случаях для оптимизации каталога для устройства требуется профиль вывода. Например 'kindle' or 'kindle_dx' создаст структурированное Оглавление с Разделами и Авторами. Умолчание: 'None' Применяется к: AZW3, EPUB, MOBI форматам вывода

--prefix-rules

Задать правила включения префиксов, указывающих чтение книг, элементы списка пожеланий и др. польз-х префиксов. Модель для префиксного правила ('<rule name>','<source field>','<pattern>','<prefix>'). Когда определено несколько правил, будет использоваться первое правило сопоставления. Умолчание: '(('Read books','tags','+','✓'),('Wishlist item','tags','Wishlist','×'))' Применяется к: AZW3, EPUB, MOBI форматам вывода

--preset

Использовать именованный пресет, созданный в GUI конструкторе каталогов Пресет задает все настройки для создания каталога. Умолчание: 'None' Применяется к: AZW3, EPUB, MOBI форматам вывода

--thumb-width

Размер подсказки (в дюймах) для обложки книг в каталоге. Диапазон: 1.0 - 2.0 Умолчание: '1.0' Применяется к: AZW3, EPUB, MOBI форматам вывода

--use-existing-cover

Заменить существующую обложку при генерации каталога. Умолчание: 'False' Применяется к: AZW3, EPUB, MOBI форматам вывода

## SAVED_SEARCHES

```
calibredb saved_searches [options] (list|add|remove)
```

Управление сохраненными в этой базе данных поисками. При добавлении запроса с уже существующим именем, он будет заменён.

Синтаксис для добавления:

calibredb saved_searches add search_name search_expression

Синтаксис для удаления:

calibredb saved_searches remove search_name

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

## ADD_CUSTOM_COLUMN

```
calibredb add_custom_column [опции] ярлык имя тип_данных
```

Создаёт пользовательский столбец, где «ярлык» — удобное для компьютера название столбца, без пробелов и двоеточий; «имя» — удобное для человека название столбца; «тип_данных» один из: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--display

Словарь настроек для указания того, как данные в столбцах будут интерпретированы. Это JSON строка. Для перечисления столбцов используйте --display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}" Есть много настроек, которые можно использовать в переменной отображения. Эти настройки по типу столбца бывают: составными: composite_template, composite_sort, make_category,contains_html, use_decorations даты и времени: date_format перечисление: enum_values, enum_colors, use_decorations целочисленные или с плавающей точкой: number_format текстовые: is_names, use_decorations Для поиска правильных сочетаний лучше всего создать пользовательский столбец соответствующего типа в GUI и посмотреть резервный OPF книги (убедитесь что новый OPF был создан после добавления столбца). Вы увидите JSON для "отображения" для нового столбца в OPF.

--is-multiple

Этот столбец хранит теги как данные (например, несколько значений, разделенных запятыми). Применяется только, если тип данных текст.

## CUSTOM_COLUMNS

```
calibredb custom_columns [options]
```

Список доступных пользовательских столбцов. Показ меток столбцов и идентификаторы.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--details, -d

Показать подробности для каждой колонки.

## REMOVE_CUSTOM_COLUMN

```
calibredb remove_custom_column [options] labelУдалить пользовательский столбец, идентифицированный меткой. Вы можете увидеть доступные столбцы с командой custom_columns.
```

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--force, -f

Не запрашивать подтверждение

## SET_CUSTOM

```
calibredb set_custom [options] column id value
```

Задать значение настраиваемого столбца для книги определяемой по id. Cписок идентификаторов получается командой поиска. Список пользовательских имен столбцов получается командой custom_columns

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--append, -a

Если столбец содержит несколько значений, добавить указанное значение к существующим, а не заменять их.

## RESTORE_DATABASE

```
calibredb restore_database [параметры]
```

Восстановить эту базу данных из метаданных, хранящихся в файлах OPF в каждом папка библиотеки calibre. Это полезно, если ваш файл metadata.db был поврежден.

ВНИМАНИЕ: Эта команда полностью регенерирует вашу базу данных. Теряются все сохраненные поисковые запросы, категории пользователей, плагины, сохраненные конвертации для каждой книги настройки и пользовательские рецепты. Восстановленные метаданные будут иметь точность как в файлах OPF.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--really-do-it, -r

Действительно выполнить восстановление. Команда не запустится пока эта опция не определена.

## CHECK_LIBRARY

```
calibredb check_library [настройки]
```

Выполняет некоторые проверки файловой системы представляющей библиотеку. Отчёты invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--csv, -c

Вывод в CSV

--ignore_extensions, -e

Разделённый запятыми список игнорируемых расширений. По умолчанию: все (all).

--ignore_names, -n

Разделённый запятыми список игнорируемых названий. По умолчанию: все (all).

--report, -r

Разделённый запятыми список отчётов. По умолчанию: все (all).

--vacuum-fts-db

Сжать (командой Vacuum) базу данных полнотекстового поиска. Если база данных велика, это может занять много времени и памяти.

## LIST_CATEGORIES

```
calibredb list_categories [настройки]
```

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

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--categories, -r

Разделённый запятыми список имён поиска категорий. По умолчанию: all

--csv, -c

Вывод в CSV

--dialect

Тип файла CSV для создания. Варианты: excel, excel-tab, unix

--item_count, -i

Выводить только общее число записей в категории вместо поэлементного подсчёта.

--width, -w

Максимальная ширина строки вывода. По умолчанию - размер экрана.

## BACKUP_METADATA

```
calibredb backup_metadata [параметры]
```

Резервное копирование метаданных, хранящихся в базе данных, в отдельные файлы OPF в каждой папке с книгами. Обычно это происходит автоматически, но вы можете запустить эту команду для принудительного повторного создания файлов OPF с параметром --all.

Обратите внимание, что обычно в этом нет необходимости, так как файлы OPF сохраняются. автоматически, каждый раз при изменении метаданных.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--all

Обычно команда работает только с книгами, имеющими устаревшие OPF файлы. Эта опция заставляет её работать со всеми книгами.

## CLONE

```
calibredb clone path/to/new/library
```

Создать клон текущей библиотеки. Создаётся новая пустая библиотека, содержащая все пользовательские столбцы, виртуальные библиотеки и прочие параметры, аналогично текущей библиотеке.

Клонированная библиотека не содержит книг. Чтобы создать полную копию со всеми книгами просто скопируйте папку библиотеки.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

## EMBED_METADATA

```
calibredb embed_metadata [параметры] book_id
```

Обновление метаданных в файлах текущей книги, хранящейся в библиотеке calibre, из метаданных в базе данных calibre. Обычно метаданные обновляются только во время экспорта файлов из calibre, эта команда полезна, если вы хотите, чтобы файлы были обновлены на месте. Заметьте, что различные форматы файлов поддерживают разное количество метаданных. Вы можете использовать специальное значение 'all' для book_id, чтобы обновить метаданные во всех книгах. Вы можете также задать несколько идентификаторов книг, разделённых пробелами, и диапазон идентификаторов, разделённых дефисами. Например: calibredb embed_metadata 1 2 10-15 23

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--only-formats, -f

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

## SEARCH

```
calibredb search [опции] поисковое выражение
```

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

Выражение поиска может быть любым из языка поисковых запросов calibre, например: calibredb search author:asimov 'title:"i robot"'

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--limit, -l

Максимальное число возвращаемых результатов. По умолчанию - все результаты.

## FTS_INDEX

```
calibredb fts_index [параметры] enable/disable/status/reindex
```

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

enable

Включить индексирование для данной библиотеки

disable

Включить индексирование для данной библиотеки

status

Показать состояние индексирования

reindex

Переиндексировать отдельные книги или библиотеку целиком. Для отдельных книг, укажите их идентификаторы после команды reindex. Если идентификаторы не указаны, то переиндексируется вся библиотека.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--indexing-speed

Скорость индексации. Быстрое индексирование использует максимум ресурсов компьютера, медленное - менее ресурсоёмко. Скорость сбрасывается на медленную после каждого вызова.

--wait-for-completion

Ждать, пока все книги будут проиндексированы, периодически показывая ход индексации.

## FTS_SEARCH

```
calibredb fts_search [параметры] выражение поиска
```

Полнотекстовый поиск в библиотеке или ее фрагменте.

Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"

--do-not-match-on-related-words

Точное совпадение вместо родственных слов, напр. correction не совпадает с correcting.

--include-snippets

Выводить фрагменты текста вокруг совпадений. Это существенно замедлит поиск.

--indexing-threshold

Сколько процентов библиотеки должно быть проиндексировано для включения полнотекстового поиска. По умолчанию 90

--match-end-marker

Маркер конца совпавшего слова во фрагменте

--match-start-marker

Маркер начала совпавшего слова во фрагменте

--output-format

Формат вывода результатов: "text" для обычного текста или "json".

--restrict-to

Ограничьте искомые книги, используя поисковое выражение или идентификаторы. Например: ids:1,2,3 для ограничения по идентификаторам или search:tag:foo для ограничения книг с тегом foo.

## Author
Kovid Goyal

## Copyright
Kovid Goyal


ebook-convert

title: ebook-convert(1)

summary: ebook-convert

text:
# 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


ebook-edit

title: ebook-edit(1)

summary: ebook-edit

text:
# ebook-edit(1)

## NAME
ebook-edit - ebook-edit

```
ebook-edit [опции] [путь_к_электронной_книге] [имя_файла_внутри_книги …]
```

Запускает инструмент редактирования книги calibre. Также можно задать имена файлов внутри книги, которые автоматически откроются для редактирования.

Когда вы передаёте аргументы с пробелами в ebook-edit, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--detach

Отвязаться от управляющего терминала (только Linux)

--help, -h

показать это сообщение и выйти

--select-text

Текст, который нужно выделить в книге, когда она открыта для редактирования.

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


ebook-meta

title: ebook-meta(1)

summary: ebook-meta

text:
# ebook-meta(1)

## NAME
ebook-meta - ebook-meta

```
ebook-meta файл_электронной_книги [опции]
```

Читать / писать метаданные из / в файлы электронных книг.

Поддерживаемые форматы для чтения метаданных: azw, azw1, azw3, azw4, cb7, cbc, cbr, cbz, chm, docx, epub, fb2, fbz, html, htmlz, imp, kepub, lit, lrf, lrx, mobi, odt, oebzip, opf, pdb, pdf, pml, pmlz, pobi, prc, rar, rb, rtf, snb, tpz, txt, txtz, updb, zip

Поддерживаемые форматы для записи метаданных: azw, azw1, azw3, azw4, docx, epub, fb2, fbz, htmlz, kepub, lrf, mobi, odt, pdb, pdf, prc, rtf, tpz, txtz

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

Когда вы передаёте аргументы с пробелами в ebook-meta, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--author-sort

Строка для сортировки по автору. Если не указана, а авторы указаны, будет авто-сгенерирована из списка авторов.

--authors, -a

Вписать авторов. Несколько авторов разделяются символом &. Имена должны быть указаны в порядке: Имя Фамилия.

--book-producer, -k

Установить создателя книги.

--category

Установить категорию книги

--comments, -c

Установить описание электронной книги.

--cover

Указать файл обложки.

--date, -d

Установить дату публикации

--disallow-rendered-cover

Для таких форматов, как EPUB, которые используют 'обложку по умолчанию' для первой отображаемой страницы, отключите такие обложки по умолчанию

--from-opf

Прочитать метаданные из указанного файла OPF и использовать его для установки метаданных электронной книги. Метаданные, указанные в командной строке, будут переопределять метаданные, считанные из файла OPF

--get-cover

Получить обложку из электронной книги и сохранить её как указанный файл.

--help, -h

показать это сообщение и выйти

--identifier

Установить идентификаторы книги, могут быть указаны несколько раз. Например: «--identifier uri:https://acme.com --identifier isbn:12345». Чтобы удалить идентификатор, не указывайте значение: «--identifier isbn:». Обратите внимание, что для файлов EPUB идентификатор, помеченный как идентификатор пакета, не может быть удалён.

--index, -i

Указать номер книги в серии.

--isbn

Указать ISBN книги.

--language, -l

Установить язык.

--lrf-bookid

Указать BookID в файлах LRF

--publisher, -p

Установить издателя электронной книги.

--rating, -r

Поставьте оценку. Должна быть числом от 1 до 5.

--series, -s

Установить серию этой электронной книги.

--tags

Указать теги для книги. Должны быть разделены запятыми.

--title, -t

Указать название.

--title-sort

Версия имени для сортировки. Если отсутствует, а имя указано, то будет автоматически сгенерировано из имени.

--to-opf

Укажите имя файла OPF. Метаданные будут сохранены в этом OPF-файле.

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


ebook-polish

title: ebook-polish(1)

summary: ebook-polish

text:
# ebook-polish(1)

## NAME
ebook-polish - ebook-polish

```
   ebook-polish [параметры] входной_файл [выходной_файл]
Полировка книг  - все о том, чтобы придать блеск совершенства
```

Вашим тщательно обработанным электронным книгам.

Полировка пытается минимизировать изменения во внутреннем коде вашей электронной книги. В отличие от преобразования, она не уплощает CSS, переименовывает файлы, меняет шрифт размеры, корректирует поля и т.п. Каждое действие выполняет только минимальный набор изменений, необходимых для желаемого эффекта.

Вы должны использовать этот инструмент в качестве последнего шага в процессе создания электронной книги.

Обратите внимание, что полировка работает только с файлами в форматах AZW3 или EPUB или KEPUB.

Когда вы передаёте аргументы с пробелами в ebook-polish, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--add-soft-hyphens, -H

Добавляет мягкие переносы во все слова в книге. Это позволит лучше выглядеть книгам с выровненным по ширине текстом в читалках, не поддерживающих переносы.

--compress-images, -i

Сжать иллюстрации для уменьшения объёма, без ухудшения качества изображения.

--cover, -c

Путь к обложке. Изменяет обложку, указанную в электронной книге. Если обложки нет или она неправильно идентифицирована, вставляется новая обложка.

--download-external-resources, -d

Загрузите внешние ресурсы, такие как изображения, таблицы стилей и т. д., которые указывают на URL-адреса, а не на файлы в книге. Все такие ресурсы будут загружены и добавлены в книгу, чтобы в книге больше не было ссылок на внешние ресурсы.

--embed-fonts, -e

Внедрить шрифты, указанные в документе, но ещё не внедрённые. Будет осуществлен поиск шрифтов, доступных на компьютере; если шрифты будут найдены, то они будут внедрены в документ. Убедитесь в наличии соответствующих прав на внедрение шрифтов, используемых в документе.

--help, -h

показать это сообщение и выйти

--jacket, -j

Вставить в начале книги страницу обложки, которая будет содержать все метаданные: название, теги, авторов, серии, комментарии, и т.д. Любые предыдущие обложки будут заменены.

--opf, -o

Путь к OPF файлу. Метаданные в книге обновлены из OPF файла.

--remove-jacket

Удалить предыдущую добавленную обложку.

--remove-soft-hyphens

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

--remove-unused-css, -u

Удалить все неиспользуемые CSS правила из таблицы стилей и тегов <style>. Некоторые книги, созданные с помощью технических шаблонов, могут иметь множество дополнительных CSS правил, не совпадающих с реальным содержанием. Это замедляет работу читалок при разборе правил.

--smarten-punctuation, -p

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

--subset-fonts, -f

Сокращение шрифтов означает уменьшение внедрённых шрифтов до необходимого набора символов, используемых в книге. Это значительно уменьшает размер файлов шрифтов (примерно вдвое). Например, если книга использует специальный шрифт для заголовков, то сокращение шрифтов уменьшит этот шрифт до символов содержащихся только в этих заголовках. Или если в книгу включена курсивная версия шрифта, но текст с ним встречается редко или совсем отсутствует, то курсивный шрифт может быть сокращён всего до нескольких символов или полностью удалён. Единственный недостаток сокращения шрифтов в том, если позже вы пожелаете добавить больше текста в ваши книги, то добавленный текст может быть не охвачен сокращённым шрифтом.

--upgrade-book, -U

Обновление внутренней структуры книги, по возможности. К примеру, обновление книг EPUB 2 до EPUB 3.

--verbose

Более подробный вывод обработки. Полезно при отладке.

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


ebook-viewer

title: ebook-viewer(1)

summary: ebook-viewer

text:
# ebook-viewer(1)

## NAME
ebook-viewer - ebook-viewer

```
ebook-viewer [опции] файл
```

Читать электронную книгу.

Когда вы передаёте аргументы с пробелами в ebook-viewer, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--continue

Продолжить чтение последней открытой книги

--detach

Отвязаться от управляющего терминала (только Linux)

--force-reload

Принудительная перезагрузка всех открытых книг

--full-screen, --fullscreen, -f

Если указано, окно читалки при запуске попытается открыться во весь экран.

--help, -h

показать это сообщение и выйти

--new-instance

Открыть новое окно просмотрщика, даже если установлена опция использования только одного окна просмотрщика

--open-at

Место открытия указанной книги. Местоположение или позицию можно получить, выполнив действия «Перейти->Место» в элементах управления читалкой. Можно использовать форму toc:нечто, и она откроется в месте первой записи оглавления, содержащей строку «нечто». Форма toc-href:нечто будет соответствовать href (внутренней ссылке на место назначения) элементов оглавления. Соответствие точное, если же хотите сопоставить подстроку, воспользуйтесь формой toc-href-contains:нечто. Форма ref:нечто будет использовать Ссылочный режим cсылок. Форма regex:something будет искать регулярное выражение something после открытия книги.

--raise-window

Если указано, окно читалки при запуске попытается выйти на передний план.

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


fetch-ebook-metadata

title: fetch-ebook-metadata(1)

summary: fetch-ebook-metadata

text:
# fetch-ebook-metadata(1)

## NAME
fetch-ebook-metadata - fetch-ebook-metadata

```
fetch-ebook-metadata [параметры]
```

Получить метаданные книги из онлайн-источников. Вы должны задать по крайней мере название, авторов или ISBN.

Когда вы передаёте аргументы с пробелами в fetch-ebook-metadata, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--allowed-plugin, -p

Укажите имя используемого плагина загрузки метаданных. По умолчанию будут использоваться все плагины метаданных. Может быть указано несколько раз для нескольких плагинов. Все имена плагинов: Google, Google Images, Amazon.com, Edelweiss, Open Library, Big Book Search

--authors, -a

Автор(ы) книги

--cover, -c

Указать имя файла. Обложка, если доступна, будет сохранена. Без этого параметра обложка не будет загружена.

--help, -h

показать это сообщение и выйти

--identifier, -I

Идентификаторы, такие как ASIN/Goodreads id и т. д. М.б. указаны несколько раз для нескольких идентификаторов. Например:--identifier asin:B0082BAJA0

--isbn, -i

ISBN книги

--opf, -o

Вывести метаданные в OPF формат вместо читаемого текста.

--timeout, -d

Таймаут в секундах. По умолчанию 30

--title, -t

Название книги

--verbose, -v

Вывести лог в консоль (stderr)

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


title: lrf2lrs(1)

text:
# lrf2lrs(1)

## NAME
lrf2lrs - lrf2lrs

```
lrf2lrs книга.lrf
```

Преобразовать файл LRF в файл LRS (XML, кодировка UTF-8)

Когда вы передаёте аргументы с пробелами в lrf2lrs, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--dont-output-resources

Не сохранять вложенные картинки и шрифты на диск

--help, -h

показать это сообщение и выйти

--output, -o

Выходной файл LRS

--verbose

Быть многословнее

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


lrfviewer

title: lrfviewer(1)

summary: lrfviewer

text:
# lrfviewer(1)

## NAME
lrfviewer - lrfviewer

```
lrfviewer [опции] книга.lrf
```

Читать электронную книгу в формате LRF

Когда вы передаёте аргументы с пробелами в lrfviewer, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--disable-hyphenation

Отключить переносы. Это должно значительно ускорить визуализацию

--help, -h

показать это сообщение и выйти

--profile

Описать визуализатор LRF

--verbose

Вывести больше информации о процессе рендера

--version

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

--visual-debug

Переключиться на визуальные подсказки для отладки движка визуализации

--white-background

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


title: lrs2lrf(1)

text:
# lrs2lrf(1)

## NAME
lrs2lrf - lrs2lrf

```
lrs2lrf [опции] файл.lrs
```

Собрать файл LRS в файл LRF.

Когда вы передаёте аргументы с пробелами в lrs2lrf, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--help, -h

показать это сообщение и выйти

--lrs

Преобразование LRS в LRS, необходимо для отладки.

--output, -o

Путь для файла результата

--verbose

Детализация процесса

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal


title: web2disk(1)

text:
# web2disk(1)

## NAME
web2disk - web2disk

```
web2disk URL
```

Где URL, например: <https://google.com>

Когда вы передаёте аргументы с пробелами в web2disk, заключайте их в кавычки. Например: "/some path/with spaces"

## [ОПЦИИ]
--base-dir, -d

Базовая папка, в которой сохраняется URL. По умолчанию .

--delay

Минимальный интервал в секундах между последовательными вызовами. По умолчанию: 0 с

--dont-download-stylesheets

Не скачивать файлы стилей CSS.

--encoding

Кодировка вебсайтов, которые вы собираетесь скачивать. По умолчанию делается попытка определения кодировки.

--filter-regexp

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

--help, -h

показать это сообщение и выйти

--match-regexp

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

--max-files, -n

Максимальное количество файлов для скачивания. Применимо только к файлам из тегов <a href>. По умолчанию: 9223372036854775807

--max-recursions, -r

Максимальное число уровней вложения, т.е. глубина последовательных ссылок. По умолчанию: 1

--timeout, -t

Максимальное время ожидания ответа от сервера. По умолчанию: 10.0 с

--verbose

Показать детальную информацию. Используется для отладки.

--version

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

## Author
Kovid Goyal

## Copyright
Kovid Goyal