calibre - en to es translation catalogue (396 entries)

en: API documentation for plugins
es: Documentación de la API para complementos

en: Defines various abstract base classes that can be subclassed to create powerful plugins. The useful classes are:
es: Define varias clases abstractas de base que pueden usarse para crear potentes complementos como subclase. Las clases útiles son:

en: Plugin
es: Complemento

en: A calibre plugin. Useful members include:
es: Un complemento de calibre. Los miembros útiles incluyen:

en: ``self.installation_type``: Stores how the plugin was installed.
es: ``self.installation_type``: Almacena cómo se instaló el complemento.

en: ``self.plugin_path``: Stores path to the ZIP file that contains
es: ``self.plugin_path``: Almacena la ubicación del archivo ZIP que contiene

en: this plugin or None if it is a builtin plugin
es: este complemento o None si es un complemento predefinido

en: ``self.site_customization``: Stores a customization string entered
es: ``self.site_customization``: Guarda un texto de personalización introducido

en: by the user.
es: por el usuario.

en: Methods that should be overridden in sub classes:
es: Métodos que deben reemplazarse en subclases:

en: Useful methods:
es: Métodos útiles:

en: List of platforms this plugin works on. For example: ``['windows', 'osx', 'linux']``
es: Lista de plataformas con las que este complemento es compatible. Por ejemplo: ``['windows', 'osx', 'linux']``

en: The name of this plugin. You must set it something other than Trivial Plugin for it to work.
es: El nombre de este complemento. Debe establecer algo distinto de «Trivial Plugin» para que funcione.

en: The version of this plugin as a 3-tuple (major, minor, revision)
es: La versión de este complemento como una 3-tupla (mayor, menor, revisión)

en: A short string describing what this plugin does
es: Una breve descripción de lo que hace este complemento

en: The author of this plugin
es: El autor de este complemento

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.
es: Cuando existe más de un complemento para un tipo de archivo, los complementos se ejecutarán en orden de prioridad decreciente. Los complementos de mayor prioridad se ejecutarán primero. La prioridad más alta posible es ``sys.maxsize``. La prioridad predeterminada es 1.

en: The earliest version of calibre this plugin requires
es: La versión más antigua requerida por este complemento

en: The way this plugin is installed
es: La manera en que se instaló este complemento

en: If False, the user will not be able to disable this plugin. Use with care.
es: Si es False, el usuario no podrá deshabilitar este complemento. Usar con precaución.

en: The type of this plugin. Used for categorizing plugins in the GUI
es: El tipo de este complemento. Utilizado para clasificar los complementos en la interfaz gráfica.

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.
es: Se ejecuta una vez cuando se inicializan los complementos de calibre. Los complementos se vuelven a inicializar cada vez que se añade uno nuevo. Tenga en cuenta que si el complemento se ejecuta como un proceso de trabajo, por ejemplo para añadir libros, el complemento debe inicializarse por cada nuevo proceso.

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``.
es: Realice cualquier inicialización específica del complemento aquí, tal como extraer recursos del archivo ZIP del complemento. La ruta al archivo ZIP está disponible como ``self.plugin_path``.

en: Note that ``self.site_customization`` is **not** available at this point.
es: Tenga en cuenta que ``self.site_customization`` **no** está disponible en este punto.

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.
es: Implemente este método y :meth:`save_settings` en el complemento para usar un cuadro de diálogo de configuración personalizado, en lugar de emplear la configuración predeterminada basada en textos.

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.
es: Este método, si se implementa, debe devolver un QWidget. El widget puede tener un método opcional :meth:`validate` que no toma ningún argumento y se ejecuta en cuanto el usuario pulsa el botón «Aceptar». Los cambios se aplican si y sólo si el método devuelve 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.
es: Si por alguna razón no se puede realizar la configuración en este momento, deberá devolver una tupla de dos textos (mensaje, detalles), que se mostrarán como un cuadro de diálogo de advertencia al usuario y el proceso se cancelará.

en: Save the settings specified by the user with config_widget.
es: Guardar las configuraciones especificadas por el usuario con config_widget.

en: Parameters
es: Parámetros

en: The widget returned by :meth:`config_widget`.
es: El widget devuelto por :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.
es: Este método muestra un diálogo de configuración para este complemento. Devuelve True si el usuario pulsa en «Aceptar» o False en caso contrario. Los cambios se aplican automáticamente.

en: If this plugin comes in a ZIP file (user added plugin), this method will allow you to load resources from the ZIP file.
es: Si este complemento viene en un archivo en formato ZIP (complemento añadido por el usuario), este método le permitirá cargar recursos desde el archivo ZIP.

en: For example to load an image::
es: Por ejemplo, para cargar una imagen::

en: List of paths to resources in the ZIP file using / as separator
es: Lista de rutas a los recursos en el archivo ZIP utilizando / como separador

en: Returns
es: Devuelve

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.
es: Un diccionario de la forma ``{nombre: contenido_del_archivo}``. Cualquier nombre que no se encuentre en el archivo ZIP, no estará en el diccionario.

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.
es: Devuelve un texto que ofrece ayuda sobre cómo personalizar este complemento. De manera predeterminada, genera el error :class:`NotImplementedError`, que indica que el complemento no necesita personalización.

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``.
es: Si reimplementa este método en la subclase, se le pedirá al usuario que introduzca un texto como personalización para este complemento. El texto de personalización estará disponible como ``self.site_customization``.

en: Site customization could be anything, for example, the path to a needed binary on the user's computer.
es: site_customization puede ser cualquier cosa, por ejemplo, la ruta de acceso a un archivo binario necesario en el equipo del usuario.

en: If True return HTML help, otherwise return plain text help.
es: Si es True devuelve la ayuda HTML, de lo contrario devuelve ayuda de texto sin formato.

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.
es: Devuelve un objeto de tipo archivo que es un archivo temporal en el sistema de archivos. Este archivo permanecerá disponible incluso después de cerrarse y sólo se eliminará al terminar el intérprete. Utilice el miembro ``name`` del objeto devuelto para acceder a la ruta completa del archivo temporal creado.

en: The suffix that the temporary file will have.
es: El sufijo del archivo temporal.

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.
es: Este método es el principal punto de acceso para la interfaz de línea de órdenes de los complementos. Se ejecuta cuando el usuario teclea: calibre-debug -r "Nombre del complemento". Todos los argumentos que se pasen están presentes en la variable ``args``.

en: A plugin that is associated with a particular set of file types.
es: Un complemento asociado con un determinado conjunto de tipos de archivo.

en: Set of file types for which this plugin should be run. Use '*' for all file types. For example: ``{'lit', 'mobi', 'prc'}``
es: Conjunto de tipos de archivo para que este complemento debe ejecutarse. Use ``'*'`` para todos los tipos de archivo. Por ejemplo: ``{'lit', 'mobi', 'prc'}``

en: If True, this plugin is run when books are added to the database
es: Si es True, este complemento se ejecuta cuando se añaden libros a la base de datos

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.
es: Si es True, este complemento se ejecuta después de añadir libros a la base de datos. En tal caso, se ejecutarán los métodos de :meth:`postimport` y :meth:`postadd` del complemento.

en: If True, this plugin is run after a book is converted. In this case the postconvert method of the plugin is called.
es: Si es True, este complemento se ejecuta después de convertir un libro. En tal caso, se ejecutará el método :meth:`postconvert` del complemento.

en: If True, this plugin is run after a book file is deleted from the database. In this case the postdelete method of the plugin is called.
es: Si es True, este complemento se ejecuta después de eliminar un archivo de libro de la base de datos. En tal caso, se ejecutará el método :meth:`postdelete` del complemento.

en: If True, this plugin is run just before a conversion
es: Si es True, este complemento se ejecuta justo antes de una conversión

en: If True, this plugin is run after conversion on the final file produced by the conversion output plugin.
es: Si es True, este complemento se ejecuta después de la conversión sobre el archivo final producido por el complemento de salida de conversión.

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).
es: Ejecutar el complemento. Debe implementarse en subclases. Debe realizar cualquier modificación necesaria sobre el libro y devolver la ruta absoluta al libro modificado. Si no se necesita ninguna modificación, debe devolver la ruta de acceso al libro original. Si ocurre un error, debe generar una excepción. La implementación predeterminada simplemente devuelve la ruta de acceso al libro original. Tenga en cuenta que la ruta al archivo original (antes de que se ejecute ningún complemento de tipo de archivo) está disponible como ``self.original_path_to_file``.

en: The modified e-book file should be created with the :meth:`temporary_file` method.
es: El archivo de libro electrónico modificado debe crearse con el método :meth:`temporary_file`.

en: Absolute path to the e-book.
es: Ruta absoluta al libro electrónico.

en: Absolute path to the modified e-book.
es: Ruta absoluta al libro electrónico modificado.

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.
es: Se ejecuta después de la importación, es decir, después de añadir el archivo del libro a la base de datos. Tenga en cuenta que se trata de un método diferente de :meth:`postadd`, que se ejecuta cuando se crea el registro del libro por primera vez. Este método se ejecuta siempre que se añade un archivo nuevo al registro del libro. Resulta útil para modificar el registro del libro según el contenido del archivo recién añadido.

