# Uso de &appname;

## Inicio rápido

De forma predeterminada, &appname; empieza con una colección de libros vacía. Para trabajar con cualquier otro tipo de colección, créelo usando la opción de menú Archivo Nuevo , o el botón de la barra de herramientas. Las colecciones se van rellenando con algunos de los campos más comunes, aunque puede añadirlos, modificarlos o eliminarlos según sus necesidades.

Las nuevas entradas se pueden añadir usando el Editor de entradas. La opción de menú Colección Nueva entrada abrirá el Editor de entradas con una entrada vacía lista para editar. El Editor de entradas también se puede abrir usando la opción de menú Preferencias Mostrar editor de entradas. Una vez ha introducido los valores para la entrada, puede guardarla en la colección usando el botón Guardar entrada en el diálogo Editor de entradas, que permanece abierto in caso de que desee continuar añadiendo nuevas entradas. Una vez haya guardado una entrada en la colección, puede modificarla haciendo clic sobre ella en la ventana principal. Si el Editor de entradas no está abierto, puede hacer doble clic sobre una entrada para abrir el editor y empezar a editarla.

Si desea incluir una imagen en la entrada, puede usar el selector de archivos estándar de &kde; haciendo clic en el botón Seleccionar imagen… en el Editor de entradas , o puede arrastrar una imagen desde el gestor de archivos o navegador web al Editor de entradas.

Cuando selecciona una entrada, la Vista de entrada muestra una vista formateada del contenido de la entrada. Puede cambiar la plantilla usada para mostrar la entrada en el Diálogo de configuración.

Las entradas de la colección se agrupan cuando comparten los mismos valores para determinados campos, como el autor o el director. Puede cambiar el campo usado para agrupar usando la lista desplegable de la barra de herramientas, o la opción de menú Configuración Selección de grupo.

Puede usar el Filtro rápido de la barra de herramientas para limitar las entradas visibles. El filtro también es útil cuando quiera encontrar rápidamente una entrada. Puede teclear el título o cualquier otra palabra única que identifique la entrada y la Vista de columnas mostrará solo las entradas que coincidan con el filtro. Un filtrado más complejo puede usar nombres de campos directamente, como autor=stephenson. La barra de estado muestra el número de entradas que hay en la colección y cuántas están siendo filtradas actualmente.

## Uso general

La ventana principal tiene tres áreas distintas, todas las cuales muestran información sobre la colección de maneras diferentes. La vista primaria es la Vista de columnas en el área superior derecha, donde se puede mostrar el valor de cada campo para cada entrada. A la izquierda, las pestañas contienen la Vista de grupo, que se peude usar para ordenar las entradas en grupos en una estructura de árbol, la Vista de filtro , que se usa para rastrear las entradas que cumplan ciertos criterios, y la Vista de préstamo, donde se listan todos los préstamos. Finalmente, la Vista de entrada muestra una vista con formato de los datos para una sola entrada, o un icono de un grupo de entradas, en la parte inferior derecha.

La ventana principal de &appname; La ventana principal de &appname;

### Vista de columna

Cualquiera de los campos de las colecciones se pueden mostrar en la Vista de columna, aunque los campos de Párrafo, Imagen, y Tabla probablemente no serán útiles. Hacer clic derecho sobre el encabezado de la vista abre un menú para seleccionar los campos visibles. Se puede cambiar el tamaño y el orden de las columnas de cualquier forma, y la configuración se guardará entre sesiones.

### Vista de grupo

La Vista de grupo agrupa las entradas en una vista de árbol según cualquier campo que permita el agrupamiento. El número de entradas de cada grupo se muestra al lado del nombre del grupo. Los grupos se pueden expandir o contraer haciendo clic sobre el signo con forma de flecha, o haciendo doble clic sobre el elemento. Expandir y contraer todos los grupos son opciones que aparecen en el menú contextual al hacer clic con el botón derecho del ratón. El árbol se puede ordenar tanto por nombre de grupo como por la cuenta, haciendo clic en el encabezado. Un grupo también se puede usar como filtro para la Vista de columna, haciendo clic con el botón derecho sobre el elemento grupo.

Cuando más de un campo de la colección tiene la opción Formatear como nombre habilitada, se añade un grupo adicional para combinar todos esos campos en un solo pseudo-grupo llamado Personas.

