calibre - en to fr_CA translation catalogue (389 entries)

en: API documentation for plugins
fr_CA: Documentation API pour les extensions

en: Defines various abstract base classes that can be subclassed to create powerful plugins. The useful classes are:
fr_CA: Définit différentes classes abstraites de base qui peuvent être sous-classées pour créer de puissantes extensions. Les classes utiles sont :

en: Plugin
fr_CA: Extension

en: A calibre plugin. Useful members include:
fr_CA: Une extension calibre. Les membres utiles incluent:

en: ``self.installation_type``: Stores how the plugin was installed.
fr_CA: ``self.installation_type`` : Enregistre la façon dont le plugin a été installé.

en: ``self.plugin_path``: Stores path to the ZIP file that contains
fr_CA: ``self.plugin_path`` : Enregistre le chemin vers le fichier ZIP le contenant

en: this plugin or None if it is a builtin plugin
fr_CA: cette extension ou None si c'est une extension intégrée

en: ``self.site_customization``: Stores a customization string entered
fr_CA: ``self.site_customization``: Enregistre une chaîne de personnalisation introduite

en: by the user.
fr_CA: par l'utilisateur.

en: Methods that should be overridden in sub classes:
fr_CA: Les méthodes qui devraient être annulées dans les sous-classes :

en: Useful methods:
fr_CA: Méthodes utiles :

en: List of platforms this plugin works on. For example: ``['windows', 'osx', 'linux']``
fr_CA: Liste des plateformes où fonctionne cette extension. Par exemple ``['windows', 'osx', 'linux']``

en: The name of this plugin. You must set it something other than Trivial Plugin for it to work.
fr_CA: Le nom de cette extension. Vous devez le fixer à autre chose que Trivial Plugin pour que cela fonctionne.

en: The version of this plugin as a 3-tuple (major, minor, revision)
fr_CA: La version de cette extension en tant que 3-tuple (majeure, mineure, révision)

en: A short string describing what this plugin does
fr_CA: Une courte chaine décrivant ce que fait l'extension

en: The author of this plugin
fr_CA: L'auteur de cette extension

en: When more than one plugin exists for a filetype, the plugins are run in order of decreasing priority. Plugins with higher priority will be run first. The highest possible priority is ``sys.maxsize``. Default priority is 1.
fr_CA: Quand plus d'une extension existe pour un type de fichier, les extensions sont exécutées dans l'ordre de priorité décroissant. Les extensions avec la priorité la plus haute seront exécutées en premier. La priorité la plus haute possible est ``sys.maxsize``. La priorité par défaut est de 1.

en: The earliest version of calibre this plugin requires
fr_CA: La version la plus récente de calibre que nécessite cette extension

en: The way this plugin is installed
fr_CA: La façon dont ce plugin est installé

en: If False, the user will not be able to disable this plugin. Use with care.
fr_CA: Si False, l'utilisateur ne pourra pas désactiver cette extension. À utiliser avec soin.

en: The type of this plugin. Used for categorizing plugins in the GUI
fr_CA: Le type de cette extension. Utilisé pour catégorisé les extensions dans le GUI

en: Called once when calibre plugins are initialized.  Plugins are re-initialized every time a new plugin is added. Also note that if the plugin is run in a worker process, such as for adding books, then the plugin will be initialized for every new worker process.
fr_CA: Appelé une fois lorsque les extensions calibre sont initialisées. Les extensions sont ré-initialisées à chaque fois qu'une nouvelle extension est ajoutée. Notez également que si l'extension est en exécution dans un processus de travail, tel que pour ajouter des livres, alors l'extension sera initialisée pour tout nouveau processus de travail.

en: Perform any plugin specific initialization here, such as extracting resources from the plugin ZIP file. The path to the ZIP file is available as ``self.plugin_path``.
fr_CA: Effectuer n'importe quel initialisation spécifique d'extension ici, comme l'extraction de ressource à partir du fichier ZIP de l'extension. Le chemin vers le ZIP est disponible comme ``self.plugin_path``.

en: Note that ``self.site_customization`` is **not** available at this point.
fr_CA: Notez que ``self.site_customization`` n'est **pas** disponible à ce point-ci.

en: Implement this method and :meth:`save_settings` in your plugin to use a custom configuration dialog, rather then relying on the simple string based default customization.
fr_CA: Implémenter cette méthode et :meth:`save_settings` dans votre extension pour utiliser une boîte de dialogue de configuration personnalisée, plutôt que d'utiliser la simple personnalisation par ligne par défaut.

en: This method, if implemented, must return a QWidget. The widget can have an optional method validate() that takes no arguments and is called immediately after the user clicks OK. Changes are applied if and only if the method returns True.
fr_CA: Cette méthode, si implémentée, doit retourner un QWidget. Le widget peut avoir une méthode optionnelle validate() qui ne prend pas d'argument et qui est appelée dès que l'utilisateur clique sur OK.  Les changements sont appliqués si et seulement si la méthode retourne True.

en: If for some reason you cannot perform the configuration at this time, return a tuple of two strings (message, details), these will be displayed as a warning dialog to the user and the process will be aborted.
fr_CA: Si pour une raison quelconque, vous ne pouvez pas réaliser la configuration à ce moment, renvoie un tuple de deux chaines (message, détails), qui seront affichés comme un dialogue d'alerte à l'utilisateur et le processus sera interrompu.

en: Save the settings specified by the user with config_widget.
fr_CA: Sauve les paramètres spécifiés par l'utilisateur avec config_widget

en: Parameters
fr_CA: Paramètres

en: The widget returned by :meth:`config_widget`.
fr_CA: Le widget renvoyé par :meth:`config_widget`.

en: This method shows a configuration dialog for this plugin. It returns True if the user clicks OK, False otherwise. The changes are automatically applied.
fr_CA: Cette méthode montre une boîte de dialogue de configuration pour cette extension. Elle renvoie True si l'utilisateur clique OK, sinon False. Les changements sont appliqués automatiquement.

en: If this plugin comes in a ZIP file (user added plugin), this method will allow you to load resources from the ZIP file.
fr_CA: Si cette extension est donnée dans un fichier ZIP (extension ajoutée par l'utilisateur), cette méthode vous permettra de charger des ressources du fichier ZIP.

en: For example to load an image::
fr_CA: Par exemple pour charger une image ::

en: List of paths to resources in the ZIP file using / as separator
fr_CA: Liste de chemins vers les ressources dans le ZIP utilisant / comme séparateur

en: Returns
fr_CA: Retours

en: A dictionary of the form ``{name: file_contents}``. Any names that were not found in the ZIP file will not be present in the dictionary.
fr_CA: Un dictionnaire sous la forme ``{name : file_contents}``. Tout nom qui n'est pas trouvé dans le fichier ZIP ne sera pas présent dans le dictionnaire.

en: Return a string giving help on how to customize this plugin. By default raise a :class:`NotImplementedError`, which indicates that the plugin does not require customization.
fr_CA: Retourne une chaîne offrant de l'aide sur comment personnalisé cette extension. Par défaut avance un :class:`NotImplementedError`, qui indique que l'extension ne nécessite pas de personnalisation.

en: If you re-implement this method in your subclass, the user will be asked to enter a string as customization for this plugin. The customization string will be available as ``self.site_customization``.
fr_CA: Si vous ré-implémentez cette méthode dans votre sous-classe, il sera demandé à l'utilisateur d'entrer une chaîne pour personnalisé cette extension. La chaîne de personnalisation sera disponible comme ``self.site_customization``.

en: Site customization could be anything, for example, the path to a needed binary on the user's computer.
fr_CA: La personnalisation de site peut-être n'importe quoi, par exemple, le chemin vers un binaire nécessaire sur l'ordinateur de l'utilisateur.

en: If True return HTML help, otherwise return plain text help.
fr_CA: Si True renvoie l'aide HTML, sinon renvoie l'aide en texte simple.

en: Return a file-like object that is a temporary file on the file system. This file will remain available even after being closed and will only be removed on interpreter shutdown. Use the ``name`` member of the returned object to access the full path to the created temporary file.
fr_CA: Renvoie un objet ressemblant à un fichier qui est un fichier temporaire dans les fichiers systèmes. Ce fichier reste disponible après avoir été fermé et sera supprimé uniquement après l'extinction de l'interpréteur. Utilisé le membre ``name`` de l'objet renvoyé pour accéder au chemin complet vers le fichier temporaire créé.

en: The suffix that the temporary file will have.
fr_CA: Le suffixe qu'aura le fichier temporaire.

en: This method is the main entry point for your plugins command line interface. It is called when the user does: calibre-debug -r "Plugin Name". Any arguments passed are present in the args variable.
fr_CA: Cette méthode est le point d'entrée principal pour les interfaces d'extensions en ligne de commande. Elle est appelée lorsque l'utilisateur fait: calibre-debug -r "Nom de l'Extension". Tous les arguments sont présents dans les variables args.

en: Bases: :py:class:`~calibre.customize.Plugin`
fr_CA: Les bases: :py:class:`~calibre.customize.Plugin`

en: A plugin that is associated with a particular set of file types.
fr_CA: Une extension qui est associée à un ensemble particulier de types de fichiers.

en: Set of file types for which this plugin should be run. Use '*' for all file types. For example: ``{'lit', 'mobi', 'prc'}``
fr_CA: Ensemble de types de fichiers pour lesquels cette extension devrait fonctionner. Utilisez '*' pour tous les types de fichiers. Par exemple : ``{'lit', 'mobi', 'prc'}``

en: If True, this plugin is run when books are added to the database
fr_CA: Si True, cette extension est exécutée lorsque des livres sont ajoutés à la base de donnée

en: If True, this plugin is run after books are added to the database. In this case the postimport and postadd methods of the plugin are called.
fr_CA: Si réglé sur True, cette extension est exécutée après que des livres aient été ajoutés à la base de donnée. Dans ce cas, les méthodes postimport et postadd de l'extension sont appelées.

en: If True, this plugin is run just before a conversion
fr_CA: Si True, cette extension est exécutée juste avant une conversion

en: If True, this plugin is run after conversion on the final file produced by the conversion output plugin.
fr_CA: Si True, cette extension est exécutée après conversion sur le fichier final produit par l'extension de conversion de sortie.

en: Run the plugin. Must be implemented in subclasses. It should perform whatever modifications are required on the e-book and return the absolute path to the modified e-book. If no modifications are needed, it should return the path to the original e-book. If an error is encountered it should raise an Exception. The default implementation simply return the path to the original e-book. Note that the path to the original file (before any file type plugins are run, is available as self.original_path_to_file).
fr_CA: Exécute l'extension. Doit être implémenté dans les sous-classes. Cela devrait effectuer n'importe quelles modifications requises sur le livre numérique et renvoyer le chemin absolu vers le livre numérique modifié. Si aucune modifications ne sont nécessaire, cela devrait renvoyer le chemin vers le livre numérique original. Si une erreur est rencontrée, cela devrait amener une Exception. L'implémentation par défaut retourne simplement le chemin vers le livre numérique original. Notez que le chemin vers le fichier original (avant que n'importe quelle extension type de fichier ne soit exécutée, est disponible comme ceci self.original_path_to_file).

en: The modified e-book file should be created with the :meth:`temporary_file` method.
fr_CA: Le livre numérique modifié devrait être créer avec la méthode :meth:`temporary_file`.

en: Absolute path to the e-book.
fr_CA: Chemin absolu vers le livre numérique.

en: Absolute path to the modified e-book.
fr_CA: Chemin absolu vers le livre numérique modifié.

en: Called post import, i.e., after the book file has been added to the database. Note that this is different from :meth:`postadd` which is called when the book record is created for the first time. This method is called whenever a new file is added to a book record. It is useful for modifying the book record based on the contents of the newly added file.
fr_CA: post import est appelée, c-à-d après que le fichier de livre ait été ajouté à la base de donnée. Notez que ceci est différent de :meth:`postadd` qui est appelée lorsque les données du livre sont créées pour la première fois. Cette méthode est appelée à chaque fois qu'un nouveau fichier est ajouté à un livre enregistré. Elle est utile pour modifier les données du livre se basant sur le contenu du fichier nouvellement ajouté.

en: Database id of the added book.
fr_CA: L'id du livre ajouté dans la base de donnée.