en: Database id of the added book.
es: Identificador de la base de datos del libro añadido.

en: The file type of the book that was added.
es: El tipo de archivo del libro que se ha añadido.

en: Library database.
es: Base de datos de biblioteca.

en: Called post conversion, i.e., after the conversion output book file has been added to the database. Note that it is run after a conversion only, not after a book is added. It is useful for modifying the book record based on the contents of the newly added file.
es: Se ejecuta después de la conversión, es decir, después de añadir el archivo del libro de salida a la base de datos. Tenga en cuenta que sólo se ejecuta después de una conversión, no cuando se añade un libro. Resulta útil para modificar el registro del libro según el contenido del archivo recién añadido.

en: Called post deletion, i.e., after the book file has been deleted from the database. Note that it is not run when a book record is deleted, only when one or more formats from the book are deleted. It is useful for modifying the book record based on the format of the deleted file.
es: Se ejecuta después de la eliminación, es decir, después de eliminar el archivo del libro de la base de datos. Tenga en cuenta que no se ejecuta cuando se elimina un registro de libro, sólo cuando se elimina uno o más formatos del libro. Resulta útil para modificar el registro del libro según el formato del archivo eliminado.

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.
es: Se ejecuta después la creación, es decir, después de añadir un nuevo libro a la base de datos. Tenga en cuenta que se trata de un método diferente de :meth:`postimport`, que se ejecuta cuando se añade un archivo de libro a un registro. Este método se ejecuta sólo cuando se crea un nuevo registro de libro, que puede contener más de un archivo de libro. Resulta útil si desea modificar el registro del libro en la base de datos cuando se añade el libro por primera vez en 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.
es: Correspondencia de formato de archivo con ruta desde la que se añadió el archivo. Tenga cuenta que esto puede apuntar a un archivo existente en realidad o no, pues a veces se añaden archivos como flujos, en cuyo caso puede ser un valor inútil o una ruta no existente.

en: Library database
es: Base de datos de biblioteca

en: Metadata plugins
es: Complementos de metadatos

en: A plugin that implements reading metadata from a set of file types.
es: Un complemento que implementa la lectura de metadatos de un conjunto de tipos de archivo.

en: Set of file types for which this plugin should be run. For example: ``set(['lit', 'mobi', 'prc'])``
es: Conjunto de tipos de archivo para los que este complemento debe ejecutarse. Por ejemplo: ``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.
es: Devuelve metadatos del archivo representado por `stream` (un objeto de tipo archivo que admite lectura). Genera una excepción si hay un error con los datos de entrada.

en: The type of file. Guaranteed to be one of the entries in :attr:`file_types`.
es: El tipo del archivo. Es con seguridad una de las entradas en :attr:`file_types`.

en: A :class:`calibre.ebooks.metadata.book.Metadata` object
es: Un objeto :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.
es: Establece los metadatos del archivo representado por `stream` (un objeto de tipo archivo que admite lectura). Genera una excepción si hay un error con los datos de entrada.

en: Catalog plugins
es: Complementos de catálogo

en: A plugin that implements a catalog generator.
es: Un complemento que implementa un generador de catálogos.

en: Output file type for which this plugin should be run. For example: 'epub' or 'xml'
es: Tipo de archivo de salida para el que debe ejecutarse este complemento. Por ejemplo: «epub» o «xml»

en: CLI parser options specific to this plugin, declared as `namedtuple` `Option`:
es: Opciones del intérprete de línea de órdenes específicas de este complemento, declaradas como un `namedtuple` `Option`:

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
es: Si el complemento no es uno de los incorporados, copiar los archivos .ui y .py del archivo ZIP a $TMPDIR. Se generará dinámicamente una pestaña que se añadirá a las opciones de catálogo en 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.
es: Ejecutar el complemento. Debe implementarse en subclases. Debe generar el catálogo en el formato especificado en `file_types` y devolver la ruta de acceso absoluta al archivo de catálogo generado. Si ocurre un error, debe generar una excepción.

en: The generated catalog file should be created with the :meth:`temporary_file` method.
es: El archivo del catálogo generado debe crearse con el método :meth:`temporary_file`.

en: Absolute path to the generated catalog file.
es: Ruta absoluta al archivo de catálogo generado.

en: A dictionary of keyword arguments
es: Un diccionario de argumentos de palabras claves

en: A LibraryDatabase2 object
es: Un objeto LibraryDatabase2

en: Metadata download plugins
es: Complementos de descarga de metadatos

en: Set of capabilities supported by this plugin. Useful capabilities are: 'identify', 'cover'
es: Conjunto de capacidades ofrecidas por este complemento. Algunas capacidades útiles son: 'identify', 'cover'

en: List of metadata fields that can potentially be download by this plugin during the identify phase
es: Lista de campos de metadatos que este complemento puede descargarse durante la fase de identificación.

en: Set this to True if your plugin returns HTML formatted comments
es: Establézcala a True si el complemento devuelve comentarios en formato 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
es: Si se establece en True el objeto de navegador indicará que admite transferencias codificadas con gzip. Esto puede acelerar las descargas, pero asegúrese primero de que el origen admite transferencias codificadas con gzip correctamente

en: Set this to True to ignore HTTPS certificate errors when connecting to this source.
es: Si se establece en true se ignoran los errores de certificado HTTPS al conectar con este origen.

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
es: Los URL de portadas en caché no siempre son fiables (la descarga puede fallar o la imagen puede ser incorrecta). Si esto ocurre a menudo con este origen, establézcalo en False

en: A list of :class:`Option` objects. They will be used to automatically construct the configuration widget for this plugin
es: Una lista de objetos :class:`Option`. Se usarán para construir automáticamente el widget de configuración para este complemento

en: A string that is displayed at the top of the config widget for this plugin
es: Un texto que se muestra en la parte superior del widget de configuración de este complemento.

en: If True this source can return multiple covers for a given query
es: Si es True este recurso puede devolver múltiples portadas para una consulta dada

en: If set to True covers downloaded by this plugin are automatically trimmed.
es: Si se establece en True, las portadas descargadas por este complemento se recortan automáticamente.

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
es: Si se establece en True, y esta fuente devuelve múltiples resultados para una consulta, algunos de los cuales tienen ISBN y otros no, los resultados sin ISBN se ignorarán

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.
es: Devuelve False si el complemento necesita configurarse antes de usarlo. Por ejemplo, puede requerir un nombre de usuario, contraseña o clave API.

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.
es: Toma una lista de autores y devuelve una lista de elementos útiles para una consulta de búsqueda AND. Esta función intenta devolver elementos con el orden «nombres apellidos», suponiendo que si hay una coma en nombre de autor, el nombre está en la forma «apellidos, nombre».

en: Take a title and return a list of tokens useful for an AND search query. Excludes connectives(optionally) and punctuation.
es: Toma un título y devuelve una lista de elementos útiles para una consulta de búsqueda AND. Excluye conectores (opcionalmente) y puntuación.

en: Split a list of jobs into at most num groups, as evenly as possible
es: Divide una lista de tareas en `num` grupos como máximo, tan igualados como sea posible

en: Return the first field from self.touched_fields that is null on the mi object
es: Devuelve el primer campo de `self.touched_fields` que es nulo en el objeto `mi`

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.
es: Ejecutar este métedo en el método de identificación del complemento para normalizar los metadatos antes de poner el objeto `mi` en `result_queue`. Lógicamente puede usar un algoritmo personalizado adecuado a la fuente de metadatos.

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.
es: Devuelve una 3-tupla o None. La 3-tupla es de la forma: (tipo_identificador, valor_identificador, URL). ``URL`` es el URL del libro identificado por los identificadores en este origen. ``tipo_identificador`` y ``valor_identificador`` especifican el identificador correspondiente al URL. Este URL debe ser accesible a un humano por medio de un navegador. El propósito es proporcionar un enlace que el usuario pueda pulsar para visitar la página del libro en este origen. Si no se encuentra ningún URL, devuelve None. Este método debe ser rápido y coherente, por lo que sólo debe implementarlo si es posible construir el URL mediante un esquema conocido dado ``identifiers``.

en: Return a human readable name from the return value of get_book_url().
es: Devuelve un nombre legible por humanos a partir valor devuelto por get_book_url().

en: Override this method if you would like to return multiple URLs for this book. Return a list of 3-tuples. By default this method simply calls :func:`get_book_url`.
es: Sustituya este método si desea devolver varios URL para este libro. Devuelve una lista de 3-tuplas. De manera predeterminada, este método simplemente ejecuta :func:`get_book_url`.

en: Return cached cover URL for the book identified by the identifiers dictionary or None if no such URL exists.
es: Devuelve el URL de portada en caché para el libro identificado por el diccionario ``identifiers`` o None si no existe el 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.
es: Tenga en cuenta que este método sólo debe devolver URL validados, es decir no URL que puedan resultar en una imagen de portada genérica o un error.

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.
es: Analiza un URL y devuelve una tupla de la forma: (tipo_de_identificador, valor_de_identificador). Si el URL no coincide con el patrón del origen de metadatos, devuelve 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).
es: Devuelve una función empleada para generar una clave que pueda ordenar objetos de tipo :class:`Metadata` por su relevancia dada una consulta de búsqueda (``title``, ``authors``, ``identifiers``).

