calibre - en to es translation catalogue (169 entries)

en: API documentation for the database interface
es: Documentación de la API para la interfaz de la base de datos

en: This API is thread safe (it uses a multiple reader, single writer locking scheme).  You can access this API like this::
es: Esta API es segura para subprocesos (utiliza un esquema de bloqueo de un escritor, varios lectores). Puede acceder a esta API así::

en: If you are in a calibre plugin that is part of the main calibre GUI, you get access to it like this instead::
es: Si se trata de un complemento de calibre que es parte de la interfaz gráfica principal, se accede a ella de la siguiente forma::

en: An in-memory cache of the metadata.db file from a calibre library. This class also serves as a threadsafe API for accessing the database. The in-memory cache is maintained in normal form for maximum performance.
es: Una copia en memoria caché del archivo metadata.db de la biblioteca de calibre. Esta clase también sirve como un API multihilo para acceder a la base de datos. La copia en memoria se mantiene en forma normal para maximizar el rendimiento.

en: SQLITE is simply used as a way to read and write from metadata.db robustly. All table reading/sorting/searching/caching logic is re-implemented. This was necessary for maximum performance and flexibility.
es: SQLite se usa simplemente como una manera de leer y escribir eficientemente metadata.db. Toda la lógica de lectura, clasificación, búsqueda y almacenamiento en la memoria caché de las tablas está desarrallada de nuevo. Esto fue necesario para obtener el máximo rendimiento y flexibilidad.

en: When a new book record is created in the database, with the book id as the only argument
es: Cuando se crea un nuevo registro de libro en la base de datos, con el identificador de libro como único argumento

en: When a book format is edited, with arguments: (book_id, fmt)
es: Cuando se modifica un formato de libro, con argumentos: (identificador de libro, formato)

en: When books are removed from the database with the list of book ids as the only argument
es: Cuando se eliminan libros de la base de datos con la lista de identificadores de libro como único argumento

en: When a format is added to a book, with arguments: (book_id, format)
es: Cuando se añade un formato a un libro, con argumentos: (idendificador de libro, formato)

en: When formats are removed from a book, with arguments: (mapping of book id to set of formats removed from the book)
es: Cuando se eliminan formatos de un libro, con argumentos (mapa de book_id a un conjunto de formatos eliminados del libro)

en: When the indexing progress changes
es: Cuando el progreso de indexado cambia

en: When items such as tags or authors are removed from some books. Arguments: (field_name, affected book ids, ids of removed items)
es: Cuando se eliminan elementos como etiquetas o autores de algunos libros. Argumentos: (nombre_de_campo, identificadores de libro afectados, ids de los elemtos eliminados)

en: When items such as tags or authors are renamed in some or all books. Arguments: (field_name, affected book ids, map of old item id to new item id)
es: Cuando se cambia el nombre de elementos como etiquetas o autores de algunos o todos los libros. Argumentos: (nombre_de campo, identificadores de libro afectados, mapa de id de elemento antiguo a id de elemento nuevo)

en: When some metadata is changed for some books, with arguments: (name of changed field, set of affected book ids)
es: Cuando se modifican metadatos de algunos libros, con argumentos: (nombre del campo modificado, conjunto de identificadores de libro afectados)

en: Add the specified books to the library. Books should be an iterable of 2-tuples, each 2-tuple of the form :code:`(mi, format_map)` where mi is a Metadata object and format_map is a dictionary of the form :code:`{fmt: path_or_stream}`, for example: :code:`{'EPUB': '/path/to/file.epub'}`.
es: Añadir los libros especificados a la biblioteca. Los libros deben ser iterables de 2-tuplas, cada 2-tuplas de la forma :code:`(mi, format_map)` donde ``mi`` es un objeto de metadatos y ``format_map`` es un diccionario en la forma :code:`{fmt: path_or_stream}`, por ejemplo: :code:`{'EPUB':'/path/to/file.epub'}`.

en: Returns a pair of lists: :code:`ids, duplicates`. ``ids`` contains the book ids for all newly created books in the database. ``duplicates`` contains the :code:`(mi, format_map)` for all books that already exist in the database as per the simple duplicate detection heuristic used by :meth:`has_book`.
es: Devuelve un par de listas: :code:`ids, duplicados`. ``ids`` contiene los identificadores de libros para todos los libros de reciente creación en la base de datos. ``duplicados`` contiene el :code: `(mi, format_map)` para todos los libros que ya existen en la base de datos según la sencilla detección heurística de duplicados utilizada por :meth:`has_book`.

en: Add data for name where val_map is a map of book_ids to values. If delete_first is True, all previously stored data for name will be removed.
es: Añadir datos para ``name`` donde ``val_map`` es un mapa de ``book_ids`` a valores. Si ``delete_first`` es True, se eliminarán todos los datos almacenados previamente.

en: Add extra data files
es: Añadir archivos de datos adicionales

en: Add a format to the specified book. Return True if the format was added successfully.
es: Añadir un formato al libro especificado. Devuelve True si el formato se añadió con éxito.

en: Parameters
es: Parámetros

en: If True replace existing format, otherwise if the format already exists, return False.
es: Si es True, sustituye el formato existente; en caso contrario, si el formato ya existe, devuelve False.

en: If True, file type plugins are run on the format before and after being added.
es: Si es True, los complementos de tipo de archivo se ejecutarán sobre el formato antes y después de ser añadido.

