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

<book lang="&language;">

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

<authorgroup>
<author
> <firstname
>Jonathan</firstname
> <surname
>Singer</surname
> <affiliation
> <address
><email
>jsinger@leeta.net</email
></address
> </affiliation
> </author>

<author
> <firstname
>Sirtaj</firstname
> <othername
>Singh</othername
> <surname
>Kang</surname
> <affiliation
><address
><email
>taj@kde.org</email
></address
></affiliation
> </author>

<othercredit role="reviewer">
<firstname
>Lauri</firstname>
<surname
>Watts</surname>
<contrib
>Revisor</contrib>
<affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
</othercredit>
<othercredit role="translator"
> <firstname
>Juan Manuel</firstname
> <surname
>García Molina</surname
> <affiliation
><address
><email
>juanma_gm@wanadoo.es</email
></address
> </affiliation
><contrib
>Traductor</contrib
> </othercredit>
</authorgroup>

<copyright>
<year
>2000-2002</year>
<holder
>Jonathan Singer</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-10-07</date>
<releaseinfo
>1.00.00</releaseinfo>

<abstract
><para
>&karm; registra el tiempo empleado en varias tareas.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>karm</keyword>
<keyword
>kdeutils</keyword>
<keyword
>tiempo</keyword>
<keyword
>registro</keyword>
<keyword
>proyecto</keyword>
</keywordset>

</bookinfo>

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

<para
>&karm; registra el tiempo que emplean varias tareas. Es útil para registrar horas para que sean facturadas a diferentes clientes o simplemente para averiguar qué porcentaje del día pasa jugando al Doom o leyendo Barrapunto.</para>

<para
>&karm; fue escrito originalmente por Sirtaj Singh Kang. La palabra <quote
>karm</quote
> significa <quote
>trabajo</quote
> en el Punjabi natal del autor.</para>

</chapter>


<chapter id="using-Karm">
<title
>Usar &karm;</title>

<sect1 id="starting">
<title
>Iniciar &karm;</title>

<para
>Teclee <command
>karm</command
> en un prompt de comandos o seleccione <guimenuitem
>Seguimiento de tiempo personal</guimenuitem
> en el grupo <guisubmenu
>Utilidades</guisubmenu
> del <guimenu
>menú de inicio de KDE</guimenu
>. Están disponibles las opciones de comando estándar de &Qt; y &kde;, y se puede obtener un listado de las mismas indicando en la línea de comandos <userinput
><command
>karm</command
> <option
>--help</option
></userinput
>.</para>

</sect1>

<sect1 id="general-use">
<title
>Uso general</title>

<para
>Introduzca las diversas tareas que quiera seguir.</para>

<para
>Para empezar a cronometrar una tarea, selecciónela y haga doble clic sobre ella, seleccionando <guimenuitem
>Iniciar</guimenuitem
> del menú <guimenu
>Reloj</guimenu
> o presione el botón <guiicon
>Iniciar</guiicon
> de la barra de herramientas. Para detener el recuento del tiempo, haga doble clic, seleccione <guimenuitem
>Detener</guimenuitem
> en el menú <guimenu
>Reloj</guimenu
> o presione el botón <guiicon
>Detener</guiicon
> de la barra de herramientas.</para>

<para
>Ahora puede seguir el tiempo de múltiples tareas simultáneamente.</para>

<para
>Tareas que se pueden guardar y ser restauradas la próxima vez que se use.</para>

</sect1>

</chapter>

<chapter id="interface">
<title
>El interfaz de &karm;</title>

<para
>La ventana principal de &karm; tiene los siguientes componentes: barra de menú, barra de herramientas, ventana de tarea/tiempo y barra de estado.</para>

<screenshot
> <screeninfo
>Pantalla de &karm;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="karm.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Pantalla de &karm;</phrase
> </textobject
> </mediaobject
> </screenshot>

<sect1 id="main-window">
<title
>La ventana de tarea/tiempo</title>

<para
>En esta ventana se muestran las diferentes tareas, junto con el tiempo acumulado para cada uno en la sesión actual y en total. Las tareas de las que se sigue el tiempo tiene un pequeño icono de reloj junto al tiempo de sesión.</para>

<para
>Se pueden crear subtareas para cada tarea. Al hacer doble clic sobre una tarea se muestra o se contraen sus subtareas asociadas. El tiempo total acumulado para una tarea incluye los tiempos para sus subtareas, así como su propio tiempo acumulado.</para>

</sect1>

<sect1 id="menus">
<title
>La barra de menú de &karm;</title>
<sect2>
<title
>El menú <guimenu
>Archivo</guimenu
></title>

<variablelist
> <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 la tarea actual y las subtareas con sus tiempos acumulados</action
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Imprimir</guimenuitem
> </menuchoice
></term
> <listitem
><para
> <action
>Imprime</action
> la ventana de &karm;</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Reiniciar el tiempo de la sesión</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Reinicia (pone a cero) el tiempo total transcurrido para la sesión actual</action
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Salir</guimenuitem
> </menuchoice
></term
> <listitem
> <para
><action
>Cierra</action
> &karm;</para
> </listitem
> </varlistentry
> </variablelist>

</sect2>

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

