Manual de Tellico

# Manual de Tellico

Robby Stephenson `<robby@periapsis.org>`

Traductor: Cristina Yenyxe González García
Traductora: Kira J. Fernández
revisión Tellico 4.1 (2025-01-04)

Copyright © 2001 Robby Stephenson

Para obtener información sobre la licencia tanto de este programa como de su documentación, consulte la última sección.

Este documento es un manual de uso de Tellico, una aplicación para gestionar colecciones.

Lista de tablas

2.1. Cambios de tipo de campo permitidos
2.2. Ejemplos de formateo
7.1. Valores de tipo de colección
7.2. Valores de tipo de campo
7.3. Valores del indicador de campo
7.4. Valores del formato de campo

Capítulo 1. Introducción
Introducción

# Capítulo 1. Introducción

## Tellico

Tellico es un programa para gestionar colecciones. Empezó como un sencillo gestor de colecciones de libros y se extendió para incluir plantillas predefinidas para colecciones de bibliografías, cómics, vídeos, música, monedas, sellos, tarjetas, videojuegos, vinos, juegos de mesa o archivos. Además, se pueden crear colecciones personalizadas para otros tipos de objetos coleccionables.

### Qué es Tellico

Tellico hace un seguimiento de los elementos de una colección y ofrece una forma fácil de introducir datos para cada entrada. Proporciona diversos tipos de campos y permite un número ilimitado de campos definidos por el usuario. Las entradas de una colección se pueden agrupar según cualquier campo para una organización más fácil y las vistas personalizadas muestran tanta información como desee.

Puede seguir el rastro de los elementos de su colección que haya prestado, incluida la fecha de devolución. Puede importar y exportar colecciones en diversos formatos para permitir un intercambio fácil o la publicación de los datos.

### Qué no es Tellico

Tellico no es un reproductor de audio ni de vídeo. No proporciona facilidades para leer ni para modificar archivos multimedia. Tampoco proporciona ninguna funcionalidad de edición de imágenes. Aunque Tellico tiene alguna función para gestionar listas bibliográficas, no es un gestor dedicado a referencias bibliográficas. Tellico tampoco intenta tener todas las capacidades de una base de datos relacional hecha y derecha.

Como cierta forma de exención de responsabilidad, Tellico es un hobby del autor, por lo que no se dan garantías sobre su funcionalidad, utilidad ni cualquier otra cosa. Se incluye más información en la declaración de licencia.

Terminología
Terminología

## Terminología

### Colecciones

En Tellico la colección es el documento. Solo existe una colección en cada archivo de Tellico. Una colección contiene un número de campos y entradas. Tellico admite por defecto 12 tipos específicos de colecciones: libros, entradas bibliográficas, cómics, videos, música, cromos, monedas, sellos, videojuegos, vinos, juegos de tablero y listados de archivos. Además, está disponible una plantilla de colección genérica vacía para cualquier otro tipo de colecciones o listas.

### Campos de una colección

Cada colección puede tener un número ilimitado de campos. Tellico admite once tipos de campos, lo que permite un intervalo de datos diferentes. Los campos se pueden editar con el Diálogo de campos de la colección, y se explican con más detalle en la sección Tipos de campos .

### Entradas de una colección

Una entrada es el registro básico en Tellico. Cada entrada contiene un solo valor para cada campo de la colección. Una colección puede tener, en teoría, un número ilimitado de entradas, aunque como toda la colección siempre está residente en la memoria, demasiadas entradas podrían ralentizar la aplicación.

Tellico ha sido probado con una colección de 10.000 elementos, con una velocidad satisfactoria. Sin embargo, si se incluyen muchas imágenes grandes en la colección, el tiempo de carga y procesamiento puede incrementarse drásticamente. Puede mejorar el rendimiento haciendo que Tellico almacene las imágenes separadas de los datos en sí, sea en una carpeta de la aplicación o relativa al archivo de datos. Puede encontrar más información en la sección de configuración.

Capítulo 2. Uso de Tellico
Uso de Tellico

# Capítulo 2. Uso de Tellico

## Inicio rápido

De forma predeterminada, Tellico 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
Uso general

## 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.

### 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.

### 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.

### 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 Tellico 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
Editar entradas

## 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.

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 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.

### Aviso

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 Tellico se ralentice significativamente y en que se forme un archivo de datos muy grande. Alternativamente, Tellico puede guardar las imágenes de forma separada, tanto en la carpeta `$`KDEHOME`/share/apps/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.

### 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.

### 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
Editar campos

## 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.

### 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:

Tabla 2.1. 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

Tellico 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.

Tabla 2.2. 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, Tellico 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. Tellico 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á Tellico en cargar el archivo.

Filtrado de entradas
Filtrado de entradas

## 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.

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
Generar informes

## Generar informes

Tellico 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 `$`KDEHOME`/share/apps/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 Tellico 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.

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
Rastreo de préstamos

## Rastreo de préstamos

Tellico 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 Tellico 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.

Consejos generales
Consejos generales

## Consejos generales

### Sugerencia

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.

### Sugerencia

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

### Sugerencia

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.

### Sugerencia

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

### Sugerencia

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

### Sugerencia

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.

### Sugerencia

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.

### Sugerencia

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

### Sugerencia

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

### Sugerencia

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

### Sugerencia

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.

Capítulo 3. Detalles de Tellico
Detalles de Tellico

# Capítulo 3. Detalles de Tellico

## Tipos de campos

Cada colección puede tener un número ilimitado de campos. Tellico admite once tipos de campos, que le permiten un intervalo de datos diferentes.

### Texto sencillo

El tipo más básico de campo se llama Texto sencillo. No hay restricciones sobre los valores del campo, y el widget de entrada de datos es el editor de línea estándar. Este tipo es apropiado para campos de los que no se espera que tengan valores largos, tales como el autor o el género.

### Número

El tipo Número es idéntico al Texto sencillo, excepto que los datos están limitados a valores numéricos. Las entradas se ordenarán numéricamente en la vista de columna si se hace clic en una columna de Número. Para la entrada de datos se usa el editor de línea estándar, con pequeños botones de flecha para aumentar o disminuir el valor. No se aplica nunca formato.

### URL

El tipo URL permite enlaces a otros documentos usando las asociaciones de tipo de archivo estándar de KDE para abrir los documentos enlazados. No se realiza ninguna validación del valor real del campo URL, pero los enlaces no válidos no se abren. La entrada de datos es un editor de línea con un botón para abrir el diálogo estándar de Abrir archivo, pero puede utilizarse cualquier URL. Las URL relativas se interpretarán como relativas a la localización del archivo de datos una vez ha sido guardado.

En el Editor de entradas, la etiqueta se convierte en el enlace, mientras que en la Vista de entrada se utiliza un hiperenlace real. Este tipo de campo es conveniente para enlazar a archivos PDF de entradas bibliográficas o para críticas de películas, por ejemplo. No se aplica ningún formato.

También se pueden usar URL relativas. Se interpretarán como relativas a la localización del archivo de datos de Tellico. En el Editor de entradas, el editor de línea proporciona autocompletado para las localizaciones de los archivos locales. Si desea que la URL del diálogo de selección de archivos de KDE se interprete como relativa a la localización del documento, entonces se debería establecer la propiedad del campo URL a relativa : verdadero.

### Párrafo

Para campos de texto más largos, el tipo Párrafo ofrece un área de edición de texto más grande, y siempre está en su propia categoría. Un campo de Párrafo puede no tener múltiples valores, ni se le da formato automáticamente. No puede usarse para agrupamientos. Los resúmenes, argumentos o críticas deberían introducirse usando este tipo de campo.

Los saltos de línea se sustituyen por un salto HTML para asegurar un formato consistente. Para desactivar esta sustitución, añada una propiedad al campo con el valor replace-line-feeds : false. Se puede desactivar la comprobación ortográfica definiendo la propiedad spellcheck : false.

### Elección

Cuando un campo debe limitarse a unos pocos valores preestablecidos, se utiliza el tipo Elección. Los valores aceptables se presentan en una caja desplegable para su selección. Se permiten valores múltiples. Algunos campos, como el tipo de bibliografía o la calificación personal, son campos de tipo Elección.

Se debe utilizar punto y coma para separar los valores permitidos.

### Casilla de verificación

Para campos que toman un valor de sí o no, se aplica el tipo Casilla de verificación. Por defecto, el campo está desactivado. Los campos Casilla de verificación no tienen formato y se limitan a valores sencillos. Internamente, los valores de los campos se tratan como `verdadero` o `falso`. Algunos ejemplos son campos como «regalo» o «préstamo».

### Fecha

Un campo de Fecha puede incluir un día, un mes y un año. La fecha se muestra en el formato estándar YYYY-MM-DD, que permite un ordenado más fácil. El selector de fechas estándar de KDE se puede usar para elegir la fecha con el ratón, o se puede introducir directamente. No se requiere que el campo tenga valores no nulos para el año, el mes y el día; se puede introducir solo el año, por ejemplo. No se permiten valores múltiples.

### Tabla

Los campos de Tabla contienen una o más columnas de valores. En el Editor de entradas , el campo se presenta usando una vista similar a una hoja de cálculo, con filas numeradas. Cuando se selecciona la última fila, aparece una fila adicional. El autocompletado no está disponible. Este campo es útil para la lista de capítulos de un libro, escenas de una película o canciones de un álbum. Los campos de Tabla siempre están por sí mismos en una categoría.

El número de columnas, hasta un máximo de diez, se define añadiendo una propiedad al campo de definición con el nombre columnas. Las columnas se pueden etiquetar haciendo clic derecho en la cabecera, o estableciendo una propiedad de campo llamada columna1, etc.

Cuando use el Editor de entradas para los campos de Tabla, las filas se pueden reorganizar arrastrando el ratón mientras se mantiene presionada la tecla Ctrl. También está disponible un menú emergente haciendo clic derecho sobre la tabla, lo que permite insertar o eliminar filas.

### Imagen