en: Internal use only.
es: Solo para uso interno.

en: Register a callback function that will be called after certain actions are taken on this database. The function must take three arguments: (:class:`EventType`, library_id, event_type_specific_data)
es: Registra una función que se ejecutará después de ciertas acciones sobre esta base de datos. La función debe aceptar tres argumentos (:class:`EventType`, id_de_biblioteca, datos_específicos_de_EventType)

en: Add the specified resource so it can be referenced by notes and return its content hash
es: Añade el recurso especificado para que pueda ser referenciado por notas y devuelve el código de comprobación de su contenido

en: Return a tuple of all annotation types in the database.
es: Devuelve una tupla con todos los tipos de anotaciones en la base de datos.

en: Return a tuple of all (user_type, user name) that have annotations.
es: Devuelve una tupla con todos los (tipo_usuario, nombre de usuario) que tienen anotaciones.

en: Return a tuple of all annotations matching the specified criteria. `ignore_removed` controls whether removed (deleted) annotations are also returned. Removed annotations are just a skeleton used for merging of annotations.
es: Devuelve una tupla de todas las anotaciones que coinciden con los criterios especificados. `ignore_removed` controla si las anotaciones eliminadas (borradas) también se devuelven. Las anotaciones eliminadas son solo un esqueleto usado para combinar anotaciones.

en: Return a tuple containing all annotations for the specified book_id as a dict with keys: `format`, `user_type`, `user`, `annotation`. Here, annotation is the annotation data.
es: Devuelve una tupla que contiene todas las anotaciones para el identificador de libro especificado como un diccionario con las entradas: `format`, `user_type`, `user`, `annotation`. Aquí `annotation` se refiere a los datos de la anotación.

en: Frozen set of all known book ids.
es: Conjunto fijo de todos los identificadores de libros conocidos.

en: Same as field_for, except that it operates on multiple books at once
es: Lo mismo que ``field_for``, excepto que opera sobre múltiples libros a la vez.

en: Frozen set of ids for all values in the field ``name``.
es: Conjunto fijo de identificadores para todos los valores del campo ``name``.

en: Frozen set of all fields names (should only be used for many-one and many-many fields)
es: Conjunto fijo de todos los nombres de campos (sólo se debe utilizar para los campos de tipo varios-uno y varios-varios)

en: Return the number of annotations for the specified book available in the database.
es: Devuelve el número de anotaciones disponibles para el libro especificado en la base de datos.

en: Return a map of annotation type -> annotation data for the specified book_id, format, user and user_type.
es: Devuelve una correspondencia entre tipo de anotación y datos de la anotación para el identificador de libro, formato, usuario y tipo de usuario especificados.

en: Return author data as a dictionary with keys: name, sort, link
es: Devuelve los datos del autor como un diccionario con claves: ``name``, ``sort``, ``link``

en: If no authors with the specified ids are found an empty dictionary is returned. If author_ids is None, data for all authors is returned.
es: Si no se encuentran autores con los identificadores especificados, se devuelve un diccionario vacío. Si ``author_ids`` es None, se devuelven datos para todos los autores.

en: Given a list of authors, return the author_sort string for the authors, preferring the author sort associated with the author over the computed string.
es: Dada una lista de autores, devolverá el texto ``author_sort`` para los autores, prefiriendo el orden de autor asociado con el autor sobre el texto calculado automáticamente.

en: Return all the books associated with the item identified by ``item_id``, where the item belongs to the field ``name``.
es: Devuelve todos los libros relacionados con el elemento identificado por ``item_id``, donde el elemento pertenece al campo ``name``.

en: Returned value is a set of book ids, or the empty set if the item or the field does not exist.
es: El valor devuelto es un conjunto de identificadores de libros, o el conjunto vacío si el elemento o el campo no existen.

en: Return the set of books in the specified virtual library
es: Devuelve el conjunto de libros en la biblioteca virtual especificada

en: Compress the cover images for the specified books. A compression quality of 100 will perform lossless compression, otherwise lossy compression.
es: Comprimir las imágenes de portada para los libros especificados. Una calidad de compresión de 100 realizará una compresión sin pérdidas, en caso contrario será con pérdidas.

en: The progress callback will be called with the book_id and the old and new sizes for each book that has been processed. If an error occurs, the new size will be a string with the error details.
es: La función progress_callback se ejecutará con book_id y los tamaños original y nuevo para cada libro que se procese. Si ocurre un error, el tamaño nuevo será un texto con los detalles del error.

en: Copy the cover to the file like object ``dest``. Returns False if no cover exists or dest is the same file as the current cover. dest can also be a path in which case the cover is copied to it if and only if the path is different from the current path (taking case sensitivity into account).
es: Copia la portada al objeto de tipo archivo ``dest``. Devuelve False si no existe portada o ``dest`` es el mismo archivo que la portada actual. ``dest`` también puede ser una ruta de acceso, en cuyo caso la portada se copia en la ruta si y sólo si la ruta es diferente de la actual ruta de acceso (considerando la posible distinción entre mayúsculas y minúsculas).

