calibre - en to fr translation catalogue (142 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 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: 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: 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 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 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: 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: 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: 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 (case-insensitive) or None if not found
fr: Renvoie l'id élément pour item_name(insensible à la casse) ou None si non trouvé

en: Return the item id for item_name (case-insensitive)
fr: Renvoie l'id élément pour item_name(sensible à la casse)

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 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: 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: Initialize this cache with data from the backend.
fr: Initialiser ce cache avec des données depuis le système principal.

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 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 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: 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: 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 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: 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.