en: These keys are used to sort the results of a call to :meth:`identify`.
es: Estas claves se usan para ordenar los resultados 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.
es: Para detalles sobre el algoritmo predeterminado ver :class:`InternalMetadataCompareKeyGen`. Implemente de nuevo esta función en el complemento si el algoritmo predeterminado no es el adecuado.

en: Identify a book by its Title/Author/ISBN/etc.
es: Identificar un libro por su título, autor, 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).
es: Si se especifica ``identifiers`` y no se encuentran coincidencias y este origen de metadatos no almacena todos los identificadores relacionados (por ejemplo, todos los ISBN de un libro), este método debe volver a intentarlo con sólo el título y el autor (si se especificaron).

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.
es: Si este origen de metadatos también proporciona portadas, el URL de la portada debe almacenarse en caché para que ejecuciones posteriores a la API para obtener portadas con el mismo ISBN o identificador especial no tenga que volver a obtener el URL de portada. Usar la API de caché para esto.

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.
es: Cada objeto :class:`Metadata` puesto en ``result_queue`` por este método debe tener un atributo attr:`source_relevance` que es un entero que indica el orden en que el origen de metadatos devuelve los resultados para esta búsqueda. Este entero se usará por :meth:`compare_identify_results`. Si el orden no es importante, póngalo a cero para todos los resultados.

en: Make sure that any cover/ISBN mapping information is cached before the Metadata object is put into result_queue.
es: Asegúrese de que cualquier información de correspondencia de portada o ISBN está en caché antes de poner el objeto :class:`Metadata` en `result_queue`.

en: A log object, use it to output debugging information/errors
es: Un objeto de registro, úselo para obtener errores e información de depuración

en: A result Queue, results should be put into it. Each result is a Metadata object
es: Un objeto :class:`Queue` resultante, los resultados deben ser puestos en él. Cada resultado es un objeto :class:`Metadata`.

en: If abort.is_set() returns True, abort further processing and return as soon as possible
es: Si :meth:`abort.is_set()` devuelve True, interrumpir el proceso y volver tan pronto como sea posible

en: The title of the book, can be None
es: El título del libro, puede ser None

en: A list of authors of the book, can be None
es: Una lista de autores del libro, puede ser None

en: A dictionary of other identifiers, most commonly {'isbn':'1234...'}
es: Un diccionario de otros identificadores, principalmente {'isbn':'1234...'}

en: Timeout in seconds, no network request should hang for longer than timeout.
es: Tiempo de espera en segundos, ninguna petición de red debería esperar más de este tiempo.

en: None if no errors occurred, otherwise a unicode representation of the error suitable for showing to the user
es: None si no hubo ningún error, en caso contrario una representación unicode del error que pueda mostrarse al usuario

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.
es: Descarga una portada y pone el resultado en ``result_queue``. Todos los parámetros tienen el mismo significado que para :meth:`identify`. Pone (``self``, ``cover_data``) en ``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.
es: Este metodo de usar los URL de portada en caché siempre que sea posible. Cuando no se encuentran los datos en caché, la mayoría de los complementos ejecutan :meth:`identify` y usan sus resultados.

en: If the parameter get_best_cover is True and this plugin can get multiple covers, it should only get the "best" one.
es: Si el parámetro ``get_best_cover`` es True y este complemento puede obtener múltiples portadas, esto debería obtener sólo la «mejor».

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.
es: Generar una clave de orden para comparar la relevancia de los objetos :class:`Metadata`, dada una consulta de búsqueda. Esto se usa sólo para comparar resultados del mismo origen de metadatos, no entre distintos orígenes.

en: The sort key ensures that an ascending order sort is a sort by order of decreasing relevance.
es: La clave de orden garantiza que el orden ascendente corresponde a un orden descendiente de relevancia.

en: The algorithm is:
es: El algoritmo es:

en: Prefer results that have at least one identifier the same as for the query
es: Dar prioridad a los resultados que tienen al menos un identificador igual al de la consulta

en: Prefer results with a cached cover URL
es: Preferir resultados con un URL de portada en caché

en: Prefer results with all available fields filled in
es: Preferir resultados con todos los campos disponibles rellenos

en: Prefer results with the same language as the current user interface language
es: Dar prioridad a los resultados en el mismo idioma que la interfaz de usuario actual

en: Prefer results that are an exact title match to the query
es: Preferir resultados con una coincidencia de título perfecto con la consulta

en: Prefer results with longer comments (greater than 10% longer)
es: Preferir resultados con comentarios más largos (diferencia mayor del 10%)

en: Use the relevance of the result as reported by the metadata source's search
es: Usar la relevancia del resultado según la indice la búsqueda del origen de metadatos

en: engine
es: motor

en: Conversion plugins
es: Complementos de conversión

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`.
es: Los complementos :class:`InputFormatPlugin` son los responsables de convertir un documento a HTML+OPF+CSS+etc. Los resultados de la conversión *deben* estar codificados en UTF-8. La acción principal ocurre en :meth:`convert`.

en: Set of file types for which this plugin should be run For example: ``set(['azw', 'mobi', 'prc'])``
es: Conjunto de tipos de archivo para los que este complemento debe ejecutarse. Por ejemplo: ``set(['asw', '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.
es: Si es True, este complemento de entrada genera una colección de imágenes, una por archivo HTML. Esto puede ser establecido dinámicamente en el método :meth:`convert` si los archivos de entrada pueden ser o no colecciones de imágenes. Si lo establece en True, debe implementar el método :meth:`get_images()` que devuelve una lista de imágenes.

en: Number of CPU cores used by this plugin. A value of -1 means that it uses all available cores
es: Número de núcleos de CPU utilizados por este complemento. Un valor de -1 significa que utiliza todos los núcleos disponibles

en: If set to True, the input plugin will perform special processing to make its output suitable for viewing
es: Si es True, el complemento de entrada realizará un procesado especial para que la salida sea adecuada para visualización

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
es: La codificación de los archivos que crea el complemento de entrada. Un valor de None significa que la codificación no está definida y debe detectarse individualmente

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`.
es: Opciones compartidas por todos los complementos de formato de entrada. No reemplazar en subclases. Usar :attr:`options` en su lugar. Toda opción debe ser un ejemplar de :class:`OptionRecommendation`.

en: Options to customize the behavior of this plugin. Every option must be an instance of :class:`OptionRecommendation`.
es: Opciones para personalizar el comportamiento de este complemento. Toda opción debe ser un ejemplar de :class:`OptionRecommendation`.

en: A set of 3-tuples of the form (option_name, recommended_value, recommendation_level)
es: Un conjunto de 3-tuplas del tipo (nombre_opción, valor_recomendado, nivel_de_recomendación)

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.
es: Devuelve una lista de rutas absolutas a las imágenes, si este complemento representa una colección de imágenes. La lista de imágenes está en el mismo orden que el lomo y el índice.

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.
es: Este método debe ser implementado en subclases. Debe volver la ruta al archivo OPF creado o un ejemplar :class:`OEBBook`. Toda la salida debe estar contenida en la carpeta actual. Si este complemento crea archivos fuera de la carpeta actual, deben ser eliminados o marcados para su eliminación antes de que termine este método.

en: A file like object that contains the input file.
es: Un objeto de tipo archivo que contiene el archivo de entrada.

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`.
es: Opciones para personalizar el proceso de conversión. Debe tener atributos correspondientes a todas las opciones declaradas por este complemento. Además, debe haber un atributo ``verbose`` que toma valores enteros a partir de cero. Valores mayores significan más detalles. Otro atributo útil es ``input_profile``, que es un ejemplar 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.
es: La extensión (sin el «.») del archivo de entrada. Debe ser uno de los ``file_types`` admitidos por este complemento.

en: A :class:`calibre.utils.logging.Log` object. All output should use this object.
es: Un objeto :class:`calibre.utils.logging.Log`. Toda salida debería usar este objeto.

en: A dictionary of various information that the input plugin can get easily that would speed up the subsequent stages of the conversion.
es: Un diccionario con diversa información que el complemento de entrada puede obtener fácilmente y que acelerará las etapas posteriores de la conversión.

en: Called to allow the input plugin to perform postprocessing after the book has been parsed.
es: Se ejecuta para permitir que el complemento de entrada lleve a cabo el posprocesado del libro después del procesado principal.

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.
es: Se ejecuta para permitir que el complemento de entrada especialice el libro analizado para un formato de salida particular. Se ejecuta después de :meth:`postprocess_book` y antes de que se realice cualquier transformación sobre el libro analizado.

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.
es: Ejecutado para crear el widget que se usa para configurar este complemento en la interfaz de calibre. El widget debe ser un objeto de la clase PluginWidget. Puede ver ejemplos en los complementos de entrada incorporados.

en: OutputFormatPlugins are responsible for converting an OEB document (OPF+HTML) into an output e-book.
es: Los complementos `OutputFormatPlugin` son los responsables de convertir un documento OEB (OPF+HTML) en un libro de salida.

en: The OEB document can be assumed to be encoded in UTF-8. The main action happens in :meth:`convert`.
es: El documento OEB puede suponerse codificado en UTF-8. La acción principal ocurre en :meth:`convert`.

en: The file type (extension without leading period) that this plugin outputs
es: El tipo de archivo (extensión sin punto inicial) que produce este complemento

en: Create a new string object from the given object. If encoding or errors is specified, then the object must expose a data buffer that will be decoded using the given encoding and error handler. Otherwise, returns the result of object.__str__() (if defined) or repr(object). encoding defaults to 'utf-8'. errors defaults to 'strict'.
es: Crea un nuevo objeto de texto a partir de ``object``. Si se especifica ``encoding`` o ``errors``, el objeto debe exponer un buffer de datos que se descodificará con la codificación y controlador de errores especificados. En caso contrario, devuelve el resultado de ``object.__str__()` (si está definido) o ``repr(object)``. El valor predeterminado de ``encoding`` es ``'utf-8'``. El valor predeterminado de ``errors`` es ``'strict'``.

