# El manual de &kaddressbook;

## Introducción

&kaddressbook; es la principal aplicación de libreta de direcciones para &kde;. Le permite gestionar sus contactos de una manera eficiente y confortable. Puesto que está basada en la biblioteca kabc, soporta recursos, que puede utilizar para cargar y guardar contactos en ubicaciones muy distintas, como el sistema de archivos local y servidores LDAP y bases de datos SQL.

La interfaz de usuario es similar a la de MS Outlook y soporta diferentes vistas para diversas representaciones e los datos de los contactos. Incluso proporciona una búsqueda incremental sobre todos los campos y una barra de botones para el acceso rápido a las entradas Ya que la biblioteca que está por debajo (kabc) usa el formato vCard (especificado en RFC 2426) como medio de almacenamiento predeterminado, &kaddressbook; refleja fundamentalmente los campos de entrada soportados en su interfaz gráfica de usuario.

## Usando &kaddressbook;

### Comenzando

Tras lanzar &kaddressbook; (usando el menú del panel o tecleando `kaddressbook` en el prompt de comandos) se muestra la ventana principal de &kaddressbook;:

Comenzando con &kaddressbook; La ventana principal de &kaddressbook;.

La ventana principal de &kaddressbook;.

### Configurar los recursos

&kaddressbook; puede usar múltiples recursos para cargar y almacenar sus contactos. Tras iniciar &kaddressbook; por primera vez, tiene instalado un recurso predeterminado que guarda todos los contactos en un archivo de vCard en $HOME/.kde/share/apps/kabc/std.vcf. Pero si quiere añadir más recursos, use el cuadro de diálogo Configurar recursos, que está disponible enkcontrol en Componentes de KDE->Libreta de direcciones:

El cuadro de diálogo Configurar recursos El cuadro de diálogo Configurar recursos.

El cuadro de diálogo Configurar recursos.

Cuando hace clic sobre Añadir... aparece un cuadro de diálogo en el que puede seleccionar el tipo de recurso. Por ahora, hay tres tipos disponibles:

archivo

- Todos los contactos se guardarán en un archivo.

dir

- Cada contacto se guardará en su propio archivo.

ldap

- Todos los contactos se guardarán en un servidor LDAP.

net

- Todos los contactos se guardarán en un archivo, que puede ubicar en un servidor remoto (p.ej. HTTP, WebDAV, FTP o Fish).

Tras seleccionar el tipo, aparecerá otro cuadro de diálogo en el que puede configurar las preferencias específicas del recurso.

Los recursos archivo y dir admiten diversos formatos para almacenar los contactos:

vCard

- Los contactos se guardarán en el formato vCard, como se especifica en RFC 2426.

binario

- Los contactos se guardarán en formato binario. Esto aumenta el rendimiento al cargar y al guardar, pero no es portable como el formato vCard.

&kaddressbook; necesita un recurso estándar en el que guardar todos los contactos si no se especifica ningún otro recurso. Por este motivo, tras iniciar &kaddressbook; por primera vez, ya hay un recurso disponible. Si quiere usar otro recurso como recurso estándar, utilice Usar como estándar para seleccionarlo. El nuevo recurso estándar debe permitir lectura y escritura y estar activo, o no podrá seleccionarlo.

### Gestión de contactos

Para crear o editar contactos, &kaddressbook; proporciona un cuadro de diálogo en el que puede introducir todos los datos, que también están disponibles en una vCard.

El cuadro de diálogo Contacto El cuadro de diálogo Contacto.

El cuadro de diálogo Contacto.

#### Análisis automático del nombre

&kaddressbook; intenta proporcionar una entrada de nombres sencilla analizando automáticamente el nombre. Para que funcione adecuadamente a veces es necesario añadir tratamientos, sufijos o inclusiones de nombres personalizados en el cuadro de diálogo de configuración. Sin embargo, ningún algoritmo es perfecto, y por tanto su entrada de nombre se puede analizar de forma errónea. En este caso, puede desactivar el análisis automático de nombre en el cuadro de diálogo de edición de nombre, que está disponible al hacer clic sobre Nombre... en el cuadro de diálogo de contacto. Si desea desactivar el análisis para los contactos nuevos, desactive globalmente el análisis automático de nombres en el cuadro de diálogo configurar.

#### Nombre con formato

El nombre con formato de un contacto lo usan otros programas para representarlo. &kaddressbook; ofrece tres tipos predefinidos de nombres con formato:

SimpleName

- <nombre> <apellido>

FullName

- <tratamiento> <nombre> <segundo nombre> <apellido> <sufijo>

ReverseName

- <apellido>, <nombre>