Los campos de Imagen contienen una imagen en cualquier formato admitido por KDE. Algunos de los más frecuentes incluyen PNG o JPEG. La imagen se puede guardar dentro del propio archivo de datos de Tellico o en el directorio de datos de la aplicación. Se utiliza el selector de archivos estándar de KDE, así que puede usar una URL o un archivo disponible localmente. Las imágenes también se pueden arrastrar desde un gestor de archivos o desde un navegador.

### Clasificación

Los campos de Clasificación muestran un número de estrellas que representan una valoración numérica para una entrada. Por defecto, la valoración es como máximo cinco. El mínimo y el máximo pueden cambiarse estableciendo las propiedades de la definición del campo en el Diálogo de campos de la colección, llamadas mínimo y máximo, respectivamente.

### Campos de valor derivado

Los campos con valor derivado son un caso especial. El tipo de campo corresponde al tipo habitual de valor contenido en ese campo, pero el valor del campo se construye a partir de otros campos usando una cadena en el campo de descripción. Por ejemplo, si el campo tiene una plantilla de valor de `%{título} %{año}`, entonces el valor de ese campo será el título, seguido por el año. Este tipo de campo se usa principalmente para el campo de título en las colecciones de monedas, sellos, cromos y vinos. Tanto el nombre interno del campo o el título del campo se pueden usar en la descripción para el formateo.

Para seleccionar solo un valor para un campo con múltiples valores, añada un índice de posición a la plantilla, como `%{autor:1}` para el primer autor. La posición puede ser negativa, contando desde el final, así que `%{autor:-1}` sería el último autor. Se pueden usar valores con mayúsculas o minúsculas estableciendo marcadores de plantilla, como `%{autor:1/l}` para poner el primer autor con minúsculas y `%{autor:1/u}` para ponerlo en mayúsculas.

Tipos de colecciones
Tipos de colecciones

## Tipos de colecciones

Tellico admite de forma predeterminada doce tipos específicos de colecciones: libros, entradas bibliográficas, cómics, vídeos, música, videojuegos, cromos, monedas, sellos, vinos, juegos de tablero y catálogos de archivos. Además, una plantilla vacía para una colección genérica también está disponible para otras colecciones. Las colecciones predeterminadas incluyen un conjunto general de campos. Puede añadir, modificar o eliminar los campos para que se ajusten a sus necesidades. El único requisito es que una colección debe contener siempre un campo de Título para que la Vista de grupo funcione correctamente. Para algunos tipos de colección, es solo un campo de valor derivado que combina dos o más de los otros.

En general, no hay diferencias funcionales entre los tipos de colecciones. Puede crear una colección personalizada para sus libros tan fácilmente como usar la colección de libros predeterminada. Pero Tellico elige iconos basados en tipos de colecciones, y hay algunas funcionalidades especializadas que son únicas de una determinada colección así que, si puede, debería usar las predeterminadas. Si desea crear una colección de vinos, pero no le gusta ninguno de los campos predeterminados, cree una personalizada, y elimine todas las predeterminadas. De esa forma, Tellico todavía sabe que es una colección de vinos.

Por defecto, todos los tipos de colecciones incluyen un campo de ID, que muestra el número de ID de la entrada. Además, excepto para el catálogo de archivos, cada colección incluye campos que muestran la fecha en que la entrada fue creada en la colección, y la última vez que fue modificada.

### Colecciones de libros

Las colecciones de libros tienen 27 campos por defecto: Título, Subtítulo, Autor, Encuadernación, Fecha de compra, Precio de compra, Editorial, Edición, Año del copyright, Año de publicación, ISBN#, LCCN#, Páginas, Idioma, Género, Palabras clave, Serie, Número de serie, Condición, Firmado, Leído, Regalo, Préstamo, Clasificación, Cubierta frontal, Sinopsis y Comentarios.

El campo ISBN# es especial, ya que los números ISBN son automáticamente formateados y se calcula el dígito de comprobación. Tellico reconoce el campo ISBN si su nombre interno es isbn. Si lo ha eliminado, o necesita añadirlo a otro tipo de colección, cree el campo con el título ISBN y aplique los cambios; entonces puede volver y modificar el título como quiera. Tellico crea el nombre interno basándose en el título inicial, pero nunca cambia si el título se modifica más tarde.

### Bibliografías

Las bibliografías tienen 25 campos por defecto: Título, Tipo de entrada, Autor, clave Bibtex, Título del libro, Editor, Organización, Editorial, ISBN#, Dirección, Edición, Páginas, Año, Publicación, Mes, Número, Publicado cómo, Capítulo, Serie, Número de serie, Volumen, Referencia cruzada, Palabras clave, Resumen, y Notas.

Aunque las colecciones bibliográficas no están específicamente conectadas a bibtex, el conjunto predeterminado de campos se toma de un conjunto típico de campos de bibtex. Cuando se exporte a bibtex, una propiedad llamada bibtex se utiliza para que cada campo defina su campo bibtex correspondiente. si añade un campo adicional a una bibliografía y quiere exportarlo a bibtex, asegúrese de establecer la propiedad bibtex.

Tellico tiene algunas funciones especializadas para las bibliografías. Se pueden añadir, modificar o eliminar cadenas de macros de Bibtex desde dentro de Tellico, y la exportación de bibtex le da la opción de expandir las macros. Las citas de Bibtex se pueden enviar a una aplicación externa como LyX o Kile, usando el llamado lyxpipe.

Las colecciones de libros se pueden convertir en bibliografías. Se añaden los campos predeterminados de bibtex, y se establecen las propiedades de bibtex. Esta funcionalidad existe principalmente para convertir colecciones antiguas, antes de que el tipo de bibliografía fuera separado del tipo de colección de libros.

### Colecciones de comics

Las colecciones de comics tienen 23 campos por defecto: Título, Subtítulo, Escritor, Artista, Serie, Publicaciones, Editorial, Edición, Año de publicación, Páginas, País, Idioma, Género, Palabras clave, Condición, Fecha de compra, Precio de compra, Firmado, Regalo, Préstamo, Cubierta frontal, Sinopsis y Comentarios.

### Colecciones de vídeo

Las colecciones de vídeo tienen 30 campos por defecto: Título, Medio, Año de producción, Certificación, Género, Región, Nacionalidad, Formato, Reparto, Director, Productor, Guionista, Compositor, Estudio, Pistas de idioma, Idiomas de subtítulos, Pistas de audio, Duración, Relación de aspecto, Pantalla panorámica, Modo de color, Montaje del director, Resumen del argumento, Calificación personal, Fecha de compra, Precio de compra, Regalo, Préstamo, Cubierta, y Comentarios.

El campo de Reparto es una table con dos columnas; el nombre del actor está en la primera, y su personaje en la segunda. La Duración se define en minutos, aunque puede cambiarla, por supuesto.

### Colecciones de música

Las colecciones de música tienen 15 campos por defecto: Título, Medio, Artista, Sello, Año, Género, Pistas, Clasificación, Fecha de compra, Precio de compra, Regalo, Préstamo, Palabras clave, Cubierta, y Comentarios.

### Colecciones de videojuegos

Las colecciones de videojuegos tienen 16 campos por defecto: Título, Plataforma, Género, Año de lanzamiento, Editorial, Desarrollador, Clasificación ESRB, Descripción, Calificación personal, Completado, Fecha de compra, Precio de compra, Regalo, Préstamo, Cubierta, y Comentarios.

### Colecciones de cromos

Las colecciones de cromos tienen 17 campos por defecto: Título, Jugador, Equipo, Marca, Número de tarjeta, Año, Serie, Tipo de tarjeta, Fecha de compra, Precio de compra, Localización, Regalo, Palabras clave, Cantidad, Imagen frontal, Imagen trasera, y Comentarios.

### Colecciones de monedas

Las colecciones de monedas tienen 16 campos por defecto: Título, Tipo, Denominación, Año, Marca de ceca, País, Conjunto de monedas, Estado de conservación, Servicio de clasificación, Fecha de compra, Precio de compra, Localización, Regalo, Anverso, Reverso, y Comentarios.

### Colecciones de sellos

Las colecciones de sellos tienen 18 campos de manera predeterminada: Título, Descripción, Denominación, País, Año de edición, Color, Scott#, Clasificación, Cancelado, Charnela, Centrado, Engomado, Fecha de compra, Precio de compra, Localización, Regalo, Imagen, y Comentarios.

### Colecciones de vino

Las colecciones de vino tienen 15 campos por defecto: Título, Productor, Denominación de origen, Variedad, Tipo, País, Fecha de compra, Precio de compra, Localización, Cantidad, Bebido por, Clasificación, Regalo, Imagen de etiqueta, y Comentarios.

### Colecciones de juegos de tablero

Las colecciones de juegos de tablero tienen 17 campos por defecto: Título, Género, Mecanismo, Año de lanzamiento, Editorial, Diseñador, Número de jugadores, Duración del juego, Edad mínima, Descripción, Puntuación, Fecha de compra, Precio de compra, Regalado, Préstamo, Cubierta y Comentarios.

### Catálogos de archivos

Los catálogos de archivos tienen 14 campos de manera predeterminada: Nombre, URL, Descripción, Volumen, Carpeta, Tipo MIME, Tamaño, Permisos, Propietario, Grupo, Creado, Modificado, Metainformación, eIcono.

### Colecciones personalizadas

Las colecciones presonalizadas tienen un campo predeterminado, el Título. Deberían usarse cuando el objeto de colección no es uno de los tipos preestablecidos.

Capítulo 4. Importar y exportar datos
Importar y exportar datos

# Capítulo 4. Importar y exportar datos

Tellico puede importar y exportar una amplia variedad de archivos de datos, además de buscar información en varios sitios de internet.

## Importar desde internet

Tellico puede buscar en varios sitios de internet usando el Diálogo de búsqueda en internet. Las entradas pueden ser importadas directamente y añadidas a su colección actual. Los diversos proveedores se configuran mediante las Opciones de fuentes de datos.

