# Detalles de &appname;

## Tipos de campos

Cada colección puede tener un número ilimitado de campos. &appname; 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 &appname;. 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 &appname; 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

&appname; 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 &appname; 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, &appname; 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. &appname; 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. &appname; 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.

&appname; tiene algunas funciones especializadas para las bibliografías. Se pueden añadir, modificar o eliminar cadenas de macros de Bibtex desde dentro de &appname;, 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.