en: The file type of the book that was added.
fr_CA: Le type de fichier du livre qui a été ajouté.

en: Library database.
fr_CA: Base de donnée de la bibliothèque.

en: Called post add, i.e. after a book has been added to the db. Note that this is different from :meth:`postimport`, which is called after a single book file has been added to a book. postadd() is called only when an entire book record with possibly more than one book file has been created for the first time. This is useful if you wish to modify the book record in the database when the book is first added to calibre.
fr_CA: post add est appelée, c-à-d après qu'un livre ait été ajouté à la base de donnée. Notez que ceci est différent de :meth:`postimport`, qui est appelée lorsque un fichier de livre est ajouté à un livre existant. postadd() est appelée uniquement lorsqu'un dossier entier de livre avec éventuellement plus d'un fichier de livre a été créé pour la première fois. Ceci est utile si vous souhaitez modifier les données d'un livre dans la base de donnée lorsque le livre est initialement ajouté à calibre.

en: Map of file format to path from which the file format was added. Note that this might or might not point to an actual existing file, as sometimes files are added as streams. In which case it might be a dummy value or a non-existent path.
fr_CA: Le chemin de l'emplacement du format du fichier à partir duquel le format a été ajouté. Notez que ceci pourrait ne pas indiquer un fichier existant, vu que parfois certains fichier sont ajoutés en tant que flux. Dans ce cas on pourrait avoir une valeur fausse ou un chemin inexistant.

en: Library database
fr_CA: Base de donnée de la bibliothèque

en: Metadata plugins
fr_CA: Les extensions métadonnées

en: A plugin that implements reading metadata from a set of file types.
fr_CA: Une extension qui implémente les métadonnées de lecture à partir d'un ensemble de types de fichier.

en: Set of file types for which this plugin should be run. For example: ``set(['lit', 'mobi', 'prc'])``
fr_CA: Ensemble de types de fichier pour lesquels l'extension devrait être exécutée. Par exemple : ``set(['lit', 'mobi', 'prc'])``

en: Return metadata for the file represented by stream (a file like object that supports reading). Raise an exception when there is an error with the input data.
fr_CA: Renvoie les métadonnées pour le fichier représenté par le flux (un objet-fichier qui supporte la lecture). Renvoie une exception lorsqu'il y a une erreur avec les données d'entrée.

en: The type of file. Guaranteed to be one of the entries in :attr:`file_types`.
fr_CA: Le type de fichier. Garanti d'être l'une des entrées dans :attr:`file_types`.

en: A :class:`calibre.ebooks.metadata.book.Metadata` object
fr_CA: Un objet :class:`calibre.ebooks.metadata.book.Metadata`

en: Set metadata for the file represented by stream (a file like object that supports reading). Raise an exception when there is an error with the input data.
fr_CA: Règle les métadonnées pour le fichier représenté par le flux (un objet-fichier qui supporte la lecture). Renvoie une exception lorsqu'il y a une erreur avec les données d'entrée.

en: Catalog plugins
fr_CA: Extension de catalogue

en: A plugin that implements a catalog generator.
fr_CA: Une extension qui implémente un générateur de catalogue.

en: Output file type for which this plugin should be run. For example: 'epub' or 'xml'
fr_CA: Le type de fichier de sortie pour lesquels l'extension devrait être exécutée. Par exemple : 'epub' ou 'xml'

en: CLI parser options specific to this plugin, declared as `namedtuple` `Option`:
fr_CA: Les options d'analyseur de CLI spécifiques pour cette extension, déclarée en tant qu'`Option` `namedtuple`::

en: If plugin is not a built-in, copy the plugin's .ui and .py files from the ZIP file to $TMPDIR. Tab will be dynamically generated and added to the Catalog Options dialog in calibre.gui2.dialogs.catalog.py:Catalog
fr_CA: Si l'extension n'est pas native, copier les fichiers .ui et .py de l'extension à partir du fichier ZIP vers $TMPDIR. Un entrée sera dynamiquement générée et ajotée à la boîte de dialogue du Catalogue d'Options dans calibre.gui2.dialogs.catalog.py:Catalog

en: Run the plugin. Must be implemented in subclasses. It should generate the catalog in the format specified in file_types, returning the absolute path to the generated catalog file. If an error is encountered it should raise an Exception.
fr_CA: Exécute l'extension. Doit être implémenté dans les sous-classes. Cela devrait généré le catalogue dans le format spécifié dans file_types, renvoyant le chemin absolu vers le fichier catalogue généré. SI un erreur est rencontrée, cela devrait faire apparaître une Exception.

en: The generated catalog file should be created with the :meth:`temporary_file` method.
fr_CA: Le fichier catalogue généré devrait être créer avec la méthode :meth:`temporary_file`.

en: Absolute path to the generated catalog file.
fr_CA: Chemin absolu vers le fichier catalogue généré.

en: A dictionary of keyword arguments
fr_CA: Un dictionnaire d'arguments mot-clef

en: A LibraryDatabase2 object
fr_CA: Un objet BaseDeDonnéeLibrairie2

en: Metadata download plugins
fr_CA: Extension de téléchargement de métadonnées

en: Set of capabilities supported by this plugin. Useful capabilities are: 'identify', 'cover'
fr_CA: Ensemble de capacités supportées par cet extension. Les capacités utiles sont: 'identify', 'cover'

en: List of metadata fields that can potentially be download by this plugin during the identify phase
fr_CA: Liste de champ de métadonnée qui peuvent potentiellement être téléchargée par cette extension pendant la phase d'identification

en: Set this to True if your plugin returns HTML formatted comments
fr_CA: Fixer ceci à True si votre extension renvoie des commentaires formatés en HTML

en: Setting this to True means that the browser object will indicate that it supports gzip transfer encoding. This can speedup downloads but make sure that the source actually supports gzip transfer encoding correctly first
fr_CA: Paramétrer ceci à True veut dire que l'objet navigateur indiquera qu'il prend en charge l'encodage de transfert gzip. Ceci peu accélérer les téléchargements, soyez sûr que la source supporte effectivement les encodages de transfert gzip correctement.

en: Set this to True to ignore HTTPS certificate errors when connecting to this source.
fr_CA: Paramétrer à TRUE pour ignorer les erreurs de certificat HTTPS lors de la connexion à cette source.