Las búsquedas pueden usar distintos criterios: Título, Persona, ISBN, UPC/EAN, LCCN, o Palabra clave. No todos los criterios están disponibles para ciertas fuentes de datos. Los valores ISBN y LCCN solo sirven para libros, mientras que los valores UPC o EAN pueden aplicarse a cualquier tipo de elemento.

Una vez se ha iniciado una búsqueda, el botón Buscar se convierte en Detener, que finalizará la búsqueda. A medida que se encuentren resultados, se añadirán a la lista directamente bajo la caja de búsqueda, donde seleccionar un elemento mostrará el resultado sin añadirlo a la colección. Hacer clic en el botón Añadir entrada añadirá los elementos seleccionados a su colección. Si la fuente de datos tiene más resultados de los que se solicitaron inicialmente, el botón Obtener más resultados se volverá activo. Hacer clic en Limpiar eliminará todos los resultados actuales y reiniciará la búsqueda.

Solo se encontrarán las entradas que coincidan con el tipo de la colección actual. La columna Descripción proporciona información adicional acerca de la entrada para diferenciar entre videos en diferentes formatos o libros con distinta encuadernación, por ejemplo. Una vez una entrada se ha añadido con éxito a la colección, se añadirá una marca de verificación a la primera columna de la lista.

Se pueden añadir entradas múltiples usando el método estándar de KDE para la selección múltiple, que normalmente incluye mantener pulsada la tecla Mayúsculas o Ctrl cuando se hace clic en un elemento.

Para facilitar el uso de los escáneres de código de barras, las búsquedas pueden incluir múltiples valores de ISBN/UPC. Seleccionar la casilla de verificación Búsqueda ISBN/UPC múltiple deshabilitará la caja de búsqueda y habilitará el botón Editar valores ISBN/UPC…, que abrirá una caja de entrada de texto de varias líneas. tras cerrar la caja, cada ISBN será validado para un formato correcto. La validación ISBN puede convertir los valores EAN de 13 dígitos, además de códigos UPC completos al formato apropiado. La lista de ISBN también se puede leer desde un archivo de texto.

Importar datos
Importar datos

## Importar datos

Tellico ofrece tres acciones diferentes cuando se importan datos. Sustituir la colección actual cerrará la colección actual y creará una nueva con los datos del archivo importado. Añadir a la colección actual le dice a Tellico que añada todas las entradas de la colección importada a la actual, además de añadir también cualquier campo que no exista actualmente. La acción Fusionar la colección es lo mismo que añadir, excepto que cada entrada importada se compara con las actuales, omitiendo los valores idénticos. Tellico trata de identificar las entradas coincidentes que no son completamente idénticas comparando los campos más significativos y fusionando después las entradas. Por ejemplo, las colecciones de música comparan el artista y el álbum, y luego se fusionarían las pistas de las entradas coincidentes. El importador de archivos de audio puede construir listas de pistas correctamente las entradas.

### Importar datos de otro software

Tellico puede importar datos directamente de otros programas de gestión de colecciones, como GCstar, Data Crow, Alexandria, Delicious Library, Collectorz, Ant Movie Catalog, Referencer y Griffith.

### Importar otros formatos de datos

Tellico puede importar datos de varios formatos de archivos, como CSV, bibtex, discos y archivos de audio, MODS, PDF y RIS.

#### Importar datos de Tellico

Se pueden importar directamente otros archivos de datos de Tellico. Sustituir la colección actual importando otro archivo de Tellico es lo mismo que abrir el propio archivo. Importar datos de Tellico sirve para poder añadir datos o para fusionar dos colecciones.

#### Importar datos CSV

Los valores separados por comas (CSV) son una forma común de importar y exportar datos tabulares. El valor de cada campo se separa por una coma, con una entrada por línea. Los títulos de los campos se pueden incluir en la primera línea. El importador CSV no se limita a usar una coma como separador. Se puede utilizar cualquier carácter o cadena de caracteres.

Primero, seleccione el tipo de colección que está importando. Si la está añadiendo o fusionando con su colección abierta, el tipo está limitado al tipo de su colección actual. Si la primera línea del archivo CSV contiene los títulos de los campos, haga clic en la casilla de verificación y el importador comparará automáticamente los títulos con los de los campos en la colección actual. Si el título de un campo coincide, la cabecera para esa columna cambiará para mostrar que la columna se ha asignado a ese campo. Si el archivo usa un separador distinto a la coma, asegúrese de cambiar esa opción de acuerdo con él.

Para que Tellico importe el archivo correctamente, debe saber qué campo corresponde a cada columna. Si la columna solo tiene un número en la cabecera, los datos de esa columna no serán importados. Debería asignar campos a cada columna seleccionando una columna haciendo clic en ella o cambiando el número de columna, y después seleccionando el campo que asignarle de la caja desplegable y haciendo clic en el botón Asignar campo. Si necesita añadir un nuevo campo a la colección, el último elemento en la caja desplegable abrirá el Diálogo de campos de la colección.

Para simplificar, solo se muestran en el diálogo las primeras cinco líneas del archivo CSV importado. No obstante, se importarán todas las líneas del archivo.

#### Importar datos de un CD de audio

Tellico puede usar el servicio freedb.org para buscar información sobre un CD, incluyendo la lista de pistas. Dependiendo de su distribución, los ajustes para acceder al servicio se podrán configurar en las Preferencias del sistema de KDE. Se añadirán el CD, artista, título, género, año y lista de pistas.

Además, si el disco contiene texto de CD, se leerá esa información y se añadirá a la entrada importada.

#### Importar metadatos de archivos de audio

Tellico puede explorar una carpeta y leer las etiquetas de los formatos de audio más comunes, como `mp3` y `ogg`. Las canciones se introducen en una colección de música, donde cada entrada es un álbum. Si los archivos de la canción contienen el número de pista, el nombre de la canción se inserta en el lugar correcto del listado de pistas. La información del artista y del género también se añaden a la entrada. Si las etiquetas de la canción incluyen comentarios, se añaden al campo de comentarios de la entrada, precedidos por el nombre del archivo.

Además, si una carpeta contiene un archivo `.directory` y el nombre de la carpeta coincide con el título de un álbum, la entrada de `Icono` en el archivo de escritorio se utiliza como imagen de portada para ese álbum.

El importador de metadatos de archivos de audio puede explorar recursivamente una carpeta para encontrar todos los archivos de audio en cualquier subcarpeta, aunque no se siguen los enlaces simbólicos. Tellico usa la biblioteca TagLib para leer metadatos de archivos de sonido, por lo que puede importar datos de cualquier tipo de archivo que entienda TagLib.

#### Importar datos de Bibtex

Bibtex es un formato de bibliografía usado con el sistema de preparación de documentos LaTeX. Se pueden incluir varios tipos de referencias bibliográficas en el archivo. Tellico importa archivos bibtex como una colección bibliográfica.

Si el importador bibtex encuentra campos en el archivo que no están en la colección de bibliografía predeterminada, se añadirán como campos de texto sencillo, con dos excepciones. Si el valor del campo contiene más de 100 caracteres, se convierte en un campo de Párrafo. Si el valor del campo parece contener una URL o una referencia de archivo, entonces se crea un campo URL. Tellico usa una copia interna de la librería btparse para analizar sintácticamente los archivos bibtex.

Bibtexml es una representación XML de datos de bibtex, y los datos de los archivos bibtexml importados se tratan de la misma forma que los datos de bigbtex.

#### Importar datos MODS

MODS es un formato para representar varios tipos de colecciones. En la actualidad, Tellico solo importa libros como colección bibliográfica.

#### Importar datos PDF

Si Tellico se ha compilado con exempi o poppler, se podrán importar los metadatos de los archivos PDF. Los metadatos pueden incluir información del título, el autor y la fecha, además de identificadores bibliográficos que se utilizarán para actualizar otra información.

#### Importar datos RIS

El formato RIS es un formato de archivo bibliográfico usado por EndNote, Reference Manager y por otras aplicaciones. Tellico importa archivos RIS como colección bibliográfica.

### Importar colecciones en línea

Tellico puede conectarse e importar datos de sitios web que gestionan colecciones personales.

#### Importar colección de BoardGameGeek

BoardGameGeek es un recurso y comunidad de juegos de mesa. Tellico puede importar los juegos de mesa en una colección del usuario, siempre que la colección sea accesible públicamente. La colección importada puede estar limitada a los elementos marcados como propios.

#### Importar colección de Goodreads

Goodreads es una red social en línea para que los lectores sigan sus colecciones de libros. Tellico puede importar la lista de libros de la colección de un usuario, dados tanto el nombre como la identificación del usuario, siempre que la colección esté configurada para ser accesible públicamente.

#### Importar colecciones de LibraryThing

LibraryThing es un service en línea para ayudar a catalogar libros de forma fácil. Tellico puede importar la lista de libros en una colección del usuario, exportada en formato JSON.

#### Importar colección de Discogs

Discogs es una base de datos en línea y un mercado de lanzamientos musicales. Tellico puede importar la lista de lanzamientos musicales en una colección de un usuario, dado el nombre de usuario, siempre que la colección esté configurada para que se pueda acceder a ella públicamente.

### Importar listados de archivos

Tellico puede explorar carpetas para importar información de archivos, principalmente para crear una colección de Catálogo de archivos. La carpeta se puede examinar recursivamente para añadir todos los archivos que se encuentren en su interior. El importador es más útil para listados de copias de seguridad y para catalogar archivos multimedia, como listados de CD o DVD. Además, puede generar las vistas previas del contenido de los archivos. Las vistas previas de los archivos son las mismas que se muestran en el gestor de archivos de KDE.

Las carpetas con archivos de libros electrónicos y de vídeo también se pueden importar como colecciones de libros y de vídeos. Los metadatos de los archivos se pueden leer y, para los archivos de vídeo, cualquier archivo `nfo` que exista se usa para completar la información de las entradas de vídeo.

