Manual de usuario de calibre, Publicación 2.73.0
La API del complemento
Como ya se habrá dado cuenta, un complemento en calibre es una clase. Hay diferentes clases para los diferentes
tipos de complementos en calibre. Los detalles de cada clase, incluyendo la clase base de todos los complementos, se
pueden encontrar en Documentación de la API para complementos (página 211).
Es casi seguro que el complemento va a usar el código de calibre. Para saber cómo encontrar los distintos elementos
de funcionalidad en el código base de calibre, lea la sección Estructura del código (página 281).
Depurar complementos
El primer paso, el más importante, es ejecutar calibre en modo de depuración. Puede hacer esto desde la línea de
órdenes con:
calibre-debug -g
O desde el mismo calibre, pulsando con el botón derecho en Preferencias o usando el atajo de teclado Ctrl+Shift+R.
Cuando se ejecuta desde la línea de órdenes, la salida de depuración se enviará a la consola, si se ejecuta dentro de
calibre, la salida irá a un archivo txt.
Puede insertar sentencias de impresión en cualquier lugar en el código fuente del complemento, tendrán efecto en el
modo de depuración. Recuerde, esto es python, no debe necesitar más que sentencias de impresión para depurar ;) He
desarrollado todo calibre usando sólo esta técnica de depuración.
Puede probar rápidamente los cambios en el complemento con la siguiente orden:
calibre-debug -s; calibre-customize -b /path/to/your/plugin/directory; calibre
Esto cerrará calibre, espere hasta que se cierre completamente, después actualice el complemento en calibre y vuelva
a iniciar calibre.
Más ejemplos de complementos
Puede encontrar una lista muchos complementos de calibre más complejos aqui84 .
Compartir sus complementos con otros
Si desea compartir los complementos que ha creado con otros usuarios de calibre, inicie un nuevo hilo adjuntando el
complemento en el foros de complementos de calibre85 (en inglés).
1.9.7 Escribir fórmulas matemáticas en libros electrónicos
El visor de libros de calibre tiene la capacidad de mostrar fórmulas matemáticas incrustadas en libros electrónicos
(archivos ePub y HTML). Puede escribir las fórmulas directamente con TeX, MathML o ASCIIMath. El visor de
calibre usa la excelente biblioteca MathJax86 para procesar las fórmulas. Esto es un breve cursillo para crear libros con
fórmulas que funcionen con el visor de calibre.
84
85
86
http://www.mobileread.com/forums/showthread.php?t=118764
http://www.mobileread.com/forums/forumdisplay.php?f=237
http://www.mathjax.org
200
Capítulo 1. Secciones