Manual de usuario de calibre, Publicación 2.73.0
assign( id, val) – asigna val a id y devuelve val. id debe ser un identificador, no una expresión
approximate _ formats() – devuelve una lista separada por comas de formatos que en algún momento estuvieron asociados con el libro. No hay garantía de que esta lista sea correcta, aunque probablemente lo sea. Esta función puede ejecutarse en el modo de programación de plantillas usando la plantilla {:' approximate _ formats()'}. Tenga en cuenta que los nombres de formato están siempre en mayúsculas, como en « EPUB ».
author _ links( sep _ val, sep _ par) – devuelve un texto que contiene una lista de autores y enlaces de autores de la forma: autor1 sep _ val enlace _ autor1 sep _ par autor2 sep _ val enlace _ autor2 etc. Cada autor está separado de su correspondiente enlace por el texto sep _ val, sin espacios adicionales. Los pares autor: enlace _ autor están separados por el texto sep _ par, sin espacios adicionales. Es responsabilidad del usuario proporcionar separadores que no aparezcan en los nombres o enlaces de autor. El nombre de autor se incluye aunque su enlace esté vacío.
author _ sorts( separador) – devuelve un texto que contiene la lista de valores de orden de autor para los autores del libro. El orden de autor es el que figura en los metadatos de autores( diferente del valor de orden de autor del libro). La lista devuelta es de la forma orden _ de _ autor _ 1 separador orden _ de _ autor _ 2 etc. Los valores de orden de autor en la lista están en el mismo orden que los autores del libro. Si quiere espacios alrededor de separador, inclúyalos en el valor.
booksize() – devuelve el valor del campo « tamaño » de calibre. Devuelve «» si no hay formatos.
cmp( x, y, mn, ig, my) – compara x e y después de convertirlas en números. Devuelve mn si x < y. Devuelve ig si x == y. Devuelve my en otros casos.
current _ library _ name() – devuelve la última parte de la ruta a la biblioteca de calibre actual. Esta función puede llamarse en el modo de programación de plantilla usando la plantilla {:' current _ library _ name()'}.
current _ library _ path() – devuelve la ruta a la biblioteca de calibre actual. Esta función puede usarse en el modo de programación de plantillas utilizando la plantilla {:' current _ library _ path()'}.
days _ between( fecha1, fecha2) – devuelve el número de días entre fecha1 y fecha2. El número es positivo si fecha1 es posterior a fecha2, en caso contrario es negativo. Si fecha1 o fecha2 no son fechas, la función devuelve un texto vacío.
divide( x, y) – devuelve x / y. Da un error si x o y no son números.
eval( texto) – evalúa texto como un programa, pasando las variables locales( las definidas con assign). Esto permite usar el procesador de plantillas para elaborar resultados complejos a partir de variables locales. Dado que los caracteres { y } tienen un uso especial, debe usarse [[ en lugar de { y ]] para }; se convertirán automáticamente. Tenga en cuenta que los prefijos y sufijos( la sintaxis | prefijo | sufijo |) no puede usarse en el argumento de esta función en el modo de programación de plantilla.
field( nombre) – devuelve el campo de metadatos identificado por nombre.
first _ matching _ cmp( val, cmp1, resultado1, cmp2, resultado2,..., otro _ resultado) – compara val < cmpN consecutivamente y devuelve resultadoN para la primera comparación que sea cierta. Devuelve otro _ resultado si ninguna comparación es cierta. Ejemplo:
first _ matching _ cmp( 10,5," small ", 10," middle ", 15," large "," giant ")
devuelve «” large”». El mismo ejemplo con un primer valor de 16 devuelve «” giant”».
first _ non _ empty( valor, valor,...) – devuelve el primer valor que no esté vacío. Si todos los valores están vacíos, se devuelve también un valor vacío. Puede incluir tantos valores como quiera.
format _ date( val, formato _ fecha) – da formato a un valor, que debe ser un campo de fecha, según formato _ fecha y devuelve un texto. Los códigos de formato son:
152 Capítulo 1. Secciones