<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kappname "&kab;">
  <!ENTITY package "kdeutils">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Spanish "INCLUDE" 
> <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>El manual de &kab;</title>

<authorgroup>
<author
> <firstname
>Mirko</firstname
> <surname
>Boehm</surname
> <affiliation
> <address
><email
>mirko@kde.org</email
></address
> </affiliation
> </author>

<author
> <firstname
>Pam</firstname
> <surname
>Roberts</surname
> <affiliation
> <address
><email
>pam.roberts@btinternet.com</email
></address
> </affiliation
> </author>

<othercredit role="translator"
><firstname
>Mario</firstname
><surname
>Teijeiro Otero</surname
><affiliation
><address
><email
>emeteo@escomposlinux.org</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit>
</authorgroup>

<copyright>
<year
>2001</year>
<holder
>Mirko Boehm, Pam Roberts</holder>
</copyright>
    
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2001-07-08</date>
<releaseinfo
>2.00.00</releaseinfo>

<abstract
><para
>&kab; (Libreta de dirección de &kde;) es un simple libro de direcciones para &kde;.</para
> </abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Kab</keyword>
<keyword
>kdeutils</keyword>
<keyword
>libreta de direcciones</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducción </title>

<para
>&kab; es una libreta de direcciones para usar con &kde; que permite guardar nombres, direcciones postales, de correo, de habla y <acronym
>WWW</acronym
>; números de teléfonos, fechas importantes y otra información en un índice de tarjetas.</para>
    
</chapter>

<chapter id="using">
<title
>Usando &kab;</title>

<sect1 id="entering">
<title
>Introduciendo datos</title>

<para
>Se puede importar datos de la libreta de direcciones de la versión de &kde; 1 de &kab; o desde &Netscape; usando la opción de menú <menuchoice
><guimenu
>Archivo</guimenu
> <guisubmenu
>Importar</guisubmenu
></menuchoice
>.</para>
      
<para
>También se puede añadir entradas individuales eligiendo en la opción <menuchoice
> <guimenu
>Editar</guimenu
><guimenuitem
>Añadir entrada...</guimenuitem
></menuchoice
>, la cual muestra el siguiente cuadro de diálogo.</para>

<screenshot
> <screeninfo
>Aquí hay otra captura de &kab;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="kab-edit.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>    ; en modo edición&kab;</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Esta vista se usa para añadir o cambiar detalles de una tarjeta. Tiene cinco pestañas; <guilabel
>Persona</guilabel
>, <guilabel
>Teléfono</guilabel
>, <guilabel
> Direcciones</guilabel
>, <guilabel
>Fecha de nacimiento</guilabel
>  y <guilabel
>Comentarios</guilabel
></para>
      
<para
>La pestaña <guilabel
>Persona</guilabel
> es el lugar donde se introduce el nombre y las direcciones de correo electrónico, de charla y &URL; asociadas. Todo lo que se introduzca en el cuadro de texto <guilabel
>Nombre formateado</guilabel
> aparecerá como nombre de entrada en la lista de navegación de entradas, en la lista de selección en la barra de herramientas y en la parte superior izquierda de la tarjeta. Si no se introduce nada en cuadro de texto <guilabel
>nombre formateado</guilabel
> &kab; automáticamente generará un nombre formateado tal como <quote
>Holmes, Sherlock</quote
>.</para>

<para
>La pestaña <guilabel
>Teléfono</guilabel
> es, obviamente, donde se introduce el/los número/s de teléfono/s.</para>

<para
>La pestaña <guilabel
>Direcciones</guilabel
> permite introducier una o más direcciones para esta entrada.</para>

