calibre - en to uk translation catalogue (171 entries)

en: API documentation for the database interface
uk: Документація з програмного інтерфейсу для роботи з базою даних

en: This API is thread safe (it uses a multiple reader, single writer locking scheme).  You can access this API like this::
uk: Цей програмний інтерфейс безпечний щодо потоків виконання (використовує схему із декількома потоками читання і одним потоком запису із блокуванням). Доступ до програмного інтерфейсу можна отримати так::

en: If you are in a calibre plugin that is part of the main calibre GUI, you get access to it like this instead::
uk: Якщо ви працюєте із додатком до calibre, який є частиною основного графічного інтерфейсу 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.
uk: Кеш у пам’яті файла metadata.db з бібліотеки calibre. Цей клас також слугує безпечним для потоків обробки програмним інтерфейсом для доступу до бази даних. Кеш у пам’яті підтримується у нормальній формі для збільшення швидкодії.

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.
uk: SQLITE просто використовується як стійкий спосіб читання і запису metadata.db. Усю логіку читання, упорядковування, пошуку та кешування таблиць реалізовано окремо. Так зроблено для забезпечення максимальної швидкодії і гнучкості.

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

en: When a book format is edited, with arguments: (book_id, fmt)
uk: Коли буде змінено формат книги з аргументами: (ідентифікатор_книги, формат)

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

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

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

en: When the indexing progress changes
uk: Коли змінюється поступ індексування

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

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)
uk: Коли у деяких або усіх книгах перейменовують записи, подібні до міток або записів авторів. Аргументи: (назва_поля, ідентифікатори книг, відображення старого ідентифікатора запису на новий ідентифікатор запису)

en: When the links associated with items(s) are changed, with arguments: (field_name, item_ids)
uk: Коли змінено посилання, які пов'язано із записами, з аргументами (назва_поля, ідентифікатори_записів)

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

en: When the notes associated with item(s) are changed, with arguments: (field_name, item_ids)
uk: Коли змінено нотатки, які пов'язано із записами, з аргументами (назва_поля, ідентифікатори_записів)

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'}`.
uk: Додати вказані книги до бібліотеки. Books має бути ітерованим списком з двоелементних кортежів, кожен кортеж має бути записано у формі :code:`(mi, format_map)`, де mi — об’єкт Metadata, а format_map — словник у формі form :code:`{формат: шлях_або_потік}`. Приклад: :code:`{'EPUB': '/шлях/до/файла.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`.
uk: Повертає пару списків: :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.
uk: Додати дані для вказаної назви, де val_map — прив’язка book_id до значень. Якщо delete_first має значення True, усі раніше збережені для вказаної назви дані буде вилучено.

en: Add extra data files
uk: Додати додаткові файли даних

en: Add a format to the specified book. Return True if the format was added successfully.
uk: Додати запис формату до вказаного запису книги. Повертає True, якщо запис формату було успішно додано.

en: Parameters
uk: Параметри

en: If True replace existing format, otherwise if the format already exists, return False.
uk: Якщо True, замінити наявний формат, інакше, якщо формат вже існує, повернути False.

en: If True, file type plugins are run on the format before and after being added.
uk: Якщо True, додатки форматів типів файлів опрацьовують формат до і після додавання.

en: Internal use only.
uk: Лише для внутрішнього використання.

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)
uk: Зареєструвати функцію зворотного виклику, яку буде викликано після певних дій над цією базою даних. Функція має приймати три аргументи: (:class:`EventType`, ідентифікатор_бібліотеки, специфічні_дані_типу_події)

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

en: Return a tuple of all annotation types in the database.
uk: Повертає кортеж усіх типів анотацій у базі даних.

