calibre - en to ru translation catalogue (171 entries)

en: API documentation for the database interface
ru: Документация API интерфейса базы данных

en: This API is thread safe (it uses a multiple reader, single writer locking scheme).  You can access this API like this::
ru: Это потокобезопасный API (используется схема блокировки чтения-записи). Получить доступ к API можно так::

en: If you are in a calibre plugin that is part of the main calibre GUI, you get access to it like this instead::
ru: Из плагина, являющегося частью основного графического интерфейса calibre, доступ осуществляется так::

en: An in-memory cache of the metadata.db file from a calibre library. This class also serves as a threadsafe API for accessing the database. The in-memory cache is maintained in normal form for maximum performance.
ru: Кэш в памяти файла metadata.db из библиотеки calibre. Этот класс также служит потокобезопасным API для доступа к базе данных. Кэш в памяти поддерживается в нормальной форме для максимальной производительности.

en: SQLITE is simply used as a way to read and write from metadata.db robustly. All table reading/sorting/searching/caching logic is re-implemented. This was necessary for maximum performance and flexibility.
ru: SQLITE используется просто как способ надежного чтения и записи из metadata.db. Переработана вся логика чтения/сортировки/поиска/кеширования таблиц. Это было необходимо для максимальной производительности и гибкости.

en: When a new book record is created in the database, with the book id as the only argument
ru: Когда в базе данных создается новая запись книги с идентификатором книги в качестве единственного аргумента

en: When a book format is edited, with arguments: (book_id, fmt)
ru: При редактировании формата книги с аргументами: (book_id, fmt)

en: When books are removed from the database with the list of book ids as the only argument
ru: Когда книги удаляются из базы данных со списком идентификаторов книг в качестве единственного аргумента

en: When a format is added to a book, with arguments: (book_id, format)
ru: Когда в книгу добавляется формат с аргументами: (book_id, формат)

en: When formats are removed from a book, with arguments: (mapping of book id to set of formats removed from the book)
ru: Когда форматы удаляются из книги, с аргументами: (сопоставление идентификатора книги с набором форматов, удаленных из книги)

en: When the indexing progress changes
ru: Когда меняется прогресс индексации

en: When items such as tags or authors are removed from some books. Arguments: (field_name, affected book ids, ids of removed items)
ru: Когда из некоторых книг удаляются такие элементы, как теги или авторы. Аргументы: (имя_поля, идентификаторы затронутых книг, идентификаторы удаленных элементов)

en: When items such as tags or authors are renamed in some or all books. Arguments: (field_name, affected book ids, map of old item id to new item id)
ru: Когда элементы, такие как теги или авторы, переименовываются в некоторых или во всех книгах. Аргументы: (field_name, затронутые идентификаторы книг, сопоставление старого идентификатора элемента с новым идентификатором элемента)

en: When the links associated with items(s) are changed, with arguments: (field_name, item_ids)
ru: При изменении ссылок, связанных с элементами, с аргументами: (field_name, item_ids)

en: When some metadata is changed for some books, with arguments: (name of changed field, set of affected book ids)
ru: Когда некоторые метаданные изменяются для некоторых книг, с аргументами: (имя измененного поля, набор затронутых идентификаторов книг)

en: When the notes associated with item(s) are changed, with arguments: (field_name, item_ids)
ru: Когда примечания, связанные с элементом (ами), изменяются с аргументами: (field_name, item_ids)

en: Add the specified books to the library. Books should be an iterable of 2-tuples, each 2-tuple of the form :code:`(mi, format_map)` where mi is a Metadata object and format_map is a dictionary of the form :code:`{fmt: path_or_stream}`, for example: :code:`{'EPUB': '/path/to/file.epub'}`.
ru: Добавьте указанные книги в библиотеку. Книги должны быть повторяемыми из 2-х кортежей, каждый из 2-х кортежей в форме :code:`(mi, format_map)`, где mi - объект метаданных, а format_map - словарь в форме :code:`{fmt: path_or_stream}`, например: :code:`{'EPUB': '/path/to/file.epub'}`.

en: Returns a pair of lists: :code:`ids, duplicates`. ``ids`` contains the book ids for all newly created books in the database. ``duplicates`` contains the :code:`(mi, format_map)` for all books that already exist in the database as per the simple duplicate detection heuristic used by :meth:`has_book`.
ru: Возвращает пару списков: :code:`ids, duplicates`. 'ids' содержит идентификаторы всех новосозданных книг в базе данных. `duplicates` содержит :code:`(mi, format_map)` для книг уже существующих в базе данных, руководствуясь простой эвристикой обнаружения дубликатов, используемой :meth:`has_book`.

en: Add data for name where val_map is a map of book_ids to values. If delete_first is True, all previously stored data for name will be removed.
ru: Добавить данные для имени, где val_map - это отображение идентификаторов книг в значения. Если delete_first имеет значение True, все ранее сохраненные данные для имени будут удалены.

en: Add extra data files
ru: Добавить дополнительные файлы данных

