.. _calibredb-ru:
.. raw:: html
``calibredb``
===================================================================
.. code-block:: none
calibredb команда [опции] [аргументы]
:command:`calibredb` - это интерфейс командной строки к базе данных calibre. Оно имеет
несколько подкоманд, описанных ниже.
:command:`calibredb` может использоваться для управления любой базой данных calibre
указывается путь или calibre :guilabel:`Content server`, работающий на
на локальном компьютере или через Интернет. Вы можете запустить
calibre :guilabel:`Content server` с помощью команды :command:`calibre-server`
или в главной программе calibre нажав :guilabel:`Подключить/поделиться ->Запустить Content server`. Так как :command:`calibredb` может вносить изменения в ваш
calibre, вы должны сначала настроить аутентификацию на сервере.
Есть два способа сделать это:
* Если вы планируете подключаться только к серверу, работающему на том же компьютере,
вы можете просто использовать параметр --enable-local-write в
контент-сервере, чтобы любая программа, включая calibredb, работала на
локальный компьютер, чтобы внести изменения в данные calibre. При запуске
сервера из главной программы calibre, эта опция есть в
:guilabel:`Preferences-Sharing over the net-Advanced`.
* Если вы хотите разрешить доступ через Интернет, вам следует настроить
учетные записи пользователей на сервере и использовать :option:`--username` и :option:` --password`
options to :command:`calibredb`, чтобы предоставить доступ. Вы можете настроить
аутентификацию пользователей для :command:`calibre-server` с помощью` --enable-auth`
вариант и используя ``--manage-users`` для создания учетных записей пользователей.
Если вы запускаете сервер из главной программы calibre, используйте
:guilabel:`Preferences-Sharing over the net-Require username / password`.
Чтобы подключиться к работающему серверу содержимого, передайте URL-адрес сервера в
параметр: option: `--with-library`, см. документацию по этому параметру.
.. contents::
:local:
ГЛОБАЛЬНЫЕ НАСТРОЙКИ
~~~~~~~~~~~~~~~~~~~~~~~~
.. option:: --help, -h
показать это сообщение и выйти
.. option:: --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.
.. option:: --password
Пароль для подключения к контент-серверу calibre. Чтобы прочитать пароль со стандартного ввода, используйте специальное значение: . Чтобы прочитать пароль из файла, используйте: (т.е. ). Требуются угловые скобки в приведённом выше разделе, не забудьте экранировать их или использовать кавычки в вашем шелле.
.. option:: --timeout
Тайм-аут в секундах при подключении к библиотеке calibre по сети. По умолчанию - две минуты.
.. option:: --username
Имя пользователя для соединения с контент-сервером calibre
.. option:: --version
показать версию программы и выйти
.. _calibredb-ru-list:
list
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb список [options]
Список книг в базе данных calibre.
Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"
.. program:: calibredb list
.. option:: --ascending
Сортировать результаты по возрастанию
.. option:: --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
.. option:: --for-machine
Генерирует вывод в формате JSON, более подходящем для машинного разбора. Игнорирует настройки ширины строки и разделителя.
.. option:: --limit
Максимальное число результатов для отображения. По умолчанию: все
.. option:: --line-width, -w
Максимальная ширина строки вывода. По умолчанию - размер экрана.
.. option:: --prefix
Префикс для всех путей. По умолчанию - абсолютный путь к директории библиотеки.
.. option:: --search, -s
Фильтровать результаты запроса. С форматом запроса можно ознакомиться в соответствующей документации в руководстве пользователя. По умолчанию не фильтровать.
.. option:: --separator
Разделитель полей. По умолчанию это пробел.
.. option:: --sort-by
Поле, по которому сортируются результаты. Вы можете указать несколько полей, разделив их запятыми. Доступные поля: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid По умолчанию: id
.. option:: --template
Шаблон для запуска, если \ ``'``\ template\ ``'``\ находится в списке полей. По умолчанию: Нет
.. option:: --template_file, -t
Путь к файлу, содержащему шаблон для запуска, если в списке полей есть \ ``'``\ template\ ``'``\ . По умолчанию: Нет
.. option:: --template_heading
Заголовок столбца шаблона. По умолчанию: template. Этот параметр игнорируется, если установлен параметр :option:`--for-machine`
.. _calibredb-ru-add:
add
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb добавить [параметры] файл1 файл2 файл3 ...
Добавить указанные файлы как книги в базу данных. Вы также можете указать папки, см.
параметры, относящиеся к папке, ниже.
Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"
.. program:: calibredb add
.. option:: --authors, -a
Указать авторов добавляемых книг
.. option:: --automerge, -m
Если будут найдены книги с похожими названиями и авторами, автоматически объединить входящие форматы (файлы) с существующими книжными записями. Значение \ ``"``\ ignore\ ``"``\ - повторяющиеся форматы отбрасываются. Значение \ ``"``\ overwrite\ ``"``\ - повторяющиеся форматы в библиотеке перезаписываются вновь добавленными файлами. Значение \ ``"``\ new_record\ ``"``\ - повторяющиеся форматы помещаются в новую запись книги.
.. option:: --cover, -c
Путь к обложке для использования в добавленной книге
.. option:: --duplicates, -d
Добавлять книги в базу данных, даже если они уже есть. Сравнение - по названиям книг и авторам. Параметр :option:`--automerge` имеет приоритет.
.. option:: --empty, -e
Добавить пустую книгу (книгу без форматов)
.. option:: --identifier, -I
Задать идентификаторы книги, напр. -I asin:XXX -I isbn:YYY
.. option:: --isbn, -i
Указать ISBN добавляемых книг
.. option:: --languages, -l
Список языков через запятую (желательно использовать языкововую кодировку ISO639, хотя могут быть распознаны и некоторые обычные названия языков)
.. option:: --series, -s
Указать серию добавляемых книг
.. option:: --series-index, -S
Указать номер в серии у добавляемых книг
.. option:: --tags, -T
Указать теги добавляемых книг
.. option:: --title, -t
Установить название добавляемой книги (книг)
ДОБАВЛЕНИЕ ИЗ ПАПОК
^^^^^^^^^^^^^^^^^^^^^^^
Опции для управления добавлением книг из директорий. По умолчанию добавляются только файлы с расширениями известных форматов электронных книг.
.. option:: --add
Шаблон имени файла (glob), файлы, соответствующие этому шаблону, будут добавлены при сканировании папок на наличие файлов, даже если они не относятся к известному типу файлов электронных книг. Можно указать несколько раз для нескольких шаблонов.
.. option:: --ignore
Шаблон имени файла (glob), файлы, соответствующие этому шаблону, будут игнорироваться при сканировании папок на наличие файлов. Можно указать несколько раз для нескольких шаблонов. Например: \*.pdf игнорирует все файлы PDF.
.. option:: --one-book-per-directory, -1
Предположим, что в каждой папке есть только одна логическая книга и что все файлы в ней представляют собой электронные книги разных форматов этой книги.
.. option:: --recurse, -r
Рекурсивно обрабатывать папки
.. _calibredb-ru-remove:
remove
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb remove ids
Удалить книги, с определёнными идентификаторами из базы данных. Id должен быть разделенным запятыми списком идентификационных номеров (вы можете получить номера идентификаторов с помощью команды поиска). Например, 23,34,57-85 (при указании диапазона последнее число в диапазоне не включено).
Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"
.. program:: calibredb remove
.. option:: --permanent
Не использовать Корзина
.. _calibredb-ru-add_format:
add_format
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb add_format [опции] id файл_электронной_книги
Добавьте файл_электронной_книги в доступные форматы логической книги, определённой по id. Идентификатор можно получить с помощью команды search (искать). Если формат уже существует, он заменяется, если не указана опция --dont-replace (не заменять).
Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"
.. program:: calibredb add_format
.. option:: --as-extra-data-file
Добавьте файл как дополнительный файл данных в книгу, а не как электронную книгу.
.. option:: --dont-replace
Не заменять формат, если он уже существует
.. _calibredb-ru-remove_format:
remove_format
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb remove_format [параметры] id fmt
Удалить формат fmt из логической книги с идентификатором id. Получить id - команда search. fmt должен быть расширением файла, например LRF, или TXT, или EPUB. Если логическая книга не имеет доступного fmt не делать ничего.
Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"
.. program:: calibredb remove_format
.. _calibredb-ru-show_metadata:
show_metadata
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb show_metadata [параметры] id
Показывает метаданные, хранящиеся в базе данных calibre для книги, заданной идентификатором id.
id - числовой идентификатор из команды search.
Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"
.. program:: calibredb show_metadata
.. option:: --as-opf
Напечатать метаданные в OPF из (XML)
.. _calibredb-ru-set_metadata:
set_metadata
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
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"
.. program:: calibredb set_metadata
.. option:: --field, -f
Поле для установки. Формат название_поля:значение. Например: :option:`--field` tags:tag1,tag2. Используйте :option:`--list-fields` чтобы получить список названий полей. Вы можете указать эту настройку несколько раз для установки нескольких полей. Помните: для языков вы должны использовать ISO639 языковую кодировку (то есть en для English, fr для French и т.д.). Для идентификаторов, синтаксис :option:`--field` identifiers:isbn:XXXX,doi:YYYYY. Для булевых (да/нет) полей используйте true и false или yes и no.
.. option:: --list-fields, -l
Список названий полей метаданных, которые могут быть использованы с опцией :option:`--field`.
.. _calibredb-ru-export:
export
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb export [options] ids
Экспортировать книги, указанные идентификаторами (список, разделённый запятыми), в файловую систему.
Операция экспорта сохраняет все форматы книги, её обложку и метаданные (в
OPF-файл). Любые дополнительные файлы данных, связанные с книгой, также сохраняются.
Вы можете получить номера идентификаторов с помощью команды поиска (search).
Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"
.. program:: calibredb export
.. option:: --all
Экспортировать все книги в базу данных, игнорируя список id.
.. option:: --dont-asciiize
calibre преобразует все неанглийские символы в английские эквиваленты имен файлов. Это полезно при сохранении в устаревшую файловую систему без полной поддержки имен файлов Unicode. Указание этого переключателя отключит данный режим.
.. option:: --dont-save-cover
Обычно, calibre будет сохранять обложку в отдельном файле рядом с файлами электронной книги. Указание этого переключателя отключит данный режим.
.. option:: --dont-save-extra-files
Сохранить все файлы данных, связанные с книгой, при сохранении книги. Указание этого переключателя отключит данный режим.
.. option:: --dont-update-metadata
По умолчанию calibre обновляет метаданные в сохранённых файлах в библиотеке. Может замедлить запись на диск. Указание этого переключателя отключит данный режим.
.. option:: --dont-write-opf
Обычно, calibre будет писать метаданные в отдельный файл OPF рядом с файлом электронной книги. Указание этого переключателя отключит данный режим.
.. option:: --formats
Список форматов, разделенных запятыми, для сохранения для каждой книги. По умолчанию все доступные форматы сохраняются.
.. option:: --progress
Прогресс отчёта
.. option:: --replace-whitespace
Заменить пробел символом подчёркивания.
.. option:: --single-dir
Экспорт всех книг в одну папку
.. option:: --template
Шаблон для управления именем файла и структурой папок сохраненных файлов. По умолчанию это \ ``"``\ {author_sort}/{title}/{title} - {authors}\ ``"``\ , при котором книги будут сохраняться в подпапку для каждого автора с именами файлов, содержащими название и автора. Доступные элементы управления: {author_sort, authors, id, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, tags, timestamp, title}
.. option:: --timefmt
Формат отображения дат. %d - день, %b - месяц, %m - номер месяца, %Y - год. По умолчанию: %b, %Y
.. option:: --to-dir
Экспорт книг в указанную папку. По умолчанию .
.. option:: --to-lowercase
Преобразовать пути в нижний регистр.
.. _calibredb-ru-catalog:
catalog
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [options]
Export a :command:`catalog` in format specified by path/to/destination extension.
Options control how entries are displayed in the generated :command:`catalog` output.
Note that different :command:`catalog` formats support different sets of options. To
see the different options, specify the name of the output file and then the
--help option.
Когда вы передаёте аргументы с пробелами в calibredb, заключайте их в кавычки. Например: "/some path/with spaces"
.. program:: calibredb catalog
.. option:: --ids, -i
Разделённый запятыми список идентификаторов из базы данных для каталога. Если указано, :option:`--search` игнорируется. По умолчанию: all
.. option:: --search, -s
Фильтровать результаты по поисковому запросу. О формате поискового запроса читайте в связанной с поиском документации в руководстве пользователя. По умолчанию: no filtering (не фильтровать)
.. option:: --verbose, -v
Показать детальную информацию. Используется для отладки.
ОПЦИИ EPUB
^^^^^^^^^^^^^^
.. option:: --catalog-title
Название сгенерированного каталога, используемого как название в метаданных. По умолчанию: \ ``'``\ My Books\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --cross-reference-authors
Создание перекрестных ссылок в разделе «Авторы» для книг с несколькими авторами. По умолчанию: \ ``'``\ False\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --debug-pipeline
Сохранить вывод из разных этапов конвейера преобразования в указанную папку. Полезно, если вы не уверены, на каком этапе процесса преобразования возникает ошибка. По умолчанию: \ ``'``\ None\ ``'``\ Применимо к: выходным форматам AZW3, EPUB, MOBI
.. option:: --exclude-genre
Regex, описывающий теги для исключения в качестве жанров. По умолчанию: \ ``'``\ \[.+\]|^\+$\ ``'``\ исключает теги в квадратных скобках, напр. \ ``'``\ [Project Gutenberg]\ ``'``\ , и \ ``'``\ +\ ``'``\ , умолчальный тег для чтения книг. Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --exclusion-rules
Задать правила, используемые для исключения книг из сгенерированного каталога. Модель для правила исключения: (\ ``'``\ \ ``'``\ ,\ ``'``\ Tags\ ``'``\ ,\ ``'``\ \ ``'``\ ) или (\ ``'``\ \ ``'``\ ,\ ``'``\ \ ``'``\ ,\ ``'``\ \ ``'``\ ). Например: ((\ ``'``\ Archived books\ ``'``\ ,\ ``'``\ #status\ ``'``\ ,\ ``'``\ Archived\ ``'``\ ),) исключит книгу со значением \ ``'``\ Archived\ ``'``\ в польз. столбце \ ``'``\ status\ ``'``\ . Когда определено несколько правил, все они применятся. По умолчанию: \ ``'``\ ((\ ``'``\ Catalogs\ ``'``\ ,\ ``'``\ Tags\ ``'``\ ,\ ``'``\ Catalog\ ``'``\ ),)\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --generate-authors
Включить раздел «Авторы» в каталог. По умолчанию: \ ``'``\ False\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --generate-descriptions
Включить раздел «Примечания» в каталог. По умолчанию: \ ``'``\ False\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --generate-genres
Включить раздел «Жанры» в каталог. По умолчанию: \ ``'``\ False\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --generate-recently-added
Включить раздел «Недавно добавленные» в каталог. По умолчанию: \ ``'``\ False\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --generate-series
Включить раздел «Серии» в каталог. По умолчанию: \ ``'``\ False\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --generate-titles
Включить раздел «Названия» в каталог. По умолчанию: \ ``'``\ False\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --genre-source-field
Исходное поле для секции \ ``'``\ Жанры\ ``'``\ . Умолчание: \ ``'``\ Теги\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --header-note-source-field
Пользовательское поле, содержащее текст примечания для вставки в заголовок описания. Умолчание: \ ``'``\ \ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --merge-comments-rule
#: [before|after]:[True|False] с указанием: Пользовательское поле, содержащее примечания для объединения с комментариями [before|after] Размещение примечаний относительно комментариев [True|False] - между примечаниями и комментариями вставляется горизонтальная линия. По умолчанию: \ ``'``\ ::\ ``'``\ Применимо к выходным форматам AZW3, EPUB, MOBI
.. option:: --output-profile
Определить профиль вывода. В некоторых случаях для оптимизации каталога для устройства требуется профиль вывода. Например \ ``'``\ kindle\ ``'``\ or \ ``'``\ kindle_dx\ ``'``\ создаст структурированное Оглавление с Разделами и Авторами. Умолчание: \ ``'``\ None\ ``'``\ Применяется к: AZW3, EPUB, MOBI форматам вывода
.. option:: --prefix-rules
Задать правила включения префиксов, указывающих чтение книг, элементы списка пожеланий и др. польз-х префиксов. Модель для префиксного правила (\ ``'``\ \ ``'``\ ,\ ``'``\