### Importar datos XML vía XSLT

Cualquier archivo XML se puede importar a Tellico, siempre que la hoja de estilo XML esté dispuesta a convertir el archivo al formato de Tellico. Tellico carga automáticamente la hoja de estilo y ejecuta el procesamiento XSLT necesario para cargar el archivo.

Arrastrar y soltar
Arrastrar y soltar

## Arrastrar y soltar

Arrastrar archivos de datos a la ventana principal de Tellico y soltarlos importará los archivos, de la misma forma que si se hubiera seleccionado la orden de importar desde un menú. Arrastrar y soltar funciona para los siguientes tipos de archivos: Tellico, Bibtex, RIS y PDF y EPub. También se admite la importación de múltiples archivos a la vez.

Así que, por ejemplo, si desea catalogar varios archivos PDF, selecciónelos en el gestor de archivos y arrástrelos a la ventana de Tellico. Tellico importará tantos metadatos de los archivos como pueda, y después buscará información adicional de varias fuentes configuradas de internet.

Exportar datos
Exportar datos

## Exportar datos

Cuando se exporten los datos de la colección, los valores de entrada pueden exportarse como se han introducido, o con el formato automático proporcionado por Tellico. Además, la exportación puede estar limitada a las entradas seleccionadas actualmente en la colección, donde la barra de estado muestra el número de entradas seleccionadas.

Los archivos de texto exportados, como Bibtex o CSV, pueden usar la codificación de caracteres Unicode (UTF-8), o la codificación local del sistema operativo.

### Exportar XML

El formato de archivo para los datos de Tellico es un archivo XML comprimido. Exportar a XML simplemente crea el archivo XML sin comprimirlo. Las imágenes se pueden incluir en el archivo XML como datos codificados en base 64 en un elemento de imagen, pero hacerlo así puede crear archivos de texto muy grandes.

### Exportar zip

El formato de archivo estándar para Tellico es un archivo comprimido, que contiene el archivo XML de la colección y, opcionalmente, todas las imágenes a las que se hace referencia en la misma. Si las imágenes, por el contrario, se están almacenando en la carpeta de la aplicación, exportarlas a un archivo Zip creará un archivo de datos autocontenido, que incluirá todas las imágenes de la colección.

### Exportar HTML

La exportación HTML usa la misma hoja de estilo `tellico2html.xsl`. Las imágenes se exportan a una carpeta con el mismo nombre que el archivo HTML exportado, con `_files` adjuntado.

El formato por defecto es similar a la salida impresa, y permite varias opciones para modificar el HTML. Las cabeceras de los campos pueden ser impresas en la parte superior de cada columna, pero por desgracia KDE no permite aún que las cabeceras de tabla se repitan en cada página. Las entradas pueden también ser agrupadas como en la Vista de grupo.

Adicionalmente, se pueden crear archivos individuales para cada entrada de la colección, con enlaces creados en el archivo HTML de nivel superior. Los archivos de entrada se crearán en la misma carpeta que las imágenes. Los archivos HTML de entrada usarán la plantilla de hoja de estilo actual, como se muestra en la Vista de entrada.

### Exportar CSV

Los valores separados por comas (CSV) son una manera común de importar y exportar datos tabulares. El valor de cada campo está separado por una coma, con una o dos entradas por línea. Los títulos de campo pueden incluirse como cabeceras en la primera línea. Cualquier otro carácter o cadena de caracteres diferente a una coma se puede usar para delimitar los campos.

### Exportar Alexandria

Alexandria es un gestor de colecciones de libros para el entorno de escritorio GNOME. Tellico puede exportar un subconjunto limitado de campos de las colecciones de libros a la localización por defecto de los datos de Alexandria.

### Exportar ONIX

ONIX es un formato XML para representar y comunicar información sobre productos de la industria del libro, principalmente para vendedores de libros. Tellico puede exportar colecciones de libros usando un pequeño subconjunto de ONIX.

### Exportar Bibtex

Cuando se exporta a Bibtex, los valores de los campos pueden escaparse con paréntesis o comillas. Si se están utilizando macros de cadena en esta colección, opcionalmente pueden exportarse como macros o expandirse. Para los campos de URL, Tellico puede incluir los valores del campo con la etiqueta `\url{…}`. Finalmente, las entradas sin clave de cita pueden ser obviadas, más que hacer que Tellico autogenere la clave.

### Exportar GCstar

GCstar es otro gestor de colecciones de películas. Tellico puede exportar la mayoría de los tipos de colección a un archivo de datos de GCstar.

### Exportar XML vía XSLT

Finalmente, Tellico puede procesar su representación interna en XML de los datos de la colección a través de una hoja de estilo XML externa antes de exportarlos. Este tipo de exportación puede ser útil para generar informes de texto u otros tipos de archivo.

Trabajar con citas
Trabajar con citas

## Trabajar con citas

Cuando trabaje con una bibliografía, se pueden generar citas a partir de las entradas actualmente seleccionadas y usarse en otras aplicaciones. Una cita en formato bibtex puede copiarse al portapapeles, y después pegarse en un archivo latex. las citas de Bibtex también pueden incluirse en una aplicación externa como LyX o Kile, utilizando el llamado lyxpipe.

Capítulo 5. Uso avanzado
Uso avanzado

# Capítulo 5. Uso avanzado

## Opciones de la línea de órdenes

Cuando ejecute Tellico desde la línea de órdenes, dispondrá de muchas opciones para abrir archivos de datos. Puede consultarlas ejecutando `tellico --help`. También puede activar el registro de diagnóstico, con el que dispondrá de una entrada del menú para mostrar el registro de diagnóstico. La opción `--logfile` redirige el registro a un archivo.

    Uso: tellico [opciones] [archivo]

    Tellico - software de gestión de colecciones, libre y sencillo

    Opciones:
      --nofile                  No reabrir el último archivo abierto
      --bibtex                  Importar <archivo> como archivo bibtex
      --mods                    Importar <archivo> como archivo MODS
      --ris                     Importar <archivo> como archivo RIS
      --pdf                     Importar <archivo> como archivo PDF
      --log                     Salida de diagnóstico del registro
      --logfile <archivo>       Escribir salida de registro en <archivo>

    Argumentos:
      [archivo]                  Archivo a abrir

Interfaz D-Bus
Interfaz D-Bus

## Interfaz D-Bus

Tellico dispone de una interfaz D-Bus mínima que puede ser útil para scriptar o interactuar con una aplicación en ejecución desde la línea de órdenes. Como en todas las llamadas D-Bus, debe especificar el servicio con el que quiere comunicarse, y la interfaz particular. El nombre del servicio D-Bus es `org.kde.tellico`.

### Órdenes D-Bus

Los dos objetos primarios D-Bus están disponibles en la interfaz de tellico: `Tellico` y `Collecciones`.

#### El objeto `Tellico`

A continuación se muestra la lista completa de órdenes D-Bus del objeto `tellico`:

    bool importTellico(QString archivo, QString acción)
    bool importBibtex(QString archivo, QString acción)
    bool importMODS(QString archivo, QString acción)
    bool importPDF(QString archivo, QString acción)
    bool importRIS(QString archivo, QString acción)
    bool exportXML(QString archivo, bool filtrado)
    bool exportZip(QString archivo, bool filtrado)
    bool exportBibtex(QString archivo, bool filtrado)
    bool exportHTML(QString archivo, bool filtrado)
    bool exportCSV(QString archivo, bool filtrado)
    QList<int> selectedEntries()
    QList<int> filteredEntries()
    void openFile(QString archivo)
    void setFilter(QString texto)
    bool showEntry(int id)

Para las cuatro órdenes de importación, el primer argumento es el archivo que se va a importar y el segundo la acción de importación. Dispone de tres acciones: sustituir, añadir y fusionar. Existen cuatro formatos de archivo de los que se puede importar: archivos XML de Tellico, archivos Bibtex, archivos MODS y archivos RIS. También puede importar metadatos de archivos PDF.

Para cualquiera de las órdenes que exportan texto, un archivo con el nombre `--` redirigirá el contenido a la salida estándar.

La colección actualmente abierta en Tellico se puede exportar a un archivo, ya sea en formato XML de Tellico, en formato ZIP de Tellico, Bibtex, HTML o en valores separados por comas (CSV). Las órdenes de exportación tienen un argumento adicional para indicar si la colección se debe limitar al filtro actual o no.

Una lista de las ID de la entrada actualmente seleccionada o filtrada puede facilitar mostrar o actualizar las entradas en la vista.

Puede abrir un nuevo archivo de datos mediante la orden openFile(). Debe especificar la ruta completa.

Puede establecer un nuevo filtro mediante la orden setFilter(), que equivale a escribir en la caja de filtro de la ventana principal.

Dado el ID de una entrada, showEntry() la seleccionará y mostrará sus detalles en la ventana principal.

#### El objeto `Colecciones`

La lista completa de órdenes de D-Bus en el objeto `Collecciones` se muestra debajo:

    int addEntry()
    bool removeEntry(int entryID)
    QStringList allValues(QString fieldName)
    QStringList entryValues(int entryID, QString fieldName)
    QStringList selectedBibtexKeys()
    QString entryBibtexKey(int entryID)
    bool setEntryValue(int entryID, QString fieldName, QString value)
    bool addEntryValue(int entryID, QString fieldName, QString value)

Una nueva entrada vacía puede ser creada en la colección actual usando la orden addEntry(). El valor devuelto es la ID de la entrada, que puede entonces ser usada para establecer los valores del campo en la entrada. Una entrada puede ser eliminada de la colección ejecutando la orden removeEntry().

Ejecutar allValues() usando un nombre de campo devolverá todos los valores para ese campo para las entradas seleccionadas actualmente. Si no hay seleccionada ninguna entrada, la lista devuelta estará vacía. Si la ID de la entrada se incluye en la orden, se devolverán los valores de los campos para esa entrada específica.