Si una entrada no contiene ningún valor para el campo que se está usando para formar los grupos, se coloca en el grupo (Vacío), que usa una carpeta roja.

### Vista de filtro

Si hay filtros guardados para la colección, la Vista de filtro estará activa. A medida que añada y modifique entradas, estas se compararán con los filtros y se añadirán o eliminarán, según sea el caso. Puede modificar el filtro haciendo doble clic en el elemento para abrir el Diálogo de filtro avanzado. Haga clic con el botón derecho para poder eliminarlo de todas formas.

La Vista de filtro La Vista de filtro

### Vista de préstamo

Una vez las entradas se han dado en préstamo, la Vista de préstamo se añade a la ventana, de forma que se puedan rastrear las entradas dadas en préstamo. Los préstamos se registran por entrada, así que hacer un clic derecho sobre un elemento de la entrada tiene una opción para modificar el préstamo utilizando el Diálogo de préstamo.

La Vista de préstamo La Vista de préstamo

### Vista de entrada

En la Vista de entrada se muestra una representación con formato de los valores de la entrada. Se usan plantillas para la distribución y cualquier gráfico adicional. Se pueden especificar plantillas separadas para cada tipo de colección en el Diálogo de configuración, junto con colores y tipos de letra personalizados.

Todas las plantillas predeterminadas reflejan el color y la selección del tipo de letra, pero puede que otras plantillas personalizadas no lo hagan. Las plantillas por defecto también tienen campos &URL; activos, que se abrirán con la asociación de archivo predeterminada de &kde;. Cuando exporte a &HTML;, la plantilla actual se usará para exportar los archivos de entrada individuales.

### Barra de estado

La barra de estado se utiliza para mostrarle lo que &appname; está haciendo. También incluye un recuento total de las entradas de la colección y, si se está usando un filtro, cuántas son actualmente visibles.

## Editar entradas

El Editor de entradas se utiliza para añadir y modificar entradas de la colección. Hacer doble clic en una entrada en la Vista de grupo o en la Vista de columna abre el Editor de entradas con esa entrada. Las nuevas entradas se pueden crear usando el menú Colección, el icono de la barra de herramientas o el botón en el propio Editor de entradas.

Cerrar el Editor de entradas cuando se han hecho cambios pero no se han guardado hará que aparezca un mensaje de advertencia. Los campos se agrupan por categoría, y aparecen en el orden en que lo hacen en el Diálogo de campos de la colección. También se pueden reordenar.

El Editor de entradas El Editor de entradas

Hacer clic en el título de un campo de &URL; abrirá el enlace usando la asociación de archivos por defecto de &kde;. El botón selector de &URL; junto al texto de la entrada abrirá el diálogo de abrir archivo predeterminado de &kde;, pero el campo no está limitado a archivos locales.

Para campos de Imagen, el botón Seleccionar imagen… abre el selector de archivos de imágenes de &kde;. La imagen se guarda en la colección en su formato original, y una versión a escala se muestra en el Editor de entradas. La imagen se puede borrar usando el botón Limpiar. Las imágenes borradas son eliminadas de la colección.

El Editor de entradaspara campos de Imagen El Editor de entradaspara campos de Imagen

El widget de edición también admite arrastrar y soltar. Arrastrar un archivo de imagen desde el gestor de archivos o la ventana del navegador hace lo mismo que seleccionar la imagen en el selector de archivos. Arrastrar la imagen desde el widget de edición a una ventana de gestión de archivos de &konqueror; guardará la imagen en esa carpeta.

Por defecto, las imágenes se guardan en el archivo de datos de la colección, manteniendo todo contenido en una sola ubicación. Sin embargo, demasiadas imágenes harán que &appname; se ralentice significativamente y en que se forme un archivo de datos muy grande. Alternativamente, &appname; puede guardar las imágenes de forma separada, tanto en la carpeta `~/.local/share/tellico/data/` como en una carpeta en la misma ubicación del archivo de datos. Cargar y guardar archivos de datos es mucho más rápido si las imágenes se almacenan separadamente. pero los archivos de datos ya no serán trasladables a otros formatos o archivables. Los archivos de datos autocontenidos siempre se podrán crear usando el elemento de menú Archivo Exportar Exportar a Zip….

Los campos de Tabla empiezan con cinco filas, pero al mover el cursor a la última fila se añade otra automáticamente. Para tablas con varias columnas, solo la primera se utiliza para agrupar o para dar formato.