en: Render the contents of `oeb_book` (which is an instance of :class:`calibre.ebooks.oeb.OEBBook`) to the file specified by output.
es: Mostrar el contenido de `oeb_book` (que es un espécimen de :class:`calibre.ebooks.oeb.OEBBook`) en el archivo especificado por `salida`.

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.
es: Un objeto de tipo archivo o un texto. Si es un texto es la ruta a una carpeta que puede existir o no. El complemento de salida debe escribir su resultado en esta carpeta. Si es un objeto de tipo archivo, el complemento de salida debe escribir su resultado en el archivo.

en: The input plugin that was used at the beginning of the conversion pipeline.
es: El archivo de entrada que se usó al inicio del proceso de conversión.

en: Conversion options. Guaranteed to have attributes corresponding to the OptionRecommendations of this plugin.
es: Opciones de conversión. Es seguro que tiene atributos correspondientes a los valores de OptionRecommendations de este complemento.

en: The logger. Print debug/info messages etc. using this.
es: El registrador. Escribir mensajes de depuración, información, etc. usando este objeto.

en: Can be used to change the values of conversion options, as used by the conversion pipeline.
es: Puede usarse para modificar los valores de las opciones de conversión, como en el proceso de conversión.

en: Can be used to make changes to the CSS during the CSS flattening process.
es: Puede usarse para hacer cambios al css durante el proceso de aplanamiento del CSS.

en: The item (HTML file) being processed
es: El elemento (archivo HTML) que se está procesando.

en: A Stylizer object containing the flattened styles for item. You can get the style for any element by stylizer.style(element).
es: Un objeto de tipo :class:`Stylizer` que contiene los estilos aplanados para ``item``. Puede obtener el estilo para cualquier elemento con ``stylizer.style(elemento)`.

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.
es: Ejecutado para crear el widget que se usa para configurar este complemento en la interfaz de calibre. El widget debe ser un objeto de la clase PluginWidget. Puede ver ejemplos en los complementos de salida incorporados.

en: Device drivers
es: Controladores de dispositivo

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.
es: La clase base para todos los controladores de dispositivo es :class:`DevicePlugin`. Sin embargo, si el dispositivo se muestra como una unidad USBMS ante el sistema operativo, debe usar la clase :class:`USBMS` en su lugar, pues implementa toda la lógica necesaria para este tipo de dispositivos.

en: Defines the interface that should be implemented by backends that communicate with an e-book reader.
es: Define la interfaz que deben implementar los motores que comunican con un lector de libros electrónicos.

en: Ordered list of supported formats
es: Lista ordenada de formatos soportados

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::
es: ``VENDOR_ID`` puede ser un entero, una lista de enteros o un diccionario. Si es un diccionario, debe ser un diccionario de diccionarios de la forma::

en: An integer or a list of integers
es: Un entero o una lista de enteros

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.
es: BCD puede ser bien None para no distinguir entre dispositivos según BCD, o bien una lista de los números BCD de todos los dispositivos soportados por este controlador.

en: Height for thumbnails on the device
es: Altura de las miniaturas en el dispositivo

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.
es: Calidad de compresión para las miniaturas. Cuanto más cercano a 100, mejor será la calidad de las miniaturas y menores los defectos de compresión. Por supuesto, también ocuparán más espacio las miniaturas.

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
es: Establézcalo en True si el dispositivo admite actualizar miniaturas de portada durante meth:`sync_booklists`. Si es True, se pedirá a device.py que vuelva a cargar las miniaturas al comparar libros

en: Whether the metadata on books can be set via the GUI.
es: Especifica si los metadatos de los libros pueden establecerse a través de la interfaz gráfica.

en: Whether the device can handle device_db metadata plugboards
es: Especifica si el dispositivo puede gestionar paneles de conexiones de metadatos device_db

en: Path separator for paths to books on device
es: Separador de ruta para rutas de acceso a los libros en el dispositivo

en: Icon for this device
es: Icono para este dispositivo

en: GUI displays this as a message if not None in the status bar. Useful if opening can take a long time
es: La interfaz gráfica muestra esto como un mensaje en la barra de estado si no es None. Útil si la apertura puede llevar mucho tiempo

en: Set of extensions that are "virtual books" on the device and therefore cannot be viewed/saved/added to library. For example: ``frozenset(['kobo'])``
es: Conjunto de extensiones que son «libros virtuales» en el dispositivo y por lo tanto no pueden visualizarse, guardarse o añadirse a la biblioteca. Por ejemplo: ``frozenset(['kobo'])``

en: Message to display to user for virtual book extensions.
es: Mensaje que se mostrará al usuario para las extensiones de libro virtuales.

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.
es: Indica si se eliminan los comentarios de la copia del libro que se envía al dispositivo. Si no es None, debería ser un texto corto por el que se sustituirán los comentarios.

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().
es: Si es True, indica que este controlador gestiona completamente la detección de dispositivos, la desconexión, etc. Si la establece a True, *debe* implementar los métodos detect_managed_devices y debug_managed_device_detection. Un controlador con esta variable como True tiene la responsabilidad de detectar dispositivos, gestionar una lista negra de dispositivos, una lista de dispositivos desconectados, etc. calibre ejecutará periódicamente el método meth:`detect_managed_devices()` y si devuleve un dispositivo detectado, calibre ejecutará :meth:`open()`. :meth:`open()` se ejecutará cada vez que se devuelva un dispositivo, incluso si previamente :meth:`open()` falló, por lo tanto el controlador debe mantener su propia lista negra de dispositivos fallidos. Análogamente, al desconectar, calibre ejecutará :meth:`eject()` y, suponiendo que que la siguiente ejecución de :meth:`detect_managed_devices()` devuelva None, ejecutará :meth:`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.
es: Si se establece en True, calibre ejecutará el método :meth:`get_driveinfo()` una vezs cargadas las listas de libros para obtener la información de la unidad.

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`
es: Si se establece en True, calibre preguntará al usuario si quiere administrar el dispositivo con calibre la primera vez que se detecta. Si lo establece en True debe implementar :meth:`get_device_uid()`, :meth:`ignore_connected_device()`, :meth:`get_user_blacklisted_devices` y :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.
es: Establezca esto a un diccionario de la forma {'title':título, 'msg':mensaje, 'det_msg':mensaje_detallado} para que calibre muestre una ventana con un mensaje para el usuario tras ejecutar varias acciones (actualmente sólo :meth:`upload_books`). Procure no mostrar demasiados mensajes al usuario. Esta variable se comprueba después de *cada* acción, así que establézcala sólo cuando sea realmente necesaria.

en: GUI displays this as a non-modal popup. Should be an instance of OpenPopupMessage
es: La interfaz gráfica muestra esto como una ventana emergente no modal. Debe ser un ejemplar de :class:`OpenPopupMessage`

en: Return True, device_info if a device handled by this plugin is currently connected.
es: Devuelve True, device_info si algún dispositivo gestionado por este complemento está actualmente conectado.

en: List of devices currently connected
es: Lista de dispositivos conectados actualmente

en: Called only if MANAGES_DEVICE_PRESENCE is True.
es: Sólo se llama si MANAGES_DEVICE_PRESENCE es 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().
es: Buscar dispositivos que pueda gestionar este controlador. Debe devolver un objeto de dispositivo si se encuentra algún dispositivo. Este objeto se pasará al método :meth:`open()` como `connected_device`. Si no se encuentra ningún dispositivo, devuelve None. El objeto devuelto puede ser cualquier cosa, calibre no lo usa, sólo lo pasa a :meth:`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.
es: Este método se ejecuta periódicamente por la interfaz gráfica, así que asegúrese de que no requiere demasiados recursos. Use un caché para evitar buscar en el sistema una y otra vez.

en: Set of USB devices found on the system.
es: Conjunto de dispositivos USB encontrados en el sistema.

en: If True and the driver uses a cache to prevent repeated scanning, the cache must be flushed.
es: Si es True y el controlador usa un caché para evitar búsquedas repetitivas, el caché debe vaciarse.

en: Should write information about the devices detected on the system to output, which is a file like object.
es: Debe escribir en `output` información sobre los dispositivos detectados en el sistema, que es un objeto de tipo archivo.

en: Should return True if a device was detected and successfully opened, otherwise False.
es: Debe devolver True si se detecta un dispositivo y se abre con éxito, en caso contrario debe devolver False.