Si los tipos de arriba no se ajustan a sus necesidades, puede elegir el tipo Personalizado, en el que puede añadir su propio formato para el nombre. Esta configuración se puede realizar en el cuadro de diálogo de edición de nombre. Para especificar un tipo de formato de nombre predeterminado para los contactos nuevos, use el cuadro de diálogo de configuración.

### Usando las vistas

En esta versión, &kaddressbook; ofrece diferentes vistas, que representan los contactos de diversas formas:

Vista de tabla

- Todos los contactos se muestran en una tabla. Se pueden ordenar haciendo clic en el encabezado de la columna de la tabla. Las columnas de la tabla dependen de los campos que se hubieran seleccionado en el cuadro de diálogo de configuración de las vistas.

Vista de icono

- Los contactos se listan como iconos en una vista. Si el contacto contiene una foto o un logo, se usará en la vista; en otro caso, se usará un icono predeterminado.

Vista de tarjeta

- Todos los contactos se presentan en forma de tarjetas. Las tarjetas tienen el nombre con formato por título. El cuerpo de la tarjeta depende de qué campos se hayan seleccionado en el cuadro de diálogo de configuración de la vista.

El cuadro de diálogo Configurar vista El cuadro de diálogo Configurar vista

El cuadro de diálogo Configurar vista

La página Campos seleccionados le ofrece la posibilidad de seleccionar qué partes de un contacto se deben mostrar en la vista. En la página Filtro predeterminado puede configurar qué filtro se debe usar en la vista.

### Usando los filtros

Puede configurar los filtos de &kaddressbook;, que dependen de las categorías a las que un contacto pertenece. Por ejemplo,puede crear un filtro que seleccione todos los contactos que pertenezcan a las categorías «Familia» y «Amigos». Pero también puede crear un filtro para seleccionar todos los contactos que no pertenezcan a estas categorías. Para gestionar los filtros, use el cuadro de diálogo de configuración de filtros:

El cuadro de diálogo Configurar filtro El cuadro de diálogo Configurar filtro

El cuadro de diálogo Configurar filtro

Los filtros se pueden usar en las vistas para reducir el número de contactos representados. En el cuadro de diálogo de configuración de vistas puede especificar qué filtro se debe usar para una vista como predeterminado.

### Usando extensiones

Las extensiones se implementan como plugins en &kaddressbook;, de tal forma que otros desarrolladores puedan proporcionar más. Por ahora ya tenemos tres extensiones:

Editor de contactos

- Es casi igual que el diálogo de edición de contactos, pero como extensión se puede usar para editar de forma rápida un contacto.

Ubicación de un contacto

- Esta extensión toma la dirección postal de un contacto y carga un mapa de un servicio de mapas de Internet (como www.map24.de) con estos datos. El resultado se muestra en una vista de html.

Gestor de listas de distribución

- Esta extensión proporciona la gestión simple de listas de distribución. Simplemente cree una lista nueva y seleccione un contacto en la vista. Después de hacer clic en Añadir contacto, el contacto seleccionado forma parte de la lista de distribución. Una forma más sencilla es arrastrar un contacto desde la vista y soltarla sobre el gestor de listas de distribución.

La ventana principal con la extensión de la lista de distribución. La ventana principal con la extensión de la lista de distribución.

La ventana principal con la extensión de la lista de distribución.

### Importar y exportar

El nuevo entorno de trabajo para importar/exportar de &kaddressbook; le ofrece un cuadro de diálogo con el que puede exportar todos sus contactos.

El cuadro de diálogo de selección de la exportación. El cuadro de diálogo de selección de la exportación.

El cuadro de diálogo de selección de la exportación.

Ahora están disponibles los siguientes plugins de importación y exportación

vCard

- El formato vCard es un formato estándar (RFC 2426) que está soportado por la mayoría de libretas de direcciones. &kaddressbook; puede importar y exportar las versiones 2.1 y 3.0.

Teléfono móvil

- Este plugin puede importar contactos de teléfonos móviles Nokia vía la biblioteca gnokii.

Libreta de direcciones de Eudora

- Con este plugin puede importar sus contactos desde el cliente de correo de Eudora.

CSV

- CSV (valores separados por comas) es un formato usado por muchas aplicaciones (libretas de direcciones). Puede importar y exportar sus contactos con este formato.

KDE2

- Para importar los datos de sus anteriores libretas de direcciones de KDE 2.X puede usar este elemento.

LDIF

- LDIF es una representación en texto plano de datos de LDAP. Netscape y Mozilla usan este formato para guardar los datos de sus libretas de direcciones. &kaddressbook; admite la importación y exportación en este formato.

PAB