Si la colección actual es una bibliografía, ejecutar selectedBibtexKeys() devolverá la clave de cita de Bibtex para todas las entradas seleccionadas. La bibtexKey para una entrada específica se puede encontrar utilizando la orden entryBibtexKey().

Las entradas se pueden editar directamente con la interfaz de D-Bus. Dada una ID de entrada, setEntryValue() establecerá el valor del campo directamente. Para añadir un valor sin afectar a los ya existentes, use addEntryValue(). El nuevo vaor aparece añadido al final de la lista existente.

### Ejemplos de D-Bus

Estos son algunos ejemplos de guiones de Tellico que usan la interfaz D-Bus. Tenga en cuenta que la orden qdbus puede existir con el nombre qdbus-qt5 u otro similar en su sistema.

    Abrir un archivo Bibtex
    % qdbus org.kde.tellico /Tellico org.kde.tellico.importBibtex "/home/robby/reference.bib" "replace"
    true

    Exportar un archivo Bibtex
    % qdbus org.kde.tellico /Tellico org.kde.tellico.exportBibtex ~/documents/reference.bib
    true

    Exportar un archivo Bibtex usando el filtro actual
    % qdbus org.kde.tellico /Tellico org.kde.tellico.exportBibtex ~/documents/reference.bib true
    true

    Mostrar la clave de cita de la selección actual
    % qdbus org.kde.tellico /Collections org.kde.tellico.selectedBibtexKeys
    stephenson2004

    Añadir una nueva entrada y establecer el título
    % myid=`qdbus org.kde.tellico /Collections org.kde.tellico.addEntry`
    % qdbus org.kde.tellico /Collections org.kde.tellico.setEntryValue $myid title "My New Book"
    true

Capítulo 6. Configuración
Configuración

# Capítulo 6. Configuración

El Diálogo de configuración contiene todas las opciones para cambiar algunos comportamientos predeterminados de Tellico.

Hacer clic en el botón Aplicar causará que los cambios tengan efecto inmediatamente sin cerrar el diálogo, mientras que Aceptar aplica los cambios y cierra el diálogo. Cancelar cierra el diálogo, pero cualquier cambio ya hecho y aplicado permanecerá. El botón Predeterminado revierte las opciones de la página actual del diálogo a sus valores por defecto, mientras que el botón Ayuda abre el KHelpCenter de la sección correspondiente en el manual de Tellico.

Algunos ajustes menores solo se pueden cambiar editando el archivo de configuración. Consulte Opciones ocultas.

## Opciones generales

Las Opciones generales controlan el comportamiento general. Las imágenes se pueden guardar en el mismo archivo de datos, por separado en la carpeta común de la aplicación Tellico o en un directorio con el mismo nombre que el archivo de datos, con _files añadido al nombre. En las colecciones que tienen muchas imágenes resulta bastante más lento guardarlas en el mismo archivo de datos. Cuando se inicia Tellico, puede abrir automáticamente el último archivo de datos con el que se haya trabajado. El Filtrado rápido de la barra de herramientas resulta de utilidad para filtrar rápidamente la colección y permite el uso de expresiones regulares.

Las Opciones de formato controlan el nivel de formato automático que hace Tellico. Por ejemplo, consulte la sección Formato de campos. La capitalización y el formato son opciones destacadas, ya que un campo puede estar capitalizado sin tener el orden de las palabras alterado, y viceversa. La capitalización automática puede cambiarse para ignorar algunas palabras. El formato automático incluye artículos gramaticales en los títulos, junto con prefijos y sufijos para los nombres propios. Los valores no distinguen entre mayúsculas y minúsculas, y deberían estar separados por punto y coma.

Las reglas de formato siguen el uso general del inglés, lo que puede no funcionar para otros idiomas. Los artículos se adjuntan al final del título, con una coma. Los nombres propios se alteran para que tengan el apellido al principio, seguido por una coma, y después el nombre. Los sufijos personales, como Jr., se mantienen con el apellido. Los prefijos, como por ejemplo von, se mantienen con el apellido, pero se ignoran cuando se ordenan los valores.

John Q. von Public, III se convertiría en von Public, III, John Q., y Public sería usado como clave para la ordenación.

Solo se admiten prefijos de una sola palabra. Si un nombre incluye van der, por ejemplo, tanto van como der se incluirían en la lista de prefijos del apellido. Los artículos que terminan con un apóstrofe también se admiten para la ordenación.

### Nota

Los valores reales de la colección no se cambian, solo el texto visible usado para la interfaz. Así, las opciones de formato se pueden cambiar una y otra vez sin afectar a ninguno de los datos de la colección.

Opciones de impresión
Opciones de impresión

## Opciones de impresión

Tellico usa una plantilla XSLT para crear HTML, y se la transifere al servicio de impresión de KDE. Solo se imprimen los campos visibles en la Vista de columna. Más aún, si la colección ha sido filtrada, solo se imprimirán las entradas visibles. Al inicio aparecerá un mensaje diciendo que el filtro está activado.

Las Opciones de impresión le permiten cambiar algunas opciones de formato cuando imprima una colección. Si la opción Dar formato a títulos y nombres está marcada, a los campos se les dará formato automático cuando se impriman. De otro modo, se imprimirán exactamente igual que fueron introducidos.

La hoja de estilo de impresión predeterminada imprime la colección con los valores de los campos en columnas. Imprimir cabeceras de campo controla si el título del campo se imprime en la parte superior de la columna.

En el listado, las entradas se ordenarán tal como están en la Vista de columna. Además, podrán estar agrupadas tal como están en la Vista de grupo.

Finalmente, cuando los campos de imagen se incluyen en el listado, las imágenes pueden estar cambiadas de tamaño, manteniendo la relación de aspecto. El ancho y el alto máximos de la imagen definen el tamaño más grande posible de esta, aunque nunca será incrementado.

Opciones de plantilla
Opciones de plantilla

## Opciones de plantilla

La Vista de entrada utiliza plantillas para mostrar los valores de los campos. Puede especificar una plantilla diferente para cada tipo de colección. Algunas plantillas, como la de Álbum o Vídeo, son para un tipo determinado de colección, y aparecerá un breve mensaje de error en la Vista de entrada si se utilizan para otros tipos. El botón Vista previa hace aparecer una ventana para mostrarle una vista preliminar del aspecto de la plantilla. Los tipos de letra y colores personalizados pueden transmitirse a la plantilla, y todas las plantillas predeterminadas reflejarán esos ajustes. Sin embargo, las plantillas personalizadas pueden ignorarlos.

Se pueden instalar plantillas adicionales directamente, o descargarlas desde store.kde.org haciendo clic en el botón Descargar. Cualquier plantilla instalada por el usuario se puede borrar. Las plantillas de entrada se guardan en `$`KDEHOME`/share/apps/tellico/entry-templates/`.

Si crea una nueva plantilla, considere la opción de enviarla a store.kde.org.

Opciones de fuentes de datos
Opciones de fuentes de datos

## Opciones de fuentes de datos

Tellico puede usar varias fuentes para importar datos, que se pueden configurar en el diálogo de fuentes de datos. Existen muchos tipos y fuentes disponibles. A continuación se listan algunos de ellos, aunque la lista completa está dispoible en el sitio web de Tellico.

- Servicios web de Amazon.com,
- ISBNdb.com,
- OpenLibrary.org,
- Catálogos OPDS,
- la Internet Movie Database,
- TheMovieDB.org,
- la Open Movie Database,
- FilmAffinity,
- BDGest,
- Comic Vine,
- Discogs.com,
- MusicBrainz.org,
- TheGamesDB.net,
- GiantBomb.com,
- MobyGames.com,
- IGDB.com,
- VideoGameGeek,
- BoardGameGeek,
- arxiv.org,
- Bases de datos Entrez (PubMed),
- z39.50 servers,
- servidores SRU,
- Colnect,
- Numista,
- otras aplicaciones o guiones externos y
- una combinación de cualquiera de las fuentes de arriba.

Se pueden añadir nuevas fuentes haciendo clic en el botón Nuevo…, mientras que las ya existentes se pueden modificar o eliminar usando los botones Modificar… o Eliminar. El orden de las fuentes, que se muestra en los menús de actualización de entradas, también se puede cambiar.

Muchas de las fuentes de datos ofrecen más información que los campos predeterminados de Tellico. Esos campos se muestran a la derecha del cuadro de configuración. Si alguno de esos campos está marcado, se añadirá a la colección cuando se añada una entrada desde esa fuente.

### Fuentes de datos de libros y bibliográficas

#### Servidores z39.50

El protocolo z39.50 se utiliza para acceder a proveedores de información sobre bibliotecas y bibliografía de todo el mundo. Las listas de servidores z39.50 públicos están disponibles en indexdata.dk, entre otras. Tellico viene con varias configuraciones preestablecidas para las principales bibliotecas, y también puede especificar la información de conexión manualmente.

Tellico puede leer datos en los formatos MODS, USMARC/MARC21, o UNIMARC, usando la biblioteca yaz. Además, hay apoyo limitado para el formato GRS-1.

Para usar una de las bibliotecas preestablecidas, marque la casilla y seleccione la biblioteca. Las otras entradas de configuración se deshabilitarán. Si necesita configurar la información manualmente, desmarque la casilla.

El puerto predeterminado para el acceso a z39.50 es el 210, pero algunos servidores pueden utilizar uno diferente. Tellico supone que el servidor utiliza la codificación MARC-8, a menos que esté configurado de otra forma. Si se utiliza una codificación de caracteres incorrecta, aparecerá un mensaje de error en la salida del programa o posiblemente no se obtengan entradas.

Algunos servidores requieren un nombre de usuario y una contraseña de acceso. Tellico puede usar y guardar esa contraseña, pero tenga en cuenta que estará escrita en el archivo de configuración de Tellico en texto sencillo y no es segura. Para la mayoría de servidores públicos, los campos de nombre de usuario y contraseña pueden dejarse vacíos.

#### Servidores SRU