en: Copy the format ``fmt`` to the file like object ``dest``. If the specified format does not exist, raises :class:`NoSuchFormat` error. dest can also be a path (to a file), in which case the format is copied to it, iff the path is different from the current path (taking case sensitivity into account).
es: Copiar el formato ``fmt`` al objeto de tipo archivo ``dest``. Si el formato especificado no existe, se presenta un error :class:`NoSuchFormat`. ``dest`` también puede ser una ruta de acceso (a un archivo), en cuyo caso el formato se copia en la ruta si y sólo si la ruta es diferente de la ruta de acceso actual (considerando la posible distinción entre mayúsculas y minúsculas).

en: Return the cover image or None. By default, returns the cover as a bytestring.
es: Devuelve la imagen de portada o None. De manera predeterminada, devuelve la portada como una serie de bytes.

en: WARNING: Using as_path will copy the cover to a temp file and return the path to the temp file. You should delete the temp file when you are done with it.
es: ADVERTENCIA: Si se usa ``as_path``, se copia la portada a un archivo temporal y se devuelve la ruta de acceso al archivo temporal. Deberá eliminar el archivo temporal cuando haya terminado con él.

en: If True return the image as an open file object (a SpooledTemporaryFile)
es: Si es True devuelve la imagen como un objeto de archivo abierto (un SpooledTemporaryFile)

en: If True return the image as a QImage object
es: Si es True devuelve la imagen como un objeto QImage

en: If True return the image as a QPixmap object
es: Si es True devuelve la imagen como un objeto QPixmap

en: If True return the image as a path pointing to a temporary file
es: Si es True devuelve la imagen como una ruta de acceso a un archivo temporal

en: Return data that can be used to implement :meth:`find_identical_books` in a worker process without access to the db. See db.utils for an implementation.
es: Devuelve datos que pueden usarse para implementar :meth:`find_identical_books` en un proceso de trabajo sin acceso a la base de datos. Véase db.utils para una implementación.

en: Return data suitable for use in :meth:`has_book`. This can be used for an implementation of :meth:`has_book` in a worker process without access to the db.
es: Devuelve datos adecuados para :meth:`has_book`. Puede usarse para implementar :meth:`has_book` en un proceso de trabajo sin acceso a la base de datos.

en: Delete annotations with the specified ids.
es: Berrar anotaciones con los identificadores especificados.

en: Delete data for name. By default deletes all data, if you only want to delete data for some book ids, pass in a list of book ids.
es: Borra los datos para ``name``. De manera predeterminada se borran todos los datos, si sólo desea borrar datos de ciertos identificadores de libros, señálelos como una lista de identificadores de libros.

en: Delete an entry from the trash. Here category is 'b' for books and 'f' for formats.
es: Eliminar una entrada de la papelera de reciclaje. Aquí `category` es `'b'` para libros y `'f'` para formatos.

en: Update metadata in all formats of the specified book_ids to current metadata in the database.
es: Actualizar metadatos en todos los formatos de los ``book_ids`` especificados a los metadatos actuales de la base de datos.

en: Expire entries from the trash that are too old
es: Caducar entradas de la papelera de reciclaje que son demasiado antiguas

en: Export the note as a single HTML document with embedded images as data: URLs
es: Exporta la nota como un único documento HTML con imágenes empotradas como URL de tipo data:

en: Same as field_for, except that it avoids the extra lookup to get the field object
es: Igual que ``field_for``, salvo que se evita la consulta adicional para obtener el objeto de campo

en: Return the value of the field ``name`` for the book identified by ``book_id``. If no such book exists or it has no defined value for the field ``name`` or no such field exists, then ``default_value`` is returned.
es: Devuelve el valor del campo ``name`` para el libro identificado por ``book_id``. Si no existe tal libro o no tiene un valor definido para el campo ``name`` o no existe dicho campo, entonces devuelve ``default_value``.

en: ``default_value`` is not used for title, title_sort, authors, author_sort and series_index. This is because these always have values in the db. ``default_value`` is used for all custom columns.
es: ``default_value`` no se utiliza para title, title_sort, authors, author_sort y series_index. Esto se debe a que éstos siempre tienen valores en la base de datos. ``default_value`` se utiliza para todas las columnas personalizadas.

en: The returned value for is_multiple fields are always tuples, even when no values are found (in other words, default_value is ignored). The exception is identifiers for which the returned value is always a dictionary. The returned tuples are always in link order, that is, the order in which they were created.
es: El valor devuelto para los campos ``is_multiple`` es siempre una tupla, incluso cuando no se encuentran valores (en otras palabras, ``default_value`` no tiene efecto). La excepción son los identificadores para los que el valor devuelto es siempre un diccionario. Las tuplas devueltas son siempre en orden de enlace, es decir, el orden en el que fueron creadas.

en: Return the ids (as a tuple) for the values that the field ``name`` has on the book identified by ``book_id``. If there are no values, or no such book, or no such field, an empty tuple is returned.
es: Devuelve los identificadores (como una tupla) de los valores que el campo ``name`` tiene en el libro identificado por ``book_id``. Si no hay valores, o tal libro o tal campo, se devuelve una tupla vacía.

en: Return True iff the specified field supports notes. If field is None return frozenset of all fields that support notes.
es: Devuelve True si y sólo si el campo especificado admite notas. Si ``field`` es None, devuelve un conjunto de todos los campos que admiten notas.

