Manual de usuario de calibre, Publicación 2.73.0
author = u’ Desconocido’ El autor de este complemento
priority = 1 Cuando existe más de un complemento para un tipo de archivo, los complementos se ejecutarán en orden de prioridad decreciente, es decir, que los complementos de mayor prioridad se ejecutarán primero. La prioridad más alta posible es sys. maxint. La prioridad predeterminada es 1.
minimum _ calibre _ version =( 0, 4, 118) La versión más antigua requerida por este complemento
can _ be _ disabled = True Si es False, el usuario no podrá deshabilitar este complemento. Usar con precaución.
type = u’ Base’ El tipo de este complemento. Utilizado para clasificar los complementos en la interfaz gráfica.
initialize() 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.
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.
Tenga en cuenta que self. site _ customization no está disponible en este punto.
config _ widget() Implemente este método y save _ settings()( página 212) 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.
Este método, si se implementa, debe devolver un QWidget. El widget puede tener un mótodo opcional 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.
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á.
save _ settings( config _ widget) Guardar las configuraciones especificadas por el usuario con config _ widget.
Parámetros config _ widget – El widget devuelto por config _ widget()( página 212).
do _ user _ config( parent = None) 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.
load _ resources( names) 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.
Por ejemplo, para cargar una imagen:
pixmap = QPixmap() pixmap. loadFromData( self. load _ resources([' images / icon. png ']). itervalues(). ˓→next()) icon = QIcon( pixmap)
212 Capítulo 1. Secciones