<procedure
> <step
> <para
>Por cada dirección que se introduzca, haciendo click en el botón <guibutton
>añadir</guibutton
> mostrará una lista desplegable que contiene los tipos de dirección que se hayan configurado en la opción  <menuchoice
><guimenu
>Editar</guimenu
><guimenuitem
>Configurar este archivo...</guimenuitem
></menuchoice
>. Si se elige una aparecerá en el cuadro de texto <guilabel
>Tipo de dirección</guilabel
> donde se puede editar si se requiere.</para
> </step
> <step
> <para
>Entonces se rellena los detalles de la dirección.</para
> </step
> <step
> <para
>Presionando el botón <guibutton
>Organización....</guibutton
> muestra otro cuadro de diálogo dónde se puede introducir detalles de cualquier organización en la que la persona trabaja y su posición en ella. Sin embargo, la versión actual de &kab; no muestra esta información en la vista <guimenuitem
>Tarjeta de negocios</guimenuitem
>. </para
> </step
> </procedure>

<para
>La pestaña <guilabel
>Fecha de nacimiento</guilabel
> es donde se seleccionan fechas significantes que aparecerán en la parte superior izquierda de la vista de tarjetas. Sólo aparecerán si se ha seleccionado <guilabel
>Conozco la fecha de nacimiento de esta persona:</guilabel
>.</para>

<note
> <para
>Problamemente se necesite experimentar con las entradas en las pestañas <guilabel
>Persona</guilabel
> y <guilabel
>direcciones</guilabel
> para conseguir el resultado deseado en la vista de tarjetas.</para
> </note>

<para
>Hay otras dos pestañas en el cuadro de diálogo las cuales pueden ser útiles en ciertas circustancias.</para>

<para
>La pestaña <guilabel
>Comentario</guilabel
>. Caualquier texto que aparezca aquí no aparecerá en la vista de <guimenuitem
>Tarjetas de negocio</guimenuitem
> pero será incluída cuando se imprima los detalles de la tarjeta.</para>

<para
>La pestaña <guilabel
>Campos de usuario</guilabel
>. Esto permite añadir información al archivo de base de datos con los campos y datos definidos por el usuario. Estos datos no se mostrarán en la vista de <guimenuitem
>Tarjeta de negocios</guimenuitem
>, no serán impresos, pero podrán ser leídos por otro programa.</para>

</sect1>

<sect1 id="kabcard">
<title
>Viendo datos</title>

<para
>&kab;tiene dos vistas básicas, <guimenuitem
>Tarjeta de negocios</guimenuitem
> y <guimenuitem
>Edición</guimenuitem
>. Se puede cambiar entre ellas mediante el menú <guimenu
>Vista</guimenu
>.La captura de pantalla siguiente muestra la vista <guimenuitem
>Tarjeta de negocios</guimenuitem
>.</para>


<screenshot
> <screeninfo
>Aquí hay una captura de pantalla de &kab;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="kab-using.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>      en modo vista de tarjetas&kab;</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Esta vista permite buscar una entrada en la base de datos de &kab; y ver la información mantenida para esta entrada.</para>

<para
>Para seleccionar una entrada particular se puede seleccionar en la caja desplegable en la barra de herramientas o en la lista de entradas de navegación, o se puede caminar a través de las entradas usando las <guiicon
>flechas de la barra de herramientas</guiicon
> o con las teclas de dirección del teclado.</para>

<para
>Se puede buscar en la base de datos por una entrada particular usando la opción de menú <link linkend="kab-edit-menu"
><menuchoice
><guimenu
>Editar</guimenu
><guimenuitem
> Buscar entradas...</guimenuitem
></menuchoice
></link
> o introduciendo una dirección de correo electrónico, nombre o apellidos en el cuadro de texto en la parte superior de la lista de navegación de entradas.</para>

<para
>En la parte superior del área de la tarjeta principal se puede ver el nombre que aparece en la lista desplegable de la barra de herramientas, y posiblemente una fecha importante tal como el cumpleaños de la persona.</para>

<para
>Una dirección será mostrada en la mitad de la tarjeta. &kab; permite introducir más de una dirección, por ejemplo casa, trabajo y vacaciones. La caja desplegable de debajo de las direccinoses permite seleccionar qué dirección se muestra.</para>