en: Finds books that have a superset of the authors in mi and the same title (title is fuzzy matched). See also :meth:`data_for_find_identical_books`.
es: Encuentra libros que contienen los autores en «mi» y tienen el mismo título (la búsqueda de título es difusa). Véase también

en: Return the e-book format as a bytestring or `None` if the format doesn't exist, or we don't have permission to write to the e-book file.
es: Devuelve el formato de libro electrónico como una serie de bytes o `None` si el formato no existe, o no hay permiso para escribir en el archivo de libro electrónico.

en: If True the e-book format is returned as a file object. Note that the file object is a SpooledTemporaryFile, so if what you want to do is copy the format to another file, use :meth:`copy_format_to` instead for performance.
es: Si es True el formato de libro electrónico se devuelve como un objeto de archivo. Tenga en cuenta que el objeto es un archivo SpooledTemporaryFile, por lo que si lo que quiere hacer es copiar el formato a otro archivo, utilice :meth:`copy_format_to` en su lugar para mejorar el rendimiento.

en: Copies the format file to a temp file and returns the path to the temp file
es: Copia el archivo de formato a un archivo temporal y devuelve la ruta de acceso al archivo temporal.

en: If True and returning a path the filename is the same as that used in the library. Note that using this means that repeated calls yield the same temp file (which is re-created each time)
es: Si es True y devuelve una ruta de acceso, el nombre de archivo es el mismo que el utilizado en la biblioteca. Tenga en cuenta que, al utilizar este método, llamadas repetidas producen el mismo archivo temporal (que se vuelve a crear cada vez)

en: Return absolute path to the e-book file of format `format`. You should almost never use this, as it breaks the threadsafe promise of this API. Instead use, :meth:`copy_format_to`.
es: Devuelve la ruta de acceso absoluta al archivo de libro electrónico de formato ``format``. Casi nunca debe usarlo, ya que rompe la filosofía multihilo de esta API. Use :meth:`copy_format_to`.

en: Currently used only in calibredb list, the viewer, edit book, compare_format to original format, open with, bulk metadata edit and the catalogs (via get_data_as_dict()).
es: Actualmente sólo se usa en calibredb list, el visor, modificar libro, compare_format con formato original, abrir con, modificación de metadatos en masa y los catálogos (vía get_data_as_dict()).

en: Apart from the viewer, open with and edit book, I don't believe any of the others do any file write I/O with the results of this call.
es: Aparte del visor, abrir con y el editor de libros, no creo que ningún otro realice ninguna operación de entrada o salida con el resultado de esta función.

en: Return the hash of the specified format for the specified book. The kind of hash is backend dependent, but is usually SHA-256.
es: Devuelve el código de comprobación para el formato y libro especificados. El tipo de código de comprobación es dependiente del motor, pero generalmente es SHA-256.

en: Return the path, size and mtime for the specified format for the specified book. You should not use path unless you absolutely have to, since accessing it directly breaks the threadsafe guarantees of this API. Instead use the :meth:`copy_format_to` method.
es: Devuelve la ruta, el tamaño y mtime para el formato especificado del libro especificado. No debe utilizar la ruta a menos que sea absolutamente necesario, ya que el acceso directo rompe las garantías multihilo de esta API. Use :meth:`método copy_format_to` en su lugar.

en: If ``True`` cached values are used, otherwise a slow filesystem access is done. The cache values could be out of date if access was performed to the filesystem outside of this API.
es: Si es True se usan los valores almacenados en memoria, en caso contrario se produce un acceso lento al sistema de archivos. Los valores en la memoría podrían estar desfasados si se ha realizado algún acceso al sistema de archivos fuera de esta API.

en: If ``True`` The max_size field of the database is updated for this book.
es: Si es True el campo max_size de la base de datos se actualiza para este libro.

en: Return tuple of all formats for the specified book. If verify_formats is True, verifies that the files exist on disk.
es: Devuelve una tupla con todos los formatos del libro especificado. Si ``verify_formats`` es True, se verifica que los archivos existen en el disco.

en: Return all item_ids for items that have notes in the specified field or all fields if field_name is None
es: Devuelve todos los ``item_id`` para los elementos que tienen notas en el campo especificado, o en todos los campos si ``field_name`` es None

en: Returns all links for all fields referenced by book identified by book_id. If book_id doesn't exist then the method returns {}.
es: Devuelve todos los enlaces para todos los campos referenciados por el libro identificado por ``book_id``. Si ``book_id`` no existe, el método devuelve ``{}``.

en: Example: Assume author A has link X, author B has link Y, tag S has link F, and tag T has link G. If book 1 has author A and tag T, this method returns {'authors':{'A':'X'}, 'tags':{'T', 'G'}}. If book 2's author is neither A nor B and has no tags, this method returns {}.
es: Ejemplo: Suponiendo que el autor A tiene el enlace X, el autor B tiene el enlace Y, la etiqueta S tiene el enlace F y la etiqueta T tiene el enlace G. Si el libro 1 tiene autor A y etiqueta T, este método devuelve ``{'authors':{'A':'X'}, 'tags':{'T', 'G'}}``. Si el autor del libro 2 no es ni A ni B y no tiene etiquetas, este método devuelve ``{}``.

en: the book id in question.
es: el identificador del libro en cuestión.

en: Returns
es: Devuelve