El Editor de entradas para campos de Tabla fields El Editor de entradas para campos de Tabla fields

### Editar varias entradas

Se pueden editar al mismo tiempo múltiples entradas seleccionando más de una tanto en la Vista de grupo como en la Vista de columnas. Si están seleccionadas varias entradas, los campos que contentan el mismo valor en cada entrada estarán habilitados. Si las entradas tienen diferentes valores, los campos estarán deshabilitados. Se añaden a la derecha de cada campo unas casillas de verificación que controlan si el campo está habilitado o no, tal como se muestra en la captura de pantalla de abajo.

Solo se modificarán los campos habilitados cuando se guarden las entradas, lo que hace la edición a gran escala mucho más fácil. Por ejemplo, para establecer el «Medio» de todas las entradas de video de la colección, asegúrese de que el campo «Medio» está habilitado. Cámbielo a DVD, y después guarde las entradas. Solo se modificará el campo «Medio», preservando los valores de todos los demás campos de las entradas.

El Editor de entradas para entradas múltiples El Editor de entradas para entradas múltiples

### Actualizando los datos de las entradas

Las entradas se pueden actualizar automáticamente consultando las fuentes de datos disponibles para el tipo actual de colección, lo cual es muy útil para información combinada de diferentes fuentes. Por ejemplo, puede añadir una película a su colección usando el servicio web de Amazon.com, y después actualizar la entrada con información adicional de Internet Movie Database.

Solo se actualizan los campos vacíos a menos que la configuración para esa fuente permita que los resultados sobrescriban la información existente. Para los scripts externos, se debe especificar un campo de actualización en las opciones de la fuente.

La actualización de las entradas se puede iniciar mediante el menú contextual (clic derecho) de una entrada, o usando el elemento de menú Colección Actualizar entrada .

## Editar campos

El Diálogo de campos de la colección le permite añadir nuevos campos a la colección, modificar los existentes o eliminarlos.

El Diálogo de campos de la colección de &appname; El Diálogo de campos de la colección de &appname;

### Lista de campos

A la izquierda del diálogo está la lista de los campos actuales. Los campos modificados se muestran en negrita cursiva. Los botones de debajo de la lista añaden o eliminan un campo, y las flechas se pueden usar para cambiarlos de orden. El orden de los campos de la lista es importante, porque el Editor de entradas utiliza ese orden para su distribución. Para cada categoría, los campos se disponen de izquierda a derecha, según el orden de arriba hacia abajo de los campos de la lista.

### Propiedades del campo

Un campo se define por su título, tipo, categoría, descripción y posiblemente un valor predeterminado o algunos valores permitidos. El título se usa en todas partes para referirse al campo en el interfaz de usuario. El Editor de entradas lo utiliza para pedir valores. La Vista de columnas lo usa como encabezado de columna. Los diferentes tipos de campos están explicados en la sección Tipos de campos. La descripción se usa como pista en el Editor de entradas para dar una explicación de los contenidos del campo. Además, para campos con valores derivados, se utiliza una plantilla de valor para darle formato al valor del campo. El valor por defecto se añade automáticamente cuando se crea una nueva entrada. la lista de valores permitidos para los campos de Elección deben separarse por un punto y coma.

Los nuevos campos pueden ser de cualquier tipo, pero cambiar el tipo de los campos ya existentes está restringido a los tipos compatibles, tal como se muestra en la tabla de abajo:

### Cambios de tipo de campo permitidos

Tipo actual | Nuevo tipo permitido
Texto sencillo | Texto simple, Párrafo, Número, &URL;, Tabla
Párrafo | Texto simple, Párrafo
Elección | Texto sencillo, Párrafo, Elección, Número, &URL;, Tabla
Casilla de verificación | Texto sencillo, Párrafo, Casilla de verificación, Número, &URL;, Tabla
Número | Texto simple, Párrafo, Número, &URL;, Tabla
&URL; | Texto simple, Párrafo, Número, &URL;, Tabla
Fecha | Texto simple, Fecha
Tabla | Texto sencillo, Párrafo, Tabla
Imagen | Imagen
Clasificación | Elección, Clasificación

### Formateo de campos