en: Add a format to the specified book. Return True if the format was added successfully.
ru: Добавить формат в указанную книгу. Вернёт True, если формат был добавлен успешно.

en: Parameters
ru: Параметры

en: If True replace existing format, otherwise if the format already exists, return False.
ru:  Если True - заменить существующий формат, иначе, если формат уже существует, вернуть False.

en: If True, file type plugins are run on the format before and after being added.
ru:  Если True, плагины типов файлов обрабатывают формат до и после добавления.

en: Internal use only.
ru: Для внутреннего пользования

en: Register a callback function that will be called after certain actions are taken on this database. The function must take three arguments: (:class:`EventType`, library_id, event_type_specific_data)
ru: Регистрирует функцию обратного вызова, которая будет вызываться после выполнения определённых действий с этой базой данных. Функция должна принимать три аргумента: (:class:`EventType`, library_id, event_type_specific_data)

en: Add the specified resource so it can be referenced by notes and return its content hash
ru: Добавить указанный ресурс, чтобы его можно было ссылаться в примечаниях и вернуть его хэш-код

en: Return a tuple of all annotation types in the database.
ru: Возвращает кортеж из всех типов аннотаций в базе данных.

en: Return a tuple of all (user_type, user name) that have annotations.
ru: Возвращает кортеж из всех (user_type, имя пользователя), которые имеют аннотации.

en: Return a tuple of all annotations matching the specified criteria. `ignore_removed` controls whether removed (deleted) annotations are also returned. Removed annotations are just a skeleton used for merging of annotations.
ru: Возвращает кортеж всех аннотаций, соответствующих указанным критериям. `ignore_removed` определяет, будут ли также возвращаться удалённые аннотации. Удалённые аннотации - это просто каркас, используемый для объединения аннотаций.

en: Return a tuple containing all annotations for the specified book_id as a dict with keys: `format`, `user_type`, `user`, `annotation`. Here, annotation is the annotation data.
ru: Возвращает кортеж, содержащий все аннотации для указанного book_id в виде dict с ключами: `format`, `user_type`, `user`, `annotation`. Здесь annotation - это данные аннотации.

en: Frozen set of all known book ids.
ru: Замороженный набор всех известных идентификаторов книг.

en: Same as field_for, except that it operates on multiple books at once
ru: То же, что field_for, за исключением того, что работает с несколькими книгами одновременно

en: Frozen set of ids for all values in the field ``name``.
ru: Замороженный набор идентификаторов для всех значений в поле ``name``.

en: Frozen set of all fields names (should only be used for many-one and many-many fields)
ru: Замороженный набор имен всех полей (следует использовать только для полей 'много-один' и 'много-много')

en: Return the number of annotations for the specified book available in the database.
ru: Возвращает количество аннотаций для указанной книги, доступных в базе данных.

en: Return a map of annotation type -> annotation data for the specified book_id, format, user and user_type.
ru: Возвращает сопоставление тип аннотации -> данные аннотации для указанных book_id, format, user и user_type.

en: Return author data as a dictionary with keys: name, sort, link
ru: Вернуть данные об авторе в виде словаря с ключами: имя, сортировка, ссылка

en: If no authors with the specified ids are found an empty dictionary is returned. If author_ids is None, data for all authors is returned.
ru: Если авторов с указанными идентификаторами не найдено, возвращается пустой словарь. Если author_ids - None, возвращаются данные для всех авторов.

en: Given a list of authors, return the author_sort string for the authors, preferring the author sort associated with the author over the computed string.
ru: Учитывая список авторов, вернуть строку author_sort для авторов, предпочитая сортировку по авторам, связанную с автором, а не вычисленную строку.

en: Return all the books associated with the item identified by ``item_id``, where the item belongs to the field ``name``.
ru: Вернуть все книги, связанные с элементом, идентифицированным с помощью ``item_id``, где элемент принадлежит полю ``name``.

en: Returned value is a set of book ids, or the empty set if the item or the field does not exist.
ru: Возвращаемое значение - это набор идентификаторов книг или пустой набор, если элемент или поле не существует.

en: Return the set of books in the specified virtual library
ru: Вернуть набор книг из указанной виртуальной библиотеки

en: Compress the cover images for the specified books. A compression quality of 100 will perform lossless compression, otherwise lossy compression.
ru: Сжать изображения обложек для указанных книг. Качество сжатия 100 - сжатие без потерь, иначе - сжатие с потерями.

en: The progress callback will be called with the book_id and the old and new sizes for each book that has been processed. If an error occurs, the new size will be a string with the error details.
ru: Коллбэк прогресса будет вызываться с book_id и старым и новым размерами для каждой обработанной книги. При возникновении ошибки новый размер - строка с подробными сведениями об ошибке.

en: Copy the cover to the file like object ``dest``. Returns False if no cover exists or dest is the same file as the current cover. dest can also be a path in which case the cover is copied to it if and only if the path is different from the current path (taking case sensitivity into account).
ru: Копировать обложку в файл как объект ``dest``. Возвращает False, если обложки не существует или если dest - тот же файл, что и текущая обложка. dest также может быть путем, и в этом случае обложка копируется по нему тогда и только тогда, когда путь отличается от текущего пути (с учетом чувствительности к регистру).