- PAB es el formato de la libreta de direcciones personal de MS Exchange. MS Outlook y MS Outlook Express lo usan para guardar los datos de sus contactos. &kaddressbook; admite la importación de este formato.

Opera

- Para importar la base de datos de contactos del navegador web Opera.

Marcadores

- Éste es un plugin de pseudo exportación, que hace que los URLs de sus contactos estén disponibles en el menú de marcadores de Konqueror.

### Consultas LDAP

&kaddressbook; se puede usar para importar información de las direcciones desde servidores LDAP a la libreta de direcciones local usando el diálogo de búsqueda de LDAP.

Para configurar (bastantes) servidores LDAP, use el cuadro de diálogo de configuración.

En la barra principal de &kaddressbook; hay disponible un botón con una imagen de una lupa sobre un libro. Use este botón para abrir el diálogo de búsqueda LDAP. El diálogo por sí mismo es bastante intuitivo. Simplemente teclee una parte del nombre, dirección de correo o número de teléfono y pulse el botón Buscar.

Cuando los resultados se muestren en la lista, es posible seleccionar una o más direcciones y usar Añadir seleccionado para importar las direcciones seleccionadas a la libreta de direcciones local o haga clic sobre Correo a los seleccionados para invocar el programa de correo y escribir un correo a los destinatarios seleccionados.

La marca de verificación Búsqueda recursiva está puesta por defecto. Esto hace que la consulta LDAP considere todos los objetos bajo la base DN de cada servidor. Si sólo quiere considerar los objetos un nivel por debajo de la base, desmarque este cuadro. Si tiene dudas, déjelo marcado.

### Preferencias

Puede modificar muchos aspectos del comportamiento de &kaddressbook; en el cuadro de diálogos de preferencias. El cuadro de diálogo se puede abrir vía Preferencias Configurar KAddressBook o desde el icono de la barra de herramientas.

Configurar &kaddressbook; El cuadro de diálogo de preferencias.

El cuadro de diálogo de preferencias.

#### La página Libreta de direcciones

##### La solapa General

El reconocido clic único de KDE

- Si está marcado, &kaddressbook; presta atención a la opción de clic sencillo de KDE.

Análisis de nombre automático para direcciones nuevas

- Si está marcado, la característica de análisis automático de nombre se usa para las direcciones nuevas.

Enlaces de scripts

- Aquí puede indicar los comandos que se deben ejecutar cuando haga clic sobre un enlace de número de teléfono o de número de fax en la página de detalles.

Extensiones

- En esta vista de lista puede activar y desactivar las extensiones sencillas y configurar sus preferencias.

##### La solapa Contacto

&kaddressbook; puede dividir automáticamente un nombre en sus partes. Para asegurarse de que esto funciona en muchos casos, puede añadir aquí identificadores de partes de nombres como tratamientos, sufijos e inclusiones. (Nota del traductor: en España no se debe usar el campo «Segundo nombre» para indicar la segunda parte de un nombre compuesto, ya que es propio de países anglosajones y sólo es propio de nombres provenientes de estos países. Las personas con un nombre compuesto, como «Juan Manuel» deben poner el nombre compuesto en el cuadro de entrada «Nombre» y dejar vacío el campo «Segundo nombre»).

Tratamientos

- Aquí puede gestionar tratamientos de personas como «Prof.» o «Dr.».

Inclusiones

- Aquí puede gestionar inclusiones de nombres como «van» o «von», que a menudo forman parte de los nombres holandeses o alemanes.

Sufijos

- Aquí puede gestionar sufijos de nombres como «Sr.» o «Jr.».

Formato de nombre con formato

- Aquí puede seleccionar el tipo de nombre con formato predeterminado, que se usará para los contactos nuevos.

#### La página Búsqueda LDAP

En esta página puede configurar servidores LDAP para usarlos en las consultas ldap en &kaddressbook;.

Use Añadir máquina... para añadir y configurar un nuevo servidor. Puede incluir y excluir servidores seleccionando o deseleccionando la marca de verificación en la lista de servidores. Pulse Aceptar para cerrar el diálogo.

## Referencias de comandos

### El menú Archivo

&Ctrl;N Archivo Nuevo contacto

- Abre el editor de contactos para añadir un contacto nuevo.

Archivo Editar contacto

- Abre el editor de contactos para editar el contacto seleccionado actualmente.

&Ctrl;S Archivo Guardar

- Guarda los contactos modificados.

Archivo Importar

- Lista todos los módulos de importación disponibles.

Archivo Exportar

- Lista todos los módulos de exportación disponibles.

&Ctrl;P Archivo Imprimir

- Imprime los contactos seleccionados actualmente.

Archivo Correo