&appname; proporciona alguna capacidad para el formateo automático de valores de campo. La más sencilla es la autocapitalización, que capitaliza todas las palabras excepto los artículos. El formateo del título mueve algunos artículos del principio al final del campo; por ejemplo, cambia «El Retorno del Rey» por «Retorno del Rey, El». Los artículos del título son configurables. Finalmente, el formateo de los nombres intenta romper la cadena de forma que el apellido de la persona se muestre al principio. Los prefijos y sufijos del nombre también son configurables. Además, el grupo especial Personas usa todos los campos con formateo del nombre, incluso si esto está deshabilitado en las preferencias globales.

Todo el formateo automático se puede deshabilitar cambiando las opciones globales en el Diálogo de configuración. Globalmente, la capitalización es una opción más dentro del formateo, así que a un título se le puede dar formato automático sin ser capitalizado. No todos los tipos de campo permiten el autoformateo.

### Ejemplos de formateo

Tipo de formato | Valor del campo | Auto-capitalizado | Auto-formateado | Auto-capitalizado y auto-formateado
Título | el retorno del rey | El Retorno del Rey | retorno del rey, el | Retorno del Rey, El
Nombre | tom swift, jr. | Tom Swift, Jr. | swift, jr., tom | Swift, Jr., Tom

### Opciones de campo

Los campos también tienen tres opciones generales. Si el autocompletado está habilitado, &appname; almacena los valores de cada campo, y el Editor de entradas ofrece el completado automático, usando las preferencias estándar de &kde;. No todos los campos permiten el autocompletado. &appname; también necesita saber si un campo puede tener múltiples valores o puede usarse para agrupar las entradas. Para separar los valores múltiples cuando se edite una entrada, se usa un punto y coma.

Para una mayor eficiencia, no habilite el autocompletado a menos que lo necesite. Mientras más campos con autocompletado haya en la colección, más tiempo tardará &appname; en cargar el archivo.

## Filtrado de entradas

El Diálogo de filtro avanzado le permite limitar las entradas visibles en la Vista de columnasa aquellas que coincidan con una o más reglas de filtrado. El filtro se puede usar para encontrar las entradas que cumplan todas las reglas del diálogo, o solo para encontrar las que cumplen cualquiera de ellos. El Diálogo de filtro avanzado también es útil para la búsqueda avanzada dentro de la colección.

El &appname; Diálogo de filtro avanzado El &appname; Diálogo de filtro avanzado

Cada fila contiene una sola regla de filtrado. Seleccione el campo que quiera hacer coincidir con la primera casilla de la fila, y seleccione la regla de coincidencia en el centro. Las reglas pueden hacer coincidir valores que contengan una determinada palabra, o que sean exactamente iguales. También se puede usar una expresión regular para emparejar entradas, en cuyo caso el botón Editar… se vuelve activo para editar la expresión, si &kregexpeditor; está instalado en su equipo. Finalmente, la palabra o cadena que emparejar se debe introducir en el cuadro de texto. Para los campos de imagen, puede usar el tamaño de la imagen para filtrar donde el valor del filtro se compara con la dimensión más grande de la imagen, ya sea su anchura o su altura.

Se pueden usar hasta ocho (8) reglas en el filtrado. Los botones Más y Menos se pueden usar para añadir o eliminar reglas.

Los filtros se pueden guardar, de forma que todas las entradas que coincidan se agrupan juntas en la Vista de filtro. La vista es dinámica, así que a medida que las entradas se van añadiendo o modificando, el grupo se actualiza automáticamente. Para guardar el filtro, introduzca un nombre en el cuadro de texto y haga clic en el botón Guardar Filtro.

Los filtros guardados anteriormente se pueden modificar haciendo clic derecho sobre el elemento del filtro en la Vista de filtro y seleccionando Modificar filtro. Se abrirá el Diálogo de filtro avanzado, y se podrán hacer cambios el nombre o las reglas del filtro.

Para encontrar los libros de ciencia-ficción que no ha leído, marque el botón Hacer coincidir todos los siguientes, establezca la primera regla a Género contiene Ciencia-ficción y la segunda a Leído no contiene verdadero. Para los campos de Casilla de verificación, el valor interno es verdadero).

Para encontrar libros de Bujold o Weber, marque el botón Hacer coincidir cualquiera de los siguientes, establezca la primera regla en El autor contiene Bujold y el segundo a El autor contiene Weber.

## Generar informes