en: Copy the format ``fmt`` to the file like object ``dest``. If the specified format does not exist, raises :class:`NoSuchFormat` error. dest can also be a path (to a file), in which case the format is copied to it, iff the path is different from the current path (taking case sensitivity into account).
ru: Копировать формат fmt в файл как объект dest. Если указанный формат не существует, вызывает ошибку :class:`NoSuchFormat`. dest также может быть путем (к файлу), и в этом случае формат копируется по нему, если путь отличается от текущего пути (с учетом чувствительности к регистру).

en: Return the cover image or None. By default, returns the cover as a bytestring.
ru: Вернуть обложку или None. По умолчанию возвращает обложку в виде байтовой строки.

en: WARNING: Using as_path will copy the cover to a temp file and return the path to the temp file. You should delete the temp file when you are done with it.
ru: ВНИМАНИЕ: использование as_path скопирует обложку во временный файл и вернет путь к временному файлу. Вы должны удалить временный файл, когда закончите работать с ним.

en: If True return the image as an open file object (a SpooledTemporaryFile)
ru: Если True, вернуть изображение как объект открытого файла (SpooledTemporaryFile)

en: If True return the image as a QImage object
ru: Если True вернуть изображение как объект QImage

en: If True return the image as a QPixmap object
ru: Если True вернуть изображение как объект QPixmap

en: If True return the image as a path pointing to a temporary file
ru: Если True, вернуть изображение как путь, указывающий на временный файл

en: Return data that can be used to implement :meth:`find_identical_books` in a worker process without access to the db. See db.utils for an implementation.
ru: Вернуть данные, которые можно использовать для реализации :meth:`find_identical_books` в рабочем процессе без доступа к базе данных. См. реализацию в db.utils.

en: Return data suitable for use in :meth:`has_book`. This can be used for an implementation of :meth:`has_book` in a worker process without access to the db.
ru: Возвращает данные, подходящие для использования в :meth:`has_book`. Это можно использовать для реализации :meth:`has_book` в рабочем процессе без доступа к базе данных.

en: Delete annotations with the specified ids.
ru: Удалить аннотации с указанными идентификаторами.

en: Delete data for name. By default deletes all data, if you only want to delete data for some book ids, pass in a list of book ids.
ru: Удалить данные для имени. По умолчанию удаляются все данные. Если вы хотите удалить данные только для некоторых идентификаторов книг, передайте список идентификаторов книг.

en: Delete an entry from the trash. Here category is 'b' for books and 'f' for formats.
ru: Удалить запись из корзины. Здесь категория 'b' для книг и 'f' для форматов.

en: Update metadata in all formats of the specified book_ids to current metadata in the database.
ru: Обновить метаданные во всех форматах указанных book_ids до текущих метаданных в базе данных.

en: Expire entries from the trash that are too old
ru: Записи из корзины слишком старые

en: Export the note as a single HTML document with embedded images as data: URLs
ru: Экспортировать примечание в виде одного HTML-документа с встроенными изображениями в виде URL-адресов данных

en: Same as field_for, except that it avoids the extra lookup to get the field object
ru: То же, что field_for, только исключает дополнительный поиск для получения объекта поля

en: Return the value of the field ``name`` for the book identified by ``book_id``. If no such book exists or it has no defined value for the field ``name`` or no such field exists, then ``default_value`` is returned.
ru: Вернуть значение поля name для книги, идентифицированной с помощью book_id. Если такой книги не существует, или она не имеет определенного значения для поля ``name`` или такое поле не существует, то возвращается ``default_value``.

en: ``default_value`` is not used for title, title_sort, authors, author_sort and series_index. This is because these always have values in the db. ``default_value`` is used for all custom columns.
ru: ``default_value`` не используется для заголовка, title_sort, авторов, author_sort и series_index. Это потому, что они всегда имеют значения в базе данных. ``default_value`` используется для всех настраиваемых столбцов.

en: The returned value for is_multiple fields are always tuples, even when no values are found (in other words, default_value is ignored). The exception is identifiers for which the returned value is always a dictionary. The returned tuples are always in link order, that is, the order in which they were created.
ru: Возвращаемое значение для полей is_multiple всегда является кортежем, даже если значения не найдены (другими словами, default_value игнорируется). Исключение составляют идентификаторы, для которых возвращаемое значение всегда dict. Возвращаемые кортежи всегда находятся в ссылочном порядке (в порядке их создания).

en: Return the ids (as a tuple) for the values that the field ``name`` has on the book identified by ``book_id``. If there are no values, or no such book, or no such field, an empty tuple is returned.
ru: Вернуть идентификаторы (в виде кортежа) для значений, которые поле name имеет в книге, идентифицированной с помощью ``book_id``. Если значений нет, или такой книги, или такого поля нет, возвращается пустой кортеж.

