calibre - en to fr translation catalogue (171 entries)

en: API documentation for the database interface
fr: Documentation API pour l'interface base de données

en: This API is thread safe (it uses a multiple reader, single writer locking scheme).  You can access this API like this::
fr: Cette API est un fil sûr (Elle utilise un lecteur multiple, un schéma rédacteur unique fermé). Vous pouvez accéder à cette API comme ceci :

en: If you are in a calibre plugin that is part of the main calibre GUI, you get access to it like this instead::
fr: Si vous êtes dans une extension calibre qui est partie prenante du GUI principal de calibre, vous y obtenez l'accès comme ceci à la place :

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.
fr: Un cache mémoire du fichier metadata.db depuis une bibliothèque calibre. Cette classe sert également comme une API de sécurité pour accéder à la base de données. Le cache mémoire est maintenu dans une forme normale pour une performance maximale.

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.
fr: SQLITE est simplement utilisée comme une manière robuste de lire et écrire depuis metadata.db. Toute table lecture/tri/recherche/cache est ré-implémentée. Ceci était nécessaire pour un maximum de performance et de flexibilité.

en: When a new book record is created in the database, with the book id as the only argument
fr: Lorsqu'un nouvel enregistrement de livre est créé dans la base de données, avec comme seul argument l'identifiant du livre

en: When a book format is edited, with arguments: (book_id, fmt)
fr: Lorsqu'un format de livre est édité, avec des arguments : (book_id, fmt)

en: When books are removed from the database with the list of book ids as the only argument
fr: Lorsque des livres sont retirés de la base de données avec la liste des identifiants de livres comme seul argument

en: When a format is added to a book, with arguments: (book_id, format)
fr: Lorsqu'un format est ajouté à un livre, avec les arguments : (book_id, format)

en: When formats are removed from a book, with arguments: (mapping of book id to set of formats removed from the book)
fr: Lorsque des formats sont retirés d'un livre, avec des arguments : (correspondance entre l'identifiant du livre et l'ensemble des formats supprimés du livre)

en: When the indexing progress changes
fr: Lorsque la progression de l'indexation change