SRU significa Search/Retrieve via URL (Buscar y Obtener vía URL), y es un protocolo de búsqueda estándar para internet. Algunas bibliotecas lo usan para dar acceso a sus catálogos. Entre ellas, la Biblioteca del Congreso de EE.UU. es probablemente la más conocida.

#### Bases de datos Entrez

Entrez es el sistema integrado de búsqueda y obtención basado en texto usado en el Centro Nacional de Información Biotecnológica (NCBI). La base de datos Entrez más conocida es PubMed, de artículos de ciencias de la vida de varias revistas de biología. Por el momento, la única base de datos Entrez admitida por Tellico es PubMed.

#### Bases de datos bibliográficas

arXiv.org, Bibsonomy y CrossRef son bases de datos en línea para artículos académicos e información bibliográfica. Para acceder a la fuente CrossRef, debe solicitar una cuenta y añadir la información de su cuenta a la configuración de las fuentes de datos.

#### ISBNdb.com

ISBNdb.com es una base de datos de libros en línea de bibliotecas de todo el mundo.

#### OpenLibrary.org

OpenLibrary.org es una base de datos de libros que espera tener una página para cada libro.

#### Catálogos OPDS

Los catálogos OPDS proporcionan un medio para buscar (y distribuir) libros digitales. Tellico puede usar diversos catálogos OPDS como fuente de datos, como el Proyecto Gutenberg. Introduzca el enlace del catálogo y compruebe el acceso y el formato para confirmar que Tellico puede leer el enlace.

### Fuentes de datos de Comics

#### Bedetheque

Bedetheque es una base de datos francesa de libros de cómics gestionada por BDGest.

#### Comic Vine

Comic Vine se promociona como la wiki de cómics más grande del universo.

### Fuentes de datos de películas

#### Internet Movie Database

La Internet Movie Database (Base de datos de películas de Internet) proporciona información sobre películas y videos. Cuando se hace una búsqueda de una persona, si se obtiene más de un resultado posible, se abre un cuadro de diálogo para permitirle seleccionar la persona correcta. Las opciones de configuración incluyen seleccionar la nacionalidad de IMBb a usar, y si se obtienen las imágenes o no. Como IMDb puede devolver un gran número de miembros del reparto, puede limitarlos a una determinada cantidad.

#### TheMovieDB.org

TheMovieDB.org es una base de datos abierta. Se requiere registrarse para obtener una cuenta gratuita.

#### La Open Movie Database

La Open Movie Database (OMDBAPI.com) es un servicio web gratuito para obtener información sobre películas.

#### FilmAffinity

FilmAffinity es un sitio de películas independiente.

### Fuentes de datos de música

#### Discogs.com

Discogs.com es una base de datos de música construida por los usuarios que contiene información sobre artistas, sellos y sus grabaciones. Se requiere registrarse para obtener una cuenta gratuita.

#### MusicBrainz.org

MusicBrainz.org es una base de metadatos que intenta crear un sitio de información exhaustiva sobre música.

### Fuentes de datos de videojuegos

#### GiantBomb.com

GiantBomb.com es una gran base de datos de juegos mantenida por la comunidad. Se requiere registro para obtener una cuenta gratuita.

#### TheGamesDB.net

TheGamesDB.net es una base de datos en línea y abierta para los aficionados a los videojuegos.

#### MobyGames

MobyGames.com se define a sí misma como la base de datos de videojuegos más antigua, más grande y más rigurosa.

#### IGDB.com

IGDB.com se define a sí misma como un sitio web de juego para los amantes de los juegos.

#### VideoGameGeek

VideoGameGeek es un recurso y una comunidad de videojuegos en línea.

### Fuentes de datos de juegos de mesa

#### BoardGameGeek

BoardGameGeek es un recurso y una comunidad de juegos de mesa en línea.

### Fuentes de datos de monedas y sellos

#### Colnect

Colnect es una comunidad en línea para artículos coleccionables que proporciona gestión de colecciones personales. Tellico puede buscar información de monedas y sellos en Colnect, así como libros de cómics, tarjetas deportivas y videojuegos.

#### Numista

Numista es un catálogo de monedas del mundo que crece gracias a la contribución de sus miembros y que ofrece gestión de colecciones en línea, herramientas para realizar intercambios de forma fácil con otros coleccionistas y un foro.

### Fuentes de datos para múltiples tipos de colecciones

#### Amazon.com

Utilizando los servicios web de Amazon, Tellico puede buscar información en cualquiera de 14 sitios internacionales diferentes gestionados por Amazon.com: Estados Unidos, Reino Unido, Alemania, Japón, Francia, Canadá, China, España, Italia, Brasil, Australia, India, México y Turquía.

Configurar cada fuente de Amazon.com implica tres ajustes: la localización del servidor, el tamaño de la imagen y la ID del asociado. Alguna información de Amazon.com puede incluir una imagen, como la portada de un libro o un video. Esa imagen puede descargarse en tres tamaños diferentes, dependiendo del objeto. La ID del asociado debe utilizarse para acceder a los servicios web de amazon, y se incluye en los enlaces al objeto, tal como se requiere en el acuerdo de licencia para el uso de los servicios web de Amazon.

El acceso a la API de Publicidad de Productos de Amazon puede tener restricciones relacionadas con referencias de ventas o de publicidad. Consulte la documentación de Amazon para obtener más información cuando se inscriba para acceder a la API.

#### Scripts o aplicaciones externas

Como forma más fácil de que Tellico integre complementos de terceros, se pueden utilizar scripts o aplicaciones externas como interfaz para buscar en otras fuentes de información. Tellico ejecutará una orden y transmitirá los términos de búsqueda como opciones de línea de órdenes.

Algunos scripts se distribuyen con el propio Tellico. Python es necesario para buscar en Dark Horse Comics, un editor de libros de cómics, por ejemplo.

Debe establecerse el tipo de colección devuelto por el script, junto con el formato de datos. Tellico no solo puede importar datos de los scripts que usen el formato XML predeterminado de Tellico, sino que también puede importar otros formatos, como bibtex.

La ruta completa a la aplicación debería introducirse en las opciones de la fuente. Marque las casillas junto a las claves de búsqueda admitidas por la aplicación, e introduzca las opciones de línea de órdenes requeridas en la caja de edición. El valor de búsqueda será insertado donde aparezca `%1`.

### Aviso

Nunca instale o ejecute un script de una fuente que no sea de confianza. Se ejecutan con los mismos permisos del usuario, y como resultado podrían modificar o eliminar archivos, o perjudicar su sistema de cualquier otra forma.

Para actualizar entradas que ya estén en la colección, las casillas de comprobación final y de edición se utilizan para determinar las opciones de la línea de órdenes. Deben introducirse los campos de entrada usados para encontrar una actualización, en el mismo formato que se utilizó para los campos de valor derivado.

### Múltiples fuentes de datos combinadas

Se pueden usar combinaciones de hasta ocho fuentes de datos existentes como una fuente única, donde cada resultado de la búsqueda de la primera fuente se actualiza desde las siguientes fuentes. Debe establecerse el tipo de colección que se utilizará antes de añadir fuentes.

Solo se pueden usar en combinación las fuentes de datos existentes. Solo el tipo de búsqueda de la primera fuente se puede usar en esta fuente, ya que el resultado procede de la primera fuente de datos. Por ejemplo, se puede hacer primero una búsqueda en UPCitemDb, con la que cada resultado se actualiza después desde TheMovieDB.

Capítulo 7. Programar para Tellico
Programar para Tellico

# Capítulo 7. Programar para Tellico

En el espíritu del Software Libre, se le anima a programar Tellico tanto como quiera. Debería poder escribir scripts para importar, exportar o modificar datos muy fácilmente. Este capítulo le da más información sobre cómo hacer eso.

## Formato de archivos

El archivo de datos por defecto de Tellico es un archivo zip, normalmente con una extensión de archivo `.tc`. Dentro del archivo hay un archivo de nivel superior `tellico.xml`. Las imágenes se pueden incluir dentro de la carpeta `images/` del archivo, o pueden incluirse en los datos XML directamente con una codificación base64. Las imágenes también pueden guardarse dentro de la carpeta de datos de la aplicación, en cuyo caso no estarán en el propio archivo de datos. Tellico puede también cargar el archivo XML tal cual, descomprimido.

### Datos XML

#### Colección

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE tellico PUBLIC "-//Robby Stephenson/DTD Tellico V11.0//EN" "http://periapsis.org/tellico/dtd/v11/tellico.dtd">
    <tellico xmlns="http://periapsis.org/tellico/" syntaxVersion="11">
     <collection title="My Books" type="2">
     </collection>
    </tellico>

El archivo comienza con la declaración y la codificación XML requerida, seguida por el tipo de documento. Cuando se añade un nuevo tipo de campo o se establecen propiedades adicionales en los campos predeterminados, la versión DTD se incrementa. Tellico siempre puede abrir y leer cualquier versión anterior de DTD, pero guardará los archivos en la versión actual. La localización de DTD apunta a un archivo DTD real.

El elemento de nivel superior es un elemento <tellico> que contiene la declaración por defecto namespace y la versión de la sintaxis del archivo, que siempre debe coincidir con la de DTD.

El elemento <tellico> contiene un elemento de <collection>. Las colecciones múltiples son ignoradas por ahora. El atributo title contiene el título de la colección, mientras que type especifica qué tipo de entradas están contenidas en la colección. Los tipos permitidos se listan en una sección posterior. Un atributo opcional entryTitle se puede usar para especificar el título de las entradas para una colección personalizada, y debería ir en plural.