en: Return a tuple of all (user_type, user name) that have annotations.
uk: Повертає кортеж усіх (тип_користувача, ім'я_користувача), які містять анотації.

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.
uk: Повертає кортеж усіх анотацій, які відповідають вказаному критерію. `ігнорувати_вилучені` керує тим, чи слід також повертати дані вилучених (витертих) анотацій. Вилучені анотації є лише каркасом, який використовують для об'єднання анотацій.

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.
uk: Повертає кортеж, що містить усі анотації для вказаного ідентифікатор_книги як словник із такими ключами: `format`, `user_type`, `user`, `annotation`. Тут annotation є даними анотації.

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

en: Same as field_for, except that it operates on multiple books at once
uk: Те саме, що і field_for, але одночасно обробляється декілька книг

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

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

en: Return the number of annotations for the specified book available in the database.
uk: Повертає кількість анотацій для вказаної книги, які є у базі даних.

en: Return a map of annotation type -> annotation data for the specified book_id, format, user and user_type.
uk: Повертає карту «тип анотації -> дані анотації» для вказаних ідентифікатор_книги, формат, користувач і тип_користувача.

en: Return author data as a dictionary with keys: name, sort, link
uk: Повернути дані щодо авторів у форматі словника з такими ключами: name, sort, link

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.
uk: Якщо авторів із вказаними ідентифікаторами немає, буде повернуто порожній словник. Якщо 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.
uk: За вказаними списком авторів повертає рядок author_sort для авторів, надаючи перевагу упрядковуванню за авторами, пов’язаному з автором, над обчисленим рядком.

en: Return all the books associated with the item identified by ``item_id``, where the item belongs to the field ``name``.
uk: Повертає усі книги, пов’язані із записом, вказаними за допомогою ``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.
uk: Повернуте значення є набором ідентифікаторів книг або порожньою множиною, якщо запису або поля не існує.

en: Return the set of books in the specified virtual library
uk: Повертає набір книг у вказаній віртуальній бібліотеці

en: Compress the cover images for the specified books. A compression quality of 100 will perform lossless compression, otherwise lossy compression.
uk: Стиснути зображення обкладинок вказаних книг. Якість стискання 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.
uk: Зворотний виклик поступу буде виконано із використанням ідентифікатора книги та старого і нового розмірів для кожної обробленої книги. Якщо станеться помилка, розміром новин буде рядок із повідомленням про помилку.

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).
uk: Копіювати зображення обкладинки до файлоподібного об’єкта ``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).
uk: Копіювати формат ``fmt`` до файлоподібного об’єкта ``dest``. Якщо вказаного формату не існує, повідомляє про помилку :class:`NoSuchFormat`. ``dest`` може бути шляхом. Якщо ``dest`` є шляхом (до файла), формат буде скопійовано до нього тоді і лише тоді, коли шлях відрізняється від поточного шляху (із врахуванням регістру символів).

en: Return the cover image or None. By default, returns the cover as a bytestring.
uk: Повертає зображення обкладинки або 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.
uk: ПОПЕРЕДЖЕННЯ: використання as_path призведе до копіювання зображення обкладинки до тимчасового файла і повернення шляху до цього тимчасового файла. Вам слід вилучити тимчасовий файл, коли ви завершите роботу з ним.

en: If True return the image as an open file object (a SpooledTemporaryFile)
uk: Якщо True, повернути зображення як відкритий об’єкт файла (SpooledTemporaryFile)

en: If True return the image as a QImage object
uk: Якщо True, повернути зображення як об’єкт QImage.

en: If True return the image as a QPixmap object
uk: Якщо True, повертає зображення як об'єкт QPixmap

en: If True return the image as a path pointing to a temporary file
uk: Якщо 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.
uk: Повертає дані, якими можна скористатися для реалізації :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.
uk: Повертає дані, придатні до використання у :meth:`has_book`. Можна скористатися для реалізації :meth:`has_book` у процесі обробки без доступу до бази даних.

en: Delete annotations with the specified ids.
uk: Вилучити анотації з вказаними ідентифікаторами.

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.
uk: Вилучити дані за вказаною назвою. Типово вилучає усі дані. Якщо вам потрібно вилучити дані лише для деяких ідентифікаторів книг, передайте список ідентифікаторів книг.

en: Delete an entry from the trash. Here category is 'b' for books and 'f' for formats.
uk: Вилучити запис зі смітника. Тут категоріями є «b» для книг і «f» для форматів.

en: Update metadata in all formats of the specified book_ids to current metadata in the database.
uk: Оновити метадані в усіх форматах вказаних book_id до поточних метаданих у базі даних.

en: Expire entries from the trash that are too old
uk: Вилучити надто старі записи зі смітника

en: Export the note as a single HTML document with embedded images as data: URLs
uk: Експортувати нотатку як окремий документ HTML з вбудованими зображеннями у форматі адрес data:

en: Same as field_for, except that it avoids the extra lookup to get the field object
uk: Те саме, що і 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.
uk: Повертає значення поля ``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.
uk: ``default_value`` не використовується для полів title, title_sort, authors, 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.
uk: Повернутим значення для полів is_multiple завжди будуть кортежі, навіть якщо значень не буде знайдено (іншими словами, default_value буде проігноровано). Виключенням є ідентифікатори, для яких повернуте значення завжди буде словником. Кортежі, які буде повернуто, завжди упорядковуються за посиланнями, тобто порядком їхнього створення.

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.
uk: Повертає ідентифікатори (у форматі кортежу) для значень, які поле ``name`` містить для книги, що визначається ідентифікатором ``book_id``. Якщо значень немає, або немає такої книги, або немає такого поля, буде повернуто порожній кортеж.

en: Return True iff the specified field supports notes. If field is None return frozenset of all fields that support notes.
uk: Повертає 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`.
uk: Знаходить книги, набір авторів яких містить ``mi``, і які мають ту саму назву ``title`` (відповідність ``title`` встановлюється неточно). Див. також :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.
uk: Повертає дані формату електронної книги у форматі байтового рядка або «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.
uk: Якщо має значення True, дані формату електронної книги повертаються як файловий об’єкт. Зауважте, що файлових об’єкт належатиме до типу SpooledTemporaryFile. Отже, якщо ви хочете скопіювати формат до іншого файла, скористайтеся замість цієї функції функцією :meth:`copy_format_to` з міркувань швидкодії.

en: Copies the format file to a temp file and returns the path to the temp file
uk: Копіює файл формату до тимчасового файла і повертає шлях до тимчасового файла.

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)
uk: Якщо має значення 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`.
uk: Повертає абсолютний шлях до файла електронної книги формату `format`. Цим майже ніколи не варто користуватися, оскільки використання шкодить захисту потоків виконання цього програмного інтерфейсу. Замість цієї функції, скористайтеся :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()).
uk: У поточній версії використовується лише у списку calibredb, засобі перегляду, засобі редагування, compare_format для порівняння з початковим форматом, засобі відкриття файла за допомогою іншої програми, засобі пакетного редагування метаданих та у каталогах (через 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.
uk: Окрім засобів перегляду, відкриття за допомогою іншої програми та редагування книги, як здається авторові програми, жодна інша частина не виконує будь-яких дій із запису файла вхідних-вихідних даних із результатами цього виклику.

en: Return the hash of the specified format for the specified book. The kind of hash is backend dependent, but is usually SHA-256.
uk: Повертає хеш-суму вказаного формату вказаної книги. Тип модуля обробки для отримання сум може бути різним, але, зазвичай, це 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.
uk: Повертає шлях, розмір і mtime для вказаного формату вказаної книги. Вам не варто використовувати шлях, окрім безвихідних випадків, оскільки доступ до нього безпосередньо шкодить захисту виконання у потоках, який гарантується цим програмним інтерфейсом. Замість цієї функції, скористайтеся методом :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.
uk: Якщо має значення ``True``, використовуються кешовані значення. У інших випадках використовується повільний доступ до файлової системи. Кешовані значення можуть втрачати актуальність, якщо доступ до файлової системи здійснюється поза цим програмним інтерфейсом.

en: If ``True`` The max_size field of the database is updated for this book.
uk: Якщо має значення ``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.
uk: Повертає кортеж усіх форматів для вказаної книги. Якщо 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
uk: Повертає усі ідентифікатори записів для записів, з якими пов'язано нотатки у вказаному полі або усіх полях, якщо значенням 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 {}.
uk: Повертає усі посилання для усіх полів, які використано у книзі, на яку вказує ідентифікатор_книги. Якщо книги з вказаним ідентифікатором не існує, метод повертає {}.

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 {}.
uk: Приклад: нехай запис автора A містить посилання X, а запис автора B містить посилання Y, мітка S містить посилання F, а мітка T містить посилання G. Якщо книга 1 має автора A і мітку T, цей метод поверне {'authors':{'A':'X'}, 'tags':{'T', 'G'}}. Якщо автором книги 2 не є ні A, ні B, і вона не має міток, цей метод поверне {}.

en: the book id in question.
uk: ідентифікатор потрібної книги.

en: Returns
uk: Повертає

en: {field: {field_value, link_value}, ...  for all fields with a field_value having a non-empty link value for that book
uk: {поле: {значення_поля, значення_посилання}, ... для усіх полів, які містять значення_поля і непорожнє значення посилання для цієї книги

en: Used internally to implement the Tag Browser
uk: Для внутрішньої реалізації панелі перегляду міток

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.
uk: Отримати дані для назви `name`. Типово, повертає дані для усіх 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.
uk: Повертає прив’язку номерів ідентифікаторів до значень для вказаного поля. Поле має бути полем багато-одне або багато-багато, інакше буде надіслано повідомлення ValueError.

en: Return the set of book ids for which name has data.
uk: Повернути набір ідентифікаторів книг, для яких для вказаної назви є дані.

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.
uk: Повертає ідентифікатор запису для назви запису або None, якщо нічого не буде знайдено. Ця функція працює дуже повільно, якщо її використовують для декількох назв. Користуйтеся get_item_ids() або get_item_name_map(). Так само, пошук із врахуванням регістру символів є швидшим за пошук без його врахування.

en: Return a dict mapping item_name to the item id or None
uk: Повертає словник із прив'язкою 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`.
uk: Повертає назву запису для запису, вказаного за item_id, у вказаному полі. Див. також :meth:`get_id_map`.

en: Return mapping of item values to ids
uk: Повертає прив'язку значень запису до ідентифікаторів

en: Return a dictionary of links for the supplied field.
uk: Повернути словник посилань для наданого поля.

en: the lookup name of the field for which the link map is desired
uk: пошукова назва поля, для якого потрібна карта посилань

en: {field_value:link_value, ...} for non-empty links
uk: {значення_поля:значення_посилання, ...} для непорожніх посилань

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.
uk: Повертає метадані для книги, заданої 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.
uk: Повертає наступний індекс циклу для вказаного циклу, беручи до уваги різноманітні налаштування, які керують створенням наступного номера у книжковому циклі.

en: The series-like field (defaults to the builtin series column)
uk: Поле, яке подібне до поля циклу (типово, вбудований стовпчик циклу)

en: If True, returns a mapping of book_id to current series_index value instead.
uk: Якщо має значення 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
uk: Повертає словник, що містить дані і назву ресурсу або 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.
uk: Подібний до :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.
uk: Повертає прив’язку ідентифікатора до кількості використань для усіх значень вказаного поля, яке має бути полем багато-одне або багато-багато.

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`.
uk: Повертає True тоді і лише тоді, коли база даних містить запис із таким самим заголовком, що і у переданому об’єкті Metadata. При порівнянні не враховується регістр символів. Див. також :meth:`data_for_has_book`.

en: Return True iff the format exists on disk
uk: Повертає True, лише якщо формат існує на диску

en: Return True iff the specified book_id exists in the db
uk: Повертає True, лише якщо вказане значення ід_книги існує у базі даних

en: Import a previously exported note or an arbitrary HTML file as the note for the specified item
uk: Імпортує попередньо експортовану нотатку або довільний файл HTML як нотатку для вказаного запису

en: Initialize this cache with data from the backend.
uk: Ініціалізувати цей кеш даними від модуля обробки.

en: Return a dict of field to items that have associated notes for that field for the specified book
uk: Повертає словник прив'язки полів до записів, які мають пов'язані нотатки для відповідного поля для вказаної книги

en: Return the link, if any, for the specified item or None if no link is found
uk: Повертає посилання, якщо таке існує, для вказаного запису або None, якщо посилання не буде знайдено

en: Get information about extra files in the book's directory.
uk: Отримати відомості щодо додаткових файлів у каталозі книги.

en: the database book id for the book
uk: ідентифікатор книги у базі даних

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.
uk: взірець назв файлів, які слід шукати. Порожній взірець означає «усі додаткові файли». У взірцях слід використовувати роздільник «/». Скористайтеся сталою 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.
uk: Кортеж усіх додаткових файлів, що відповідають вказаному взірцю. Кожен елемент кортежу з записом ExtraFile(відн_шлях, шлях_до_файла, статистика), де «відн_шлях» є відносним шляхом до каталогу книги із роздільником /. «статистика» є результатом виклику os.stat() для файла.

en: Merge the specified annotations into the existing annotations for book_id, fm, user_type, and user.
uk: Об'єднати вказані анотації до наявних анотацій для вказаних ідентифікатор_книги, формат, тип_користувача і користувач.

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.
uk: Об'єднати додаткові файли з src_ids до dest_id. Файли з конфліктом назв буде автоматично перейменовано, якщо не вказано replace=True. Якщо ж вказано цей параметр, файли буде замінено.

en: Undelete a book from the trash directory
uk: Відновити книгу із каталогу смітника

en: Undelete a format from the trash directory
uk: Відновити формат із каталогу смітника

en: Return a list of sorted book ids. If ids_to_sort is None, all book ids are returned.
uk: Повертає список упорядкованих ідентифікаторів книг. Якщо 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.
uk: fields має бути списком двоелементних кортежів у формі (назва_поля, за_зростанням=True або False). Найбільше значення має перша двоелементна комбінація.

en: Return all notes data as a dict or None if note does not exist
uk: Повертає усі дані нотаток як словник або None, якщо жодної нотатки не існує

en: Return the notes document or an empty string if not found
uk: Повертає документ нотаток або порожній рядок, якщо документ не знайдено

en: Return the set of resource hashes of all resources used by the note for the specified item
uk: Повертає набір хешів ресурсів усіх ресурсів, які використано нотаткою, для вказаного запису

en: Return the value for the specified preference or the value specified as ``default`` if the preference is not set.
uk: Повертає значення вказаного налаштування або значення, вказане як ``default``, якщо налаштування не встановлено.

en: Return the OPF metadata backup for the book as a bytestring or None if no such backup exists.
uk: Повертає резервну копію метаданих 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.
uk: Вилучити книги, вказані за допомогою параметра book_ids з бази даних і вилучити відповідні файли форматів. Якщо значенням ``permanent`` є False, файли форматів надсилатимуться до окремої теки смітника бібліотеки.

en: Delete the specified extra files, either to Recycle Bin or permanently.
uk: Вилучити вказані зайві файли, до теки Смітника або остаточно.

en: Remove the specified formats from the specified books.
uk: Вилучити вказані формат із запису вказаних книг.

en: A mapping of book_id to a list of formats to be removed from the book.
uk: Прив’язка 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.
uk: Якщо має значення True, вилучити запис щодо формату лише з бази даних, не вилучати файл формату з файлової системи.

en: A map of book id to set of formats actually deleted from the filesystem for that book
uk: Карта ідентифікатора книги для встановлення форматів, які буде вилучено з файлової системи цієї книги

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.
uk: Вилучити усі записи у вказаному полі з вказаними ідентифікаторами. Повертає список оброблених ідентифікаторів книг. ``restrict_to_book_ids`` — необов’язковий набір ідентифікаторів книг. Якщо вказано такий набір, записи вилучатимуться лише із книг цього набору.

en: Rename extra data files
uk: Перейменування додаткових файлів даних

en: Rename items from a many-one or many-many field such as tags or series.
uk: Перейменувати записи з поля «багато-один» або «багато-багато», зокрема з полів міток або циклів.

en: When renaming in a series-like field also change the series_index values.
uk: Під час перейменування у полі, подібному до поля циклу, змінити значення series_index.

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

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

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.
uk: Відновити вказаний формат на основі раніше збереженого 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.
uk: Безпечною дією з блокування на читання є блокування, яке забороняє дії, якщо якщо потік вже має блокування на запис, інакше отримує блокування на читання. Це необхідно для запобігання 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.
uk: Ця властивість повертає новий об’єкт блокування під час кожного доступу. Цей об’єкт блокування не є рекурсивним (з міркувань швидкодії). Його слід використовувати лише у a з інструкцією ``with cache.safe_read_lock:``, інакше можливі небажані наслідки.

en: Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any existing ORIGINAL_FORMAT.
uk: Зберегти копію вказаного формату ORIGINAL_FORMAT, переписати усі наявні записи ORIGINAL_FORMAT.

en: Search the database for the specified query, returning a set of matched book ids.
uk: Виконати пошук у базі даних за вказаним запитом. Повертає набір ідентифікаторів відповідних до критерію пошуку книг.

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.
uk: Обмеження яке буде об’єднано логічним «І» із вказаним запитом. Зауважте, що обмеження кешуються, тому пошук «a І b» буде повільнішим за пошук «a» з обмеженням «b».

en: Used internally (virtual fields such as on_device to search over).
uk: Для внутрішнього використання (віртуальні поля, зокрема on_device, для пошуку).

en: If not None, a set of book ids for which books will be searched instead of searching all books.
uk: Якщо має значення, відмінне від None, пошук виконуватиметься для набору вказаних за допомогою ідентифікаторів книг, а не для усіх книг.

en: Return of a tuple of annotations matching the specified Full-text query.
uk: Повертає кортеж анотацій, які відповідають вказаному повнотекстовому запиту.

en: Search the text of notes using an FTS index. If the query is empty return all notes.
uk: Шукає у тексті нотаток за допомогою покажчика повнотекстового пошуку. Якщо запит є порожнім, повертає усі нотатки.

en: Set all annotations for the specified book_id, fmt, user_type and user.
uk: Встановити усі анотації для вказаних ідентифікатор_книги, формат, тип_користувача і користувач.

en: options must be a map of the form {book_id:conversion_options}
uk: параметри мають бути картою у формі {ід_книги:параметри_перетворення}

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.
uk: Встановити зображення обкладинки для цієї книги. Значенням data може бути 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.
uk: Встановлює значення для поля, вказаного за допомогою ``name``. Повертає набір усіх ідентифікаторів книг, на які впливає зміна.

en: Mapping of book_ids to values that should be applied.
uk: Прив’язка 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``.
uk: Якщо має значення True, регістр символів у полях багато-одне або багато-багато буде змінено. Наприклад, якщо у книги була мітка ``мітка1`` і ви встановили для іншої книги мітку ``Мітка1``, обидві книги отримають мітку ``Мітка1``, якщо allow_case_change має значення True, і мітку ``мітка1`` у іншому випадку.

en: Used internally, you should never change it.
uk: Використовується для внутрішніх потреб програми. Вам не варто змінювати цей параметр.

en: Sets links for item values in field. Note: this method doesn't change values not in the value_to_link_map
uk: Встановлює посилання для значень пунктів у полі Зауваження: цей метод не змінює значень поза карта_прив'язки_значення_ до_посилання

en: the lookup name
uk: назва фільтра

en: dict(field_value:link, ...). Note that these are values, not field ids.
uk: dict(значення_поля:посилання, ...). Зауважте, що це значення, а не ідентифікатори полів.

en: books changed by setting the link
uk: книги, які було змінено встановленням посилання

en: Set metadata for the book `id` from the `Metadata` object `mi`
uk: Встановлює метадані для книги з ідентифікатором `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.
uk: Встановлення значення force_changes=True наказує set_metadata оновити поля у примусовому порядку, навіть якщо mi містить порожні значення. У цьому випадку `None` відрізняється від `empty`. Якщо mi.XXX має значення None, XXX не буде замінено, а якщо ні, буде. Мітки, ідентифікатори і атрибути зображення є особливими випадками. Для міток та ідентифікаторів не можна встановлювати значення `None`, отже їх буде завжди замінено, якщо force_changes має значення True. Вам слід забезпечити наявність у 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.
uk: Встановлює документ нотаток. Якщо придатний до пошуку текст відрізняється від документа, вкажіть його як searchable_text. Якщо документ посилається на ресурси, їхні хеші мають бути у resource_hashes. Встановіть для remove_unused_resources значення True, щоб вилучити невикористані ресурси. Зауважте, що оновлення нотатки автоматично і безумовно вилучає ресурси, що стосуються цієї нотатки.

en: Set the specified preference to the specified value. See also :meth:`pref`.
uk: Встановити вказаний рівень пріоритетності. Див. також :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.
uk: Якщо 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.
uk: Повертає ідентифікатори усіх книг, які мають мітку ``tag`` і які є старішими за вказаний час. При порівнянні міток регістр символів не враховується.

en: A timedelta object or None. If None, then all ids with the tag are returned.
uk: Об’єкт timedelta або None. Якщо має значення None, буде повернуто усі ідентифікатори з вказаною міткою.

en: If not None the list of matches will be restricted to books that have this tag
uk: Якщо встановлено значення None, список відповідників буде обмежено до книг, які мають вказану мітку.

en: A list of authors. If not None the list of matches will be restricted to books that have these authors (case insensitive).
uk: Список авторів. Якщо не None, список відповідників буде обмежено до книг, авторами яких є вказані письменники (без врахування регістру символів).

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

en: Update annotations.
uk: Оновити анотації.

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.
uk: Повертає категорії користувача для вказаних книг. Параметр proxy_metadata_map є необов’язковим. Він корисний для пришвидшення обробки у контекстах, коли для книг вже існує об’єкт ProxyMetadata. Має повернути прив’язку book_ids до відповідних об’єктів ProxyMetadata.