en: The key to unlock the device
es: La clave para desbloquear el dispositivo

en: If true the packet stream to/from the device is logged
es: Si es True, el flujo de paquetes de o al dispositivo se registra

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
es: Función que se ejecuta con un argumento de progreso en porcentaje (número entre 0 y 100) para diversas tareas. Si el argumento es -1 significa que la tarea no tiene información de progreso.

en: Device information from the device scanner
es: Información de dispositivo desde el examinador de dispositivos

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`.
es: Método opcional para comprobar si este controlador puede manejar un dispositivo mediante más pruebas. Si no puede, debe devolver False. Este método sólo se ejecuta una vez que los identificadores del fabricante y del producto, así como el BCD se han reconocido, por lo que puede realizar pruebas que requieran un tiempo relativamente prolongado. La implementación predeterminada devuelve True. Este método sólo se ejecuta en Windows. Véase también :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.
es: Tenga en cuenta que para dispositivos basados en USBMS este método de manera predeterminada delega en :meth:`can_handle`. Así que sólo necesita sustituir :meth:`can_handle` en la subclase de USBMS.

en: A usbdevice as returned by :func:`calibre.devices.winusb.scan_usb_devices`
es: Un dispositivo usb devuelto por :func:`calibre.devices.winusb.scan_usb_devices`

en: Unix version of :meth:`can_handle_windows`.
es: Versión unix de :meth:`can_handle_windows`.

en: Is a tuple of (vid, pid, bcd, manufacturer, product, serial number)
es: Es una tupla de (id_fab, id_prod, bcd, fabricante, producto, número de serie)

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.
es: Realiza cualquier inicio específico del dispositivo. Se ejecuta una vez que se ha detectado el dispositivo, pero antes de cualquier otra función que comunique con él. Por ejemplo, para dispositivos que se muestran como dispositivos de almacenamiento masivo USB, este método será el responsable de montar el dispositivo o, si se ha montado automáticamente, averiguar dónde. El método :meth:`calibre.devices.usbms.device.Device.open` tiene una implementación de esta función que puede ser un buen ejemplo para dispositivos de almacenamiento masivo USB.

en: This method can raise an OpenFeedback exception to display a message to the user.
es: Este método puede generar una excepción de tipo OpenFeedback para mostrar un mensaje al usuario final.

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.
es: El dispositivo que se intenta abrir. Es una tupla de (identificador de fabricante, identificador de producto, bcd, nombre de fabricante, nombre de producto, número de serie del dispositivo). Sin embargo, algunos dispositivos no tienen número de serie y en Windows sólo aparecen los tres primeros campos, el resto son 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).
es: El UUID de la biblioteca de calibre actual. Puede ser None si no existe una biblioteca (por ejemplo cuando se usa desde la línea de órdenes).

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.
es: Desmontar o expulsar el dispositivo del sistema operativo. Esto no comprueba si hay tareas de interfaz gráfica pendientes que tengan que comunicar con el dispositivo.

en: NOTE: That this method may not be called on the same thread as the rest of the device methods.
es: NOTA: Este método no puede ejecutarse en el mismo subproceso que el resto de los métodos de dispositivo.

en: Called if the user yanks the device without ejecting it first.
es: Se ejecuta si el usuario desconecta el dispositivo sin expulsarlo primero.

en: Set a function to report progress information.
es: Establece una función para mostrar información de progreso.

en: Ask device for device information. See L{DeviceInfoQuery}.
es: Pregunta al dispositivo por su información interna. Ver 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.
es: (nombre del dispositivo, versión del dispositivo, versión del software en el dispositivo, tipo MIME) La tupla puede tener un quinto elemento opcional, que es un diccionario de información de unidad. Puede verse un ejemplo en `usbms.driver`.

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.
es: Devuelve el diccionario de información de dispositivo. Normalmente se ejecuta desde :meth:`get_device_information()`, pero si la carga de la información del dispositivo es lenta para este controlador, debería establecer `SLOW_DRIVEINFO`. En este caso, calibre ejecutará este método después de cargar la lista de libros. Tenga en cuenta que no se ejecuta en el hilo del dispositivo, por lo que el controlador debería almacenar en caché la información del dispositivo en el método :meth:`books()` y esta función debería devolver los datos almacenados.

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)
es: Devuelve una lista de dos elementos con los prefijos para las rutas de acceso en las tarjetas. Si no hay tarjeta, el prefijo correspondiente será None. Por ejemplo: ('/lugar', '/lugar2') (None, 'lugar2') ('lugar', None) (None, None)

en: Get total space available on the mountpoints:
es: Obtiene el espacio total disponible en los puntos de montaje:

en: Main memory
es: Memoria principal

en: Memory Card A
es: Tarjeta de almacenamiento A

en: Memory Card B
es: Tarjeta de almacenamiento 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.
es: Una lista de tres elementos con el espacio total en bytes de (1, 2, 3). Si un dispositivo concreto no tiene alguna de estas ubicaciones, debe devolver 0.

en: Get free space available on the mountpoints:
es: Obtiene el espacio libre disponible en los puntos de montaje:

en: Card A
es: Tarjeta A

en: Card B
es: Tarjeta 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.
es: Una lista de tres elementos con el espacio libre en bytes de (1, 2, 3). Si un dispositivo concreto no tiene alguna de estas ubicaciones, debe devolver -1.

en: Return a list of e-books on the device.
es: Devuelve una lista de los libros electrónicos en el dispositivo.

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.
es: Si es 'carda' o 'cardb', devuelve una lista de los libros en la tarjeta de almacenamiento especificada, en caso contrario devuelve una lista de los libros en la memoria principal del dispositivo. Si se especifica una tarjeta y no hay libros en ella, devuelva una lista vacía.

en: A BookList.
es: Un objeto 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".
es: Copia una lista de libros al dispositivo. Si un archivo ya existe en el dispositivio, deberá ser sustituido. Este método debería generar un error :class:`FreeSpaceError` si no hay suficiente espacio libre en el dispositivo. El texto del error :class:`FreeSpaceError` debe contener la palabra «card» si ``on_card` no es None, si no, debe contener la palabra «memory».

en: A list of paths
es: Una lista de rutas

en: A list of file names that the books should have once uploaded to the device. len(names) == len(files)
es: Una lista de nombres de archivo que los libros deberán tener una vez copiados al dispositivo. 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).
es: Si no es None, es una lista de objetos :class:`Metadata`. La idea es utilizar los metadatos para determinar dónde poner el libro en el dispositivo. len(metadata) == len(files). Aparte de la portada normal (ruta a la portada), también puede haber un atributo de miniatura (``thumbnail``), que debería tener prioridad. El atributo ``thumbnail`` es de la forma (anchura, altura, datos_de_portada como jpeg).

en: A list of 3-element tuples. The list is meant to be passed to :meth:`add_books_to_metadata`.
es: Una lista de tuplas de 3 elementos. La lista se envía a :meth:`add_books_to_metadata`.

en: Add locations to the booklists. This function must not communicate with the device.
es: Añade ubicaciones a las listas de libros. Esta función no debe comunicarse con el dispositivo.

en: Result of a call to L{upload_books}
es: Resultado de una llamada a L{upload_books}

en: List of :class:`Metadata` objects, same as for :meth:`upload_books`.
es: Lista de objetos :class:`Metadata`, igual que para :meth:`upload_books`.

en: A tuple containing the result of calls to (:meth:`books(oncard=None)`, :meth:`books(oncard='carda')`, :meth`books(oncard='cardb')`).
es: Una tupla que contiene el resultado de las llamadas a (:meth:`books(oncard=None)`, :meth:`books(oncard='carda')`, :meth`books(oncard='cardb')`).

en: Delete books at paths on device.
es: Borrar libros en ubicaciones del dispositivo.

en: Remove books from the metadata list. This function must not communicate with the device.
es: Elimina libros de la lista de metadatos. Esta función no debe comunicarse con el dispositivo.

en: paths to books on the device.
es: rutas a los libros en el dispositivo.

en: Update metadata on device.
es: Actualizar metadatos del dispositivo.

en: Read the file at ``path`` on the device and write it to outfile.
es: Lee el archivo en ``path`` en el dispositivo y lo escribe en ``outfile``.

en: file object like ``sys.stdout`` or the result of an :func:`open` call.
es: objeto de archivo como ``sys.stdout`` o el resultado de ejecutar :func:`open`.

en: Should return a QWidget. The QWidget contains the settings for the device interface
es: Debe devolver un QWidget. El QWidget contiene las configuraciones de la interfaz de dispositivo.

en: Should save settings to disk. Takes the widget created in :meth:`config_widget` and saves all settings to disk.
es: Debe guardar las configuraciones en el disco. Toma el widget creado en :meth:`config_widget` y guarda todas las configuraciones en el disco.

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.
es: Debe devolver un objeto ``opts``. El objeto ``opts`` debería tener al menos un atributo `format_map` que es una lista ordenada de formatos para el dispositivo.

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.
es: Proporciona al controlador el conjunto actual de paneles de conexiones y una función para seleccionar un panel de conexión específico. Este método se ejecuta inmediatamente antes de add_books y sync_booklists.

