Manual de usuario de calibre, Publicación 2.73.0
Parámetros names – Lista de rutas a los recursos en el archivo zip utilizando / como separador
Devuelve Un diccionario de la forma {nombre: contenido_del_archivo}. Cualquier
nombre que no se encuentre en el archivo zip, no estará en el diccionario.
customization_help(gui=False)
Devuelve un texto que ofrece ayuda sobre cómo personalizar este complemento. De manera predeterminada, genera el error NotImplementedError, que indica que el complemento no necesita personalización.
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.
site_customization puede ser cualquier cosa, por ejemplo, la ruta de acceso a un archivo binario necesario
en el equipo del usuario.
Parámetros gui – Si es True devuelve la ayuda HTML, de lo contrario devuelve ayuda de texto
sin formato.
temporary_file(suffix)
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.
Parámetros suffix – El sufijo del archivo temporal.
cli_main(args)
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.
FileTypePlugin
class calibre.customize.FileTypePlugin(plugin_path)
Clases base: calibre.customize.Plugin (página 211)
Un complemento asociado con un determinado conjunto de tipos de archivo.
file_types = set([])
Conjunto de tipos de archivo para que este complemento debe ejecutarse. Por ejemplo:
{'lit','mobi','prc'}
on_import = False
Si es True, este complemento se ejecuta cuando se añaden libros a la base de datos
on_postimport = False
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 postimport() y postadd() del complemento.
on_preprocess = False
Si es True, este complemento se ejecuta justo antes de una conversión
on_postprocess = False
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.
run(path_to_ebook)
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,
1.10. Personalizar calibre
213