Manual de usuario de calibre, Publicación 2.73.0
Usar plantillas en columnas personalizadas
A veces hay casos en los que quiere mostrar metadatos que calibre no muestra normalmente, o mostrarlos de una
manera diferente. Por ejemplo, puede querer mostrar el ISBN, un campo que calibre no muestra. Puede usar columnas
personalizadas para esto creando una columna de tipo «columna generada a partir de otras columnas» (en lo sucesivo
llamadas columnas compuestas), e introduciendo una plantilla. calibre mostrará una columna con el resultado de
evaluar la plantilla. Para mostrar el ISBN, cree la columna e introduzca {identifiers:select(isbn)} en
el cuadro de plantilla. Para mostrar una columna que contenga los valores de dos campos personalizados de serie
separados por una coma, use {#serie1:||,}{#serie2}.
Las columnas compuestas pueden utilizar cualquier opción de plantilla, incluidas las de formato.
No puede cambiar los datos contenidos en una columna compuesta. Si modifica una columna compuesta pulsando dos
veces sobre un elemento, se abrirá la plantilla para modificarla, no los datos resultantes. Modificar la plantilla en la
interfaz gráfica es una manera rápida de probar y modificar columnas compuestas.
Usar funciones en plantillas: modo de función única
Supongamos que desea mostrar el valor de un campo en mayúsculas, aunque normalmente el valor del campo tiene
sólo las iniciales en mayúscula. Puede conseguir esto (y muchas otras cosas) usando las funciones disponibles para
plantillas. Por ejemplo, para mostrar el título en mayúsculas use {title:uppercase()}. Para mostrarlo con las
iniciales en mayúscula use {title:titlecase()}.
Las referencias a funciones aparecen en la parte del formato, después de : y antes del primer | o del } de cierre. Si
tiene tanto un formato como una referencia de función, la función después de otro :. Las funciones siempre deben
acabar con (). Algunas funciones toman valores adicionales (argumentos), y éstos van dentro de los ().
Las funciones siempre se aplican antes de las especificaciones de formato. Véase más abajo un ejemplo de cómo usar
un formato y una función, donde se demuestra este orden.
La
sintaxis
para
usar
funciones
es
{campo:función(argumentos)}
o
{campo:función(argumentos)|prefijo|sufijo}. Los argumentos van separados por comas. Las
comas dentro de los argumentos deben ir precedidas por una barra invertida ( \\ ). El último (o único) argumento
no puede contener un paréntesis de cierre ( ) ). Las funciones devuelven el valor del campo usado en la plantilla,
convenientemente modificado.
Importante: Si tiene experiencia en programación, tenga en cuenta que la sintaxis de este modo (de función única) no
es la que podría esperarse. Los textos van sin comillas. Los espacios son importantes. Todos los argumentos deben ser
constantes; no hay evaluación interna. No use subplantillas (‘‘{...}‘‘) como argumentos de función. En lugar de ello,
use el modo de programación de plantilla (página 149) y el modo de programación general (página 174).
Muchas funciones usan expresiones regulares. En todos los casos, la expresión regular no distingue entre mayúsculas
y minúsculas.
Las funciones disponibles se enumeran a continuación. Tenga en cuenta que la documentación definitiva para las
funciones está disponibles en la sección Clasificación de funciones (página 155):
lowercase() – devuelve el valor del campo en minúsculas.
uppercase() – devuelve el valor del campo en mayúsculas.
titlecase() – devuelve el valor del campo con las iniciales en mayúscula.
capitalize() – devuelve el valor con la primera letra mayúscula y el resto en minúsculas.
contains(patrón,texto_si_coincide,texto_si_no_coincide) – comprueba si el campo
contiene coincidencias para la expresión regular patrón. Devuelve texto_si_coincide si se encuentran coincidencias, en caso contrario devuelve texto_si_no_coincide.
1.9. Cursillos
147