en: pb_func is a callable with the following signature::
es: pb_func es un metodo ejecutable con la siguiente firma::

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).
es: Le da el nombre del dispositivo actual (ya sea el nombre de la clase o DEVICE_PLUGBOARD_NAME), el formato en que está interesado (un formato «real» o ​​`device_db`), y los paneles de conexiones (suministrados por set_plugboards, en el mismo lugar de donde se obtuvo este método).

en: None or a single plugboard instance.
es: None o un único panel de conexiones.

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.
es: Establece el nombre de dispositivo en el archivo driveinfo como ``name``. Este ajuste persistirá hasta que el archivo se vuelva a crear o se cambie el nombre de nuevo.

en: Non-disk devices should implement this method based on the location codes returned by the get_device_information() method.
es: Los dispositivos que no son de disco deberían implementar este método según los códigos de ubicación devueltos por el método :meth:`get_device_information()`.

en: Given a list of paths, returns another list of paths. These paths point to addable versions of the books.
es: Dada una lista de rutas de acceso, devuelve otra lista de rutas de acceso. Estas rutas apuntan a versiones de los libros que pueden añadirse.

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)
es: Si ocurre un error al preparar un libro, en lugar de una ruta de acceso, la posición en la lista devuelta para ese libro debería de ser una tupla de tres elementos: (ruta_original, la excepción, rastro)

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.
es: Se ejecuta cuando calibre inicia el dispositivo. Realiza cualquier inicialización necesaria. Tenga en cuenta que pueden generarse varios especímenes de la clase, y por lo tanto :meth:`__init__` puede ejecutarse varias veces, pero sólo un espécimen ejecutará este método. Este método se ejecuta en el hilo del dispositivo, no en el de la interfaz gráfica.

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.
es: Se ejecuta cuando calibre se está apagando, ya sea definitivamente o como preparación para reiniciarse. Lleva a cabo cualquier limpieza requerida. Este método se ejecuta en el hilo del dispositivo, no en el de la interfaz gráfica.

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
es: Debe devolver un identificador único para el dispositivo conectado actualmente (se ejecuta inmediatamente después de ejecutarse :meth:`open()` con éxito). Debe implementar este método si establece ``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.
es: El dispositivo identificado por ``uid`` (el resultado de ejecutar :meth:`get_device_uid()`) debe ignorarse en el futuro. Debe implementar este método si establece ``ASK_TO_ALLOW_CONNECT = True``. Tenga en cuenta que esta función se ejecuta inmediatamente después de :meth:`open()`, así que si :meth:`open()` almacena algún estado en caché el controlador debería restablecer el estado.

en: Return map of device uid to friendly name for all devices that the user has asked to be ignored.
es: Devuelve un diccionario de identificadores y nombres de dispositivo para todos los dispositivos que el usuario ha pedido ignorar.

en: Set the list of device uids that should be ignored by this driver.
es: Establecer la lista de uids de dispositivo que deben ser ignorados por este controlador.

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'])
es: Implemente este método si el dispositivo quiere sustituir una preferencia particular. Debe asegurarse de que todos los lugares de ejecución que emplean una preferencia que pueda ser sustituida usen ``device_prefs['algo']`` en lugar de ``prefs['algo']``. El metodo debe ejecutar ``device_prefs.set_overrides(pref=val, pref=val, ...)``. Actualmente se usa para: gestión de metadatos (``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.
es: Implemente este método si quiere información sobre la biblioteca de calibre actual. Este método se ejecuta al inicio y cuando la biblioteca de calibre cambia mientras está conectado.

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.
es: Ejecutado por el administrador de dispositivos al iniciar complementos. Si este método devuelve un texto, entonces a) soporta la interfaz de control dinámica del administrador de dispositivos y b) debe usarse ese nombre para comunicarse con el complemento.

en: This method can be called on the GUI thread. A driver that implements this method must be thread safe.
es: Este método puede ejecutarse en el hilo de la interfaz gráfica. Un controlador que implemente este método debe ser seguro para subprocesos.

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.
es: Este método se ejecuta para iniciar el complemento. El complemento debe empezar a aceptar conexiones de dispositivos de la manera que lo haga. Si el complemento ya acepta conexiones, no debe hacer nada.

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.
es: Este método se ejecuta para detener el complemento. El complemento debe dejar de aceptar conexiones y debe hacer hacer limpieza tras de sí. Probablemente este método debería ejecutar :meth:`shutdown`. Si el complemento ya no acepta conexiones, no debe hacer nada.

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.
es: Devuelve el valor de la opción indicada por ``opt_string``. Este método puede ejecutarse cuando el complemento no se ha iniciado. Devuelve None si la opción no existe.

en: Set the value of the option indicated by opt_string. This method can be called when the plugin is not started.
es: Establece el valor de la opción indicada por ``opt_string``. Este método puede ejecutarse cuando el complemento no se ha iniciado.

en: Return True if the plugin is started, otherwise false
es: Devuelve True si el complemento está iniciado, de lo contrario 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).
es: Se ejecuta durante el emparejamiento de libros, cuando cada libro del dispositivo se empareja con un libro en la base de datos de calibre. El método tiene por cometido sincronizar los datos del dispositivo con la base de datos de calibre (si es necesario).

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.
es: Este método debe devolver una tupla de dos valores. El primer valor es un conjunto de identificadores de libro de calibre modificados si se modificó la base de datos de calibre, o None si la base de datos no se modificó. Si el primer valor es un conjunto vacío, los metadatos del libro en el dispositivo se actualizan con los metadatos de calibre y se vuelven a mandar al dispositivo, pero no se actualiza la interfaz gráfica para ese libro. Esto es útil cuando los metadatos de calibre son correctos, pero deben enviarse al dispositivo.

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.
es: El segundo valor es una tupla de 2 valores. El primer valor de la tupla especifica si debe enviarse un formato de libro al dispositivo. El propósito es permitir comprobar que el libro en el dispositivo es el mismo que en calibre. Este valor debe ser None si no debe enviarse ningún libro, en caso contrario debe devolver el nombre de archivo base en el dispositivo (un texto como «foobar.epub»). Asegúrese de incluir la extensión en el nombre. El subsistema del dispositivo generará una tarea ``send_books`` para todos los libros cuyo valor devuelto no sea None. Nota: salvo para extraer la extensión, el nombre de archivo no tiene efecto en los casos en que el dispositivo usa una plantilla para generar el nombre de archivo, lo que ocurre para la mayoría. El segundo valor en la tupla devuelta indica si el formato está fechado en el futuro. Devuelve True si lo está, en caso contrario devuelve False. calibre mostrará un cuadro de diálogo con todos los libros fechados en el futuro.

en: Extremely important: this method is called on the GUI thread. It must be threadsafe with respect to the device manager's thread.
es: Extremadamente importante: este método se ejecuta en el subproceso de la interfaz gráfica. Debe ser seguro con respecto al subproceso del administrador de dispositivos.

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
es: ``book_id``: el identificador de calibre para el libro en la base de datos. ``book_metadata``: el objeto de tipo ``Metadata`` para el libro que viene del dispositivo. ``first_call``: True si ésta es la primera ejecución durante la sincronización, False en caso contrario.

en: A list of books. Each Book object must have the fields
es: Una lista de libros. Cada objeto Book debe tener los campos

en: title
es: ``title`` (título)

en: authors
es: ``authors`` (autores)

en: size (file size of the book)
es: ``size`` (tamaño del archivo del libro)

en: datetime (a UTC time tuple)
es: ``datetime`` (tupla de tiempo UTC)

en: path (path on the device to the book)
es: ``path`` (ruta de acceso del libro en el dispositivo)

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
es: ``thumbnail`` (miniatura, puede ser None) es bien un objeto str o bytes con los datos de la imagen, o bien debería tener un atributo ``image_path`` que almacena una ruta de acceso completa (en el formato de la plataforma) a la imagen

en: tags (a list of strings, can be empty).
es: ``tags`` (una lista de textos, puede estar vacía).

en: Return True if the device supports collections for this book list.
es: Devuelve True si el dispositivo es compatible con colecciones para esta lista de libros.

en: Add the book to the booklist. Intent is to maintain any device-internal metadata. Return True if booklists must be sync'ed
es: Añadir el libro a la lista de libros. El propósito es mantener todos los metadatos internos del dispositivo, devuelve True si la las listas de libros deben sincronizarse

en: Remove a book from the booklist. Correct any device metadata at the same time
es: Elimina un libro de una lista de libros. Simultáneamente, corrige cualquier metadato de dispositivo.

en: Return a dictionary of collections created from collection_attributes. Each entry in the dictionary is of the form collection name:[list of books]
es: Devuelve un diccionario de colecciones creadas a partirde ``collection_attributes``. Cada entrada del diccionario es de la forma ``nombre de la colección:[lista de libros]``

en: The list of books is sorted by book title, except for collections created from series, in which case series_index is used.
es: El listado de los libros se ordena por título, excepto en colecciones creadas a partir de series, donde se usa series_index.

en: A list of attributes of the Book object
es: Una lista de atributos del objeto :class:`Book`.