<variablelist
> <varlistentry
> <term
> <menuchoice
> <shortcut
><keycap
>S</keycap
></shortcut
> <guimenu
>Reloj</guimenu
> <guimenuitem
>Iniciar</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
><action
>Inicia</action
> el seguimiento temporal de la tarea seleccionada</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
><keycap
>&Esc;</keycap
></shortcut
> <guimenu
>Reloj</guimenu
> <guimenuitem
>Detener</guimenuitem
> </menuchoice
> </term
> <listitem
><para
><action
>Detiene</action
> el seguimiento temporal de la tarea seleccionada</para
></listitem
> </varlistentry
> </variablelist>
</sect2>

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

<variablelist
> <varlistentry
> <term
> <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Tarea</guimenu
> <guimenuitem
>Nueva</guimenuitem
> </menuchoice
> </term
> <listitem
><para
><action
>Añade</action
> una nueva tarea</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Tarea</guimenu
> <guimenuitem
>Nueva subtarea</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
><action
>Añade</action
> una nueva subtara a la tarea seleccionada</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
> <keycap
>Del</keycap
> </shortcut
> <guimenu
>Tarea</guimenu
> <guimenuitem
>Borrar</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
><action
>Borra</action
> la tarea o subtarea seleccionada</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Tarea</guimenu
> <guimenuitem
>Editar</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
><action
>Cambia el nombre o el tiempo acumulado</action
> de la tarea actual</para
><para
>Hay dos opciones para cambiar el tiempo: Edición absoluta, en la que los nombres de sesión y el total se pueden cambiar separadamente, y Edición relativa, en la que un cierto cambio se añade a o se sustrae tanto del tiempo de sesión como del total.</para
> </listitem
> </varlistentry
> </variablelist>
</sect2>

<sect2>
<title
>El menú <guimenu
>Preferencias</guimenu
></title>
<variablelist
> <varlistentry
> <term
> <menuchoice
> <guimenu
>Preferencias</guimenu
> <guimenuitem
>Configurar atajos</guimenuitem
> </menuchoice
> </term
> <listitem
><para
><action
>Abre</action
> un diálogo para permitir al usuario personalizar los atajos de teclado</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenu
>Preferencias</guimenu
> <guimenuitem
>Configurar KArm</guimenuitem
> </menuchoice
> </term
> <listitem
><para
><action
>Abre</action
> un diálogo para permitir al usuario configurar &karm;</para
> <para
>El diálogo tiene dos partes: <guilabel
>Guardado</guilabel
>, que configura la ubicación del archivo guardado, si está activado el guardado automático, y su intervalo; y <guilabel
>Detección de inactividad</guilabel
>, que cuando está fijado muestra una alarma cuando no se detecta actividad durante un espacio de tiempo especificado.</para
> </listitem
> </varlistentry
> </variablelist>
</sect2>

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

&help.menu.documentation;

</sect2>

</sect1>

<sect1 id="tool-bar">
<title
>La barra de herramientas</title>
<para
>La barra de herramientas contiene iconos para los siguientes comandos:</para>

<note
><para
>(Todos los comportamientos son idénticos al comando menú.)</para
></note>

<itemizedlist
> <listitem
><para
><guiicon
>Iniciar</guiicon
></para
></listitem
> <listitem
><para
><guiicon
>Detener</guiicon
></para
></listitem
> <listitem
><para
><guiicon
>Nueva</guiicon
></para
></listitem
> <listitem
><para
><guiicon
>Nueva subtarea</guiicon
></para
></listitem
> <listitem
><para
><guiicon
>Borrar</guiicon
></para
></listitem
> <listitem
><para
><guiicon
>Editar</guiicon
></para
></listitem
> </itemizedlist>

</sect1>

<sect1 id="status-bar">
<title
>La barra de estado</title>

<para
>Informa del tiempo total transcurrido para la sesión.</para>
</sect1>

</chapter>

<chapter id="credits">

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

<para
> &karm; </para>

<para
> Copyright del programa 1997-2000 Sirtaj Singh Kang <email
>taj@kde.org</email
>.</para>

<para
>Colaboradores</para>
<itemizedlist
> <listitem
><para
>Espen Sand <email
>espen@kde.org</email
></para
></listitem
> <listitem
><para
>Jesper Pedersen <email
>blackie@ifad.dk</email
></para
></listitem
> <listitem
><para
>Kalle Dalheimer <email
>kalle@kde.org</email
></para
></listitem
> <listitem
><para
>Klar&auml;lvdalens Datakonsult AB</para
></listitem
> <listitem
><para
>Tomas Pospisek <email
>tpo_deb@sourcepole.ch</email
></para
></listitem
> <listitem
><para
>Gioele Barabucci <email
>gioele@gioelebarabucci.com</email
></para
></listitem
> <listitem
><para
>Jan Schaumann <email
>jschauma@netmeister.org</email
></para
></listitem
> </itemizedlist>

<para
>&karm; se ispiró en una utilidad muy buena de Harald Tveit Alverstrand llamada <application
>titrax</application
>. La única pega era que estaba basada en el toolkit Xt.</para>

<para
>Copyright de la documentación 2000 Jonathan Singer <email
>jsinger@leeta.net</email
> y Sirtaj Singh Kang <email
>taj@kde.org</email
>.</para>

&underFDL;
&underGPL;

</chapter>

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

<sect1 id="getting-karm">
<title
>Cómo obtener &karm;</title>

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

</sect1>

</appendix>

&documentation.index; 
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