#### Campos

      <fields>
       <field flags="8" title="Title" category="General" format="1" type="1" name="title" />
       <field flags="7" title="Author" category="General" format="2" type="1" name="author" />
       <field flags="2" title="Binding" category="General" allowed="Hardback;Paperback;Trade Paperback;E-Book;Magazine;Journal" format="4" type="3" name="binding" >
        <prop name="default"
    >Paperback</prop>
       </field>
       <field flags="6" title="Publisher" category="Publishing" format="0" type="1" name="publisher" />
       <field flags="4" title="Edition" category="Publishing" format="0" type="1" name="edition" />
       <field flags="3" title="Copyright Year" category="Publishing" format="4" type="6" name="cr_year" />
       <field flags="2" title="Publication Year" category="Publishing" format="4" type="6" name="pub_year" />
       <field flags="0" title="ISBN#" category="Publishing" format="4" type="1" name="isbn" description="International Standard Book Number" />
       <field flags="7" title="Genre" category="Classification" format="0" type="1" name="genre" />
       <field flags="7" title="Keywords" category="Classification" format="0" type="1" name="keyword" />
       <field flags="0" title="Front Cover" category="Front Cover" format="4" type="10" name="cover" />
       <field flags="0" title="Comments" category="Personal" format="4" type="1" name="comments" />
       <field title="Rating" flags="2" category="Personal" format="4" type="14" name="rating">
        <prop name="maximum"
    >5</prop>
        <prop name="minimum"
    >1</prop>
       </field>
       <field title="ID" flags="32" category="Personal" format="4" type="6" name="id">
        <prop name="template"
    >%{@id}</prop>
       </field>

      </fields>

Todos los campos están definidos dentro de un elemento <fields>, del cual solo puede existir uno. toda la información sobre un campo, excepto de las propiedades, está incluida como atributos en el elemento <field>. Los valores permitidos para los atributos flags, format, y type vienen dados en la sección siguiente.

Las propiedades del campo se usan para establecer valores predeterminados para el campo, intervalos de valores de clasificación, plantillas de valores derivados, etc. Los ejemplos de arriba incluyen un valor por defecto, un valor máximo de clasificación y una plantilla por un campo ID derivado.

#### Entradas

      <entry>
       <title
    >Lenguaje de programación C++, El</title>
       <authors>
        <author
    >Stroustrup, Bjarne</author>
       </authors>
       <publisher
    >Addison-Wesley Pub Co</publisher>
       <edition
    >3ª</edition>
       <pub_year
    >1997</pub_year>
       <isbn
    >0-201-88954-4</isbn>
       <genres>
        <genre
    >No ficción</genre>
       </genres>
       <keywords>
        <keyword
    >Programación</keyword>
        <keyword
    >Informática</keyword>
       </keywords>
       <cover
    >cf65a2f023b6cb9e9233323dca10ac7c.jpeg</cover>
      </entry>

Para cada campo de la colección, una <entrada> puede contener un elemento cuyo nombre sea idéntico al nombre del campo. Si se permiten valores múltiples para ese campo, entonces se añade la letra s al nombre del campo para crear un elemento, y cada valor se añade como un hijo de ese elemento, como en el caso de los campos de autor, género y palabra clave de arriba.

Como resultado, si se añaden campos adicionales a la colección, el archivo de datos ya no se ajustará al DTD. Sin embargo, Tellico usa un analizador XML no validante, de forma que los campos adicionales no causen problemas.

#### Imágenes

      <images>
       <image width="111" format="JPEG" height="140" id="cf65a2f023b6cb9e9233323dca10ac7c.jpeg" />
      </images>

Dentro del elemento <imágenes>, cada imagen referenciada por una entrada se lista junto con los atributos que describen el tamaño de la imagen, su formato y su id. Si la imagen está contenida dentro de un archivo Zip, el elemento estará vacío. De otro modo, los datos de la imagen pueden estar contenidos en el XML como un texto codificado en base64.

Valores de tipo de colección
Valores de tipo de colección

## Valores de tipo de colección

El tipo de la colección viene dado por el atributo tipo del elemento de la colección. El valor es igual al valor de enumeración de Type en `src/collection.h`.

Tabla 7.1. Valores de tipo de colección

Tipo de colección | Valor
--- | ---
Colección personalizada | 1
Colección de libros | 2
Colección de vídeo | 3
Colección de música | 4
Bibliografía | 5
Colección de comics | 6
Colección de vinos | 7
Colección de monedas | 8
Colección de sellos | 9
Colección de cromos | 10
Colección de videojuegos | 11
Catálogo de archivos | 12
Colección de juegos de tablero | 13

Valores de tipo de campo
Valores de tipo de campo

## Valores de tipo de campo

Tellico incluirá todos los campos predeterminados para una colección si el primer elemento del campo tiene el nombre _default. Para los campos Párrafo, Tabla, o Imagen, la categoría del campo debería ser idéntica al título del campo.

El tipo de campo viene dado por el atributo tipo del elemento del campo. El valor es igual al valor de enumeración de FieldType

Tabla 7.2. Valores de tipo de campo

Tipo de campo | Valor
--- | ---
Texto sencillo | 1
Párrafo | 2
Elección | 3
Casilla de verificación | 4
Número | 6
URL | 7
Tabla | 8
Imagen | 10
Fecha | 12
Clasificación | 14

El campo puede tener establecidos diferentes indicadores, dados como un valor de bit con OR en el atributo «indicador» del elemento del campo. El indicador para evitar que el usuario borre un campo está dirigido a esas cosas como la clave de cita para las entradas bibliográficas.

Tabla 7.3. Valores del indicador de campo

Indicadores de campo | Valor
--- | ---
Permitir múltiples valores | `0x01`
Permitir agrupamiento | `0x02`
Permitir completado | `0x04`
No permitir el borrado | `0x08`
No permitir la edición | `0x10`
Valor derivado | `0x20`

El formato del campo viene dado por el atributo «formato» del elemento del campo. El formato de fecha no se usa actualmente. Agrupar por personas usa todos los campos que utilizan formateo de nombres. Establecer el marcador de Valor derivado implica que el valor de ese campo se genera desde la propiedad de plantilla de otros valores de campo.

Tabla 7.4. Valores del formato de campo

Formato de campo | Valor
--- | ---
Solo capitalización | 0
Formateo de título | 1
Formateo de nombres | 2
Formateo de fecha | 3
Sin formateo | 4

Opciones ocultas de configuración
Opciones ocultas de configuración

## Opciones ocultas de configuración

Tellico tiene algunas opciones de configuración adicionales que no son visibles en el Diálogo de configuración. No son lo suficientemente importantes para garantizar masificar el diálogo con más opciones, pero como representan opciones que pueden ser interesantes para varios usuarios, la aplicación las lee desde el archivo de configuración.

Los ajustes para Tellico se guardan en un archivo del directorio local del usuario, `$`KDEHOME`/share/config/tellicorc`. Dentro de ese archivo, los ajustes se ponen en grupos, que aparecen con nombres entre corchetes, como en [Opciones generales]. Para añadir un ajuste al grupo Opciones generales, encuentre la línea en el archivo de ajustes que contenga el nombre del grupo. Si no aparece, créelo usted mismo añadiendo una línea que diga [Opciones generales]. Entonces, el ajuste se puede añadir bajo el nombre del grupo.

### [Opciones generales]

Estos ajustes deberían colocarse en el grupo Opciones generales.

#### Máx. tamaño de icono

El tamaño máximo de los iconos en la Vista de iconos se puede cambiar mediante este ajuste. El valor por defecto es de 96. El tamaño debe estar entre 32 y 256.

#### Ejemplo

`Max Icon Size=128`

#### Tamaño de la caché de iconos

El número máximo de iconos almacenados en la memoria se puede cambiar mediante este ajuste. El valor por defecto es 1000.

#### Ejemplo

`Icon Cache Size=100`

#### Ejemplo

`Max Icon Size=128`

#### Tamaño de la caché de imágenes

La cantidad máxima de memoria en bytes usada para almacenar todas las imágenes se puede cambiar con este ajuste. El valor por defecto es 67108864.

#### Ejemplo

`Image Cache Size=256000000`

### [Opciones - bibtex]

Estos ajustes deberían colocarse en el grupo Opciones - bibtex.

#### lyxpipe

Este ajuste es para la localización de lyxpipe para enviar citas bibliográficas. No debería incluir el sufijo `.in`

#### Ejemplo

`lyxpipe=$HOME/.lyx/lyxpipe`

Traducción de caracteres Bibtex
Traducción de caracteres Bibtex

## Traducción de caracteres Bibtex