<para
>En la parte inferior de la tarjeta se muestra las direcciones de correo electrónico, &URL;s y números de teléfonos. Realizando un click con el botón izquierdo sobre la dirección de correo electrónico permite enviar un correo, sobre la &URL; abrirá la ventana de navegación. Si se ha introducido más de una dirección de correo electrónico o &URL;, sólo se mostrará una en la tarjeta seguido de [...] y cuando hagas click en ellos un pequeño cuadro de diálogo aparecerá permitiendo elegir las direcciones que se quieran.</para>

<para
>El menú <link linkend="kab-file-menu"
><guimenu
>Archivo</guimenu
></link
> tiene opciones que permiten crear y usar más de una base de datos, importar libretas de direcciones viejas de &kde; o &Netscape; o imprimir una o todas las entradas.</para>
</sect1>

</chapter>

<chapter id="commands">
<title
>Referencia de comandos</title>

<sect1 id="kab-menubar">
<title
>La barra de menú</title>

<sect2 id="kab-file-menu">
<title
>El menú <guimenu
> Archivo</guimenu
></title>

<variablelist
> <varlistentry
> <term
><menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
><guimenu
>Archivo</guimenu
><guimenuitem
>Crear nueva base de datos </guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Úsese esto si se desea crear otra base de datos de libretas de direcciones de &kab; así se puede mantener libretas de direcciones separadas, por ejemplo, contactos de negocios y personales.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
><guimenu
>Archivo</guimenu
> <guimenuitem
>Abrir...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Abre</action
> una base de datos de &kab;. Esta elección de menú se usa para abrir una nueva libreta de direcciones que se haya creado con anterioridad.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Abrir base de datos predeterminada</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Abre la base de datos predeterminada</action
> de &kab;</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Guardar</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Guarda</action
> la base de datos de &kab; actual.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Archivo</guimenu
> <guisubmenu
>Importar</guisubmenu
> <guimenuitem
>Libreta de direcciones de KDE 1</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Permite <action
>importar una libreta de direcciones</action
> generada por la versión 1 de &kab;, cambiendo su formato a la usado por la versión 2, y guardando con un nombre diferente. Haciendo esto no se destruyen la libreta de direcciones original.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Archivo</guimenu
> <guisubmenu
>Importar</guisubmenu
> <guimenuitem
>Libreta de direcciones de Netscape</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Permite <action
>importar una libreta de direcciones</action
> generada por &Netscape;</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Archivo</guimenu
> <guisubmenu
>Imprimir</guisubmenu
> <guimenuitem
>Imprimir entrada...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Imprimir todos los detalles de la entrada actual.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
><guimenu
>Archivo</guimenu
> <guisubmenu
>Imprimir</guisubmenu
> <guimenuitem
>Imprimir entradas....</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Imprime todos los detalles de todas las entradas en la base de datos.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
></keycap
></keycombo
> </shortcut
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Salir</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Sale</action
> de &kab;</para
> </listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="kab-edit-menu">
<title
>El menú <guimenu
>Editar</guimenu
></title>

<variablelist
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Añadir entrada...</guimenuitem
> </menuchoice
></term
> <listitem
><para
><action
>Añade una nueva entrada a la libreta de direcciones</action
>. Esto hace lo mismo que el icono de la barra de herramientas <guiicon
>Nueva entrada</guiicon
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Editar entrada...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Si se está en la vista de negocios se puede usar esta entrada de menú (o el icono de la barra de herramientas <guiicon
>Editar entrada</guiicon
>f) cuando se quiera <action
>editar la entrada actual</action
>, o bien cambiando a la vista <guimenuitem
>Editando</guimenuitem
> con la opción de menú <menuchoice
><guimenu
>Vista</guimenu
><guimenuitem
>Editando</guimenuitem
></menuchoice
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Suprimir entrada</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Suprime la entrada actual de la base de datos.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>M</keycap
></keycombo
> </shortcut
><guimenu
>Editar</guimenu
> <guimenuitem
>Envíar un mensaje</guimenuitem
> </menuchoice
></term
> <listitem
> <para
> Realiza lo mismoq eu un click <mousebutton
>izquierdo</mousebutton
> en la línea <guilabel
>Direccion de correo electrónico</guilabel
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
> </shortcut
><guimenu
>Editar</guimenu
> <guimenuitem
>Navegar</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
> Abre en navegador</action
> con la &URL; almacenada en la entrada actual de &kab;.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl; <keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Buscar entradas</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Busca en la base de datos </action
> una entrada en particular.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Editar</guimenu
> <guimenuitem
>Habilitar todos los mensajes</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Hay algunos mensajes que pueden ser accidentalmente deshabilitados por el usuario tales como el mensaje de inicio para importar la libreta de direcciones de &kde; 1. <action
>Seleccionando este elemento de menú hace que todos estos mensajes reaparezcan.</action
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Editar</guimenu
> <guimenuitem
>Configurar este archivo...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Permite configurar algunos parémetros de la libreta de direcciones actual</action
> . En la actualidad la pestaña <guilabel
>campos de usuario</guilabel
> no funciona, pero la pestaña <guilabel
>tipos de direcciones</guilabel
> pueden ser usadas para configurar los valores de los <guilabel
>tipos de direcciones</guilabel
> de la libreta predeterminada  </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Editar</guimenu
> <guimenuitem
>Preferencias para la libreta de direcciones de KDE...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Permite configurar algunas opciones generales de &kab;</para
> </listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Vista</guimenu
></title>

