Manual de usuario de calibre, Publicación 2.73.0
puede ser establecido dinámicamente en el método convert() si los archivos de entrada pueden ser o
no colecciones de imágenes. Si lo establece en True, debe implementar el método get_images() que
devuelve una lista de imágenes.
core_usage = 1
Número de núcleos de CPU utilizados por este complemento. Un valor de -1 significa que utiliza todos los
núcleos disponibles
for_viewer = False
Si es True, el complemento de entrada realizará un procesado especial para que la salida sea adecuada para
visualización
output_encoding = ‘utf-8’
La codificación de los archivos que crea el complemento de entrada. Un valor de None significa que la
codificación no está definida y debe detectarse individualmente
common_options = set([])
Opciones compartidas por todos los complementos de formato de entrada. No reemplazar en
subclases. Usar options (página 219) en su lugar. Toda opción debe ser un ejemplar de
OptionRecommendation.
options = set([])
Opciones para personalizar el comportamiento de este complemento. Toda opción debe ser un ejemplar de
OptionRecommendation.
recommendations = set([])
Un conjunto de 3-tuplas del tipo (nombre_opción, valor_recomendado, nivel_de_recomendación)
get_images()
Devuelve una lista de rutas absolutas a las imágenes, si este complemento representa una colección de
imágenes. La lista de imágenes está en el mismo orden que el lomo y el índice.
convert(stream, options, file_ext, log, accelerators)
Este método debe ser implementado en subclases. Debe volver la ruta al archivo OPF creado o un ejemplar
OEBBook. Toda la salida debe estar contenida en el directorio actual. Si este complemento crea archivos
fuera del directorio actual, deben ser eliminados o marcados para su eliminación antes de que termine este
método.
Parámetros
stream – Un objeto de tipo archivo que contiene el archivo de entrada.
options – Opciones para personalizar el proceso de conversión. Debe tener atributos
correspondientes a todas las opciones declaradas por este complemento. Además, debe
haber un atributo verbose que toma valores enteros a partir de cero. Valores mayores
significan más detalles. Otro atributo útil es input_profile, que es un ejemplar de
calibre.customize.profiles.InputProfile.
file_ext – La extensión (sin el «.») del archivo de entrada. Debe ser uno de los
file_types admitidos por este complemento.
log – Un objeto calibre.utils.logging.Log. Toda salida debería usar este objeto.
accelarators – Un diccionario con diversa información que el complemento de entrada puede obtener fácilmente y que acelerará las etapas posteriores de la conversión.
postprocess_book(oeb, opts, log)
Se ejecuta para permitir que el complemento de entrada lleve a cabo el posprocesado del libro después del
procesado principal.
1.10. Personalizar calibre
219