en: When items such as tags or authors are removed from some books. Arguments: (field_name, affected book ids, ids of removed items)
fr: Lorsque des éléments tels que les étiquettes ou les auteurs sont supprimés de certains livres. Arguments : ( field_name, ids des livres concernés, ids des éléments supprimés)

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)
fr: Lorsque des éléments tels que les étiquettes ou les auteurs sont renommés dans certains ou tous les livres. Arguments : ( field_name, ids de livres concernés, mappage de l'ancien id d'élément vers le nouvel id d'élément)

en: When the links associated with items(s) are changed, with arguments: (field_name, item_ids)
fr: Lorsque les liens associés aux éléments sont modifiés, avec les arguments : (field_name, item_ids)

en: When some metadata is changed for some books, with arguments: (name of changed field, set of affected book ids)
fr: Lorsque certaines métadonnées sont modifiées pour certains livres, avec des arguments : (nom du champ modifié, ensemble d'identifiants de livres concernés)

en: When the notes associated with item(s) are changed, with arguments: (field_name, item_ids)
fr: Lorsque les notes associés aux éléments sont modifiés, avec les arguments : (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'}`.
fr: Ajouter les livres spécifiés à la bibliothèque. Les livres doivent être un itérable de 2-tuples, chaque 2-tuple sous la forme :code:`(mi, format_map)` où mi est un objet métadonnée et format_map est un dictionnaire de la forme :code:`{fmt: path_or_stream}`, par exemple : :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`.
fr: Renvoie une paire de listes : :code:`ids, duplicates`. ``ids`` contient les ids de livre pour tous les livres nouvellement créés dans la base de données. ``duplicates`` contient :code:`(mi, format_map)` pour tous les livres qui existent déjà dans la base de données  selon l'heuristique simple de détection de doublons utilisée par  :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.
fr: Ajouter les données pour le nom où val_map est une carte des book_ids vers les valeurs. Si delete_first est Vrai, toutes les données stockées précédemment seront supprimées.

en: Add extra data files
fr: Ajouter des fichiers de données supplémentaires

en: Add a format to the specified book. Return True if the format was added successfully.
fr: Ajouter un format au livre spécifié. Renvoie True si le format a été ajouté avec succès.

en: Parameters
fr: Paramètres

en: If True replace existing format, otherwise if the format already exists, return False.
fr: Si Vrai, remplace le format existant, autrement si le format existe déjà, renvoie Faux.

en: If True, file type plugins are run on the format before and after being added.
fr: Si Vrai, les extensions de type de fichier sont exécutées. dans le format avant et après avoir été ajoutées

en: Internal use only.
fr: Usage interne uniquement.

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)
fr: Enregistrer une fonction de rappel qui sera appelée après que certaines actions aient été effectuées sur cette base de données. La fonction doit prendre trois arguments : (: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
fr: Ajouter la ressource spécifiée afin qu'elle puisse être référencée par les notes et renvoyer le hash de contenu

en: Return a tuple of all annotation types in the database.
fr: Retourne un tuple de tous les types d'annotations dans la base de données.

en: Return a tuple of all (user_type, user name) that have annotations.
fr: Retourne un tuple de tous les (user_type, user name) qui ont des annotations.

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.
fr: Retourne un tuple de toutes les annotations correspondant aux critères spécifiés. `ignore_removed` contrôle si les annotations retirées (supprimées) sont également retournées. Les annotations supprimées ne sont qu'un squelette utilisé pour la fusion des annotations.

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.
fr: Retourne un tuple contenant toutes les annotations pour le book_id spécifié sous la forme d'un dict avec les clés : `format`, `user_type`, `user`, `annotation`. Ici, annotation est la donnée d'annotation.

en: Frozen set of all known book ids.
fr: Ensemble gelé de tous les ids de livre connus.

en: Same as field_for, except that it operates on multiple books at once
fr: Identique à field_for, excepté qu'il agit sur de multiples livres en une fois

en: Frozen set of ids for all values in the field ``name``.
fr: Ensemble gelé d'ids pour toutes les valeurs dans le champ``name``.

en: Frozen set of all fields names (should only be used for many-one and many-many fields)
fr: Ensemble gelé de tous les champs de noms (devrait uniquement être utilisé pour les champs many-one et many-many)

en: Return the number of annotations for the specified book available in the database.
fr: Renvoie le nombre d'annotations disponibles dans la base de données pour le livre spécifié.

en: Return a map of annotation type -> annotation data for the specified book_id, format, user and user_type.
fr: Renvoie une carte du type d'annotation -> données d'annotation pour le book_id, le format, l'utilisateur et le type d'utilisateur spécifiés.

en: Return author data as a dictionary with keys: name, sort, link
fr: Renvoie la donnée auteur comme un dictionnaire avec des clés : nom, genre, lien

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.
fr: Si aucuns auteurs avec les ids spécifiés ne sont trouvés un dictionnaire vide est renvoyé. Si author_ids est None, les données pour tous les auteurs sont renvoyées.

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.
fr: En fonction d'une liste d'auteurs, renvoie la chaîne author_sort pour les auteurs, en préférant l'auteur assorti associé à l'auteur plutôt que la chaîne calculée.

en: Return all the books associated with the item identified by ``item_id``, where the item belongs to the field ``name``.
fr: Renvoie tous les livres associés avec l'élément identifié par ``item_id``, où l'élément appartient au champ  ``name``.

en: Returned value is a set of book ids, or the empty set if the item or the field does not exist.
fr: La valeur retournée est un ensemble d'ids de livre, ou l'ensemble vide si l'élément n'existe pas.

en: Return the set of books in the specified virtual library
fr: Affiche l'ensemble des livres dans la bibliothèque virtuelle spécifiée

en: Compress the cover images for the specified books. A compression quality of 100 will perform lossless compression, otherwise lossy compression.
fr: Compresser les images de couverture des livres spécifiés. Une qualité de compression de 100 effectuera une compression sans perte, sinon la compression sera avec perte.

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.
fr: Le rappel d'avancement sera appelé avec le book_id et les anciens et nouveaux formats pour chaque livre qui a été traité. Si une erreur se produit, la nouvelle taille sera une chaîne de caractères contenant les détails de l'erreur.

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).
fr: Copier la couverture dans le fichier comme un objet ``dest``. Renvoie False si aucune couverture n'existe ou dest est le même fichier que la couverture actuelle. dest peut aussi être un chemin dans tel cas la couverture y est copiée si le chemin est différent du chemin actuel (prendre en compte la sensibilité à la casse).

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).
fr: Copier le format ``fmt`` dans le fichier comme un objet ``dest``. Si le format spécifié n'existe pas, indique l'erreur :class:`NoSuchFormat`. dest peut aussi être un chemin (vers un fichier) dans tel cas la couverture y est copiée si et seulement si le chemin est différent du chemin actuel (prendre en compte la sensibilité à la casse).

en: Return the cover image or None. By default, returns the cover as a bytestring.
fr: Renvoie l'image de couverture ou Aucun. Par défaut, renvoie la couverture comme une chaîne de caractères.

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.
fr: ATTENTION : l'utilisation de as_path copiera la couverture vers un fichier temporaire et renverra le chemin vers ce fichier temporaire. Vous devez supprimer le fichier temporaire quand vous en avez terminé avec celui-ci.

en: If True return the image as an open file object (a SpooledTemporaryFile)
fr: Si Vrai renvoie l'image en tant qu'objet fichier ouvert (une file d'attente de fichiers temporaires)

en: If True return the image as a QImage object
fr: Si vrai renvoie l'image comme un objet QImage

en: If True return the image as a QPixmap object
fr: Si True renvoie l'image comme un objet QPixmage

en: If True return the image as a path pointing to a temporary file
fr: Si vrai renvoie l'image comme un chemin pointant vers un fichier temporaire

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.
fr: Renvoie les données qui peuvent être utilisées pour implémenter :meth:`find_identical_books` dans un processus de travail sans accès à la bd. Voir db.utils pour une implémentation.

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.
fr: Renvoie les données appropriées pour être utilisées dans  :meth:`has_book`. Ceci peut être utilisé pour une implémentation de :meth:`has_book` dans un processus de travail sans accès à la bd.

en: Delete annotations with the specified ids.
fr: Supprime les annotations dont l'identifiant est spécifié.

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.
fr: Effacer les données pour le nom. Par défaut efface toutes les données, si vous voulez seulement effacer les données pour certaines ids de livres, passez dans une liste d'ids de livres.

en: Delete an entry from the trash. Here category is 'b' for books and 'f' for formats.
fr: Supprimer une entrée de la corbeille. Ici, la catégorie est 'b' pour les livres et 'f' pour les formats.

en: Update metadata in all formats of the specified book_ids to current metadata in the database.
fr: Mettre à jour les métadonnées pour tous les fomats du book_ids sélectionné vers les métadonnées actuelle dans la base de  données.

en: Expire entries from the trash that are too old
fr: Expirer les entrées trop anciennes de la corbeille

en: Export the note as a single HTML document with embedded images as data: URLs
fr: Exporter la note sous la forme d'un document HTML unique avec des images intégrées en tant que données : URL

en: Same as field_for, except that it avoids the extra lookup to get the field object
fr: Semblable à field_for, sauf qu'il évite la consultation supplémentaire pour obtenir l'objet du champ

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.
fr: Renvoie la valeur du champ ``name`` pour le livre identifié par ``book_id``. Si un tel livre n'existe pas ou s'il n'y a pas de valeur spécifiée pour le champ ``name` ou qu'un tel champ n'existe pas, alors ``default_value`` est renvoyée.

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.
fr: ``default_value`` n'est pas utilisée pour title, title_sort, authors, author_sort and series_index. C'est parce que ceux-ci ont toujours des valeurs dans la base de données. ``default_value`` est utilisée pour toutes les colonnes personnalisées.

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.
fr: La valeur renvoyée pour les champs is_multiple est toujours un tuples, même si aucune valeur n'est trouvée (en d'autres termes, default_value est ignoré). L'exception concerne les identificateurs, pour lesquels la valeur retournée est toujours un dictionnaire. Les tuples renvoyés sont toujours dans l'ordre des liens, c'est-à-dire l'ordre dans lequel ils ont été créés.

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.
fr: Renvoie les ids (en tant que tuples) pour les valeurs que le champ ``name`` à dans le livre identifié par ``book_id``. S'il n'y a pas de valeurs, ou pas de tel livre, ou pas de tel champ, un tuple vide est renvoyé.

en: Return True iff the specified field supports notes. If field is None return frozenset of all fields that support notes.
fr: Retourne True si le champ spécifié prend en charge les notes. Si le champ est None, il renvoie un ensemble de tous les champs qui supportent les notes.

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`.
fr: Trouve les livres qui ont un sur-ensemble d'auteurs dans mi et ont le même titre (titre est à correspondance floue). Voir aussi :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.
fr: Renvoie le format de livre numérique comme une chaîne de caractères ou  `None` si le format n'existe pas, ou que nous n'avons pas la permission d'écrire dans le fichier de livre numérique.

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.
fr: Si True le format de livre numérique est renvoyé comme un objet fichier. Notez que l'objet fichier est un fichier temporaire de file d'attente, aussi si ce que vous voulez faire est de copier le format sur un autre fichier, utilisez :meth:`copy_format_to` à la place pour la performance.

en: Copies the format file to a temp file and returns the path to the temp file
fr: Copie le format de fichier vers un fichier temporaire et renvoie le chemin vers le fichier temporaire

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)
fr: Si Vrai et renvoie un chemin le nom de fichier est le même que celui utilisé dans la bibliothèque. Notez qu’utiliser ceci signifie donner des appels répétés du même fichier temporaire (qui est recréé chaque fois)

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`.
fr: Renvoie le chemin absolu du fichier livre numérique du format `format`. Vous ne devriez presque jamais utiliser ceci, car compromet la promesse threadsafe de cette API. A la place utilisez, :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()).
fr: Actuellement utilisé uniquement dans la liste calibredb, la visionneuse, éditer le livre, compare_format au format original, Open With et les catalogues (via 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.
fr: A part depuis la visionneuse, open with et éditer le livre, je ne crois pas qu'aucun des autres ne fassent de fichier écriture I/O avec les résultats de cet appel.

en: Return the hash of the specified format for the specified book. The kind of hash is backend dependent, but is usually SHA-256.
fr: Renvoie le hash du format spécifié pour le livre spécifié. Le type de hash est dépendant du système principal, mais il est habituellement 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.
fr: Renvoie le chemin, la taille et mtime pour le format spécifié. Vous ne devriez presque jamais utiliser path à moins que vous n'en ayez absolument besoin, dès qu'il est accédé il compromet directement la promesse threadsafe de cette API. A la place utilisez la méthode :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.
fr: Si ``Vrai`` les valeurs en cache sont utilisées, autrement un accès lent au système de fichiers est fait. Le cache des valeurs peut être périmé si l'accès est effectué au système de fichier en dehors de cette API.

en: If ``True`` The max_size field of the database is updated for this book.
fr: Si ``Vrai`` Le champ max_size de la base de données est mis à jour pour ce livre.

en: Return tuple of all formats for the specified book. If verify_formats is True, verifies that the files exist on disk.
fr: Renvoie le tuple pour tous les formats du livre spécifié. Si verify_format est Vrai, vérifie que les fichiers existent sur le disque.

en: Return all item_ids for items that have notes in the specified field or all fields if field_name is None
fr: Retourne tous les item_ids pour les éléments qui ont des notes dans le champ spécifié ou pour tous les champs si field_name est 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 {}.
fr: Renvoie tous les liens pour tous les champs référencés par book_id. Si book_id n'existe pas, la méthode renvoie {}.

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 {}.
fr: Exemple : Supposons que l'auteur A ait un lien X, que l'auteur B ait un lien Y, que le tag S ait un lien F, et la balise T a un lien G. Si le livre 1 a un auteur A et une balise T, cette méthode renvoie {'authors':{'A':'X'}, 'tags':{'T', 'G'}}. Si l'auteur du livre 2 n'est ni A ni B et qu'il n'a pas d'étiquette, cette méthode renvoie {}.

en: the book id in question.
fr: l'identifiant du livre en question.

en: Returns
fr: Retours

en: {field: {field_value, link_value}, ...  for all fields with a field_value having a non-empty link value for that book
fr: {field: {field_value, link_value}, … pour tous les champs qui ont une valeur de lien non vide pour ce livre

en: Used internally to implement the Tag Browser
fr: Utilisé en interne pour implémenter le Navigateur d'Etiquettes

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.
fr: Donne les données pour le nom. Par défaut renvoie les données pour tous les book_ids, passez dans une liste d'ids de livre si vous voulez seulement quelques données. Renvoie un mappage du book_id à la valeur. Si une valeur particulière ne peut être décodée, utilise l'option par défaut pour celle-ci.

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.
fr: Renvoie un mappage des nombres id aux valeurs pour le champ spécifié. Le champ doit être un champ many-one ou many-many, autrement une ValueError est évoquée.

en: Return the set of book ids for which name has data.
fr: Renvoie un ensemble d'ids de livre pour lesquels le nom a des données.

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.
fr: Renvoie l'id de l'item correspondant a item_name ou None s'il n'est pas trouvé. Cette fonction est très lente si vous effectuez des recherches pour plusieurs noms, utilisez get_item_ids() ou get_item_name_map(). De même, les recherches sensibles à la casse sont plus rapides que les recherches insensibles à la casse.

en: Return a dict mapping item_name to the item id or None
fr: Retourne un dict qui associe item_name à l'identifiant ou None

en: Return the item name for the item specified by item_id in the specified field. See also :meth:`get_id_map`.
fr: Renvoie le nom d'élément pour l'élément spécifié par item_id dans le champ spécifié. Voir aussi :meth:`get_id_map`.

en: Return mapping of item values to ids
fr: Renvoi un mapping entre les valeurs des éléments et leurs ids

en: Return a dictionary of links for the supplied field.
fr: Renvoie un dictionnaire de liens pour le champ fourni.

en: the lookup name of the field for which the link map is desired
fr: le nom du champ pour lequel la carte de liens est souhaitée

en: {field_value:link_value, ...} for non-empty links
fr: {field_value:link_value, …} pour les liens non vides

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.
fr: Renvoie les métadonnées pour le livre identifié par book_id comme un un objet :class:`calibre.ebooks.metadata.book.base.Metadata` . Notez que la liste des formats n'est pas vérifiée. Si get_cover est True, la couverture est retournée, soit un chemin au fichier temporaire comme mi.cover ou si cover_as_date est True comme 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.
fr: Renvoie les index de séries suivants pour les séries spécifiées, prendre en compte les préférences variées qui contrôlent la génération du numéro suivant de séries.

en: The series-like field (defaults to the builtin series column)
fr: Le champ series-like (par défaut à la colonne séries intégrées)

en: If True, returns a mapping of book_id to current series_index value instead.
fr: Si Vrai, renvoie à la place un mappage de book_id à l'actuelle valeur series_index.

en: Return a dict containing the resource data and name or None if no resource with the specified hash is found
fr: Retourne un dict contenant les données et le nom de la ressource ou None si aucune ressource avec le hash spécifié n'est trouvée

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.
fr: Semblable à :meth:`get_metadata` excepté qu'il renvoie un objet ProxyMedadata qui lit uniquement les valeurs depuis la base de données à la demande. Ceci est beaucoup plus rapide que get_metadata quand seulement un petit nombre de champs ont besoin d'être accédés depuis l'objet métadonnées renvoyé.

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.
fr: Renvoie un mappage de l'id au compte d'utilisation pour toutes les valeurs du champ spécifié, qui doit être un champ many-one ou many-many.

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`.
fr: Renvoie True si et seulement si la base de donnée contient une entrée avec le même titre que l'objet Metadata transmis. La comparaison est sensible à la casse. Voir aussi :meth:`data_for_has_book`.

en: Return True iff the format exists on disk
fr: Renvoie Vrai si et seulement si le format existe sur le disque

en: Return True iff the specified book_id exists in the db
fr: Renvoie Vrai si et seulement si le book_id spécifié existe dans la base de données.

en: Import a previously exported note or an arbitrary HTML file as the note for the specified item
fr: Importer une note précédemment exportée ou un fichier HTML arbitraire en tant que note pour l'élément spécifié

en: Initialize this cache with data from the backend.
fr: Initialiser ce cache avec des données depuis le système principal.

en: Return a dict of field to items that have associated notes for that field for the specified book
fr: Retourne un dict de champs des éléments qui ont des notes associées à ce champ pour le livre spécifié.

en: Return the link, if any, for the specified item or None if no link is found
fr: Renvoie le lien, s'il y en a un, pour l'élément spécifié ou None si aucun lien n'est trouvé

en: Get information about extra files in the book's directory.
fr: Obtenir des informations sur les fichiers supplémentaires dans le répertoire du livre

en: the database book id for the book
fr: l'identifiant de livre dans la base de données pour ce livre

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.
fr: le modèle de noms de fichiers à rechercher. Le modèle vide correspond à tous les fichiers supplémentaires. Les modèles doivent utiliser / comme séparateur. Utilisez la constante DATA_FILE_PATTERN pour faire correspondre les fichiers à l'intérieur du répertoire de données.

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.
fr: Un n-uplet de tous les fichiers supplémentaires correspondant au modèle spécifié. Chaque élément du tuple est ExtraFile(relpath, file_path, stat_result). Où relpath est le chemin relatif du fichier vers le répertoire du livre en utilisant / comme séparateur. stat_result est le résultat de l'appel à os.stat() sur le fichier.

en: Merge the specified annotations into the existing annotations for book_id, fm, user_type, and user.
fr: Fusionner les annotations spécifiées avec les annotations existantes pour book_id, fm, user_type et 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.
fr: Fusionnez les fichiers supplémentaires de src_ids dans dest_id. Les fichiers en conflit sont renommés automatiquement sauf si replace=True auquel cas ils sont remplacés.

en: Undelete a book from the trash directory
fr: Annuler la suppression d'un livre dans le répertoire de la corbeille

en: Undelete a format from the trash directory
fr: Annuler la suppression d'un format dans le répertoire de la corbeille

en: Return a list of sorted book ids. If ids_to_sort is None, all book ids are returned.
fr: Renvoie une liste des ids de livre triés. Si ids_to_sort est Aucun, tout les ids de livre sont retournés.

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.
fr: les champs doivent être une liste de 2-tuples de la forme (field_name, ascending = True ou False). Le champ le plus important est le 2-tuple.

en: Return all notes data as a dict or None if note does not exist
fr: Retourne toutes les données des notes sous forme de dict ou None si la note n'existe pas

en: Return the notes document or an empty string if not found
fr: Retourne le document de notes ou une chaîne vide s'il n'est pas trouvé

en: Return the set of resource hashes of all resources used by the note for the specified item
fr: Retourne l'ensemble des hachages de toutes les ressources utilisées par la note pour l'élément spécifié

en: Return the value for the specified preference or the value specified as ``default`` if the preference is not set.
fr: Renvoie la valeur pour la préférence spécifiée ou la valeur spécifiée comme étant ``par défaut`` si la préférence n'est pas paramétrée.

en: Return the OPF metadata backup for the book as a bytestring or None if no such backup exists.
fr: Renvoie la sauvegarde des métadonnées OPF comme une chaîne de caractères ou Aucun si une telle sauvegarde n'existe pas.

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.
fr: Supprimer de la base de données les livres spécifiés par les book_ids et effacer leurs formats de fichier . Si ``permanent`` est à False, alors les formats de fichiers sont placés dans la corbeille de la bibliothèque.

en: Delete the specified extra files, either to Recycle Bin or permanently.
fr: Supprime les fichiers supplémentaires spécifiés, soit dans la corbeille, soit de manière permanente.

en: Remove the specified formats from the specified books.
fr: Supprimer les formats spécifiés des livres spécifiés.

en: A mapping of book_id to a list of formats to be removed from the book.
fr: Un mappage de book_id à une liste de formats à supprimer du livre.

en: If True, only remove the record for the format from the db, do not delete the actual format file from the filesystem.
fr: Si Vrai, retirer uniquement l'enregistrement pour le format de la base de données, n'efface pas le fichier de format actuel du système de fichiers.

en: A map of book id to set of formats actually deleted from the filesystem for that book
fr: Une correspondance entre l'identifiant du livre et l'ensemble des formats effectivement supprimés du système de fichiers pour ce livre.

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.
fr: Supprimer tous les éléments dans le champ spécifié avec les ids spécifiés. Renvoie l'ensemble des ids de livres affectés. ``restrict_to_book_ids`` est un ensemble optionnel d'ids de livres. Si spécifié les éléments seront uniquement supprimés de ces livres.

en: Rename extra data files
fr: Renommer des fichiers de données supplémentaires

en: Rename items from a many-one or many-many field such as tags or series.
fr: Renommer les éléments d'un champ many-one ou many-many comme étiquettes ou séries.

en: When renaming in a series-like field also change the series_index values.
fr: Lors du renommage d'un champ series-like change aussi les valeurs series_index.

en: An optional set of book ids for which the rename is to be performed, defaults to all books.
fr: Un ensemble optionnel d'ids de livres pour lesquels le renommage est effectué, par défaut à tous les livres.

en: Restore the book entry in the database for a book that already exists on the filesystem
fr: Restaure l'entre du livre dans la base de données pour un livre qui existe déjà dans le système de fichiers.

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.
fr: Restaure le format spécifié à partir du ORIGINAL_FORMAT précédemment sauvé, s'il y en a. Renvoie Vrai en cas de réussite. Le ORIGINAL_FORMAT est supprimé après une restauration réussie.

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.
fr: Un verrou en lecture sûr qui ne fait rien si le thread à déjà un verrou en écriture, autrement il acquiert un verrou en lecture.Ceci est nécessaire pour prévenir les DowngradeLockErrors, qui peuvent survenir quand on met à jour le cache de  recherche en la présence de colonnes composées. Mettre à jour le cache de recherche préserve un verrou exclusif, mais la recherche d'une colonne composée implique de lire des valeurs de champ par l'intermédiaire de ProxyMetadata qui essaye d'obtenir un verrou partagé. Il peut y avoir d'autres scénarios qui déclenchent ceci également.

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.
fr: Cette propriété renvoie un nouvel objet verrou  à chaque accès. Cet objet verrou n'est pas récursif (pour la performance) et doit être uniquement utilisé dans une déclaration with comme ``with cache.safe_read_lock:`` autrement de mauvaises choses peuvent survenir.

en: Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any existing ORIGINAL_FORMAT.
fr: Sauver une copie du format spécifié comme ORIGINAL_FORMAT, écrase tout ORIGINAL_FORMAT existant.

en: Search the database for the specified query, returning a set of matched book ids.
fr: Rechercher dans la base de données pour la requête spécifiée, en renvoyant un ensemble d'ids de livre correspondants.

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.
fr: Une restriction qui est ANDed à la requête spécifique. Notez que ces restrictions sont en cache, dès lors une recherche pour a AND b plus lente que celle avec une restriction b.

en: Used internally (virtual fields such as on_device to search over).
fr: Utilisé en interne (champs virtuels tels que on_device pour y faire une recherche)

en: If not None, a set of book ids for which books will be searched instead of searching all books.
fr: Si n'est pas Aucun, un ensemble d'ids de livre pour les livres sera recherché à la place de rechercher tous les livres.

en: Return of a tuple of annotations matching the specified Full-text query.
fr: Retour d'un tuple d'annotations correspondant à la requête en texte intégral spécifiée.

en: Search the text of notes using an FTS index. If the query is empty return all notes.
fr: Recherche dans le texte des notes à l'aide d'un index FTS. Si la requête est vide, le système renvoie toutes les notes.

en: Set all annotations for the specified book_id, fmt, user_type and user.
fr: Définit toutes les annotations pour le book_id, le fmt, le user_type et l'utilisateur spécifiés.

en: options must be a map of the form {book_id:conversion_options}
fr: les options doivent être une carte de la forme {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.
fr: Paramétrer la couverture pour ce livre. Les données peuvent être soit une QImage, une QPixmap, un objet fichier ou une chaîne de caractères. Elles peuvent être aussi Aucun, dans quel cas toute couverture existante sera supprimée.

en: Set the values of the field specified by ``name``. Returns the set of all book ids that were affected by the change.
fr: Paramétrer les valeurs du champ spécifié par ``name``. Renvoie l'ensemble de tous les ids de livre affectés par le changement.

en: Mapping of book_ids to values that should be applied.
fr: Mappage des book_ids aux valeurs qui devraient être appliquées.

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``.
fr: Si Vrai, la casse des champs many-one ou many-many sera changée. Par exemple, si un livre à l'étiquette ``tag1`` et que vous paramétrez l'étiquette pour un autre livre à ``Tag1`` alors les deux livres ont l'étiquette ``Tag1`` si allow_case_change est Vrai, autrement ils ont tous les deux l'étiquette ``tag1``.

en: Used internally, you should never change it.
fr: Utilisé en interne, vous ne devriez jamais le changer.

en: Sets links for item values in field. Note: this method doesn't change values not in the value_to_link_map
fr: Définit les liens pour les valeurs des éléments dans le champ. Remarque : cette méthode ne modifie pas les valeurs qui ne figurent pas dans le value_to_link_map

en: the lookup name
fr: le nom recherché

en: dict(field_value:link, ...). Note that these are values, not field ids.
fr: dict(field_value:link, …). Notez qu'il s'agit de valeurs et non d'identifiants de champ.

en: books changed by setting the link
fr: livres modifiés en définissant le lien

en: Set metadata for the book `id` from the `Metadata` object `mi`
fr: Paramétrer les métadonnées pour le livre `id` depuis l'objet `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.
fr: En réglant force_changes=True forcera set_metadata à mettre à jour les champs même si mi contient des valeurs vides. Dans ce cas, 'Aucun' est distingué de 'vide'. Si mi.XXX est Aucun, le XXX n'est pas remplacé, autrement il l'est. Les étiquettes, identifiants, et attributs de couverture sont des cas spéciaux. Étiquettes et identifiants ne peuvent  être paramétrés à Aucun aussi seront-ils toujours remplacés si force_change est Vrai. Vous devez vous assurer que mi contient les valeurs que vous voulez que le livre ait.. Les couvertures sont toujours changées si une nouvelle couverture est procurée, mais ne sont jamais supprimées. Aussi notez que force_changes n'a pas d'effet sur les réglages titre ou auteurs.

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.
fr: Définir le document de notes. Si le texte consultable est différent du document, indiquez-le dans searchable_text. Si le document fait référence à des ressources, leurs hachages doivent être présents dans resource_hashes. Définissez remove_unused_resources à True pour nettoyer les ressources inutilisées. Notez que la mise à jour d'une note nettoie automatiquement les ressources relatives à cette note de toute façon.

en: Set the specified preference to the specified value. See also :meth:`pref`.
fr: Paramétrer la préférence spécifiée à la valeur spécifiée. Voir aussi :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.
fr: Si f est une clé de recherche de colonne composite et que la colonne est is_multiple, diviser v en valeurs uniques et non vides. La comparaison est sensible à la casse. L'ordre n'est pas préservé. Retourne une list() pour des raisons de compatibilité avec les getters des champs de proxy metadata , par exemple les tags.

en: Return the ids of all books having the tag ``tag`` that are older than the specified time. tag comparison is case insensitive.
fr: Renvoie les ids de tous les livres ayant l'étiquette ``tag`` qui sont plus anciennes que le moment spécifié, la comparaison d'étiquette est insensible à la casse.

en: A timedelta object or None. If None, then all ids with the tag are returned.
fr: Un objet timedelta ou Aucun. Si Aucun, alors tous les ids avec l'étiquette sont retournées.

en: If not None the list of matches will be restricted to books that have this tag
fr: Si pas Aucun la liste des correspondances sera restreinte aux livres qui ont cette étiquette

en: A list of authors. If not None the list of matches will be restricted to books that have these authors (case insensitive).
fr: Une liste d'auteurs. Si pas Aucun la liste des correspondances sera restreinte aux livres qui ont ces auteurs (insensible à la casse).

en: Unretire a previously retired note for the specified item. Notes are retired when an item is removed from the database
fr: Annule une note précédemment retirée pour l'élément spécifié. Les notes sont retirées lorsqu'un élément est supprimé de la base de données

en: Update annotations.
fr: Mettre à jour les annotations.

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.
fr: Retourne les catégories utilisateur pour les livres spécifiés. proxy_metadata_map est optionnel et est utile pour une amélioration de la performance, dans les contextes où un objet ProxyMetadata pour les livres existe déjà. Il devrait être une cartographie des book_ids à leurs objets correspondants ProxyMetadata.