en: USB Mass Storage based devices
es: Dispositivos basados en almacenamiento masivo 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:
es: La clase base para tales dispositivos es :class:`calibre.devices.usbms.driver.USBMS`. Esta clase hereda algunas de sus funcionalidades de sus bases, documentadas a continuación. Un controlador típico basado en USBMS es así:

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.
es: Esta clase proporciona una lógina común a todos los controladores para dispositivos que se manifiestan como dispositivos USB de almacenamiento masivo. Proporciona implementaciones para montar o extraer dispositivo USBMS en todas las plataformas.

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
es: Texto que identifica la memoria principal del dispositivo en los textos de identificación PnP de Windows. Puede ser None, un texto, una lista de textos o una expresión regular compilada

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
es: Texto que identifica la primera tarjeta del dispositivo en los textos de identificación PnP de Windows. Puede ser None, un texto, una lista de textos o una expresión regular compilada

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
es: Texto que identifica la segunda tarjeta del dispositivo en los textos de identificación PnP de Windows. Puede ser None, un texto, una lista de textos o una expresión regular compilada

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
es: Usado por la nueva detección de controladores para distinguir la memoria principal de las tarjetas de almacenamiento. Debería ser una expresión regular que corresponda al punto de montaje de la memoria principal asignado por macOS

en: The maximum length of paths created on the device
es: La longitud máxima para las rutas de acceso en el dispositivo

en: Put news in its own folder
es: Poner noticias en una carpeta propia

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
es: Ejecutado para distinguir la memoria principal y la tarjeta de almacenamiento para dispositivos en los que `WINDOWS_CARD_*_NAME` no funciona. Por ejemplo, el EB600

en: Callback to allow individual device drivers to override the path sanitization used by :meth:`create_upload_path`.
es: Método para permitir a los controladores de dispositivo individuales reemplazar la limpieza de rutas de acceso empleada por :meth:`create_upload_path`.

en: Callback to allow drivers to change the default file name set by :meth:`create_upload_path`.
es: Devuelve la llamada para permitir a los conductores cambiar el nombre de archivo por defecto introducido por :meth:`create_upload_path`

en: Perform any device specific sanitization on the path components for files to be uploaded to the device
es: Realiza cualquier limpieza específica del dispositivo en los componentes de la ruta de acceso para los archivos que se copiarán al dispositivo

en: Resolve path_map to annotation_map of files found on the device
es: Resuelve path_map a annotation_map para archivos en el dispositivo

en: Add an annotation to the calibre library
es: Añadir una anotación a la biblioteca de calibre

en: The base class for all USBMS devices. Implements the logic for sending/getting/updating metadata/caching metadata/etc.
es: La clase base para todos los dispositivos USBMS. Implementa la lógica para enviar, recibir, actualizar metadatos, retener metadatos, etc.

en: Upload book cover to the device. Default implementation does nothing.
es: Envía una portada de libro al dispositivo. La implementación predeterminada no hace nada.

en: The full path to the folder where the associated book is located.
es: La ruta completa de la carpeta donde se encuentra el libro asociado.

en: The name of the book file without the extension.
es: El nombre del archivo del libro electrónico sin la extensión.

en: metadata belonging to the book. Use metadata.thumbnail for cover
es: metadatos perteneciente al libro. Use ``metadata.thumbnail`` para la portada

en: The full path to the e-book file
es: La ruta completa al archivo del libro electrónico

en: Return path with platform native path separators
es: Devuelve path con los separadores de ruta propios de la plataforma

en: User interface actions
es: Acciones de interfaz de usuario

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.
es: Si añade un complemento propio en un archivo ZIP, debería crear subclases de `InterfaceActionBase` e `InterfaceAction`. El método :meth:`load_actual_plugin` de la nueva subclase de `InterfaceActionBase` debe devolver un espécimen de la subclase de `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.
es: Un complemento que representa una «acción» que puede ejecutarse en la interfaz gráfica. Todos los elementos de la barra de herramientas y de los menús contextuales están implementados mediante estos complementos.

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.
es: Tenga en cuenta que esta clase es la clase base para estos complementos, pero para integrar el complemento con el sistema de complementos de calibre debe crear una clase envoltorio que haga referencia al complemento real. Ver ejemplos en el módulo :mod:`calibre.customize.builtins`.

en: If two :class:`InterfaceAction` objects have the same name, the one with higher priority takes precedence.
es: Si dos objetos :class:`InterfaceAction` tienen el mismo nombre, tiene preferencia el que tenga mayor prioridad.

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.
es: Las subclases deben implementar los métodos :meth:`genesis`, :meth:`library_changed`, :meth:`location_selected`, :meth:`shutting_down`, :meth:`initialization_complete` y 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::
es: Una vez inicializado, este complemento tiene acceso a la interfaz gráfica principal de calibre vía :attr:`gui`. Puede acceder a otros complementos por su nombre, por ejemplo::

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().
es: Para acceder al complemento real, use el atributo :attr:`interface_action_base_plugin`; este atributo sólo está disponible una vez que el complemento se ha iniciado. Es útil si quiere usasr métodos de la clase del complemento como :meth:`do_user_config()`.

en: The QAction specified by :attr:`action_spec` is automatically create and made available as ``self.qaction``.
es: La QAction especificada por :attr:`action_spec` se crea automáticamente y está disponible como ``self.qaction``.

en: The plugin name. If two plugins with the same name are present, the one with higher priority takes precedence.
es: El nombre del complemento. Si dos complementos con el mismo nombre están presentes, el que tenga mayor prioridad tiene preferencia.

en: The plugin priority. If two plugins with the same name are present, the one with higher priority takes precedence.
es: La prioridad del complemento. Si dos complementos con el mismo nombre están presentes, el que tenga mayor prioridad tiene preferencia.

en: The menu popup type for when this plugin is added to a toolbar
es: El tipo de menú emergente para cuando se añade este complemento a una barra de herramientas

en: Whether this action should be auto repeated when its shortcut key is held down.
es: Especifica si esta acción debe repetirse automáticamente cuando el atajo de teclado se mantiene presionado.

en: Of the form: (text, icon_path, tooltip, keyboard shortcut). icon, tooltip and keyboard shortcut can be None. keyboard shortcut must be either a string, None or tuple of shortcuts. If None, a keyboard shortcut corresponding to the action is not registered. If you pass an empty tuple, then the shortcut is registered with no default key binding.
es: De la forma: (texto, ruta_icono, ayuda, atajo_teclado). ruta_icono, ayuda y atajo_teclado pueden ser None. atajo_teclado debe ser un texto, None o una tupla de atajos. Si es None, no se registra ningún atajo de teclado correspondiente a la acción. Si se pasa una tupla vacía, se registra un atajo sin ninguna tecla predefinida.

en: If not None, used for the name displayed to the user when customizing the keyboard shortcuts for the above action spec instead of action_spec[0]
es: Si no es None, se usa para el nombre que se muestra al usuario al personalizar los atajos de teclado para la acción anterior, en lugar de ``action_spec[0]``

en: If True, a menu is automatically created and added to self.qaction
es: Si es True, se crea automáticamente un menú y se añade a ``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
es: Si es True, se añade un clon de ``self.qaction`` al menú de ``self.qaction``. Si quiere que el texto de esta acción sea distinto del de ``self.qaction``, establezca esta variable como el nuevo texto.

en: Set of locations to which this action must not be added. See :attr:`all_locations` for a list of possible locations
es: Conjunto de ubicaciones a las que no debe añadirse esta acción. Ver :attr:`all_locations` para una lista de posibles ubicaciones

en: Set of locations from which this action must not be removed. See :attr:`all_locations` for a list of possible locations
es: Conjunto de ubicaciones de las que no se debe eliminar esta acción. Ver: :attr:`all_locations` para obtener una lista de posibles ubicaciones

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
es: Tipo de acción. «current» significa que actúa sobre la vista actual, «global» indica una acción que no actúa sobre la vista actual, sino sobre calibre en general

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.
es: Si es True, este :class:`InterfaceAction` tendrá la oportunidad de interactuar con acciones de arrastrar y soltar. Ver los métodos :meth:`accept_enter_event`, :meth`:accept_drag_move_event`, :meth:`drop_event` para más detalles.

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.
es: Este método debe devolver True si y sólo si esta acción de interfaz puede gestionar la acción de arrastrar. No ejecute ``accept`` o ``ignore`` en la acción, la interfaz de calibre se encargará de ello.

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.
es: Este método debe realizar algunas acciones útiles y devolver True si y sólo si esta acción de interfaz puede manejar el suceso `drop`. No ejecute `accept` o `ignore` sobre el suceso, la interfaz de calibre se encargará de eso. No debe realizar operaciones largas o que causen bloqueo en esta función. En su lugar lugar emita una señal o use `QTimer.singleShot` y finalice rápidamente. Vea las acciones predefinidas como ejemplos.

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.
es: Método práctico para añadir acciones a un QMenu. Devuelve la QAction creada. Esta acción tiene un atributo adicional ``calibre_shortcut_unique_name`` que, si no es None, se refiere al nombre único con el que esta acción se registra en el gestor de teclado.

en: The QMenu the newly created action will be added to
es: El QMenu al que se añadirá la nueva acción creada

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.
es: Un nombre único para esta acción. Debe ser un nombre globalmente único, así que hágalo tan descriptivo como sea posible. Si duda, añádale un identificador UUID.

en: The text of the action.
es: El texto de la acción.

en: Either a QIcon or a file name. The file name is passed to the QIcon.ic() builtin, so you do not need to pass the full path to the images folder.
es: Un QIcon o un nombre de archivo. El nombre de archivo se pasa al ``QIcon.ic()`` predefinido, así que no necesita pasar la ruta completa a la carpeta de imágenes.

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.
es: Un texto, una lista de textos, None o False. Si es False, no se registra ningún atajo de teclado para esta acción. Si es None, se registra un atajo de teclado sin ninguna tecla predeterminada. Con un texto o lista de textos se registra un atajo con las teclas asociadas predeterminadas que se especifiquen.

en: A description for this action. Used to set tooltips.
es: Una descripción para esta acción. Usado para establecer ayudas de herramienta.

en: A callable which is connected to the triggered signal of the created action.
es: Un objeto ejecutable conectado con la señal desencadenada de la acción creada.

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``.
es: El texto que se muestra al usuario al personalizar los atajos de teclado para esta acción. De manera predeterminada toma el valor de ``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.
es: Los atajos para acciones que no aparecen siempre, o que dependen de la biblioteca, pueden desaparecer al modificar otros atajos a menos que ``persist_shortcut`` sea 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.
es: Un diccionario de la forma ``{nombre: contenido_del_archivo}``. Cualquier nombre que no se encuentre en el archivo ZIP, no estará en el diccionario.

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``.
es: Configurar este complemento. Sólo se ejecuta una vez durante la inicialización. self.gui está disponible. La acción especificada por  :attr:`action_spec` está disponible como ``self.qaction``.

en: Called whenever the book list being displayed in calibre changes. Currently values for loc are: ``library, main, card and cardb``.
es: Ejecutado siempre que cambia la lista que se muestra en calibre. Actualmente los valores para ``loc`` son: ``library``, ``main``, ``card`` y ``cardb``.

en: This method should enable/disable this action and its sub actions as appropriate for the location.
es: Este método debe habilitar o deshabilitar esta acción y sus subacciones, según sea adecuado para la ubicación.

en: Called whenever the current library is changed.
es: Ejecutado cada vez que se cambia la biblioteca actual.

en: The LibraryDatabase corresponding to the previous library.
es: El objeto LibraryDatabase correspondiente a la biblioteca anterior.

en: The LibraryDatabase corresponding to the new library.
es: El objeto LibraryDatabase correspondiente a la nueva biblioteca.

en: The LibraryDatabase corresponding to the current library.
es: La LibraryDatabase correspondiente a la biblioteca actual.

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`.
es: Ejecutado una vez por acción cuando se completa la disposición de la interfaz gráfica principal. Si la acción necesita hacer cambios en la disposición, deben ocurrir aquí y no en :meth:`initialization_complete`.