- Abre el programa de correo preferido con los contactos seleccinados actualmente como destinatarios.

Archivo Enviar vCard

- Abre el programa de correo preferido con los contactos seleccinados actualmente adjuntos como vCards.

&Ctrl;Q Archivo Salir

- Sale de &kaddressbook;.

### El menú Editar

&Ctrl;Z Editar Deshacer

- Deshace el último cambio.

&Ctrl;&Shift;Z Editar Rehacer

- Rehace el último cambio.

&Ctrl;X Editar Cortar

- Corta los contactos seleccionados actualmente.

&Ctrl;C Editar Copiar

- Copia los contactos seleccionados actualmente al portapapeles.

&Ctrl;V Editar Pegar

- Pega el contenido del portapapeles en la libreta de direcciones, si está en un formato válido.

Delete Editar Borrar contacto

- Borra todos los contactos seleccionados actualmente.

&Ctrl;A Editar Seleccionar todo

- Selecciona todos los contactos.

Editar Fijar categorías

- Abre un cuadro de diálogo en el que puede fijar las categorías de todos los contactos seleccionados en ese momento. Cuando la categoría seleccionada sea distinta de las categorías de los contactos, el cuadro de diálogo le preguntará si quiere combinar estas diferencias o si se deben escribir las categorías.

Editar Fijar quién soy

- Marca el contacto seleccionado en ese momento como el contacto «Quién soy», que representa los datos del usuario. Debería tener un contacto así, porque otras aplicaciones como &kmail; y &kword; pueden usar estos datos. De esta forma, no tendrá que volver a teclearlos en cada aplicación.

### El menú Ver

Ver Seleccionar vista

- Lista todas las vistas disponibles.

Ver Añadir vista

- Abre un cuadro de diálogo para crear una vista nueva.

Ver Modificar vista...

- Abre un cuadro de diálogo en el que puede modificar las preferencias de la vista actual.

Ver Borrar vista

- Borra la vista actual.

Ver Refrescar vista

- Refresca la vista actual.

### El menú Herramientas

Este menú proporciona herramientas para actuar sobre la base de datos de contactos.

Herramientas Buscar direcciones endirectorio

- Abre el cuadro de diálogo de búsqueda de direcciones en servidores LDAP. Puede configurar los parámetros del servidor en el cuadro de diálogo de configuración.

### El menú Preferencias

Este menú proporciona opciones para configurar &kaddressbook;, cambiar su apariencia, las teclas rápidas y el comportamiento estándar.

Preferencias Barras de herramientas

- Activa o desactiva las barras de herramientas.

Preferencias Mostrar barra de extensiones

- Selecciona qué extensiones se deben mostrar en la barra de extensiones abajo en la ventana principal.

Preferencias Mostrar barra de salto

- Activa o desactiva la barra de saltos.

Preferencias Mostrar detalles

- Activa o desactiva la página de detalles.

Preferencias Editar filtro

- Abre un cuadro de diálogo en el que puede editar los filtros.

Preferencias Configurar teclas rápidas...

- Abre un cuadro de diálogo para cambiar las teclas rápidas. Usando esta opción, puede cambiar las teclas rápidas estándar para los comandos de &kaddressbook; o crear nuevas teclas rápidas.

Preferencias Configurar barras de herramientas...

- Abre un cuadro de diálogo para configurar la barra de herramientas. Puede añadir o borrar barras de botones para los comandos de &kaddressbook; mediante esta opción.

Preferencias Configurar KAddressBook...

- Abre el cuadro de diálogo de preferencias.

### El menú Ayuda

&help.menu.documentation;

## Opciones de la línea de comandos

&kaddressbook; admite varios argumentos en la línea de comandos, que puede usar para modificar el comportamiento al arrancar:

`kaddressbook` `-a, --addr <correo-e>`

- Muestra el editor de contactos con la dirección de correo electrónico dada.

`kaddressbook` `--uid <id de usuario>`

- Muestra el editor de contactos con el id de usuario dado.

`kaddressbook` `--editor-only`

- Carga en modo de sólo editor.

`kaddressbook` `--new-contact`

- Lanza el editor para el contacto nuevo.

&kaddressbook; también admite otras opciones en la línea de comandos, comunes a los programas de &kde; y &Qt;. Puede obtener una lista de tales opciones con:``--help``, ``--help-kde`` y ``--help-qt``

## Créditos y licencia

&kaddressbook; - la libreta de direcciones de &kde;

Copyright (c) 1997-2003, el equipo de KDE-PIM

&kaddressbook; fue escrito originalmente en 1997 por Don Sanders dsanders@kde.org. Actualmente lo mantiene Tobias Koenig tokoe@kde.org.

&underFDL;