Manual de usuario de calibre, Publicación 2.73.0
queta1» 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».
do_path_update – Usado internamente, nunca debe cambiarse.
set_metadata(book_id,
mi,
ignore_errors=False,
force_changes=False,
set_authors=True, allow_case_change=False)
Aplicar metadatos para el libro id a partir del objeto Metadata mi
set_title=True,
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.
set_pref(name, val)
Establecer la preferencia especificada al el valor especificado. Ver también pref() (página 292).
tags_older_than(tag, delta=None, must_have_tag=None, must_have_authors=None)
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.
Parámetros
delta – Un objeto de tipo timedelta o None. Si es None, se devuelven todos los identificadores con etiqueta.
must_have_tag – Si no es None, la lista de coincidencias se limitará a los libros que
tengan esta etiqueta
must_have_authors – 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).
user_categories_for_books(book_ids, proxy_metadata_map=None)
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.
Documentación de la API para las herramientas de modificación de libros electrónicos
Las
herramientas
de
modificación
de
libros
electrónicos
consisten
en
un
objeto
calibre.ebooks.oeb.polish.container.Container (página 295) que representa un libro como
colección de archivos HTML y de recursos, y varias herramientas que pueden usarse para realizar diversas operaciones sobre el contenedor. Todas las herramientas están bajo la forma de funciones a nivel de módulo, en los distintos
módulos calibre.ebooks.oeb.polish.*. Se obtiene un objeto contenedor para un libro en una ruta como
esta:
from calibre.ebooks.oeb.polish.container import get_container
container = get_containe