&appname; puede generar varios informes sobre su colección actual. el Diálogo de informes comprueba todas las plantillas &xslt; de la ruta de instalación y en `~/.local/share/tellico/report-templates/`. Así puede crear otras nuevas, y se encuentran automáticamente y se incluyen como opciones en el Diálogo de informes. Algunos informes complejos pueden tardar más tiempo en generarse para colecciones grandes.

Las plantillas que están instaladas con &appname; incluyen una lista de solo títulos, la vista de columna predeterminada, una vista de grupo, un resumen de todos los grupos y los valores más populares de esos grupos, un informe de préstamos, y un gran informe con imágenes de portada. Seleccione la plantilla deseada y haga clic en el botón Generar. Cualquier informe se puede también imprimir o guardar en un archivo &HTML;.

El Diálogo de informes de &appname; El Diálogo de informes de &appname;

Las entradas incluidas en este informe se limitarán a las de la Vista de columna, así que si tiene algún filtro activo, el Diálogo de informes lo utilizará.

## Rastreo de préstamos

&appname; admite el rastreo de los préstamos de cualquier entrada de la colección. El Diálogo de préstamo se puede abrir usando el elemento de menú Salida, o haciendo clic derecho sobre una entrada. Se puede dar salida a múltiples entradas a la vez.

El nombre del prestatario se puede introducir directamente, o se puede sacar de la libreta de direcciones predeterminada de &kde; haciendo clic en el botón junto a la entrada del nombre. Se asume que la fecha de salida es la actual, pero se puede cambiar. La fecha límite es opcional, y se pueden añadir otras notas sobre el préstamo.

Si se introduce una fecha pasada, y &appname; está compilado con implementación libkcal, se podrá añadir un recordatorio de préstamos al calendario predeterminado de &kde; como un objeto «para hacer». Se puede usar &korganizer; para ver esos elementos.

Cuando una entrada se marca como salida, el campo Prestado se establece en verdadero. Si no existen campos prestados en la colección, se añade uno. ¡No modifique el campo directamente! Las entradas en préstamo se pueden establecer como ingresadas usando el elemento de menú, o haciendo clic derecho sobre la entrada en la Vista de préstamo.

El Diálogo de préstamo de &appname; El Diálogo de préstamo de &appname;

## Consejos generales

Si un libro tiene más de un autor, debería separar los nombres por un punto y coma, de forma que Tellico sepa cómo dividirlos y usarlos separadamente. Se debe hacer lo mismo con cualquier otro campo que permita múltiples valores, con un punto y coma (;) separando cada valor.

Puede cambiar qué campos se muestran en la vista de lista haciendo clic derecho sobre la cabecera de columna.

Puede añadir, editar o modificar los campos de la colección usando el Diálogo de campos de la colección. Los botones de flecha debajo de la lista de campos se pueden usar para cambiar la posición del campo en la lista, lo que afecta a la ubicación en el editor de entradas.

Puede editar más de una entrada a la vez manteniendo pulsada la tecla &Shift; o &Ctrl; y seleccionando múltiples entradas.

Puede convertir una colección de libros existente en una bibliografía, que se podrá exportar a formato bibtex o Bibtexml.

Si más de un campo está formateado como nombre, entonces se añade un grupo adicional llamado «Personas» a la colección, permitiendo que los autores y los editores se ordenen o se impriman juntos, por ejemplo.

Puede modificar la salida impresa modificando el archivo `tellico-printing.xsl`. El archivo genera &HTML;, y el &CSS; dentro de la hoja de estilo gestiona cosas como el tipo de letra, los márgenes, etc.

Hacer doble clic en un elemento de la entrada abre el Editor de entradas.

Puede añadir etiquetas &HTML; a cualquier campo de Párrafo para darle formato, como <b>negrita</b> o <i>cursiva</i>.

En la Vista de columnas, puede presionar una letra del teclado para saltar hasta la siguiente entrada que comience con esa letra.

Puede usar valores derivados para combinar valores desde múltiples campos en un solo valor sencillo. Marque la casilla de valor derivado y utilice una plantilla de valor similar a «`Value: %{fielda}%{fieldb}`», donde %{…}se reemplaza con el valor de campo apropiado. Esto es útil para recoger múltiples valores dentro de uno solo, p.ej. para un mejor agrupamiento, y para combinar campos de diferentes tipos respetando el orden adecuado al mismo tiempo. Considere, por ejemplo, un campo numérico seguido de un subcampo de texto con entradas 3b, 14a.