en: Return True iff the specified field supports notes. If field is None return frozenset of all fields that support notes.
ru: Вернуть True, если указанное поле поддерживает примечания. Если поле равно None, вернуть неизменяемое множество всех полей, поддерживающих примечания.

en: Finds books that have a superset of the authors in mi and the same title (title is fuzzy matched). See also :meth:`data_for_find_identical_books`.
ru: Находит книги, у которых есть надмножество авторов в mi и одинаковое название (нечеткое совпадение названия). См. Также :meth:`data_for_find_identical_books`.

en: Return the e-book format as a bytestring or `None` if the format doesn't exist, or we don't have permission to write to the e-book file.
ru: Вернуть формат электронной книги в виде байтовой строки или `None`, если формат не существует или у нас нет разрешения на запись в файл электронной книги.

en: If True the e-book format is returned as a file object. Note that the file object is a SpooledTemporaryFile, so if what you want to do is copy the format to another file, use :meth:`copy_format_to` instead for performance.
ru:  Если True, формат электронной книги возвращается как файловый объект. Обратите внимание, что файловым объектом является SpooledTemporaryFile, поэтому, если вы хотите скопировать формат в другой файл, используйте вместо этого :meth:`copy_format_to` для повышения производительности.

en: Copies the format file to a temp file and returns the path to the temp file
ru: Копирует файл формата во временный файл и возвращает путь к временному файлу.

en: If True and returning a path the filename is the same as that used in the library. Note that using this means that repeated calls yield the same temp file (which is re-created each time)
ru: Если True и возвращает путь, имя файла такое же, как и в библиотеке. Обратите внимание, что использование этого означает, что повторные вызовы дают один и тот же временный файл (который каждый раз создается заново)

en: Return absolute path to the e-book file of format `format`. You should almost never use this, as it breaks the threadsafe promise of this API. Instead use, :meth:`copy_format_to`.
ru: Вернуть абсолютный путь к файлу электронной книги формата `format`. Вам почти никогда не следует использовать это, так как это нарушает обещание потоковой безопасности этого API. Вместо этого используйте :meth:`copy_format_to`.

en: Currently used only in calibredb list, the viewer, edit book, compare_format to original format, open with, bulk metadata edit and the catalogs (via get_data_as_dict()).
ru: В настоящее время используется только в calibredb list, viewer, edit book, compare_format to original format, open with, массовое редактирование метаданных и каталоги (через get_data_as_dict ()).

en: Apart from the viewer, open with and edit book, I don't believe any of the others do any file write I/O with the results of this call.
ru: Я не верю, что кто-либо, кроме средства просмотра, открывающего и редактирующего книгу, выполняет какие-либо операции ввода-вывода записи файлов с результатами этого вызова.

en: Return the hash of the specified format for the specified book. The kind of hash is backend dependent, but is usually SHA-256.
ru: Вернуть хэш указанного формата для указанной книги. Тип хэша зависит от серверной части, но обычно это SHA-256.

en: Return the path, size and mtime for the specified format for the specified book. You should not use path unless you absolutely have to, since accessing it directly breaks the threadsafe guarantees of this API. Instead use the :meth:`copy_format_to` method.
ru: Вернуть путь, размер и время для указанного формата для указанной книги. Вы не должны использовать path, если в этом нет крайней необходимости, поскольку прямой доступ к нему нарушает гарантии потоковой безопасности этого API. Вместо этого используйте метод :meth:`copy_format_to`.

en: If ``True`` cached values are used, otherwise a slow filesystem access is done. The cache values could be out of date if access was performed to the filesystem outside of this API.
ru: Если используются кэшированные значения ``True``, в противном случае выполняется медленный доступ к файловой системе. Значения кеша могли быть устаревшими, если доступ к файловой системе выполнялся вне этого API.

en: If ``True`` The max_size field of the database is updated for this book.
ru: Если ``True`` поле max_size базы данных обновляется для этой книги.

en: Return tuple of all formats for the specified book. If verify_formats is True, verifies that the files exist on disk.
ru: Вернуть кортеж всех форматов для указанной книги. Если verify_formats имеет значение True, проверяет, существуют ли файлы на диске.

en: Return all item_ids for items that have notes in the specified field or all fields if field_name is None
ru: Вернуть все item_ids для элементов, у которых есть примечания в указанном поле или во всех полях, если field_name равно None

en: Returns all links for all fields referenced by book identified by book_id. If book_id doesn't exist then the method returns {}.
ru: Возвращает все ссылки для всех полей, на которые ссылается книга, идентифицированная book_id. Если book_id не существует, метод возвращает {}.

en: Example: Assume author A has link X, author B has link Y, tag S has link F, and tag T has link G. If book 1 has author A and tag T, this method returns {'authors':{'A':'X'}, 'tags':{'T', 'G'}}. If book 2's author is neither A nor B and has no tags, this method returns {}.
ru: Пример. Предположим, что у автора A есть ссылка X, у автора B есть ссылка Y, у тега S есть ссылка F, а у тега T есть ссылка G. Если у книги 1 есть автор A и тег T, этот метод возвращает {'authors':{'A':'X'}, 'теги':{'T', 'G'}}. Если автор книги 2 не является ни A, ни B и не имеет тегов, этот метод возвращает {}.