<variablelist
> <varlistentry
> <term
><menuchoice
> <guimenu
>Vista</guimenu
> <guimenuitem
>Tarjeta de negocios</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Muestra la vista indexada de tarjetas normales.</action
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Vista</guimenu
> <guimenuitem
>Editando</guimenuitem
> </menuchoice
></term
> <listitem
><para
><action
>Cambia</action
> la ventana principal de &kab; permite que la entrada sea editada. </para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Vista </guimenu
> <guimenuitem
>Mostrar la barra de herramientas</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Muestra o oculta la barra de herramientas principal</action
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Vista</guimenu
> <guimenuitem
>Mostrar la barra de herramientas de navegación</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Muestra u oculta la barra de herramientas usada para navegar a través de la base de datos</action
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Vista</guimenu
> <guimenuitem
>Mostrar lista de navegación de entradas</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Muestra u oculta la lista del lado izquierdo de la ventana de &kab;.</action
>.</para
> </listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Ayuda</guimenu
></title>

&help.menu.documentation;

</sect2>

</sect1>
</chapter>

<chapter id="faq">
<title
>Preguntas y respuestas</title>

<qandaset>

<qandaentry>
<question>
<para
>¿Dónde almacena &kab; la libreta de direcciones?</para>
</question>
<answer>
<para
>La libreta de direcciones predeterminada se almacena en <filename
>~/.kde/share/apps/kab/addressbook.kab</filename
>, cualquiera base de datos nueva que haya sido creada será almacenada donde se quiera. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>¿Qué ficheros de configuración usa &kab;?</para>
</question>
<answer>
<para
>El fichero <filename
>~/.kde/share/apps/kab/kab.config</filename
> mantiene las <quote
>preferencias</quote
> de &kab; y las cadenas de comandos para enviar correo y de <quote
>talk</quote
></para>

<para
><filename
>~/.kde/share/config/kabrc</filename
> mantiene los parámetros de apariencia general de &kab; y una lista de las libreta de direcciones más recientemente visitadas.</para>

<para
>No se debe modificar estos ficheros al no ser que realmente se sepa lo que se está haciendo ( y se haya realizado una copia de seguridad).</para>
</answer>
</qandaentry>

</qandaset>

</chapter>

<chapter id="credits">

<title
>Créditos y licencia</title>

<para
>&kab;</para>
<para
>Programa: copyright 1996-2001 Mirko Boehm <email
>mirko@kde.org</email
></para>

<para
>Documentación: copyright 2001</para>

<itemizedlist
> <listitem
><para
>Mirko Boehm <email
>mirko@kde.org</email
></para
></listitem
> <listitem
><para
>Pam Roberts <email
>pam.roberts@btinternet.com</email
></para
></listitem
> </itemizedlist>

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title
>Instalación</title>

&install.intro.documentation;
&install.compile.documentation;

</appendix>

&documentation.index; 
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->