en: {field: {field_value, link_value}, ...  for all fields with a field_value having a non-empty link value for that book
es: ``{campo: {valor_campo, valor_enlace}, ...}`` para todos los campos con un ``valor_campo`` que contenga un valor del enlace no vacío para ese libro

en: Used internally to implement the Tag Browser
es: Usado internamente para implementer el exlorador de etiquetas

en: Get data for name. By default returns data for all book_ids, pass in a list of book ids if you only want some data. Returns a map of book_id to values. If a particular value could not be decoded, uses default for it.
es: Obtener datos para ``name``. De manera predeterminada devuelve datos para todos los ``book_ids``, pase una lista de identificadores de libros si sólo desea algunos dato. Devuelve un mapa de book_id a valores. Si un valor particular no puede ser descodificado, utiliza el predeterminado.

en: Return a mapping of id numbers to values for the specified field. The field must be a many-one or many-many field, otherwise a ValueError is raised.
es: Devuelve un mapa de números de identificación a valores para el campo especificado. El campo debe ser un campo de varios-uno o varios-varios, de lo contrario se presenta un ValueError.

en: Return the set of book ids for which name has data.
es: Devuelve el conjunto de identificadores de libros para los que ``name`` tiene datos.

en: Return the item id for item_name or None if not found. This function is very slow if doing lookups for multiple names use either get_item_ids() or get_item_name_map(). Similarly, case sensitive lookups are faster than case insensitive ones.
es: Devuelve el identificador de elemento para «item_name» o None si no se encuentra. Esta función es muy lenta, para consultas de varios nombres use get_item_ids() o get_item_name_map(). Las consultas con distinción de mayúsculas y minúsculas son más rápidas que las consultas sin distinción.

en: Return a dict mapping item_name to the item id or None
es: Devuelve un diccionario que hace corresponder «item_name» con el identificador de elemento o None

en: Return the item name for the item specified by item_id in the specified field. See also :meth:`get_id_map`.
es: Devuelve el nombre del elemento para el elemento especificado por ``item_id`` en el campo especificado. Ver también :meth:`get_id_map`.

en: Return mapping of item values to ids
es: Devuelve una correspondencia entre valores de elemento e id

en: Return a dictionary of links for the supplied field.
es: Devuelve un diccionario de enlaces para el campo proporcionado.

en: the lookup name of the field for which the link map is desired
es: el nombre de consulta del campo para el que se quiere el mapa de enlaces

en: {field_value:link_value, ...} for non-empty links
es: ``{valor_campo:valor_enlace, ...}`` para los enlaces no vacíos

en: Return metadata for the book identified by book_id as a :class:`calibre.ebooks.metadata.book.base.Metadata` object. Note that the list of formats is not verified. If get_cover is True, the cover is returned, either a path to temp file as mi.cover or if cover_as_data is True then as mi.cover_data.
es: Devuelve metadatos para el libro identificado por ``book_id`` como un objeto de :class:`calibre.ebooks.metadata.book.base.Metadata`. Tenga en cuenta que la lista de formatos no se verifica. Si ``get_cover`` es True, se devuelve la portada, ya sea como una ruta de acceso a un archivo temporal o como mi.cover, o si ``cover_as_data`` es True como mi.cover_data.

en: Return the next series index for the specified series, taking into account the various preferences that control next series number generation.
es: Devuelva el siguiente índice la serie especificada, teniendo en cuenta las distintas preferencias que controlan la generación del siguiente número de serie.

en: The series-like field (defaults to the builtin series column)
es: El campo de tipo serie (de manera predeterminada la columna predefinida «series»)

en: If True, returns a mapping of book_id to current series_index value instead.
es: Si es True, devuelve un mapa de ``book_id`` al valor actual de ``series_index``.

en: Return a dict containing the resource data and name or None if no resource with the specified hash is found
es: Devuelve un diccionario que contiene los datos y el nombre del recurso o None si no se encuentra ningún recurso con el código de comprobación (``hash``) especificado

en: Like :meth:`get_metadata` except that it returns a ProxyMetadata object that only reads values from the database on demand. This is much faster than get_metadata when only a small number of fields need to be accessed from the returned metadata object.
es: Como :meth:`get_metadata` excepto que devuelve un objeto ProxyMetadata que sólo lee valores desde la base de datos bajo demanda. Es mucho más veloz que :meth:`get_metadata` cuando sólo se quiere acceder a un pequeño número de campos desde el objeto metatados devuelto.

en: Return a mapping of id to usage count for all values of the specified field, which must be a many-one or many-many field.
es: Devuelve un mapa de identificador a cuenta de uso para todos los valores del campo especificado, que debe ser un campo de tipo varios-uno o varios-varios.

en: Return True iff the database contains an entry with the same title as the passed in Metadata object. The comparison is case-insensitive. See also :meth:`data_for_has_book`.
es: Devuelve True si y sólo si la base de datos contiene una entrada con el mismo título que el objeto Metadata pasado como argumento. La comparación no distingue mayúsculas y minúsculas. Véase también

en: Return True iff the format exists on disk
es: Devuelve True si y sólo si el formato existe en el disco.

en: Return True iff the specified book_id exists in the db
es: Devuelve True si y sólo si el ``book_id`` especificado existe en la base de datos.

en: Import a previously exported note or an arbitrary HTML file as the note for the specified item
es: Importa una nota previamente exportada o un archivo HTML arbitrario como la nota para el elemento especificado

en: Initialize this cache with data from the backend.
es: Inicializar esta copia en caché con datos del motor.

en: Return a dict of field to items that have associated notes for that field for the specified book
es: Devuelve un diccionario de campo y elementos que tienen notas asociadas para ese campo en el libro especificado

en: Return the link, if any, for the specified item or None if no link is found
es: Devuelve el enlace, si lo hay, para el elemento especificado o None si no se encuentra ningún enlace

en: Get information about extra files in the book's directory.
es: Obtener información acerca de los archivos adicionales en el directorio del libro.

en: the database book id for the book
es: el ID del libro en la base de datos

en: the pattern of filenames to search for. Empty pattern matches all extra files. Patterns must use / as separator. Use the DATA_FILE_PATTERN constant to match files inside the data directory.
es: el patrón de nombres de archivo a buscar. Un patrón vacío coincide con todos los archivos adicionales. Los patrones deben usar ``/`` como separador. Use la constante ``DATA_FILE_PATTERN`` para buscar archivos dentro del directorio de datos.

en: A tuple of all extra files matching the specified pattern. Each element of the tuple is ExtraFile(relpath, file_path, stat_result). Where relpath is the relative path of the file to the book directory using / as a separator. stat_result is the result of calling os.stat() on the file.
es: Una tupla con todos los archivos adicionales que coinciden con el patrón especificado. Cada elemento de la tupla es de la forma ``ExtraFile(ruta_rel, ruta_archivo, res_stat)``, donde ``ruta_rel`` es la ruta relativa al archivo respecto al directorio del libro usando ``/`` como separador. ``res_stat`` es el resultado de ejecuta ``os.stat()`` sobre el archivo.

en: Merge the specified annotations into the existing annotations for book_id, fm, user_type, and user.
es: Combinar las anotaciones especificadas con las anotaciones existentes para el identificador de libro, formato, tipo de usuario y usuario.

en: Merge the extra files from src_ids into dest_id. Conflicting files are auto-renamed unless replace=True in which case they are replaced.
es: Combinar los archivos adicionales de ``src_ids`` (origen) con los de ``dest_id`` (destino). A los archivos que entren en conflicto se les cambiará el nombre automáticamente, a no ser que ``replace`` sea True, en cuyo caso se sustituirán.

en: Undelete a book from the trash directory
es: Restaurar un libro del directorio de la papelera

en: Undelete a format from the trash directory
es: Restaurar un formato del directorio de la papelera

en: Return a list of sorted book ids. If ids_to_sort is None, all book ids are returned.
es: Devuelve una lista de identificadores de libros ordenados. Si ``ids_to_sort`` es None, devuelve todos los identificadores de libros.

en: fields must be a list of 2-tuples of the form (field_name, ascending=True or False). The most significant field is the first 2-tuple.
es: los campos deben ser una lista de 2-tuplas de la forma (field_name, ascending=True|False). El campo más significativo es la primera 2-tupla.

en: Return all notes data as a dict or None if note does not exist
es: Devuelve todos los datos de notas como un diccionario o None si la nota no existe

en: Return the notes document or an empty string if not found
es: Devuelve el documento de notas o un texto vacío si no se encuentra

en: Return the set of resource hashes of all resources used by the note for the specified item
es: Devuelve el conjunto de códigos de comprobación de recurso de todos los recursos usados por la nota del elemento especificado

en: Return the value for the specified preference or the value specified as ``default`` if the preference is not set.
es: Devuelve el valor de la preferencia especificada o el valor especificado como ``default`` si la preferencia no se ha establecido.

en: Return the OPF metadata backup for the book as a bytestring or None if no such backup exists.
es: Devuelve la copia de seguridad de los metadatos OPF para el libro como una serie de bytes o None si no existe dicha copia de seguridad.

en: Remove the books specified by the book_ids from the database and delete their format files. If ``permanent`` is False, then the format files are placed in the per-library trash directory.
es: Eliminar los libros especificados por los ``book_ids`` de la base de datos y eliminar sus archivos de formato. Si ``permanent`` es False, los archivos de formato se dejan en el directorio de papelera específico de la biblioteca.

en: Delete the specified extra files, either to Recycle Bin or permanently.
es: Eliminar los archivos adicionales especificados, ya sea a la papelera de reciclaje o de forma permanente.

en: Remove the specified formats from the specified books.
es: Eliminar los formatos especificados de los libros especificados.

en: A mapping of book_id to a list of formats to be removed from the book.
es: Un mapa de book_id a una lista de formatos para eliminar del libro.

en: If True, only remove the record for the format from the db, do not delete the actual format file from the filesystem.
es: Si es True, sólo se elimina el registro del formato de la base de datos, no se borra el archivo de formato del sistema de archivos.

en: A map of book id to set of formats actually deleted from the filesystem for that book
es: Un mapa de id de libro a conjunto de formatos realmente eliminados del sistema de archivos para ese libro

en: Delete all items in the specified field with the specified ids. Returns the set of affected book ids. ``restrict_to_book_ids`` is an optional set of books ids. If specified the items will only be removed from those books.
es: Elimina todos los elementos del campo especificado con los id especificados. Devuelve el conjunto de id de libro afectados. ``restrict_to_book_ids`` es un conjunto de id de libros opcional. Si se especifica, sólo se eliminarán los elementos de estos libros.

en: Rename extra data files
es: Cambiar el nombre de los archivos de datos adicionales

en: Rename items from a many-one or many-many field such as tags or series.
es: Cambiar el nombre de elementos de un campo de tipo varios-uno o varios-varios, como etiquetas o series.

en: When renaming in a series-like field also change the series_index values.
es: Al cambiarel nombre de un campo del tipo serie cambiar también los valores de «series_index».

en: An optional set of book ids for which the rename is to be performed, defaults to all books.
es: Un conjunto de id de libros opcional sobre los que se realiza el cambio de nombre, de manera predeterminada incluye todos los libros.

en: Restore the book entry in the database for a book that already exists on the filesystem
es: Restaurar la entrada del libro en la base de datos de un libro que ya existe en el sistema de archivos.

en: Restore the specified format from the previously saved ORIGINAL_FORMAT, if any. Return True on success. The ORIGINAL_FORMAT is deleted after a successful restore.
es: Restaurar el formato especificado a partir del ORIGINAL_FORMAT previamente guardado, si lo hubiera. Devuelve True en caso de éxito. El ORIGINAL_FORMAT se elimina después de una restauración correcta.

en: A safe read lock is a lock that does nothing if the thread already has a write lock, otherwise it acquires a read lock. This is necessary to prevent DowngradeLockErrors, which can happen when updating the search cache in the presence of composite columns. Updating the search cache holds an exclusive lock, but searching a composite column involves reading field values via ProxyMetadata which tries to get a shared lock. There may be other scenarios that trigger this as well.
es: Un bloqueo de lectura segura es un bloqueo que no hace nada si el hilo ya tiene un bloqueo de escritura, de lo contrario, agrega un bloqueo de lectura. Esto es necesario para evitar DowngradeLockErrors, lo que puede suceder cuando se actualiza la caché de búsqueda en presencia de columnas compuestas. Al actualizar la caché de búsqueda se crea un bloqueo exclusivo, pero al buscar en una columna compuesta tiene lugar la lectura de valores de campo vía ProxyMetadata, que trata de obtener un bloqueo compartido. Puede haber otras situaciones que desencadenen esto.

en: This property returns a new lock object on every access. This lock object is not recursive (for performance) and must only be used in a with statement as ``with cache.safe_read_lock:`` otherwise bad things will happen.
es: Esta propiedad devuelve un nuevo objeto de bloqueo en cada acceso. Este objeto de bloqueo no es recursivo (por rendimiento) y sólo debe ser utilizado en una sentencia ``with`` como ``with cache.safe_read_lock:``, de lo contrario habrá problemas.

en: Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any existing ORIGINAL_FORMAT.
es: Guardar una copia del formato especificado como ORIGINAL_FORMAT, sustituyendo cualquier ORIGINAL_FORMAT existente.

en: Search the database for the specified query, returning a set of matched book ids.
es: Buscar en la base de datos con la consulta especificada, devolviendo un conjunto de identificadores de libros que coincidan.

en: A restriction that is ANDed to the specified query. Note that restrictions are cached, therefore the search for a AND b will be slower than a with restriction b.
es: Una restricción que se añade como Y a la consulta especificada. Tenga en cuenta que las restricciones se almacenan en caché, por lo tanto, la búsqueda de a Y b será más lenta que a con una restricción b.

en: Used internally (virtual fields such as on_device to search over).
es: Usado internamente (campos virtuales tales como «on_device» para búsquedas).

en: If not None, a set of book ids for which books will be searched instead of searching all books.
es: Si no es None, un conjunto de identificadores de libros en los que buscar en vez de buscar en todos los libros.

en: Return of a tuple of annotations matching the specified Full-text query.
es: Devuelve una tupla de anotaciones que coinciden con la búsqueda de texto completo especificada.

en: Search the text of notes using an FTS index. If the query is empty return all notes.
es: Busca en el texto de las notas usando un índice de búsqueda de texto completo. Si la consulta está vacía devuelve todas las notas.

en: Set all annotations for the specified book_id, fmt, user_type and user.
es: Ver todas las anotaciones para el identificador de libro, formato, tipo de usuario y usuario especificados.

en: options must be a map of the form {book_id:conversion_options}
es: ``options`` debe ser un mapa de la forma {book_id:opciones de conversión}

en: Set the cover for this book. The data can be either a QImage, QPixmap, file object or bytestring. It can also be None, in which case any existing cover is removed.
es: Establecer la portada de este libro. El argumento puede ser un objeto de tipo QImage, QPixmap, archivo o una serie de bytes. También puede ser None, en cuyo caso se elimina cualquier portada existente.

en: Set the values of the field specified by ``name``. Returns the set of all book ids that were affected by the change.
es: Establecer los valores del campo especificado por ``name``. Devuelve el conjunto de todos los identificadores de libros afectados por el cambio.

en: Mapping of book_ids to values that should be applied.
es: Mapa de book_ids a los valores que se deben aplicar.

en: If True, the case of many-one or many-many fields will be changed. For example, if a  book has the tag ``tag1`` and you set the tag for another book to ``Tag1`` then the both books will have the tag ``Tag1`` if allow_case_change is True, otherwise they will both have the tag ``tag1``.
es: Si es True, se cambiará el uso de mayúsculas y minúsculas de campos de tipo varios-uno o varios-varios. Por ejemplo, si un libro tiene la etiqueta «etiqueta1» y establece la etiqueta de otro libro a «Etiqueta1», entonces los libros de ambos tendrá la etiqueta «Etiqueta1» si ``allow_case_change`` es True, de lo contrario ambos tendrán la etiqueta «etiqueta1».

en: Used internally, you should never change it.
es: Usado internamente, nunca debe cambiarse.

en: Sets links for item values in field. Note: this method doesn't change values not in the value_to_link_map
es: Asigna enlaces para los elementos en el campo ``field``. Tenga en cuenta que este método no cambia los valores que no estén presentes en ``value_to_link_map``

en: the lookup name
es: el nombre de consulta

en: dict(field_value:link, ...). Note that these are values, not field ids.
es: ``dict(valor_campo:enlace, ...)``. Tenga en cuenta que son valores, no identificadores de campo.

en: books changed by setting the link
es: libros modificados al asignar el enlace

en: Set metadata for the book `id` from the `Metadata` object `mi`
es: Aplicar metadatos para el libro ``id`` a partir del objeto ``Metadata`` ``mi``

en: Setting force_changes=True will force set_metadata to update fields even if mi contains empty values. In this case, 'None' is distinguished from 'empty'. If mi.XXX is None, the XXX is not replaced, otherwise it is. The tags, identifiers, and cover attributes are special cases. Tags and identifiers cannot be set to None so they will always be replaced if force_changes is true. You must ensure that mi contains the values you want the book to have. Covers are always changed if a new cover is provided, but are never deleted. Also note that force_changes has no effect on setting title or authors.
es: Si se establece ``force_changes=True`` set_metadata actualizará los campos, incluso si ``mi`` contiene valores vacíos. En este caso, None se distingue de «vacío». Si ``mi.XXX`` es None, el XXX no se sustituye, en caso contrario sí. Las etiquetas, identificadores y los atributos de portadas son casos especiales. Las etiquetas e identificadores no se pueden establecer en None por lo que siempre se sustituirán si ``force_changes`` es True. Debe asegurarse de que ``mi`` contenga los valores que desea que tenga el libro. Las portadas siempre se cambian si se proporciona una nueva, pero nunca se borran. Tenga también en cuenta que ``force_changes`` no tiene ningún efecto en la configuración de título o autores.

en: Set the notes document. If the searchable text is different from the document, specify it as searchable_text. If the document references resources their hashes must be present in resource_hashes. Set remove_unused_resources to True to cleanup unused resources, note that updating a note automatically cleans up resources pertaining to that note anyway.
es: Establece el documento de notas. Si el texto que se puede buscar es distinto del documento, debe especificarse como ``searchable_text``. Si el documento hace referencia a recursos, sus códigos de comprobación deben incluirse en ``resource_hashes``. Establecer ``remove_unused_resources`` como True para limpiar los recursos no usados, tenga en cuenta que en todo caso una nota limpia automáticamente los recursos pertenecientes a esa nota.

en: Set the specified preference to the specified value. See also :meth:`pref`.
es: Establecer la preferencia especificada al el valor especificado. Ver también :meth:`pref`.

en: If f is a composite column lookup key and the column is is_multiple then split v into unique non-empty values. The comparison is case sensitive. Order is not preserved. Return a list() for compatibility with proxy metadata field getters, for example tags.
es: Si ``f`` es una clave de búsqueda de una columna compuesta y la columna es ``is_multiple``, entonces ``val`` se divide en valores únicos no vacíos. La comparación distingue mayúsculas y minúsculas. El orden no se mantiene. Devuelve un objeto ``list()`` por compatibilidad con otros métodos de obtención de metadatos como las etiquetas.

en: Return the ids of all books having the tag ``tag`` that are older than the specified time. tag comparison is case insensitive.
es: Devuelve los identificadores de todos los libros que tienen la etiqueta ``tag`` que son anteriores al momento especificado. La comparación de etiquetas no distingue entre mayúsculas y minúsculas.

en: A timedelta object or None. If None, then all ids with the tag are returned.
es: Un objeto de tipo timedelta o None. Si es None, se devuelven todos los identificadores con etiqueta.

en: If not None the list of matches will be restricted to books that have this tag
es: Si no es None, la lista de coincidencias se limitará a los libros que tengan esta etiqueta

en: A list of authors. If not None the list of matches will be restricted to books that have these authors (case insensitive).
es: Una lista de autores. Si no es None, la lista de coincidencias se limitará a los libros que tengan estos autores (no distingue mayúsculas y minúsculas).

en: Unretire a previously retired note for the specified item. Notes are retired when an item is removed from the database
es: Desretira una nota previamente retirada para el elemento especificado. Las notas se retiran cuando se elimina un elemento de la base de datos

en: Update annotations.
es: Actualizar anotaciones.

en: Return the user categories for the specified books. proxy_metadata_map is optional and is useful for a performance boost, in contexts where a ProxyMetadata object for the books already exists. It should be a mapping of book_ids to their corresponding ProxyMetadata objects.
es: Devuelve las categorías de usuario de los libros especificados. ``proxy_metadata_map`` es opcional y es útil para aumentar el rendimiento en contextos donde ya existe un objeto ProxyMetadata de los libros. Debe ser un mapa de book_ids a los objetos ProxyMetadata correspondientes.