en: Called once per action when the initialization of the main GUI is completed.
es: Se ejecuta una vez por acción cuando se completa la inicialización de la interfaz gráfica principal.

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.
es: Se ejecuta al mostrar el menú contextual en el explorador de etiquetas. ``index`` es el QModelIndex que apunta al elemento del explorador de etiquetas sobre el que se pulsó el botón derecho. Puede comprobar su validez con index.valid() y obtener el objeto TagTreeItem correspondiente con index.data(Qt.ItemDataRole.UserRole). Todos los objetos de acción generados por este método se añadirán al menú contextual.

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.
es: Ejecutado una vez por complemento cuando la interfaz gráfica se está apagando. Libere los recursos en uso, pero procure no bloquear el apagado durante un tiempo prolongado.

en: This method must return the actual interface action plugin object.
es: Este método debe devolver el objeto real de acción de interfaz.

en: Preferences plugins
es: Complementos de preferencias

en: A plugin representing a widget displayed in the Preferences dialog.
es: Un complemento que representa un widget mostrado en el cuadro de diálogo Preferencias.

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.
es: Este complemento posee un solo método importante: :meth:`create_widget`. Los diversos campos de este complemento controlan cómo se categoriza en la interfaz de usuario.

en: Import path to module that contains a class named ConfigWidget which implements the ConfigWidgetInterface. Used by :meth:`create_widget`.
es: Ruta de importación al módule que contiene una clase llamada ``ConfigWidget`` que implementa ``ConfigWidgetInterface``. Usado por :meth:`create_widget`.

en: Where in the list of categories the :attr:`category` of this plugin should be.
es: Donde debe estar la :attr: `category` de este complemento en la lista de categorías.

en: Where in the list of names in a category, the :attr:`gui_name` of this plugin should be
es: Dónde debe estar el :attr: `gui_name` de este complemento en la lista de nombres.

en: The category this plugin should be in
es: La categoría en la que debe estar este complemento

en: The category name displayed to the user for this plugin
es: El nombre de categoría mostrado al usuario para este complemento

en: The name displayed to the user for this plugin
es: El nombre que se muestra al usuario para este complemento

en: The icon for this plugin, should be an absolute path
es: El icono para este complemento, debe ser una ruta de acceso absoluta

en: The description used for tooltips and the like
es: La descripción usada para ayudas de herramientas y similares

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`.
es: Crea y devuelve el widget Qt real usado para establecer este grupo de preferencias. El widget debe implementar :class:`calibre.gui2.preferences.ConfigWidgetInterface`.

en: The default implementation uses :attr:`config_widget` to instantiate the widget.
es: La implementación predeterminada usa :attr:`config_widget` para crear el 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.
es: Esta clase define la interfaz que deben implementar todos los widgets mostrados en el cuadro de diálogo Preferencias. Ver :class:`ConfigWidgetBase` para una clase base que implementa esta interfaz y también define varios métodos prácticos.

en: This signal must be emitted whenever the user changes a value in this widget
es: Esta señal debe emitirse cuando el usuario cambia un valor en este widget

en: Set to True iff the :meth:`restore_to_defaults` method is implemented.
es: Es True si y sólo si el método :meth:`restore_to_defaults` está implementado.

en: The tooltip for the "Restore defaults" button
es: La ayuda de herramienta para el botón de restauración de los valores predeterminados

en: If True the Preferences dialog will not allow the user to set any more preferences. Only has effect if :meth:`commit` returns True.
es: Si es True el cuadro de diálogo de preferencias no permitirá al usuario establecer más preferencias. Sólo tiene efecto si :meth:`commit` devuelve True.

en: Called once before the widget is displayed, should perform any necessary setup.
es: Se ejecuta una vez antes de mostrar el widget, debe realizar cualquier configuración necesaria.

en: The main calibre graphical user interface
es: La interfaz gráfica principal 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.
es: Debe establecer todos los valores de configuración a sus valores iniciales (los valores almacenados en los archivos de configuración). Un sentencia «return» es opcional. Si devuelve «False», el diálogo no se muestra.

en: Should set all config values to their defaults.
es: Debe establecer todos los valores de configuración a sus valores predeterminados.

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.
es: Guarda cualquier configuración modificada. Devuelve True si los cambios requieren un reinicio, False si no es así. Genera una excepción :class:`AbortCommit` para indicar que ocurrió un error. Es su responsabilidad informar al usuario del error y cómo corregirlo.

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.
es: Se ejecuta una vez después de crear este widget. Es responsable de hacer que la interfaz gráfica vuelva a leer cualquier configuración modificada. Tenga en cuenta que la interfaz gráfica predeterminada reinicia varios elementos de todas formas, así que la mayoría de los widgets no necesitarán usar este método.

en: Called if the initially displayed tab is changed before the widget is shown, but after it is initialized.
es: Se ejecuta si la pestaña mostrada inicialmente cambia antes de que se muestre el widget, pero después de inicializarse.

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.
es: Clase base que contiene código para añadir widgets de configuración corrientes, como casillas de verificación, cuadros combinados, campos de texto, etc. Ver el método :meth:`register`.

en: This class automatically handles change notification, resetting to default, translation between gui objects and config objects, etc. for registered settings.
es: Esta clase gestiona automáticamente, para las configuraciones registradas, notificaciones de cambio, reinicio a valores predeterminados, correspondencia entre objetos de interfaz gráfica y de configuración, etc.

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.
es: Si el widget de configuración hereda esta clase pero incluye configuraciones que no están registradas, debe reemplazar los métodos de :class:`ConfigWidgetInterface` y llamar a los métodos de la clase base en los reemplazos.

en: Register a setting.
es: Registrar una configuración.

en: The setting name
es: El nombre de la configuración

en: The config object that reads/writes the setting
es: El objeto de configuración que lee y escribe la configuración

en: The name of the GUI object that presents an interface to change the setting. By default it is assumed to be ``'opt_' + name``.
es: El nombre del objeto de interfaz gráfica que ofrece una interfaz para modificar la configuración. De manera predeterminada se supone que es ``'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), ...]``
es: Si esta configuración es de elección múltiple (un cuadro combinado), la lista de posibilidades. La lista es una lista de tuplas de dos elementos de la forma: ``[(nombre de interfaz, valor), ...]``.

en: The class responsible for managing this setting. The default class handles almost all cases, so this param is rarely used.
es: La clase responsable de la gestión de esta configuración. La clase predeterminada contempla casi todos los casos, por lo que este parámetro es raramente usado.