en: Cached cover URLs can sometimes be unreliable (i.e. the download could fail or the returned image could be bogus). If that is often the case with this source, set to False
fr_CA: Des URLs de couverture dans le cache peuvent parfois être peu sûr (càd. que le téléchargement pourrait échouer ou que l'image pourrait ne pas fonctionner). Si c'est souvent le cas avec cette source, fixer à False

en: A list of :class:`Option` objects. They will be used to automatically construct the configuration widget for this plugin
fr_CA: Un liste d'objet :class:`Option`. Ils seront utilisés pour construire automatiquement le widget de  configuration pour cette extension

en: A string that is displayed at the top of the config widget for this plugin
fr_CA: Une chaîne qui sera affichée au sommet du widget de configuration pour cette extension

en: If True this source can return multiple covers for a given query
fr_CA: Si True cette source peut renvoyer de multiples couvertures pour une demande donnée

en: If set to True covers downloaded by this plugin are automatically trimmed.
fr_CA: Si fixer à True les couvertures téléchargées par cette extension seront automatiquement rognées.

en: If set to True, and this source returns multiple results for a query, some of which have ISBNs and some of which do not, the results without ISBNs will be ignored
fr_CA: Si réglé à True, et cette source retourne de multiples résultats pour une requête, certains de ceux-ci ont des ISBN et certains de ceux-ci n'en ont pas, le résultat sans ISBN sera ignoré.

en: Return False if your plugin needs to be configured before it can be used. For example, it might need a username/password/API key.
fr_CA: Renvoie False si votre extension nécessite d'être configurée avant de pouvoir être utilisé. Par exemple, cela pourrait nécessiter un utilisateur/mot de passe/clef de greffon.

en: Take a list of authors and return a list of tokens useful for an AND search query. This function tries to return tokens in first name middle names last name order, by assuming that if a comma is in the author name, the name is in lastname, other names form.
fr_CA: Prend une liste d'auteurs et retourne une liste de jetons utiles pour une demande de recherche AND. Cette fonction tente de renvoyer des jetons dans l'ordre prénom, second nom, nom de famille, en escomptant que si une virgule est dans le nom d'auteur, le nom est dans le nom de famille, sous forme des autres noms.

en: Take a title and return a list of tokens useful for an AND search query. Excludes connectives(optionally) and punctuation.
fr_CA: Prend un titre et retourne une liste de jetons utiles pour une requête de recherche AND. Exclus les conjonctions(optionnel) et la ponctuation.

en: Split a list of jobs into at most num groups, as evenly as possible
fr_CA: Divise une liste de travaux en sous groupe, aussi uniformément que possible

en: Return the first field from self.touched_fields that is null on the mi object
fr_CA: Retourne le premier champs de self.touched_fields qui est nul sur le demi objet

en: Call this method in your plugin's identify method to normalize metadata before putting the Metadata object into result_queue. You can of course, use a custom algorithm suited to your metadata source.
fr_CA: Appelez cette méthode dans votre méthode d'identification de votre extension pour normaliser les métadonnées avant de rentrer l'objet Métadonnées dans le result_queue. Vous pouvez, bien sûr, utiliser un algorithme personnalisé adapté pour la source de métadonnée.

en: Return a 3-tuple or None. The 3-tuple is of the form: (identifier_type, identifier_value, URL). The URL is the URL for the book identified by identifiers at this source. identifier_type, identifier_value specify the identifier corresponding to the URL. This URL must be browsable to by a human using a browser. It is meant to provide a clickable link for the user to easily visit the books page at this source. If no URL is found, return None. This method must be quick, and consistent, so only implement it if it is possible to construct the URL from a known scheme given identifiers.
fr_CA: Renvoie un 3-tuple ou None. Le 3-tuple est sous la forme: (identifier_type, identifier_value, URL). L'URL est celle du livre identifié par les identifiants à la source. identifier_type, identifier_value, spécifiant l'identifiant correspondant à l'URL. Cet URL doit être consultable pour un être humain utilisant un navigateur. Elle est censée offrir un lien cliquable pour l'utilisateur pour visiter facilement les pages du livre à la source. Si aucun URL n'est trouvé, renvoie None. Cette méthode doit être rapide, et cohérente, à implémenter uniquement s'il est possible de construire l'URL à partir d'un schéma connu d'identifiants.

en: Return a human readable name from the return value of get_book_url().
fr_CA: Renvoie un nom lisible par un humain pour la valeur de retour de get_book_url()

en: Note that this method must only return validated URLs, i.e. not URLS that could result in a generic cover image or a not found error.
fr_CA: Noter que cette méthode doit uniquement renvoyer des URLs validées, càd. pas des  URLs qui pourrait finir en une image de couverture générique ou une erreur "not found"

en: Parse a URL and return a tuple of the form: (identifier_type, identifier_value). If the URL does not match the pattern for the metadata source, return None.
fr_CA: Analyser une URL et retourner un tuple du formulaire : (identifier_type, identifier_value). Si l'URL ne correspond pas au modèle de la source de métadonnées, renvoyer None.

en: Return a function that is used to generate a key that can sort Metadata objects by their relevance given a search query (title, authors, identifiers).
fr_CA: Renvoie une fonction qui est utilisée pour générer une clef qui peut trier les objets Métadonnées par leur pertinence en fonction d'une recherche donnée (titre, auteurs, identifiants).

en: These keys are used to sort the results of a call to :meth:`identify`.
fr_CA: Ces clefs sont utilisées pour trier les résultats d'un appel de :meth:`identify`.

en: For details on the default algorithm see :class:`InternalMetadataCompareKeyGen`. Re-implement this function in your plugin if the default algorithm is not suitable.
fr_CA: Pour plus de détails sur l'algorithme par défaut voir :class:`InternalMetadataCompareKeyGen`. Ré-implémentez cette fonction dans votre extension si l'algorithme par défaut n'est pas adapté.

en: Identify a book by its Title/Author/ISBN/etc.
fr_CA: Identifie un livre par son Titre/Auteur/ISBN/etc.

en: If identifiers(s) are specified and no match is found and this metadata source does not store all related identifiers (for example, all ISBNs of a book), this method should retry with just the title and author (assuming they were specified).
fr_CA: Si des identifiants sont spécifiés et qu'aucune n'est trouvée et que cette source de métadonnée ne contient pas tous les identifiants demandé (par exemple, tous les ISBNs d'un livre), cette méthode devrait réessayer avec juste le titre et l'auteur (s'ils ont été spécifiés).

en: If this metadata source also provides covers, the URL to the cover should be cached so that a subsequent call to the get covers API with the same ISBN/special identifier does not need to get the cover URL again. Use the caching API for this.
fr_CA: Si cette source de métadonnées fournit aussi des couvertures, l'URL de la couverture devrait être mis en cache pour qu'une demande suivant dans une API pour chercher les couvertures avec le même ISBN/identifiant spécial ne nécessite pas de rechercher l'URL de la couverture à nouveau. Utiliser le cache API pour ceci.

en: Every Metadata object put into result_queue by this method must have a `source_relevance` attribute that is an integer indicating the order in which the results were returned by the metadata source for this query. This integer will be used by :meth:`compare_identify_results`. If the order is unimportant, set it to zero for every result.
fr_CA: Chaque métadonnée introduite dans result_queue avec cette méthode doit avoir un attribut `source_relevance` qui est un entier indiquant l'ordre dans lequel les résultats seront rendus par la source de métadonnée pour cette recherche. Cet entier sera utilisé par :meth:`compare_identify_results`. Si l'ordre n'a pas d'importance, fixer à zéro pour chaque résultat.

en: Make sure that any cover/ISBN mapping information is cached before the Metadata object is put into result_queue.
fr_CA: Assurez-vous que toutes les informations de mappage de couverture/ISBN sont mises en cache avant que l'objet Metadata ne soit placé dans result_queue.

en: A log object, use it to output debugging information/errors
fr_CA: Un fichier log, utiliser le pour produire des informations de débogage/d'erreurs

en: A result Queue, results should be put into it. Each result is a Metadata object
fr_CA: Une File d'Attente de résultats, les résultats devraient y être mis. Chaque résultat est une métadonnée

en: If abort.is_set() returns True, abort further processing and return as soon as possible
fr_CA: Si abort.is_set() renvoie True, annule les futurs exécutions et retourne le plus vite possible

en: The title of the book, can be None
fr_CA: Le titre du livre, peut être None

en: A list of authors of the book, can be None
fr_CA: Une liste d'auteur du livre, peut être None

en: A dictionary of other identifiers, most commonly {'isbn':'1234...'}
fr_CA: Un ensemble d'autres identifiants, le plus souvent {'isbn':'1234...'}

en: Timeout in seconds, no network request should hang for longer than timeout.
fr_CA: "Timeout" en seconde, aucune requête réseau ne devrait durer plus longtemps que "timeout".

en: None if no errors occurred, otherwise a unicode representation of the error suitable for showing to the user
fr_CA: None si aucune erreur n’apparaît, sinon une représentation unicode de l'erreur adaptée pour le visionnage par l'utilisateur

en: Download a cover and put it into result_queue. The parameters all have the same meaning as for :meth:`identify`. Put (self, cover_data) into result_queue.
fr_CA: Télécharge une couverture et l'insère dans result_queue. Les paramètres auront tous le même sens que pour :meth:`identify`. Insère (self, cover_data) dans result_queue.

en: This method should use cached cover URLs for efficiency whenever possible. When cached data is not present, most plugins simply call identify and use its results.
fr_CA: Cette méthode devrait utiliser les URLs de couvertures mise en cache par efficience le plus souvent possible. Quand aucune donnée n'est présente en cache, la plupart des extensions appel simplement identify et utilise ces résultats.

en: If the parameter get_best_cover is True and this plugin can get multiple covers, it should only get the "best" one.
fr_CA: Si le paramètre get_best_cover est True dans cette extension et que cette extension peut récupérer de multiples couvertures, elle ne devrait prendre que la "meilleure".

en: Generate a sort key for comparison of the relevance of Metadata objects, given a search query. This is used only to compare results from the same metadata source, not across different sources.
fr_CA: Génère une sorte de clef pour la comparaison de la pertinence des métadonnée, en fonction d'une recherche. Ceci est utilisé uniquement pour comparer des résultats d'une même source de métadonnées, pas à travers de différentes sources.

en: The sort key ensures that an ascending order sort is a sort by order of decreasing relevance.
fr_CA: La clé de tri garanti que l'ordre croissant de tri soit trié par pertinence décroissante.

en: The algorithm is:
fr_CA: L'algorithme est:

en: Prefer results that have at least one identifier the same as for the query
fr_CA: Préfère des résultats qui ont au moins un identificateur égal à celui de la requête

en: Prefer results with a cached cover URL
fr_CA: Préfère des résultats avec une URL de couverture en cache

en: Prefer results with all available fields filled in
fr_CA: Préfère des résultats avec tous les champs disponible remplis

en: Prefer results with the same language as the current user interface language
fr_CA: Préfère les résultats avec la même langue que la langue de l'interface utilisateur actuelle

en: Prefer results that are an exact title match to the query
fr_CA: Préfère des résultats qui ont exactement le même titre que la recherche

en: Prefer results with longer comments (greater than 10% longer)
fr_CA: Préfère des résultats qui ont des plus longs commentaires (plus de 10% plus grand)

en: Use the relevance of the result as reported by the metadata source's search
fr_CA: Utilise la pertinence du résultat comme reporté dans la recherche de source de métadonnées

en: engine
fr_CA: machine

en: Conversion plugins
fr_CA: Extension de conversion

en: InputFormatPlugins are responsible for converting a document into HTML+OPF+CSS+etc. The results of the conversion *must* be encoded in UTF-8. The main action happens in :meth:`convert`.
fr_CA: Les InputFormatPlugins sont responsable de la conversion d'un document en HTML+OPF+CSS+etc. Le résultat de la conversion *doit* être encodé en UTF-8. L'action principale se passe dans :meth:`convert`.

en: Set of file types for which this plugin should be run For example: ``set(['azw', 'mobi', 'prc'])``
fr_CA: Ensemble de type de fichier pour lesquels l'extension devrait être exécuté. Par exemple : ``set(['azw', 'mobi', 'prc'])``

en: If True, this input plugin generates a collection of images, one per HTML file. This can be set dynamically, in the convert method if the input files can be both image collections and non-image collections. If you set this to True, you must implement the get_images() method that returns a list of images.
fr_CA: Si True, cette extension d'origine génère un ensemble d'image, une par fichier HTML. Ceci peut-être fait dynamiquement, dans la méthode de conversion si les fichiers d'origines peuvent être des ensembles d'images ou pas. Si vous fixer ceci à True, vous devez implémenter la méthode get_images() qui renvoie une liste d'images.

en: Number of CPU cores used by this plugin. A value of -1 means that it uses all available cores
fr_CA: Nombre de cœur du CPU utilisés par cette extension. Une valeur de -1 signifie qu'elle utilise tous les cœurs disponibles

en: If set to True, the input plugin will perform special processing to make its output suitable for viewing
fr_CA: Si fixer à True, cette extension d'origine effectuera un exécution spéciale pour que son résultat soit approprié au visionnage

en: The encoding that this input plugin creates files in. A value of None means that the encoding is undefined and must be detected individually
fr_CA: L'encodage dans lequel cette extension d'origine crée le fichier. Une valeur de None signifie que l'encodage est indéfini et doit être détecter individuellement

en: Options shared by all Input format plugins. Do not override in sub-classes. Use :attr:`options` instead. Every option must be an instance of :class:`OptionRecommendation`.
fr_CA: Les options partagées par toutes les extensions de Format d'Entrée. N'outrepasses pas en sous-classe. Utiliser :attr:`options` à la place. Chaque option doit être un exemple de :class:`OptionRecommendation`.

en: Options to customize the behavior of this plugin. Every option must be an instance of :class:`OptionRecommendation`.
fr_CA: Des options pour personnaliser le comportement de cette extension. Chaque option doit être un exemple de :class:`OptionRecommendation`.

en: A set of 3-tuples of the form (option_name, recommended_value, recommendation_level)
fr_CA: Un ensemble de 3-tuples sous la forme (option_name, recommended_value, recommendation_level)

en: Return a list of absolute paths to the images, if this input plugin represents an image collection. The list of images is in the same order as the spine and the TOC.
fr_CA: Renvoie une liste de chemin absolu vers les images, si cette extension d'origine représente une collection d'image. La liste d'images est dans le même ordre que le manifeste et la TdM

en: This method must be implemented in sub-classes. It must return the path to the created OPF file or an :class:`OEBBook` instance. All output should be contained in the current folder. If this plugin creates files outside the current folder they must be deleted/marked for deletion before this method returns.
fr_CA: Cette méthode doit être implémentée en sous-classe. Elle doit renvoyer le chemin vers le fichier OPF créé ou un cas :class:`OEBBook`. Tous les fichiers sortant devrait être contenu dans ce dossier. Si cette extension crée des fichiers en dehors du dossier ils doivent être supprimés/marqués pour suppression avant le résultat de cette méthode.

en: A file like object that contains the input file.
fr_CA: Un objet ressemblant à un fichier qui contient le fichier original.

en: Options to customize the conversion process. Guaranteed to have attributes corresponding to all the options declared by this plugin. In addition, it will have a verbose attribute that takes integral values from zero upwards. Higher numbers mean be more verbose. Another useful attribute is ``input_profile`` that is an instance of :class:`calibre.customize.profiles.InputProfile`.
fr_CA: Des options pour personnalisés le processus de conversion. Garanti d'avoir des attributs correspondant à toutes les options déclarée dans cette extension. De plus, il y aura un attribut "verbose"(bavard) qui prend des valeurs entières à partir de zéro. Plus le nombre est haut, plus l'extension est bavarde. Un autre attribut utile est ``input_profile`` qui est un exemple de :class:`calibre.customize.profiles.InputProfile`.

en: The extension (without the .) of the input file. It is guaranteed to be one of the `file_types` supported by this plugin.
fr_CA: L'extension (sans le .) du fichier original. Garanti d'être un des `file_types` supporté par cette extension.

en: A :class:`calibre.utils.logging.Log` object. All output should use this object.
fr_CA: Un objet :class:`calibre.utils.logging.Log`. Tous les fichiers de sorties devraient utiliser cet objet.

en: A dictionary of various information that the input plugin can get easily that would speed up the subsequent stages of the conversion.
fr_CA: Un dictionnaire d'informations variées que l'extension d'origine peut accéder facilement pour accélérer les étapes suivantes de la conversion.

en: Called to allow the input plugin to perform postprocessing after the book has been parsed.
fr_CA: Appelé pour permettre l'extension d'origine d'effectuer du post-traitement après que le livre ait été divisé.

en: Called to allow the input plugin to specialize the parsed book for a particular output format. Called after postprocess_book and before any transforms are performed on the parsed book.
fr_CA: Appelé pour permettre à l'extension d'origine pour spécialiser le livre divisé pour un format de sortie particulier. Appelé après postprocess_book et avant toutes transformations effectuée sur le livre divisé.

en: Called to create the widget used for configuring this plugin in the calibre GUI. The widget must be an instance of the PluginWidget class. See the builtin input plugins for examples.
fr_CA: Appelé pour créer un widget utilisé pour configurer cette extension dans le GUI de calibre. Le widget doit être une instance de la classe PluginWidget. Voir les d'extensions implémentées d'origine pour des exemples.

en: OutputFormatPlugins are responsible for converting an OEB document (OPF+HTML) into an output e-book.
fr_CA: Les OutputFormatPlugins sont responsables de la conversion d'un document OEB (OPF+HTML) vers le livre numérique de sortie.

en: The OEB document can be assumed to be encoded in UTF-8. The main action happens in :meth:`convert`.
fr_CA: Le document OEB peut être supposé être encodé en UTF-8. L'action principale se passe dans :meth:`conversion`.

en: The file type (extension without leading period) that this plugin outputs
fr_CA: Le type de fichier (l'extension sans le point) que cette extension produit

en: Render the contents of `oeb_book` (which is an instance of :class:`calibre.ebooks.oeb.OEBBook`) to the file specified by output.
fr_CA: Fournit le contenu de `oeb_book` (qui est une instance de :class:`calibre.ebooks.oeb.OEBBook`) au fichier spécifié par la sortie.

en: Either a file like object or a string. If it is a string it is the path to a folder that may or may not exist. The output plugin should write its output into that folder. If it is a file like object, the output plugin should write its output into the file.
fr_CA: Soit un fichier soit une chaîne. Si c'est une chaîne, c'est le chemin vers un dossier qui peut exister ou pas. L'extension de sortie devrait écrire ses restitutions dans ce dossier. Si c'est un fichier, l'extension de sortie devrait écrire ces productions dans le fichier.

en: The input plugin that was used at the beginning of the conversion pipeline.
fr_CA: L'extension d'origine qui a été utilisé au début de la pipeline de conversion.

en: Conversion options. Guaranteed to have attributes corresponding to the OptionRecommendations of this plugin.
fr_CA: Des options de conversions. Garantie d'avoir des attributs correspondant aux OptionRecommendations de cette extension.

en: The logger. Print debug/info messages etc. using this.
fr_CA: L'enregistreur. Sauver des messages d'info/débogage etc. en utilisant ceci.

en: Can be used to change the values of conversion options, as used by the conversion pipeline.
fr_CA: Peut être utilisé pour modifier les valeurs des options de conversion, telles qu'elles sont utilisées par le pipeline de conversion.

en: The item (HTML file) being processed
fr_CA: L'objet (fichier HTML) étant traité

en: A Stylizer object containing the flattened styles for item. You can get the style for any element by stylizer.style(element).
fr_CA: Un objet Styliste contenant les styles aplani pour l'objet. Vous pouvez obtenir les styles pour n'importe quel élément par stylizer.style(élément).

en: Called to create the widget used for configuring this plugin in the calibre GUI. The widget must be an instance of the PluginWidget class. See the builtin output plugins for examples.
fr_CA: Appelé pour créer un widget utilisé pour configurer cette extension dans le GUI de calibre. Le widget doit être une manipulation de la classe PluginWidget. Voir la création d'extensions d'origines pour des exemples.

en: Device drivers
fr_CA: Pilotes de périphérique

en: The base class for all device drivers is :class:`DevicePlugin`. However, if your device exposes itself as a USBMS drive to the operating system, you should use the USBMS class instead as it implements all the logic needed to support these kinds of devices.
fr_CA: La classe de base pour tous les pilotes de périphérique est :class:`DevicePlugin`. Cependant, si votre périphérique expose un port USBMS au système opérateur, vous devriez utiliser la classe USBMS à la place car elle implémente toute la logique nécessaire pour supporter ce genre de périphérique.

en: Defines the interface that should be implemented by backends that communicate with an e-book reader.
fr_CA: Définit l'interface qui devrait être implémentée par les derniers processus qui communiquent avec le lecteur de livre numérique.

en: Ordered list of supported formats
fr_CA: Liste ordonnée de formats supportés

en: VENDOR_ID can be either an integer, a list of integers or a dictionary If it is a dictionary, it must be a dictionary of dictionaries, of the form::
fr_CA: VENDOR_ID peut être soit un entier, une liste d'entiers ou un dictionnaire. Si c'est un dictionnaire, cela doit être un dictionnaire de dictionnaires sous la forme::

en: An integer or a list of integers
fr_CA: Un entier ou une liste d'entiers

en: BCD can be either None to not distinguish between devices based on BCD, or it can be a list of the BCD numbers of all devices supported by this driver.
fr_CA: BCD peut être soit None pour ne pas distingué entre les périphériques basé sur BCD, ou il peut être une liste des nombres BCD de tous les périphériques supportés par ce pilote.

en: Height for thumbnails on the device
fr_CA: Hauteur de l'aperçu sur le périphérique

en: Compression quality for thumbnails. Set this closer to 100 to have better quality thumbnails with fewer compression artifacts. Of course, the thumbnails get larger as well.
fr_CA: Qualité de compression pour les vignettes. Paramétrer ceci proche de 100 pour obtenir une meilleure qualité d'étiquette avec moins d’artefacts de compression. Bien sûr, les vignettes grandiront en conséquence.

en: Set this to True if the device supports updating cover thumbnails during sync_booklists. Setting it to true will ask device.py to refresh the cover thumbnails during book matching
fr_CA: Fixer ceci à True si le périphérique supporte les mises à jours d'aperçus de couverture pendant sync_booklists. Le fixer à True demandera à device.py de rafraîchir  les aperçus de couverture pendant  la correspondance de livre.

en: Whether the metadata on books can be set via the GUI.
fr_CA: Soit les métadonnées des livres sont fixées via le GUI.

en: Whether the device can handle device_db metadata plugboards
fr_CA: Soit le périphérique peut gérer tableau de métadonnée device_db

en: Path separator for paths to books on device
fr_CA: Le séparateur de chemin pour les chemins vers les livres sur le périphérique

en: Icon for this device
fr_CA: Icône de ce périphérique

en: GUI displays this as a message if not None in the status bar. Useful if opening can take a long time
fr_CA: Le GUI affiche ceci en tant que message dans la barre d'état si ce n'est pas None. Utile si l'ouverture peut prendre du temps

en: Set of extensions that are "virtual books" on the device and therefore cannot be viewed/saved/added to library. For example: ``frozenset(['kobo'])``
fr_CA: Ensemble d'extensions qui sont des "livres virtuels" sur le périphérique et par conséquent ne peuvent être vus/sauvés/ajoutés à la bibliothèque. Par exemple : ``frozenset(['kobo'])``

en: Message to display to user for virtual book extensions.
fr_CA: Message à afficher à l'utilisateur pour les extensions de livre virtuel

en: Whether to nuke comments in the copy of the book sent to the device. If not None this should be short string that the comments will be replaced by.
fr_CA: S'il faut détruire les commentaires dans la copie du livre envoyé au périphérique . Si ce n'est pas None ce devrait être une courte chaîne qui remplacera le commentaire.

en: If True indicates that  this driver completely manages device detection, ejecting and so forth. If you set this to True, you *must* implement the detect_managed_devices and debug_managed_device_detection methods. A driver with this set to true is responsible for detection of devices, managing a blacklist of devices, a list of ejected devices and so forth. calibre will periodically call the detect_managed_devices() method and if it returns a detected device, calibre will call open(). open() will be called every time a device is returned even if previous calls to open() failed, therefore the driver must maintain its own blacklist of failed devices. Similarly, when ejecting, calibre will call eject() and then assuming the next call to detect_managed_devices() returns None, it will call post_yank_cleanup().
fr_CA: Si True, indique que ce pilote gère entièrement la détection de périphérique, l’éjection etc. Si vous réglez à True, vous *devez* implémenter les méthodes detect_managed_devices et debug_managed_device_detection.  Un pilote avec ceci réglé à True est responsable de la détection des périphériques, de la gestion d'une liste d'exclusion des périphérique, une liste de périphérique éjectés, etc. calibre utilisera périodiquement la méthode detect_managed_devices()  et si elle retourne un périphérique détecté, calibre appellera open(). open() sera appelé à chaque fois qu'un périphérique est renvoyé même si des appels précédents à open() ont échoués, donc le pilote doit maintenir sa propre liste d'exclusion de périphériques qui ont échoués. Similairement, à l'éjection, calibre utilisera eject() et assume alors que le prochain appel à detect_managed_devices()  renvoye None, il appellera post_yank_cleanup().

en: If set the True, calibre will call the :meth:`get_driveinfo()` method after the books lists have been loaded to get the driveinfo.
fr_CA: Si fixer à True, calibre utilisera la méthode :meth:`get_driveinfo()` après que la liste de livre a été chargée pour obtenire le driveinfo.

en: If set to True, calibre will ask the user if they want to manage the device with calibre, the first time it is detected. If you set this to True you must implement :meth:`get_device_uid()` and :meth:`ignore_connected_device()` and :meth:`get_user_blacklisted_devices` and :meth:`set_user_blacklisted_devices`
fr_CA: Si fixer à True, calibre demandera à l'utilisateur s'il veut gérer le périphérique avec calibre, la première fois qu'il est détecté. Si vous fixez ceci à True, vous devez implémenter :meth:`get_device_uid()` et :meth:`ignore_connected_device()` et :meth:`get_user_blacklisted_devices` et :meth:`set_user_blacklisted_devices`

en: Set this to a dictionary of the form {'title':title, 'msg':msg, 'det_msg':detailed_msg} to have calibre popup a message to the user after some callbacks are run (currently only upload_books). Be careful to not spam the user with too many messages. This variable is checked after *every* callback, so only set it when you really need to.
fr_CA: Fixer ceci à un dictionnaire de la forme {'title':title, 'msg':msg, 'det_msg':detailed_msg} pour que calibre fasse surgir un message à l'utilisateur après que quelques rappels aient été fait ( actuellement uniquement upload_books). Il faut faire attention à ne pas noyer l'utilisateur par trop de messages. Cette variable est vérifiée après *chaque* rappel, donc utilisez la uniquement lorsque c'est réellement nécessaire.

en: GUI displays this as a non-modal popup. Should be an instance of OpenPopupMessage
fr_CA: L'interface graphique affiche ceci comme une popup non modale. Devrait être une instance de OpenPopupMessage

en: Return True, device_info if a device handled by this plugin is currently connected.
fr_CA: Renvoye True , device_info si un périphérique géré par cette extension est actuellement connecté.

en: List of devices currently connected
fr_CA: Liste des périphériques actuellement connectés

en: Called only if MANAGES_DEVICE_PRESENCE is True.
fr_CA: Appelé uniquement si MANAGES_DEVICE_PRESENCE est True.

en: Scan for devices that this driver can handle. Should return a device object if a device is found. This object will be passed to the open() method as the connected_device. If no device is found, return None. The returned object can be anything, calibre does not use it, it is only passed to open().
fr_CA: Cherche des périphérique que ce pilote peut gérer. Devrait renvoyer un objet périphérique si un périphérique est trouvé. Cet objet sera passé à la méthode open() en tant que connected_device. Si aucun périphérique n'est trouvé, renvoie None. L'objet renvoyé peut être n'importe quoi, calibre ne l'utilise pas, il est uniquement passé dans open().

en: This method is called periodically by the GUI, so make sure it is not too resource intensive. Use a cache to avoid repeatedly scanning the system.
fr_CA: Cette méthode est appelée périodiquement par le GUI, donc soyez sûr qu'il n'utilise pas trop de ressource. Utilisez un cache pour pour éviter de scanner répétitivement le système.

en: Set of USB devices found on the system.
fr_CA: Ensemble de périphériques USB trouvés sur le système.

en: If True and the driver uses a cache to prevent repeated scanning, the cache must be flushed.
fr_CA: Si True et que le pilote utilise un cache pour prévenir les scan répétés, le cache doit être flushé.

en: Should write information about the devices detected on the system to output, which is a file like object.
fr_CA: Devrait écrire des informations sur les périphériques détectés par le système pour être affiché, qui devrait être un objet ressemblant à un fichier.

en: Should return True if a device was detected and successfully opened, otherwise False.
fr_CA: Devrait renvoyer True si un périphérique était détecter et effectivement ouvert, sinon False.

en: The key to unlock the device
fr_CA: La clef pour débloquer le périphérique

en: If true the packet stream to/from the device is logged
fr_CA: Si True, le paquet envoyé ou reçu au périphérique est mis au registre

en: Function that is called with a % progress (number between 0 and 100) for various tasks. If it is called with -1 that means that the task does not have any progress information
fr_CA: Une fonction qui est appelée avec un % de progression (un nombre en 0 et 100) pour différentes tâches. Si on utilise -1 cela veut dire que la tâche n'a aucune information de progression

en: Device information from the device scanner
fr_CA: Les informations de périphérique recueilient par l'analyse de périphérique

en: Optional method to perform further checks on a device to see if this driver is capable of handling it. If it is not it should return False. This method is only called after the vendor, product ids and the bcd have matched, so it can do some relatively time intensive checks. The default implementation returns True. This method is called only on Windows. See also :meth:`can_handle`.
fr_CA: Une méthode optionnelle pour effectuer de plus amples vérifications sur un périphérique pour savoir si ce pilote est capable de le gérer. Sinon, cela devrait renvoyer False. Cette méthode est appelée uniquement après que le vendeur, l'identifiant du produit et le bcd sont appariés, donc elle peut faire des vérifications nécessitant pas mal de temps. L'implémentation par défaut renvoye True. Cette méthode est appelée uniquement sur Windows. voir aussi :meth:`can_handle`.

en: Note that for devices based on USBMS this method by default delegates to :meth:`can_handle`.  So you only need to override :meth:`can_handle` in your subclass of USBMS.
fr_CA: Notez que pour les périphériques basés sur USBMS cette méthode par défaut délègue à :meth:`can_handle`. Donc vous avez seulement besoin d'outrepasser :meth:`can_handle` dans votre sous-classe de USBMS.

en: A usbdevice as returned by :func:`calibre.devices.winusb.scan_usb_devices`
fr_CA: Un périphérique USB est rapporté par :func:`calibre.devices.winusb.scan_usb_devices`

en: Unix version of :meth:`can_handle_windows`.
fr_CA: Version Unix de :meth:`can_handle_windows`.

en: Is a tuple of (vid, pid, bcd, manufacturer, product, serial number)
fr_CA: Est un tuple de (vid, pid, bcd, manufacturer, product, serial number)

en: Perform any device specific initialization. Called after the device is detected but before any other functions that communicate with the device. For example: For devices that present themselves as USB Mass storage devices, this method would be responsible for mounting the device or if the device has been automounted, for finding out where it has been mounted. The method :meth:`calibre.devices.usbms.device.Device.open` has an implementation of this function that should serve as a good example for USB Mass storage devices.
fr_CA: Effectue n'importe quel initialisation spécifique de périphérique. Appelé après que le périphérique soit détecté mais avant que n'importe quelle fonction qui communique avec le périphérique. Par exemple: Pour les périphériques qui se présentent comme des périphériques de stockage de masse USB, cette méthode devrait être responsable du montage du périphérique ou si le périphérique a été monté automatiquement, de trouver où il a été monté. La méthode :meth:`calibre.devices.usbms.device.Device.open` a une implémentation de cette fonction qui devrait servir comme un bon exemple pour les périphériques de stockage de masse USB.

en: This method can raise an OpenFeedback exception to display a message to the user.
fr_CA: Cette méthode peut créer une exception OpenFeedback pour afficher un message à l'utilisateur.

en: The device that we are trying to open. It is a tuple of (vendor id, product id, bcd, manufacturer name, product name, device serial number). However, some devices have no serial number and on Windows only the first three fields are present, the rest are None.
fr_CA: Le périphérique que nous essayons actuellement d'ouvrir. C'est un tuple (vendor id, product id, bcd, manufacturer name, product name, device serial number). Toutefois, certains périphériques n'on aucun numéro de séries et sur Windows seul les trois premier champs sont présent, les autres sont None

en: The UUID of the current calibre library. Can be None if there is no library (for example when used from the command line).
fr_CA: L'UUID de la bibliothèque calibre actuelle. Peut être None s'il n'y a pas de bibliohèque (par exemple lorsqu'il est utilisé de l'invité de commande).

en: Un-mount / eject the device from the OS. This does not check if there are pending GUI jobs that need to communicate with the device.
fr_CA: Démonte/éjecte le périphérique de l'OS. Ceci ne vérifie pas s'il y a des travaux GUI en attente qui nécessite communication avec le périphérique.

en: NOTE: That this method may not be called on the same thread as the rest of the device methods.
fr_CA: NOTEZ: Que cette méthode peut ne pas être appelée sur le même fil que le reste des méthodes périphériques.

en: Called if the user yanks the device without ejecting it first.
fr_CA: Appelé si l'utilisateur retire le périphériques sans l'avoir éjecter préalablement.

en: Set a function to report progress information.
fr_CA: Pose une fonction pour rapporter les information de progression.

en: Ask device for device information. See L{DeviceInfoQuery}.
fr_CA: Demande ses informations au périphérique. Voir L{DeviceInfoQuery}.

en: (device name, device version, software version on device, MIME type) The tuple can optionally have a fifth element, which is a drive information dictionary. See usbms.driver for an example.
fr_CA: (nom du périphérique, version du périphérique, version du programme sur le périphérique, type MIME) Le tuple peut parfois avoir un cinquième élément, qui est dictionnaire d'information sur le lecteur. Voir usbms.driver pour un exemple.

en: Return the driveinfo dictionary. Usually called from get_device_information(), but if loading the driveinfo is slow for this driver, then it should set SLOW_DRIVEINFO. In this case, this method will be called by calibre after the book lists have been loaded. Note that it is not called on the device thread, so the driver should cache the drive info in the books() method and this function should return the cached data.
fr_CA: Renvoie le dictionnaire driveinfo. Habituellement appélé de get_device_information(), mais si le chargement du driveinfo est lent pour ce lecteur, alors il devrait fixer SLOW_DRIVEINFO. Dans ce cas, cette méthode sera appelée par calibre après que la liste de livre ait été chargée. Notez que ceci n'est pas appelé sur le fil du périphérique, donc le pilote devrait cacher les informations du pilote dans la méthode books() et cette fonction devrait renvoyer les données cachées.

en: Return a 2 element list of the prefix to paths on the cards. If no card is present None is set for the card's prefix. E.G. ('/place', '/place2') (None, 'place2') ('place', None) (None, None)
fr_CA: Renvoie une liste de 2 éléments des préfixes vers les chemins sur les cartes. Si aucune carte n'est présent, None est fixé comme le préfixe de la carte. e.g. ('/place', '/place2') (None, 'place2') ('place', None) (None, None)

en: Get total space available on the mountpoints:
fr_CA: Récupère l'espace disponible sur les points de montages:

en: Main memory
fr_CA: Mémoire principale

en: Memory Card A
fr_CA: Carte Mémoire A

en: Memory Card B
fr_CA: Carte Mémoire B

en: A 3 element list with total space in bytes of (1, 2, 3). If a particular device doesn't have any of these locations it should return 0.
fr_CA: Une liste à 3 éléments avec des espaces entier en bit de (1, 2, 3). Si un périphérique particulier n'a pas l'une de ces locations, il devrait retourner à 0.

en: Get free space available on the mountpoints:
fr_CA: Récupère l'espace disponible sur les points de montage:

en: Card A
fr_CA: Carte A

en: Card B
fr_CA: Carte B

en: A 3 element list with free space in bytes of (1, 2, 3). If a particular device doesn't have any of these locations it should return -1.
fr_CA: Une liste à 3 éléments avec des espaces entier en bit de (1, 2, 3). Si un périphérique particulier n'a pas l'une de ces locations, il devrait retourner à -1.

en: Return a list of e-books on the device.
fr_CA: Renvoie une liste des livres numérique sur le périphérique.

en: If 'carda' or 'cardb' return a list of e-books on the specific storage card, otherwise return list of e-books in main memory of device. If a card is specified and no books are on the card return empty list.
fr_CA: Si 'carda' ou 'cardb', renvoie une liste de livres numériques sur la carte de stockage spécifique, sinon renvoie une liste de livres numériques dans la mémoire principale du périphérique. Si une carte est spécifiée et qu'aucun livre n'est dans la carte, renvoie une liste vide.

en: A BookList.
fr_CA: Une BookList

en: Upload a list of books to the device. If a file already exists on the device, it should be replaced. This method should raise a :class:`FreeSpaceError` if there is not enough free space on the device. The text of the FreeSpaceError must contain the word "card" if ``on_card`` is not None otherwise it must contain the word "memory".
fr_CA: Envoie une liste de livres au périphérique. Si un fichier existe déjà sur le périphérique, il devrait être remplacé. Cette méthode devrait soulever une :class:`FreeSpaceError` s'il n'y a pas d'espace sur le périphérique. Le texte dans la FreeSpaceError doit contenir le mot "carte" si "on_card" n'est pas None il doit contenir le mot "mémoire".

en: A list of paths
fr_CA: Une liste de chemins

en: A list of file names that the books should have once uploaded to the device. len(names) == len(files)
fr_CA: Une liste de noms que les livres devraient avoir une fois envoyé au périphérique. len(names) == len(files)

en: If not None, it is a list of :class:`Metadata` objects. The idea is to use the metadata to determine where on the device to put the book. len(metadata) == len(files). Apart from the regular cover (path to cover), there may also be a thumbnail attribute, which should be used in preference. The thumbnail attribute is of the form (width, height, cover_data as jpeg).
fr_CA: Si n'est pas None, est une liste d'objets :class:`Métadonnées`. L'idée est d'utiliser la métadonnée pour déterminer où mettre le livre sur le périphérique. len(metadata) == len(files). En plus de la couverture habituelle(chemin vers la couverture), il peut aussi y avoir un attribut d'aperçu, qui devrait être utilisée préférentiellement. L'attribut d'aperçu est de la form (largeur, hauteur, cover_data en jpeg).

en: A list of 3-element tuples. The list is meant to be passed to :meth:`add_books_to_metadata`.
fr_CA: Une liste d'ensemble de tuples à 3 éléments. La liste est faite pour être passée à :meth:`add_books_to_metadata`.

en: Add locations to the booklists. This function must not communicate with the device.
fr_CA: Ajoute des emplacements à la liste de livres. cette fonction ne doit pas communiquer avec le périphérique.

en: Result of a call to L{upload_books}
fr_CA: Résultat d'un appel à L{upload_books}

en: List of :class:`Metadata` objects, same as for :meth:`upload_books`.
fr_CA: Liste d'objets :class:`Métadonénes`, même chose que :meth:`upload_books`.

en: A tuple containing the result of calls to (:meth:`books(oncard=None)`, :meth:`books(oncard='carda')`, :meth`books(oncard='cardb')`).
fr_CA: En tuple contenant le résultat d'appels à (:meth:`books(oncard=None)`, :meth:`books(oncard='carda')`, :meth`books(oncard='cardb')`).

en: Delete books at paths on device.
fr_CA: Supprime les livre aux chemins sur le périphérique.

en: Remove books from the metadata list. This function must not communicate with the device.
fr_CA: Retire les livres de la liste de métadonnées. Cette fonction ne doit pas communiquer avec le périphérique.

en: paths to books on the device.
fr_CA: les chemins vers les livres sur le périphérique.

en: Update metadata on device.
fr_CA: Met à jour les métadonnées sur le périphérique.

en: Read the file at ``path`` on the device and write it to outfile.
fr_CA: Lit le fichier à ``path`` sur le périphérique et l'écrit sur un fichier extérieur.

en: file object like ``sys.stdout`` or the result of an :func:`open` call.
fr_CA: un objet ressemblant à un fichier ``sys.stdout`` ou le résultat d'un appel à une :func:`open`

en: Should return a QWidget. The QWidget contains the settings for the device interface
fr_CA: Devrait renvoyer un QWdiget. Le QWidget contient les paramètres pour l'interface du périphérique.

en: Should save settings to disk. Takes the widget created in :meth:`config_widget` and saves all settings to disk.
fr_CA: Devrait sauver les paramètres sur le disque. Prend le widget créer dans :meth:`config_widget` et sauve tous les paramètres sur le disque.

en: Should return an opts object. The opts object should have at least one attribute `format_map` which is an ordered list of formats for the device.
fr_CA: Devrait renvoyer un objet opts. Les objets opts devrait au moins avoir un attribut `format_map` qui est une liste ordonnée de formats pour le périphérique.

en: provide the driver the current set of plugboards and a function to select a specific plugboard. This method is called immediately before add_books and sync_booklists.
fr_CA: fournit au pilote le l'ensemble actuel de tableaux de connexion et une fonction pour sélectionner un tableau de connexion spécifique. Cette méthode est appelée immédiatement avant add_books et sync_booklists.

en: pb_func is a callable with the following signature::
fr_CA: pb_func est appelable avec la signature suivante::

en: def pb_func(device_name, format, plugboards)
fr_CA: def pb_func(device_name, format, tableaux de connexion)

en: You give it the current device name (either the class name or DEVICE_PLUGBOARD_NAME), the format you are interested in (a 'real' format or 'device_db'), and the plugboards (you were given those by set_plugboards, the same place you got this method).
fr_CA: Vous donnez le nom actuel du périphérique(soit le nom de classe du périphérique soit DEVICE_PLUGBOARD_NAME), le format qui vous intéresse (un 'real' format ou 'device_db'), et les tableaux de connexion (ceux donnés par set_plugboards, au même endroit qu'où vous avez eu cette méthode).

en: None or a single plugboard instance.
fr_CA: None ou unique tableau de connexion

en: Set the device name in the driveinfo file to 'name'. This setting will persist until the file is re-created or the name is changed again.
fr_CA: Fixe le nom du périphérique dans le driveinfo à 'name'. Ce Paramètre persistera jusqu'à ce que le fichier soit recréer ou que le nom soit changé à nouveau.

en: Non-disk devices should implement this method based on the location codes returned by the get_device_information() method.
fr_CA: Des périphériques n'étant pas des disques devrait implémenter cette méthode basée sur les codes d'emplacement renvoyé par la méthode get_device_information().

en: Given a list of paths, returns another list of paths. These paths point to addable versions of the books.
fr_CA: En fonction d'une liste de chemins, renvoie une autre liste de chemins. Ces chemins pointe vers des versions cumulable des livres.

en: If there is an error preparing a book, then instead of a path, the position in the returned list for that book should be a three tuple: (original_path, the exception instance, traceback)
fr_CA: S'il y a une erreur dans la préparation d'un livre, alors au lieu du chemin, la position dans la liste renvoyée pour ce livre devrait être un 3-tuple (original_path, l'exception, retraçage)

en: Called when calibre is starting the device. Do any initialization required. Note that multiple instances of the class can be instantiated, and thus __init__ can be called multiple times, but only one instance will have this method called. This method is called on the device thread, not the GUI thread.
fr_CA: Appelé lorsque calibre démarre le périphérique. Fait toutes les initialisations requises. Notez que de multiples utilisation de la classe peuvent être instanciée, et donc __init__ peut être appelé de nombreuse fois, mais une seule instance utilisera cette méthode. Cette méthode est appelée sur le fil périphérique, pas celui du GUI.

en: Called when calibre is shutting down, either for good or in preparation to restart. Do any cleanup required. This method is called on the device thread, not the GUI thread.
fr_CA: Appelé lorsque calibre s'éteint, soit réellement, soit pour redémarrer. Fais n'importe quel nettoyage nécessaire. Cette méthode est appelée sur le fil périphérique, pas celui du GUI.

en: Must return a unique id for the currently connected device (this is called immediately after a successful call to open()). You must implement this method if you set ASK_TO_ALLOW_CONNECT = True
fr_CA: Doit rendre un identificateur unique pour le périphérique connecté (ceci est appelé immédiatement après un appel réussi à open()). Vous devez implémenter cette méthode si vous fixez ASK_TO_ALLOW_CONNECT = True

en: Should ignore the device identified by uid (the result of a call to get_device_uid()) in the future. You must implement this method if you set ASK_TO_ALLOW_CONNECT = True. Note that this function is called immediately after open(), so if open() caches some state, the driver should reset that state.
fr_CA: Devrait ignorer le périphérique identifié par l'uid (le résultat d'un appel à get_device_uid()) dans le futur. Vous devez implémenter cette méthode si vous avez fixez ASK_TO_ALLOW_CONNECT = True.. Notez que cette fonction est appelée immédiatement après open(), donc si open() cache un état, le pilote devrait réinitialiser cet état.

en: Return map of device uid to friendly name for all devices that the user has asked to be ignored.
fr_CA: Renvoie un carte d'uid de périphérique à des noms lisibles pour tous les périphériques que l'utilisateur a demandé d'ignorer.

en: Set the list of device uids that should be ignored by this driver.
fr_CA: Fixe la liste d'uids de périphérique qui devraient être ignorés par ce pilote.

en: Implement this method if your device wants to override a particular preference. You must ensure that all call sites that want a preference that can be overridden use device_prefs['something'] instead of prefs['something']. Your method should call device_prefs.set_overrides(pref=val, pref=val, ...). Currently used for: metadata management (prefs['manage_device_metadata'])
fr_CA: Implémentez cette méthode si votre périphérique veut surpasser une préférence particulière. Vous devez vous assurer que tous les sites d'appel qui veulent la préférence qui peut être outrepassée utilise device_prefs['quelque_chose']  au lieu de prefs['quelque_chose']. Votre méthode devrait appeler device_prefs.set_overrides(pref=val, pref=val, ...). Acutellement utilisé pour: gestion de métadonnée (prefs['manage_device_metadata'])

en: Implement this method if you want information about the current calibre library. This method is called at startup and when the calibre library changes while connected.
fr_CA: Implémentez cette méthode si vous voulez des informations sur la bibliothèque calibre actuelle. Cette méthode est appelée au démarrage et lorsque la bibliothèque calibre est changée un fois connecté.

en: Called by the device manager when starting plugins. If this method returns a string, then a) it supports the device manager's dynamic control interface, and b) that name is to be used when talking to the plugin.
fr_CA: Appelée par le gestionnaire de périphérique au lancement des extensions. Si cette méthode renvoie une chaîne, alors a) il supporte le contrôle dynamique d'interface du gestionnaire de périphérique, et b) ce nom doit être utiliser lorsqu'on communique avec l'extension.

en: This method can be called on the GUI thread. A driver that implements this method must be thread safe.
fr_CA: Cette méthode peut être appelée dans le fil GUI. Un pilote qui implémente cette méthode doit être sûr du fil.

en: This method is called to start the plugin. The plugin should begin to accept device connections however it does that. If the plugin is already accepting connections, then do nothing.
fr_CA: Cette méthode est appelée au lancement de l'extension. Cette extension devrait commencer à accepter des connexions de périphériques qu'importe la manière dont ils le font. Si l'extension accepte déjà les connexions, alors ne fait rien.

en: This method is called to stop the plugin. The plugin should no longer accept connections, and should cleanup behind itself. It is likely that this method should call shutdown. If the plugin is already not accepting connections, then do nothing.
fr_CA: Cette méthode est appelée pour arrêter l'extension. Cette extension ne devrait plus accepter de connections et devrait nettoyer derrière lui. Il est probable que cette méthode appel une éteinte. Si cette extension n'accepte déjà plus de connections, alors ne fait rien.

en: Return the value of the option indicated by opt_string. This method can be called when the plugin is not started. Return None if the option does not exist.
fr_CA: Renvoie la valeur de l'option indiquée par opt_string. Cette méthode peut être appelée lorsque l'extension n'est pas lancée. Renvoie None si cette option n'existe pas.

en: Set the value of the option indicated by opt_string. This method can be called when the plugin is not started.
fr_CA: Fixe la valeur de l'option indiquée par opt_string. Cette méthode peut être appelée lorsque l'extension n'est pas lancée.

en: Return True if the plugin is started, otherwise false
fr_CA: Renvoie True si l'extension est lancée, sinon False

en: Called during book matching when a book on the device is matched with a book in calibre's db. The method is responsible for synchronizing data from the device to calibre's db (if needed).
fr_CA: Appelé durant la correspondance de livre lorsqu'un livre sur un périphérique est appareillé avec une livre de la bdd de calibre. La méthode est responsable pour synchroniser les données du périphérique vers la bdd de calibre (si nécessaire).

en: The method must return a two-value tuple. The first value is a set of calibre book ids changed if calibre's database was changed or None if the database was not changed. If the first value is an empty set then the metadata for the book on the device is updated with calibre's metadata and given back to the device, but no GUI refresh of that book is done. This is useful when the calibre data is correct but must be sent to the device.
fr_CA: La méthode doit renvoyer un tuple à deux valeurs. La première valeur est un ensemble des identifiants de livre calibre changés si la base de donnée calibre a été changée ou None si la base de donnée n'a pas été changée. Si la première valeur est un ensemble vide alors les métadonnée pour le livre sur le périphérique sont mises à jour avec les métadonnées de calibre et renvoyée au périphérique, mais aucun rafraîchissement GUI de ce livre n'est effectué. Ceci est pratique lorsque les données de calibre sont justes mais qu'elles doivent être envoyées au périphérique.

en: The second value is itself a 2-value tuple. The first value in the tuple specifies whether a book format should be sent to the device. The intent is to permit verifying that the book on the device is the same as the book in calibre. This value must be None if no book is to be sent, otherwise return the base file name on the device (a string like foobar.epub). Be sure to include the extension in the name. The device subsystem will construct a send_books job for all books with not- None returned values. Note: other than to later retrieve the extension, the name is ignored in cases where the device uses a template to generate the file name, which most do. The second value in the returned tuple indicated whether the format is future-dated. Return True if it is, otherwise return False. calibre will display a dialog to the user listing all future dated books.
fr_CA: La seconde valeur est elle-même un tuple de 2 valeurs. La première valeur dans le tuple spécifie si un format du livre devrait être envoyé au périphérique. L'idée est de permettre de vérifier que le livre sur le périphérique est le même que le livre dans calibre. Cette valeur doit être None si aucun livre ne doit être envoyé, sinon renvoie le nom du fichier de base sur le périphérique (une chaîne comme foobar.epub). Soyez sûr d'inclure l'extension dans le nom. Le sous système du périphérique construira une tâche send_books pour tous les livres qui n'ont pas une valeur None . Note: à part pour récupérer l'extension par après, le nom est ignoré dans le cas où le périphérique utilise un schéma pour générer le nom de fichier, ce que la plupart font. La seconde valeur dans le tuple renvoyé indique si le format est prévu. Renvoie True s'il l'est, sinon renvoie False. calibre affichera une boîte de dialogue à l'utilisateur pour afficher tous les livres prévus.

en: Extremely important: this method is called on the GUI thread. It must be threadsafe with respect to the device manager's thread.
fr_CA: Extrêmement important: cette méthode est appelée sur le fil GUI. Elle doit être en accord avec le fil du gestionnaire de périphérique.

en: book_id: the calibre id for the book in the database. book_metadata: the Metadata object for the book coming from the device. first_call: True if this is the first call during a sync, False otherwise
fr_CA: book_id: l'identificateur calibre pour le livre dans la base de données. book_metadata: la métadonnée pour le livre venant du périphérique. first_call: True si c'est le premier appel durant une synchronisation, sinon False.

en: Bases: :py:class:`list`
fr_CA: Les bases :py:class:`list`

en: A list of books. Each Book object must have the fields
fr_CA: Un liste de livres. Chaque livre doit avoir les champs

en: title
fr_CA: titre

en: authors
fr_CA: auteurs

en: size (file size of the book)
fr_CA: taille (taille du fichier du livre)

en: datetime (a UTC time tuple)
fr_CA: date (un tuple temps UTC)

en: path (path on the device to the book)
fr_CA: chemin (chemin vers le livre sur le périphérique)

en: thumbnail (can be None) thumbnail is either a str/bytes object with the image data or it should have an attribute image_path that stores an absolute (platform native) path to the image
fr_CA: aperçu (peut être None) l'aperçu est soit un str/bytes avec les données de l'image ou il devrait avoir un attribut image_path qui contient un chemin absolu (dépendant de la plateforme) vers le livre

en: tags (a list of strings, can be empty).
fr_CA: identifiant (une liste de chaîne, peut être vide).

en: Return True if the device supports collections for this book list.
fr_CA: Renvoie True si le périphérique supporte les collections de livre pour cette liste de livre.

en: Add the book to the booklist. Intent is to maintain any device-internal metadata. Return True if booklists must be sync'ed
fr_CA: Ajoute le livre dans la liste de livre. L'idée est de maintenir les métadonnées interne du périphérique. Renvoie True si la liste de livre doit être synchronisée.

en: Remove a book from the booklist. Correct any device metadata at the same time
fr_CA: Supprime un livre de la liste de livre. Corrige toutes les métadonnées sur le périphérique en même temps

en: Return a dictionary of collections created from collection_attributes. Each entry in the dictionary is of the form collection name:[list of books]
fr_CA: Renvoie un dictionnaire de collections créée avec collection_attributes. Chaque entrée dans le dictionnaire est sous la forme nom de collection:[liste de livres]

en: The list of books is sorted by book title, except for collections created from series, in which case series_index is used.
fr_CA: La liste de livre est triée par titre, sauf pour les collections créée à partir de séries, auquel cas series_index est utilisé.

en: A list of attributes of the Book object
fr_CA: Un liste d'attribut du livre

en: USB Mass Storage based devices
fr_CA: Périphérique basé sur du stockage de masse USB

en: The base class for such devices is :class:`calibre.devices.usbms.driver.USBMS`. This class in turn inherits some of its functionality from its bases, documented below. A typical basic USBMS based driver looks like this:
fr_CA: La classe de base pour ces périphériques est :class:`calibre.devices.usbms.driver.USBMS`. Cette classe hérite certaines de ces fonctionnalité de ces bases, documentée plus bas. Un pilote basique typique USBMS (USB Mass Storage) ressemble à ceci :

en: Bases: :py:class:`~calibre.devices.usbms.deviceconfig.DeviceConfig`, :py:class:`~calibre.devices.interface.DevicePlugin`
fr_CA: Les bases: :py:class:`~calibre.devices.usbms.deviceconfig.DeviceConfig`, :py:class:`~calibre.devices.interface.DevicePlugin`

en: This class provides logic common to all drivers for devices that export themselves as USB Mass Storage devices. Provides implementations for mounting/ejecting of USBMS devices on all platforms.
fr_CA: Cette classe fournit une logique commune à tous les pilotes pour les périphériques qui s'exportent comme des périphériques de stockage de masse USB. Fournit des implémentation pour monter/éjecter un périphérique USBMS sur toute les plateformes.

en: String identifying the main memory of the device in the Windows PnP id strings This can be None, string, list of strings or compiled regex
fr_CA: Une chaîne identifiant la mémoire principale du périphérique dans les chaines d'identifications PnP de Windows. Ceci peut être None, une chaîne, une liste de chaîne ou une expression régulière compilée

en: String identifying the first card of the device in the Windows PnP id strings This can be None, string, list of strings or compiled regex
fr_CA: Une chaîne identifiant la première carte du périphérique dans les chaines d'identifications PnP de Windows. Ceci peut être None, une chaîne, une liste de chaîne ou une expression régulière compilée

en: String identifying the second card of the device in the Windows PnP id strings This can be None, string, list of strings or compiled regex
fr_CA: Une chaîne identifiant la deuxième carte du périphérique dans les chaines d'identifications PnP de Windows. Ceci peut être None, une chaîne, une liste de chaîne ou une expression régulière compilée

en: Used by the new driver detection to disambiguate main memory from storage cards. Should be a regular expression that matches the main memory mount point assigned by macOS
fr_CA: Utilisé par la détection du nouveau pilote pour dissocier la mémoire principale des cartes mémoires. Devrait-être une expression régulière qui correspond au point de montage de la mémoire principale assignée par macOS

en: The maximum length of paths created on the device
fr_CA: La longueur maximum des chemins créés sur le périphérique

en: Put news in its own folder
fr_CA: Place les nouvelles dans son propre fichier

en: Called to disambiguate main memory and storage card for devices that do not distinguish between them on the basis of `WINDOWS_CARD_NAME`. For example: The EB600
fr_CA: Appelée pour différencier la mémoire principale et les cartes mémoires pour les périphériques qui ne peuvent les différencier sur base de `WINDOWS_CARD_NAME`. par ex. : L'EB600

en: Callback to allow individual device drivers to override the path sanitization used by :meth:`create_upload_path`.
fr_CA: Rappel pour permettre aux pilotes individuels de périphérique d'outrepasser l'expurgation des chemins utilisé par :meth:`create_upload_path`.

en: Callback to allow drivers to change the default file name set by :meth:`create_upload_path`.
fr_CA: Rappel pour permettre aux pilotes de changer le nom de fichier par défaut fixé par :meth:`create_upload_path`.

en: Perform any device specific sanitization on the path components for files to be uploaded to the device
fr_CA: Effectue n'importe quel expurgation de chemins spécifique au périphérique pour les fichiers devant être envoyés au périphérique

en: Resolve path_map to annotation_map of files found on the device
fr_CA: Résous path_map pour annotation_map pour les fichier trouvés sur le périphérique

en: Add an annotation to the calibre library
fr_CA: Ajoute une annotation dans la bibliothèque calibre

en: Bases: :py:class:`~calibre.devices.usbms.cli.CLI`, :py:class:`~calibre.devices.usbms.device.Device`
fr_CA: Les bases: :py:class:`~calibre.devices.usbms.cli.CLI`, :py:class:`~calibre.devices.usbms.device.Device`

en: The base class for all USBMS devices. Implements the logic for sending/getting/updating metadata/caching metadata/etc.
fr_CA: Les classes de base pour tous les périphériques USBMS. Implémente la logique d'envoi/réception/màj/métadonnée/encachement de métadonnée/etc.

en: Upload book cover to the device. Default implementation does nothing.
fr_CA: Envoie les couvertures de livre au périphérique. L'implémentation par défaut ne fait rien.

en: The full path to the folder where the associated book is located.
fr_CA: Le chemin complet vers le dossier où se trouve le livre associé.

en: The name of the book file without the extension.
fr_CA: Le nom du fichier du livre sans l'extension.

en: metadata belonging to the book. Use metadata.thumbnail for cover
fr_CA: métadonnée appartenant au livre. Utilisez metadata.thumbnail pour les couvertures

en: The full path to the e-book file
fr_CA: Le chemin absolu vers le livre numérique

en: Return path with platform native path separators
fr_CA: Renvoie le chemin avec les séparateurs de chemin natif à la platforme

en: User interface actions
fr_CA: Actions interface utilisateur

en: If you are adding your own plugin in a ZIP file, you should subclass both InterfaceActionBase and InterfaceAction. The :meth:`load_actual_plugin` method of your InterfaceActionBase subclass must return an instantiated object of your InterfaceBase subclass.
fr_CA: Si vous ajoutez votre propre extension dans un fichier ZIP, vous devriez sous-classer InterfaceActionBase et InterfaceAction. La méthode :meth:`load_actual_plugin`  de votre sous-classe InterfaceActionBase doit renvoyer un objet instancié de  votre sous-classe InterfaceBase.

en: A plugin representing an "action" that can be taken in the graphical user interface. All the items in the toolbar and context menus are implemented by these plugins.
fr_CA: Une extension représentant une "action" qui peut être effectuée dans le GUI. Tous les menus de la barre d'outil et les menus contextuels sont implémentés par ces extensions.

en: Note that this class is the base class for these plugins, however, to integrate the plugin with calibre's plugin system, you have to make a wrapper class that references the actual plugin. See the :mod:`calibre.customize.builtins` module for examples.
fr_CA: Notez que cette classe est la classe de base pour ces extensions, toutefois, pour intégrer l'extension avec le système d'extension de calibre, vous devez avoir une classe englobante qui référence la vrai extension.Voir le module :mod:`calibre.customize.builtins` pour des exemples.

en: If two :class:`InterfaceAction` objects have the same name, the one with higher priority takes precedence.
fr_CA: Si deux objets :class:`InterfaceAction` ont le même nom, celui avec la priorité la plus haute à préséance.

en: Sub-classes should implement the :meth:`genesis`, :meth:`library_changed`, :meth:`location_selected`, :meth:`shutting_down`, :meth:`initialization_complete` and :meth:`tag_browser_context_action` methods.
fr_CA: Les sous-classes devrait implémenter les méthodes :meth:`library_changed`, :meth:`location_selected`, :meth:`shutting_down`, :meth:`initialization_complete` et :meth:`tag_browser_context_action`.

en: Once initialized, this plugin has access to the main calibre GUI via the :attr:`gui` member. You can access other plugins by name, for example::
fr_CA: Une fois initialisé, cette extension à accès au Gui principal de calibre via le membre :attr:`gui`. Vous pouvez accéder d'autres extensions par nom, par exemple::

en: To access the actual plugin, use the :attr:`interface_action_base_plugin` attribute, this attribute only becomes available after the plugin has been initialized. Useful if you want to use methods from the plugin class like do_user_config().
fr_CA: Pour accéder à la réelle extension, utiliser l'attribut :attr:`interface_action_base_plugin`, cet attribut devient disponible uniquement après que l'extension ait été initialisée. Utile si vous souhaitez utiliser des méthodes de la classe extension comme do_user_config().

en: The QAction specified by :attr:`action_spec` is automatically create and made available as ``self.qaction``.
fr_CA: La QAction spécifiée par :attr:`action_spec` est automatiquement créée et rendue disponible sous ``self.qaction``.

en: The plugin name. If two plugins with the same name are present, the one with higher priority takes precedence.
fr_CA: Le nom de l'extension. Si deux extensions avec le même nom sont présentes, celle avec la plus haute priorité à préséance.

en: The plugin priority. If two plugins with the same name are present, the one with higher priority takes precedence.
fr_CA: La priorité de l'extension. Si deux extensions avec le même nom sont présentes, celle avec la plus haute priorité a préséance.

en: The menu popup type for when this plugin is added to a toolbar
fr_CA: Le type de menu contextuel pour lorsque cette extension est ajoutée à la barre d'outils

en: Whether this action should be auto repeated when its shortcut key is held down.
fr_CA: Si cette action devrait être répétée automatiquement lorsque son raccourci est maintenant enfoncé.

en: If True, a menu is automatically created and added to self.qaction
fr_CA: Si True, un menu est automatiquement créé et ajouté à self.qaction

en: If True, a clone of self.qaction is added to the menu of self.qaction If you want the text of this action to be different from that of self.qaction, set this variable to the new text
fr_CA: Si True, un clône de self.qaction est ajouté au menu de self.qaction. Si vous souhaitez que le texte de cette action soit différent de self.qaction, fixer cette variable aux nouveau texte

en: Set of locations to which this action must not be added. See :attr:`all_locations` for a list of possible locations
fr_CA: Ensemble d'emplacements vers lesquels cette action ne doit pas être ajoutée. Voir :attr:`all_locations` pour une liste des emplacements possible

en: Set of locations from which this action must not be removed. See :attr:`all_locations` for a list of possible locations
fr_CA: Ensemble d'emplacements d'où cette action ne doit pas être supprimé. Voir :attr:`all_locations` pour une liste des emplacements possible

en: Type of action 'current' means acts on the current view 'global' means an action that does not act on the current view, but rather on calibre as a whole
fr_CA: Type d'action. 'current' signifie qu'il agit sur la vue courante, 'global' représente une action qui ne change pas la vue courante, mais plutôt calibre tout entier

en: If True, then this InterfaceAction will have the opportunity to interact with drag and drop events. See the methods, :meth:`accept_enter_event`, :meth`:accept_drag_move_event`, :meth:`drop_event` for details.
fr_CA: Si True, alors cette InterfaceAction aura l'opportunité d’interagir avec les événements glisser-déposer. Voir les méthodes :meth:`accept_enter_event`, :meth`:accept_drag_move_event`, :meth:`drop_event` pour plus de détails.

en: This method should return True iff this interface action is capable of handling the drag event. Do not call accept/ignore on the event, that will be taken care of by the calibre UI.
fr_CA: Cette méthode devrait renvoyer True ssi cette action d'interface est capable de gérer les événements glisser. Ne pas appeler accepter/ignorer sur l'événement, ceci sera géré par l'UI de calibre.

en: This method should perform some useful action and return True iff this interface action is capable of handling the drop event. Do not call accept/ignore on the event, that will be taken care of by the calibre UI. You should not perform blocking/long operations in this function. Instead emit a signal or use QTimer.singleShot and return quickly. See the builtin actions for examples.
fr_CA: Cette méthode devrait effectuer des actions utiles et renvoyer True ssi cette action interface est capable de gérer les événement déposer. Ne pas appeler accepter/ignorer sur cet événement, cela sera géré par l'UI de calibre. Vous ne devriez pas effectuer d'opérations longues/bloquantes avec cette fonction. À la place, émettez un signal ou utiliser un QTimer.singleShot et renvoyez rapidement. Voir les actions intégrées pour des exemples.

en: Convenience method to easily add actions to a QMenu. Returns the created QAction. This action has one extra attribute calibre_shortcut_unique_name which if not None refers to the unique name under which this action is registered with the keyboard manager.
fr_CA: Une méthode commode pour ajouter facilement des actions à un QMenu. Renvoie la QAction créée. Cette action a un attribut de plus, calibre_shortcut_unique_name qui s'il n'est pas None réfère à un nom unique sous lequel cette action est enregistrée dans le gestionnaire du clavier.

en: The QMenu the newly created action will be added to
fr_CA: Le QMenu auquel la nouvelle action créée sera ajouté

en: A unique name for this action, this must be globally unique, so make it as descriptive as possible. If in doubt, add an UUID to it.
fr_CA: Un nom unique pour cette action, ceci doit être globalement unique, donc faites en sorte qu'il soit le plus descriptif possible. Dans le doute, ajoutez-y un UUID

en: The text of the action.
fr_CA: Le texte de l'action.

en: A string, a list of strings, None or False. If False, no keyboard shortcut is registered for this action. If None, a keyboard shortcut with no default keybinding is registered. String and list of strings register a shortcut with default keybinding as specified.
fr_CA: Une chaîne, un ensemble de chaînes, None ou False. Si False, aucun raccourci clavier ne sera enregistré pour cette action. Si None, un raccourci clavier sans touche par défaut est enregistré. La chaîne et la liste de chaîne enregistre un raccourci avec une touche par défaut comme spécifié.

en: A description for this action. Used to set tooltips.
fr_CA: Une description pour cette action. Utilisée pour fixer les infobulles.

en: A callable which is connected to the triggered signal of the created action.
fr_CA: Un appelable qui est connecté au signal déclenché de l'action créée.

en: The text displayed to the user when customizing the keyboard shortcuts for this action. By default it is set to the value of ``text``.
fr_CA: Le texte affiché à l'utilisateur lors de la personnalisation des raccourcis clavier pour cette action. Par défaut il est fixer à une valeur ``text``.

en: Shortcuts for actions that don't always appear, or are library dependent, may disappear when other keyboard shortcuts are edited unless ```persist_shortcut``` is set True.
fr_CA: Les raccourcis pour les actions qui n'apparaissent pas toujours, ou qui dépendent de la bibliothèque, peuvent disparaître lorsque d'autres raccourcis clavier sont édités, sauf si "Persist_shortcut" est réglé sur True.

en: A dictionary of the form ``{name : file_contents}``. Any names that were not found in the ZIP file will not be present in the dictionary.
fr_CA: Un dictionnaire sous la forme ``{name : file_contents}``. Tout nom qui n'est pas trouvé dans le fichier ZIP ne sera pas présent dans le dictionnaire.

en: Setup this plugin. Only called once during initialization. self.gui is available. The action specified by :attr:`action_spec` is available as ``self.qaction``.
fr_CA: Paramètre cette extension. Uniquement appelé une fois lors de l'initialisation. self.gui est disponible. L'action spécifiée par :attr:`action_spec` est disponible à ``self.qaction``.

en: Called whenever the book list being displayed in calibre changes. Currently values for loc are: ``library, main, card and cardb``.
fr_CA: Appelé dès que la liste de livre étant affichée dans calibre change. Actuellement, les valeur pour loc sont: ``library, main, card and cardb``.

en: This method should enable/disable this action and its sub actions as appropriate for the location.
fr_CA: Cette méthode devrait activer/désactiver cette action et ces sous-actions en fonction de l'emplacement

en: Called whenever the current library is changed.
fr_CA: Appelé dès que la bibliothèque actuelle est changée.

en: The LibraryDatabase corresponding to the previous library.
fr_CA: La LibraryDatabase correspondant à la bibliothèque précédente

en: The LibraryDatabase corresponding to the new library.
fr_CA: La LibraryDatabase correspondant à la nouvelle bibliothèque.

en: The LibraryDatabase corresponding to the current library.
fr_CA: La LibrabyDatabase correspondant à la bibliothèque actuelle

en: Called once per action when the layout of the main GUI is completed. If your action needs to make changes to the layout, they should be done here, rather than in :meth:`initialization_complete`.
fr_CA: Appelée une fois par action lorsque l'affichage du Gui principal est complété. Si votre action nécessite de faire des changements dans l'affichage, elles devraient être faite ici, plutôt que dans :meth:`initialization_complete`.

en: Called once per action when the initialization of the main GUI is completed.
fr_CA: Appelée un fois par action lorsque l'initiation du GUI principal est complète.

en: Called when displaying the context menu in the Tag browser. ``index`` is the QModelIndex that points to the Tag browser item that was right clicked. Test it for validity with index.valid() and get the underlying TagTreeItem object with index.data(Qt.ItemDataRole.UserRole). Any action objects yielded by this method will be added to the context menu.
fr_CA: Appelé lors de l'affichage du menu contextuel dans le Navigateur d'étiquettes. ``index`` est le QModelIndex qui pointe vers l'élément du Navigateur d'étiquettes qui a été cliqué avec le bouton droit. Testez sa validité avec index.valid() et obtenez l'objet TagTreeItem sous-jacent avec index.data(Qt.ItemDataRole.UserRole). Tout objet d'action produit par cette méthode sera ajouté au menu contextuel.

en: Called once per plugin when the main GUI is in the process of shutting down. Release any used resources, but try not to block the shutdown for long periods of time.
fr_CA: Appelée une fois par extension lorsque le GUI principal est en train de s'éteindre. Relâche toute les ressources utilisée, mais essaye de ne pas bloquer l’arrêt pour un longue période.

en: This method must return the actual interface action plugin object.
fr_CA: Cette méthode doit renvoyer l'extension d'action interface correspondante.

en: Preferences plugins
fr_CA: Extensions préférences

en: A plugin representing a widget displayed in the Preferences dialog.
fr_CA: Une extension représentant un widget affiché dans la boîte de dialogue des préférences.

en: This plugin has only one important method :meth:`create_widget`. The various fields of the plugin control how it is categorized in the UI.
fr_CA: Cette extension n'a qu'un méthode importante :meth:`create_widget`. Les différents champs de l'extension contrôlent comment c'est catégorisé dans l'UI.

en: Import path to module that contains a class named ConfigWidget which implements the ConfigWidgetInterface. Used by :meth:`create_widget`.
fr_CA: Importe le chemin vers le module qui contient une classe nommée ConfigWidget qui implémente ConfigWidgetInterface. Utilisé par :meth:`create_widget`.

en: Where in the list of categories the :attr:`category` of this plugin should be.
fr_CA: Où dans la liste de catégories la :attr:`catégorie` de cette extension devrait se trouver.

en: Where in the list of names in a category, the :attr:`gui_name` of this plugin should be
fr_CA: Où dans la liste de noms d'une catégorie, le :attr:`gui_name` de cette extension devrait se trouver

en: The category this plugin should be in
fr_CA: La catégorie où devrait se trouver cette extension

en: The category name displayed to the user for this plugin
fr_CA: Le nom de catégorie affiché à l'utilisateur pour cette extension

en: The name displayed to the user for this plugin
fr_CA: Le nom affiché à l'utilisateur pour cette extension

en: The icon for this plugin, should be an absolute path
fr_CA: L'icône pour cette extension, devrait être un chemin absolu

en: The description used for tooltips and the like
fr_CA: La description pour les infobulles etc

en: Create and return the actual Qt widget used for setting this group of preferences. The widget must implement the :class:`calibre.gui2.preferences.ConfigWidgetInterface`.
fr_CA: Crée et renvoie le Qt widget effectivement utilisé pour paramétrer ce groupe de préférence. Le widget doit implémenter la :class:`calibre.gui2.preferences.ConfigWidgetInterface`.

en: The default implementation uses :attr:`config_widget` to instantiate the widget.
fr_CA: L'implémentation par défaut utilise :attr:`config_widget` pour instancié le widget.

en: This class defines the interface that all widgets displayed in the Preferences dialog must implement. See :class:`ConfigWidgetBase` for a base class that implements this interface and defines various convenience methods as well.
fr_CA: Cette classe définit l'interface que tous les widgets affichée dans la boîte de dialogues de Préférences doit implémenter. Voir :class:`ConfigWidgetBase` pour une classe de base qui implémente cette interface et définit aussi des méthodes pratiques.

en: This signal must be emitted whenever the user changes a value in this widget
fr_CA: Ce signal doit être émis dès que l'utilisateur change une valeur de ce widget

en: Set to True iff the :meth:`restore_to_defaults` method is implemented.
fr_CA: Fixer à TRue ssi la méthode :class:`ConfigWidgetBase` est implémentée.

en: The tooltip for the "Restore defaults" button
fr_CA: L'infobulle pour le bouton "Restauration des paramètres par défaut"

en: If True the Preferences dialog will not allow the user to set any more preferences. Only has effect if :meth:`commit` returns True.
fr_CA: Si True, le la boite de dialogue de Préférence ne permettra pas à l'utilisateur d'ajouter d'autres préférences. A de l'effet uniquement si :meth:`commit` renvoie True.

en: Called once before the widget is displayed, should perform any necessary setup.
fr_CA: Appelé une fois avant que le widget ne soit affiché, devrait effectuer les paramétrages nécessaire

en: The main calibre graphical user interface
fr_CA: L'interface graphique utilisateur principale de calibre

en: Should set all config values to their initial values (the values stored in the config files). A "return" statement is optional. Return False if the dialog is not to be shown.
fr_CA: Devrait définir toutes les valeurs de configuration à leurs valeurs initiales (les valeurs stockées dans les fichiers de configuration). L'instruction "return" est facultative. Renvoie False si la boîte de dialogue ne doit pas être affichée.

en: Should set all config values to their defaults.
fr_CA: Devrait fixer toutes les valeurs de configuration à leur valeur par défaut.

en: Save any changed settings. Return True if the changes require a restart, False otherwise. Raise an :class:`AbortCommit` exception to indicate that an error occurred. You are responsible for giving the user feedback about what the error is and how to correct it.
fr_CA: Sauve tout changement de paramètre. Renvoie True si les changements requière un redémarrage, sinon False. Crée un exception :class:`AbortCommit pour indiquer qu'une erreur est survenue. Vous êtes responsable de donner des informations à l'utilisateur sur ce qu'est l'erreur et comment la corriger.

en: Called once after this widget is committed. Responsible for causing the gui to reread any changed settings. Note that by default the GUI re-initializes various elements anyway, so most widgets won't need to use this method.
fr_CA: Appelée une fois que ce widget est engagé. Responsable la relecture par le GUI de tous les paramètres modifiés. Notez que par défaut le GUI réinitialise de toutes façon différents éléments, donc la plupart des widgets ne nécessitent pas cette méhode.

en: Base class that contains code to easily add standard config widgets like checkboxes, combo boxes, text fields and so on. See the :meth:`register` method.
fr_CA: Une classe de base qui contient du code pour ajouter facilement des widgets de configuration standards comme des cases, des listes déroulantes, des zones de textes, etc. Voir la méthode :meth:`register`.

en: This class automatically handles change notification, resetting to default, translation between gui objects and config objects, etc. for registered settings.
fr_CA: Cette classe gère automatiquement changement de notification, les remises aux paramètres par défaut, la traduction entre les objets GUI et les objets configuration, etc. pour l'enregistrement de paramètres.

en: If your config widget inherits from this class but includes setting that are not registered, you should override the :class:`ConfigWidgetInterface` methods and call the base class methods inside the overrides.
fr_CA: Si votre widget de configuration hérite de cette classe mais inclus des paramètres qui ne sont pas enregistrés, vous devriez outrepasser les méthodes :class:`ConfigWidgetInterface`  et appelé les méthodes de base à l’intérieur des dérogations.

en: Register a setting.
fr_CA: Enregistrer un paramètre.

en: The setting name
fr_CA: Le nom du paramètre

en: The config object that reads/writes the setting
fr_CA: Un configuration qui lit/écrit le paramètre

en: The name of the GUI object that presents an interface to change the setting. By default it is assumed to be ``'opt_' + name``.
fr_CA: Le nom de l'objet GUI qui présente une interface à changer par le paramètre. Par défaut, il est présumé être ``'opt_' + name``.

en: If this setting is a multiple choice (combobox) based setting, the list of choices. The list is a list of two element tuples of the form: ``[(gui name, value), ...]``
fr_CA: Si le paramètre est un paramètre de base à plusieurs choix (une liste déroulante), la liste de choix. La liste est une liste de tuples sous la forme ``[(nom GUI, valeur), ...]``

en: The class responsible for managing this setting. The default class handles almost all cases, so this param is rarely used.
fr_CA: La classe responsable de la gestion de ce paramètre. La classe par défaut gère presque ous les cas, donc ce paramètre est rarement utilisé.