en: the book id in question.
ru: book id в вопросе.

en: Returns
ru: Возврат

en: {field: {field_value, link_value}, ...  for all fields with a field_value having a non-empty link value for that book
ru: {field: {field_value, link_value}, ... для всех полей с field_value, имеющим непустое значение ссылки для этой книги

en: Used internally to implement the Tag Browser
ru: Используется внутри для реализации браузера тегов

en: Get data for name. By default returns data for all book_ids, pass in a list of book ids if you only want some data. Returns a map of book_id to values. If a particular value could not be decoded, uses default for it.
ru: Получите данные для имени. По умолчанию возвращает данные для всех book_ids, передайте список идентификаторов книг, если вам нужны только некоторые данные. Возвращает карту значений book_id. Если определенное значение не может быть декодировано, для него используется значение по умолчанию.

en: Return a mapping of id numbers to values for the specified field. The field must be a many-one or many-many field, otherwise a ValueError is raised.
ru: Вернуть сопоставление номеров идентификаторов со значениями для указанного поля. Поле должно быть полем «многие-один» или «многие-многие», в противном случае возникает ошибка ValueError.

en: Return the set of book ids for which name has data.
ru: Вернуть набор идентификаторов книг, в названии которых есть данные.

en: Return the item id for item_name or None if not found. This function is very slow if doing lookups for multiple names use either get_item_ids() or get_item_name_map(). Similarly, case sensitive lookups are faster than case insensitive ones.
ru: Возвращает идентификатор элемента для item_name или None, если не найден. Эта функция работает очень медленно, если при поиске нескольких имен используется либо get_item_ids(), либо get_item_name_map(). Аналогично, поиск с учетом регистра выполняется быстрее, чем без учета регистра.

en: Return a dict mapping item_name to the item id or None
ru: Возвращает значение dict , сопоставляющее item_name с идентификатором элемента , или None

en: Return the item name for the item specified by item_id in the specified field. See also :meth:`get_id_map`.
ru: Вернуть имя элемента для элемента, указанного в item_id в указанном поле. См. также :meth:`get_id_map`.

en: Return mapping of item values to ids
ru: Вернуть отображение значений элементов в идентификаторы

en: Return a dictionary of links for the supplied field.
ru: Возвращает словарь ссылок для предоставленного поля.

en: the lookup name of the field for which the link map is desired
ru: имя поиска поля, для которого требуется карта ссылок

en: {field_value:link_value, ...} for non-empty links
ru: {field_value:link_value, ...} для непустых ссылок

en: Return metadata for the book identified by book_id as a :class:`calibre.ebooks.metadata.book.base.Metadata` object. Note that the list of formats is not verified. If get_cover is True, the cover is returned, either a path to temp file as mi.cover or if cover_as_data is True then as mi.cover_data.
ru: Возвращает метаданные для книги, идентифицированной book_id как объект :class:`calibre.ebooks.metadata.book.base.Metadata`. Обратите внимание, что список форматов не проверяется. Если get_cover - True, обложка возвращается, либо путь к временному файлу как mi.cover, либо если cover_as_data имеет значение True, то как mi.cover_data.

en: Return the next series index for the specified series, taking into account the various preferences that control next series number generation.
ru: Возвращает индекс следующей серии для указанной серии с учетом различных предпочтений, управляющих генерацией номера следующей серии.

en: The series-like field (defaults to the builtin series column)
ru: Поле типа серии (по умолчанию - встроенный столбец серии)

en: If True, returns a mapping of book_id to current series_index value instead.
ru:  Если True, вместо этого возвращает сопоставление book_id с текущим значением series_index.

en: Return a dict containing the resource data and name or None if no resource with the specified hash is found
ru: Вернуть словарь, содержащий данные ресурса и имя или None, если ресурс с указанным хэшем не найден

en: Like :meth:`get_metadata` except that it returns a ProxyMetadata object that only reads values from the database on demand. This is much faster than get_metadata when only a small number of fields need to be accessed from the returned metadata object.
ru: Например :meth:`get_metadata`, за исключением того, что он возвращает объект ProxyMetadata, который только считывает значения из базы данных по запросу. Это намного быстрее, чем get_metadata, когда необходимо получить доступ только к небольшому количеству полей из возвращенного объекта метаданных.

en: Return a mapping of id to usage count for all values of the specified field, which must be a many-one or many-many field.
ru: Вернуть отображение идентификатора в счетчик использования для всех значений указанного поля, которое должно быть полем «много-один» или «много-много»

en: Return True iff the database contains an entry with the same title as the passed in Metadata object. The comparison is case-insensitive. See also :meth:`data_for_has_book`.
ru: Верните True, если база данных содержит запись с тем же заголовком, что и переданный объект Metadata. При сравнении регистр не учитывается. См. также :meth:`data_for_has_book`.

en: Return True iff the format exists on disk
ru: Вернуть True, если формат существует на диске

en: Return True iff the specified book_id exists in the db
ru: Вернёт True, если указанный book_id существует в БД

en: Import a previously exported note or an arbitrary HTML file as the note for the specified item
ru: Импортировать ранее экспортированное примечание или произвольный HTML-файл в качестве примечания для указанного элемента

en: Initialize this cache with data from the backend.
ru: Инициализировать этот кеш данными из серверной части.

en: Return a dict of field to items that have associated notes for that field for the specified book
ru: Вернуть словарь поля для элементов, у которых есть примечания для этого поля для указанной книги

en: Return the link, if any, for the specified item or None if no link is found
ru: Вернуть ссылку, если она есть, для указанного элемента или None, если ссылка не найдена

en: Get information about extra files in the book's directory.
ru: Получить информацию о дополнительных файлах в каталоге книги.

en: the database book id for the book
ru: идентификатор книги в базе данных для книги

en: the pattern of filenames to search for. Empty pattern matches all extra files. Patterns must use / as separator. Use the DATA_FILE_PATTERN constant to match files inside the data directory.
ru: паттерн имен файлов для поиска. Пустой паттерн соответствует всем дополнительным файлам. Паттерны должны использовать / в качестве разделителя. Используйте константу DATA_FILE_PATTERN для сопоставления файлов внутри каталога данных.

en: A tuple of all extra files matching the specified pattern. Each element of the tuple is ExtraFile(relpath, file_path, stat_result). Where relpath is the relative path of the file to the book directory using / as a separator. stat_result is the result of calling os.stat() on the file.
ru: Кортеж всех дополнительных файлов, соответствующих указанному шаблону. Каждый элемент кортежа — это ExtraFile(relpath, file_path, stat_result). Где relpath — это относительный путь файла к каталогу книги с использованием / в качестве разделителя. stat_result — это результат вызова os.stat() для файла.

en: Merge the specified annotations into the existing annotations for book_id, fm, user_type, and user.
ru: Объединяет указанные аннотации с существующими аннотациями для book_id, fm, user_type и user.

en: Merge the extra files from src_ids into dest_id. Conflicting files are auto-renamed unless replace=True in which case they are replaced.
ru: Объединить дополнительные файлы из src_ids в dest_id. Конфликтующие файлы автоматически переименовываются, если только replace=True не заменяет их.

en: Undelete a book from the trash directory
ru: Восстановить книгу из каталога корзины

en: Undelete a format from the trash directory
ru: Восстановить формат из каталога корзины

en: Return a list of sorted book ids. If ids_to_sort is None, all book ids are returned.
ru: Вернуть список отсортированных идентификаторов книг. Если ids_to_sort - None, возвращаются идентификаторы всех книг.

en: fields must be a list of 2-tuples of the form (field_name, ascending=True or False). The most significant field is the first 2-tuple.
ru: поля должны быть списком из двух кортежей формы (field_name, ascending = True или False). Наиболее значимое поле - первое в кортеже из двух элементов.

en: Return all notes data as a dict or None if note does not exist
ru: Вернуть все данные примечаний в виде словаря или None, если примечание не существует

en: Return the notes document or an empty string if not found
ru: Вернуть документ с примечаниями или пустую строку, если не найдено

en: Return the set of resource hashes of all resources used by the note for the specified item
ru: Вернуть набор хэшей ресурсов всех ресурсов, используемых примечанием для указанного элемента

en: Return the value for the specified preference or the value specified as ``default`` if the preference is not set.
ru: Вернуть значение для указанного предпочтения или значение, указанное как ``по умолчанию``, если предпочтение не установлено.

en: Return the OPF metadata backup for the book as a bytestring or None if no such backup exists.
ru: Вернуть резервную копию метаданных OPF для книги в виде байтовой строки или None, если такой резервной копии не существует

en: Remove the books specified by the book_ids from the database and delete their format files. If ``permanent`` is False, then the format files are placed in the per-library trash directory.
ru: Удалить записи книг, указанных в book_ids, из базы данных и удалить их файлы. Если для параметра ``permanent`` установлено значение False, файлы помещаются в корзину для библиотеки.

en: Delete the specified extra files, either to Recycle Bin or permanently.
ru: Удалить указанные дополнительные файлы либо в корзину, либо навсегда.

en: Remove the specified formats from the specified books.
ru:  Удалить указанные форматы из указанных книг.

en: A mapping of book_id to a list of formats to be removed from the book.
ru: Сопоставить book_id со списком форматов, которые нужно удалить из книги.

en: If True, only remove the record for the format from the db, do not delete the actual format file from the filesystem.
ru: Если True, удалить только запись для формата из базы данных, не удалять файл формата из файловой системы.

en: A map of book id to set of formats actually deleted from the filesystem for that book
ru: Сопоставление идентификатора книги с набором форматов, фактически удаленных из файловой системы для этой книги

en: Delete all items in the specified field with the specified ids. Returns the set of affected book ids. ``restrict_to_book_ids`` is an optional set of books ids. If specified the items will only be removed from those books.
ru: Удалить все элементы в указанном поле с указанными идентификаторами. Возвращает набор идентификаторов затронутых книг. ``restrict_to_book_ids`` - необязательный набор идентификаторов книг. Если указано, элементы будут удалены только из этих книг.

en: Rename extra data files
ru: Переименовать дополнительные файлы данных

en: Rename items from a many-one or many-many field such as tags or series.
ru: Переименовать элементы из полей «многие-один» или «многие-многие», например тегов или серий.

en: When renaming in a series-like field also change the series_index values.
ru: При переименовании в поле типа серии также изменить значения series_index.

en: An optional set of book ids for which the rename is to be performed, defaults to all books.
ru: Необязательный набор идентификаторов книг, для которых должно быть выполнено переименование, по умолчанию для всех книг.

en: Restore the book entry in the database for a book that already exists on the filesystem
ru: Восстановить запись книги в базе данных для книги, которая уже существует в файловой системе

en: Restore the specified format from the previously saved ORIGINAL_FORMAT, if any. Return True on success. The ORIGINAL_FORMAT is deleted after a successful restore.
ru: Восстановить указанный формат из ранее сохраненного ORIGINAL_FORMAT, если таковой имеется. Вернуть True в случае успеха. ORIGINAL_FORMAT удаляется после успешного восстановления.

en: A safe read lock is a lock that does nothing if the thread already has a write lock, otherwise it acquires a read lock. This is necessary to prevent DowngradeLockErrors, which can happen when updating the search cache in the presence of composite columns. Updating the search cache holds an exclusive lock, but searching a composite column involves reading field values via ProxyMetadata which tries to get a shared lock. There may be other scenarios that trigger this as well.
ru: Безопасная блокировка чтения - это блокировка, которая ничего не делает, если поток уже имеет блокировку записи, в противном случае он получает блокировку чтения. Это необходимо для предотвращения ошибок DowngradeLockErrors, которые могут возникнуть при обновлении кеша поиска при наличии составных столбцов. Обновление кеша поиска содержит эксклюзивную блокировку, но поиск в составном столбце включает чтение значений полей через ProxyMetadata, который пытается получить общую блокировку. Могут быть и другие сценарии, которые также вызывают это.

en: This property returns a new lock object on every access. This lock object is not recursive (for performance) and must only be used in a with statement as ``with cache.safe_read_lock:`` otherwise bad things will happen.
ru: Это свойство возвращает новый объект блокировки при каждом доступе. Этот объект блокировки не является рекурсивным (для повышения производительности) и должен использоваться только в операторе with как ``with cache.safe_read_lock:``, иначе произойдут плохие вещи.

en: Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any existing ORIGINAL_FORMAT.
ru: Сохранить копию указанного формата как ORIGINAL_FORMAT, перезаписав любой существующий ORIGINAL_FORMAT.

en: Search the database for the specified query, returning a set of matched book ids.
ru: Искать в базе данных указанный запрос, возвращая набор совпадающих идентификаторов книг.

en: A restriction that is ANDed to the specified query. Note that restrictions are cached, therefore the search for a AND b will be slower than a with restriction b.
ru: Ограничение, добавляемое (AND) к указанному запросу. Обратите внимание, что ограничения кэшируются, поэтому поиск "a" AND "b" будет медленнее, чем "a" с ограничением "b".

en: Used internally (virtual fields such as on_device to search over).
ru: Используется внутри (виртуальные поля, такие как on_device, для поиска).

en: If not None, a set of book ids for which books will be searched instead of searching all books.
ru: Если не None, то набор идентификаторов книг, по которым будет выполняться поиск книг вместо поиска по всем книгам.

en: Return of a tuple of annotations matching the specified Full-text query.
ru: Возвращает кортеж аннотаций, соответствующий указанному полнотекстовому запросу.

en: Search the text of notes using an FTS index. If the query is empty return all notes.
ru: Искать текст примечаний с использованием индекса FTS. Если запрос пустой, вернуть все примечания.

en: Set all annotations for the specified book_id, fmt, user_type and user.
ru: Установить все аннотации для указанных book_id, fmt, user_type и user.

en: options must be a map of the form {book_id:conversion_options}
ru: параметры должны быть картой в форме {book_id: conversion_options}

en: Set the cover for this book. The data can be either a QImage, QPixmap, file object or bytestring. It can also be None, in which case any existing cover is removed.
ru: Установить обложку для этой книги. Данные могут быть QImage, QPixmap, файловым объектом или байтовой строкой. Также может быть None - любая существующая обложка будет удалена

en: Set the values of the field specified by ``name``. Returns the set of all book ids that were affected by the change.
ru: Установить значения поля, указанного в ``name``. Возвращает набор всех идентификаторов книг, на которые повлияло изменение.

en: Mapping of book_ids to values that should be applied.
ru: Сопоставление book_ids значениям, которые следует применить.

en: If True, the case of many-one or many-many fields will be changed. For example, if a  book has the tag ``tag1`` and you set the tag for another book to ``Tag1`` then the both books will have the tag ``Tag1`` if allow_case_change is True, otherwise they will both have the tag ``tag1``.
ru: Если True, регистр полей много-один или много-много будет изменен. Например, если у книги есть тег ``tag1``, а вы установили тег для другой книги как ``Tag1``, тогда обе книги будут иметь тег ``Tag1``, если allow_case_change - True, иначе они оба будут иметь тег ``tag1``.

en: Used internally, you should never change it.
ru: Используется внутри, вы никогда не должны его менять.

en: Sets links for item values in field. Note: this method doesn't change values not in the value_to_link_map
ru: Устанавливает ссылки для значений элемента в поле. Примечание: этот метод не изменяет значения не в value_to_link_map.

en: the lookup name
ru: имя поиска

en: dict(field_value:link, ...). Note that these are values, not field ids.
ru: dict(field_value:ссылка, ...). Обратите внимание, что это значения, а не идентификаторы полей.

en: books changed by setting the link
ru: книги изменены путем установки ссылки

en: Set metadata for the book `id` from the `Metadata` object `mi`
ru: Установить метаданные для книги `id` из объекта `Metadata` `mi`

en: Setting force_changes=True will force set_metadata to update fields even if mi contains empty values. In this case, 'None' is distinguished from 'empty'. If mi.XXX is None, the XXX is not replaced, otherwise it is. The tags, identifiers, and cover attributes are special cases. Tags and identifiers cannot be set to None so they will always be replaced if force_changes is true. You must ensure that mi contains the values you want the book to have. Covers are always changed if a new cover is provided, but are never deleted. Also note that force_changes has no effect on setting title or authors.
ru: Установка force_changes = True заставит set_metadata обновлять поля, даже если mi содержит пустые значения. В этом случае `None` отличается от `empty`. Если mi.XXX равно 'None', XXX не заменяется, в противном случае - нет. Теги, идентификаторы и атрибуты обложки - это особые случаи. Теги и идентификаторы не могут быть установлены на 'None', поэтому они всегда будут заменены, если force_changes истинно. Вы должны убедиться, что mi содержит те значения, которые вы хотите, чтобы книга имела. Обложки всегда меняются, если предоставляется новая обложка, но никогда не удаляются. Также обратите внимание, что force_changes не влияет на установку заголовка или авторов.

en: Set the notes document. If the searchable text is different from the document, specify it as searchable_text. If the document references resources their hashes must be present in resource_hashes. Set remove_unused_resources to True to cleanup unused resources, note that updating a note automatically cleans up resources pertaining to that note anyway.
ru: Установить документ с примечаниями. Если искомый текст отличается от документа, указать его как searchable_text. Если документ ссылается на ресурсы, их хэши должны присутствовать в resource_hashes. Установить remove_unused_resources в True, чтобы очистить неиспользуемые ресурсы, обратите внимание, что обновление примечания автоматически очищает ресурсы, относящиеся к этому примечанию.

en: Set the specified preference to the specified value. See also :meth:`pref`.
ru: Установите указанное предпочтение на указанное значение. См. Также: meth:`pref`.

en: If f is a composite column lookup key and the column is is_multiple then split v into unique non-empty values. The comparison is case sensitive. Order is not preserved. Return a list() for compatibility with proxy metadata field getters, for example tags.
ru: Если f является составным ключом поиска столбца, а столбец is_multiple, то разделите v на уникальные непустые значения. Сравнение чувствительно к регистру. Порядок не сохраняется. Возвращает list() для совместимости с получателями полей метаданных прокси, например тегами.

en: Return the ids of all books having the tag ``tag`` that are older than the specified time. tag comparison is case insensitive.
ru: Возвратить идентификаторы всех книг с тегом ``tag``, которые старше указанного времени. сравнение тегов производится без учета регистра.

en: A timedelta object or None. If None, then all ids with the tag are returned.
ru: Объект timedelta или None. Если None, то возвращаются все идентификаторы с тегом.

en: If not None the list of matches will be restricted to books that have this tag
ru: Если нет, то список совпадений будет ограничен книгами с этим тегом.

en: A list of authors. If not None the list of matches will be restricted to books that have these authors (case insensitive).
ru: Список авторов. Если нет, то список совпадений будет ограничен книгами, имеющими этих авторов (без учета регистра).

en: Unretire a previously retired note for the specified item. Notes are retired when an item is removed from the database
ru: Восстановить ранее удаленное примечание для указанного элемента. Примечания удаляются, когда элемент удаляется из базы данных.

en: Update annotations.
ru: Обновить аннотации.

en: Return the user categories for the specified books. proxy_metadata_map is optional and is useful for a performance boost, in contexts where a ProxyMetadata object for the books already exists. It should be a mapping of book_ids to their corresponding ProxyMetadata objects.
ru: Вернуть категории пользователей для указанных книг. proxy_metadata_map не является обязательным и полезен для повышения производительности в контекстах, где уже существует объект ProxyMetadata для книг. Это должно быть отображение book_ids на соответствующие им объекты ProxyMetadata.