Cuando se importan o exportan archivos de bibtex, ciertos caracteres

      <key char="À">
        <string
    >{\`A}</string>
        <string
    >\`{A}</string>
      </key>

Trucos XSLT
Trucos XSLT

## Trucos XSLT

Aquí tiene algunos trucos para escribir XSLT para analizar sintácticamente los datos XML de Tellico (TBD).

Capítulo 8. Preguntas y respuestas
Preguntas y respuestas

# Capítulo 8. Preguntas y respuestas

8.1. ¿Cómo introduzco varios autores?
8.2. ¿Cómo agrupo por una propieda distinta a las listadas en la barra de herramientas?
8.3. ¿Cómo cambio qué columnas se muestran?
8.4. ¿Cómo exporto campos adicionales de bibtex?
8.5. ¿El nombre Tellico tiene que ver con algo?
8.6. ¿Por qué se incluyen todos esos enlaces a Amazon.com en los resultados de búsqueda?
8.7. ¿Por qué no utiliza una base de datos real?

8.1. | ¿Cómo introduzco varios autores?

Los nombres de los autores deben separarse con punto y coma, como en `Brian W. Kernighan; Dennis M. Ritchie`. No incluya la palabra «y» o similares, aunque tenga 20 autores. Si ha marcado la casilla de auto-formato, se mostrará automáticamente el apellido

Otras propiedades que permiten múltiples valores, como «género» o «palabras clave», se rellenan de la misma forma, con los valores separados por punto y coma (;).

8.2. | ¿Cómo agrupo por una propieda distinta a las listadas en la barra de herramientas?
| Para permitir la agrupación por un campo que de manera predeterminada no lo permite, marque la casilla «Permitir agrupar» para ese campo en concreto en el diálogo «Campos de colección».
8.3. | ¿Cómo cambio qué columnas se muestran?
| Haga clic derecho en la barra de cabecera. Puede también arrastrar las cabeceras para reordenar las columnas, y hacer clic sobre ellas para ordenarlas según ese campo.
8.4. | ¿Cómo exporto campos adicionales de bibtex?
| Tellico utiliza la propiedad bibtex para saber cómo exportar los campos bibtex. Si desea incluir campos adicionales para exportar, como un resumen, abra el Diálogo de campos de la colección y haga clic en el botón Establecer propiedades. Añada una propiedad bibtex con el valor resumen. Así, cuando exporte a bibtex o a bibtexml, esa propiedad será usada para el nombre del campo bibtex.
8.5. | ¿El nombre Tellico tiene que ver con algo?
| Había pensando en otros nombres, algunos de ellos relacionados con las colecciones de libros. Sin embargo, Tellico puede manejar más que libros y, como además esto es una afición, elegí un nombre que sonase bien (en mi opinión), el de un pueblo cercano a donde crecí.
8.6. | ¿Por qué se incluyen todos esos enlaces a Amazon.com en los resultados de búsqueda?
| Los términos de uso para acceder a los servicios web de Amazon.com requieren que todas las imágenes que se obtengan del servicio tengan un enlace a Amazon.com, además de un enlace adicional. La ID de asociado a Amazon.com es incluida necesariamente, de forma que los pagos por referencia son debidamente recogidos.
8.7. | ¿Por qué no utiliza una base de datos real?

Parte de la razón por la que empecé Tellico fue aprender C++. No sabía SQL en esa época, y por el momento solo tengo un ligero conocimiento de cómo usarlo. Simplemente, Tellico no empezó como una base de datos relacional, y eso no cambiará hasta que en algún momento del futuro, cuando consiga aprender SQL y tenga el tiempo y la motivación para cambiar el modelo de datos.

Por supuesto, cualquiera puede realizar los cambios que desee sobre el código fuente.

Capítulo 9. Referencia de órdenes
Referencia de órdenes

# Capítulo 9. Referencia de órdenes

## La ventana principal de Tellico

A continuación se explica cada elemento del menú. En caso de que se pueda lanzar la función de alguno con un atajo de teclado, se muestra el atajo predefinido junto a dicho elemento.

### El menú Archivo

Archivo → Nuevo

  Esta orden crea una nueva colección. Tellico permite 12 tipos de colecciones predefinidas, además de una colección vacía definida por el usuario. Cualquier plantilla de colección personalizada que haya guardado también estará disponible.

Archivo → Abrir… (Ctrl+O)

  Esta orden abre un archivo de Tellico.

Archivo → Abrir reciente

  Esta orden abre un archivo seleccionado de un submenú con una lista de archivos abiertos recientemente.

Archivo → Guardar… (Ctrl+S)

  Esta orden guarda la colección. Si el archivo no tiene título, entonces Guardar… equivale a Guardar como. Solo está habilitado cuando la colección ha sido modificada.

Archivo → Guardar como… (Ctrl+Mayúsculas+S)

  Esta orden guarda la colección en un nuevo archivo.

Archivo → Guardar como plantilla…

  Esta orden guarda la colección como una nueva plantilla. Solo se guardan los campos, y el tipo de colección personalizada se puede crear mediante la orden Nueva colección.

Archivo → Imprimir… (Ctrl+P)

  Esta orden imprime la colección. Las opciones de impresión se pueden configurar en el Diálogo de configuración.

Archivo → Vista previa de la impresión

  Esta orden muestra una vista previa de la colección impresa.

Archivo → Importar

  Esta orden importa datos desde otro archivo. Tellico puede importar datos desde un gran número de archivos con otros formatos.

Archivo → Exportar

  Esta orden exporta la colección a otro formato. Tellico puede exportar datos a un gran número de archivos con otros formatos.

Archivo → Salir (Ctrl+Q)

  Esta orden cierra la ventana de Tellico. Si la colección tiene cambios sin guardar, se le pedirá que los guarde antes de continuar.

### El menú Editar

Edición → Deshacer (Ctrl+Z)

  Esta orden deshace la acción previa. No todas las acciones están admitidas por Deshacer.

Edición → Rehacer (Ctrl+Mayúsculas+Z)

  Esta orden revierte un Deshacer previo.

Edición → Cortar (Ctrl+X)

  Esta orden elimina el texto seleccionado, si lo hay, y pone una copia del texto eliminado en el portapapeles.

Edición → Copiar (Ctrl+C)

  Esta orden copia el texto seleccionado, si lo hay, al portapapeles.

Edición → Pegar (Ctrl+V)

  Esta orden pega el texto del portapapeles, si lo hay, al editor en la posición del cursor.

Edición → Seleccionar todo (Ctrl+A)

  Esta orden selecciona todas las entradas de la colección, en la Vista de columna.

Edición → Deseleccionar (Ctrl+Mayúsculas+A)

  Esta orden deselecciona todas las entradas de la colección.

Edición → Buscar en internet… (Ctrl+I)

  Esta orden abre el diálogo Búsqueda en Internet para buscar e importar entradas desde varios sitios de Internet, entre otros Amazon.com.

Edición → Filtro avanzado… (Ctrl+J)

  Esta orden abre el Diálogo de filtro avanzado.

### El menú Colección

Colección → Nueva entrada (Ctrl+N)

  Esta orden abre el Editor de entradas para editar una nueva entrada.

Collección → Editar entrada (Ctrl+E)

  Esta orden abre el Editor de entradas para editar las entradas seleccionadas.

Colección → Duplicar entrada (Ctrl+Y)

  Esta orden copia, o duplica, las entradas seleccionadas como nuevas entradas de la colección.

Colección → Eliminar entrada (Ctrl+D)

  Esta orden elimina las entradas seleccionadas.

Colección → Refundir entradas

  Esta orden refunde las entradas seleccionadas.

Colección → Actualizar entrada

  Este menú contiene una lista de todas las fuentes de datos disponibles, y se puede usar para consultar automáticamente la fuente y actualizar las entradas seleccionadas.

Colección → Sacar prestado

  Esta orden abre un cuadro de diálogo para dar en préstamo las entradas seleccionadas.

Colección → Registrar

  Esta orden registra cualquiera de las entradas seleccionadas que están actualmente en préstamo.

Colección → Renombrar colección (Ctrl+R)

  Esta orden abre un cuadro de diálogo para renombrar la colección.

Colección → Campos de la colección… (Ctrl+U)

  Estar orden abre el Diálogo de campos de la colección.

Colección → Generar informes…

  Esta orden abre el Diálogo de informes para generar informes sobre la colección.

Colección → Bibliografia → Convertir a bibliografía

  Esta orden convierte una colección de libros en una bibliografía añadiendo ciertos campos necesarios para exportarse a Bibtex, y solo está habilitada cuando está abierta una colección de libros.

Colección → Bibliografia → Macros de cadena…

  Esta orden abre un cuadro de diálogo para editar las macros de cadena de Bibtex de la colección. Solo está habilitada cuando se edita una bibliografía.

Colección → Bibliografia → Comprobar si hay claves duplicadas…

  Esta orden comprueba si hay claves de Bibtex duplicadas y puede filtrar la colección para mostrar las entradas que tienen claves duplicadas.

Colección → Bibliografia → Copiar Bibtex al portapapeles

  Esta orden copia una cita de Bibtex al portapapeles, para que se pueda pegar en un documento de LaTeX.

Colección → Bibliografia → Citar entrada en Lyx

  Esta orden envía una cita de las entradas seleccionadas al llamado lyxpipe para usarlas en LyX, Kile, u otras aplicaciones LaTeX. Solo está habilitada cuando se edita una bibliografía.

### Los menús Preferencias y Ayuda

Además de los típicos menús Preferencias y Ayuda de KDE descritos en el capítulo Menú de la documentación de las bases de KDE, Tellico tiene las siguientes entradas específicas de la aplicación:

Preferencias → Mostrar vista de grupo

  Esta orden activa o desactiva la Vista de grupo.

Preferencias → Mostrar editor de entradas

  Esta orden activa o desactiva que se muestre el Editor de entradas

Preferencias → Selección de agrupamiento

  Esta orden cambia el campo usado para agrupar las entradas de la colección.

Preferencias → Bloquear esquema

  Esta orden bloquea el esquema para que no se puedan mover las distintas vistas de la colección. Si desbloquea el esquema podrá reorganizarlas.

Preferencias → Reiniciar esquema

  Esta orden reinicia el esquema a la vista predeterminada, lo que puede resultar de utilidad cuando algunas vistas se han ocultado o se han contraído.

Ayuda → Mostrar registro

  Cuando se usa la opción `tellico --log`, esta orden muestra el registro de diagnóstico.

Capítulo 10. Créditos y licencia
Créditos y licencia

# Capítulo 10. Créditos y licencia

Tellico

Copyright del programa 2001 Robby Stephenson `(robby AT periapsis.org)`

Copyright de la documentación 2001 Robby Stephenson `(robby AT periapsis.org)`

Traducido por Cristina Yenyxe González García `(the.blue.valkyrie AT gmail.com)`

Este programa está sujeto a los términos de la Licencia Pública General GNU.

Esta documentación está sujeta a los términos de la Licencia de Documentación Libre GNU.

El autor de esta documentación le garantiza también el permiso para usar el contenido bajo los términos de la Licencia de documentación de FreeBSD, si así lo elige. Si desea permitir el uso de su versión de este contenido solo bajo los términos de la Licencia de documentación de FreeBSD, pero no permitir que otros usen su versión de este archivo bajo los términos de la GFDL, indique su decisión eliminando el aviso de GFDL y reemplazándolo con el aviso y otras provisiones requeridas por la Licencia de documentación de FreeBSD. Si no elimina el aviso GFDL de arriba, un destinatario podría usar su versión de este archivo bajo los términos tanto de GFDL como de la Licencia de documentación de FreeBSD.