Manual de usuario de calibre, Publicación 2.73.0
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.
get_book_url_name(idtype, idval, url)
Devuelve un nombre legible por humanos a partir valor devuelto por get_book_url().
get_book_urls(identifiers)
Reemplace 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 get_book_url() (página 216).
get_cached_cover_url(identifiers)
Devuelve el URL de portada en caché para el libro identificado por el diccionario identifiers o None
si no existe el URL.
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.
identify_results_keygen(title=None, authors=None, identifiers={})
Devuelve una función empleada para generar una clave que pueda ordenar objetos de tipo Metadata por
su relevancia dada una consulta de búsqueda (title, authors, identifiers).
Estas claves se usan para ordenar los resultados de identify() (página 217).
Para detalles sobre el algoritmo predeterminado ver InternalMetadataCompareKeyGen (página 218). Implemente de nuevo esta función en el complemento si el algoritmo predeterminado no es el
adecuado.
identify(log, result_queue, abort, title=None, authors=None, identifiers={}, timeout=30)
Identificar un libro por su título, autor, ISBN, etc.
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).
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.
Cada objeto 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 compare_identify_results(). Si el orden
no es importante, póngalo a cero para todos los resultados.
Asegúrese de que cualquier información de correspondencia de portada o ISBN está en caché antes de que
el objeto Metadata sea puesto en result_queue.
Parámetros
log – Un objeto de registro, úselo para obtener errores e información de depuración
result_queue – Un objeto Queue resultante, los resultados deben ser puestos en él.
Cada resultado es un objeto Metadata.
abort – Si abort.is_set() devuelve True, interrumpir el proceso y volver tan pronto como sea posible
title – El título del libro, puede ser None
authors – Una lista de autores del libro, puede ser None
identifiers –
{‘isbn’:‘1234...’}
1.10. Personalizar calibre
Un
diccionario
de
otros
identificadores,
principalmente
217