<para>&karm; comptabilise le temps passé sur diverses tâches. Il est employé pour connaître les heures à facturer et peut vous renseigner sur le temps passé par tâche et par jour.</para>
<para>&karm; détecte l'inactivité de vos clavier et souris et peut associer différentes tâches à différents bureaux, deux outils qui vous aident à chronométrer correctement vos travaux.</para>
<para>À l'origine &karm; a été écrit par Sirtaj Singh Kang. Dans la langue de l'auteur, le Punjabi, le mot <quote>karm</quote> signifie <quote>travail</quote> ou <quote>actions</quote>. C'est également le même mot (dans une meilleure transcription) que <quote>karma</quote>.</para>
<para>Saisissez <command>karm</command> en ligne de commande ou choisissez <guimenuitem>Chronomètre individuel de tâches</guimenuitem> du groupe <guisubmenu>Utilitaires</guisubmenu> dans le menu <guimenu>K</guimenu>. Les commandes standard de &Qt; et &kde; sont disponibles et peuvent être listées en saisissant <userinput><command>karm</command> <option>--help</option> </userinput> en ligne de commande.</para>
<para>&karm; fournit une option supplémentaire qui vous permet de saisir le nom d'un fichier iCalendar qui sera utilisé pour stocker l'historique de votre travail. Pour spécifier l'emplacement d'un fichier iCalendar distant vous utiliserez HTTP ou FTP dans le nom du fichier : par exemple, http://www.monsite.com/mesdonnees/montravail.ics.</para>
<para><emphasis>Problème : </emphasis>vous êtes un consultant en logiciels libres avec de nombreux clients. Certains d'entre eux ont plusieurs projets. Tout au long de la journée, vous passez d'un projet à l'autre. Vous avez besoin de comptabiliser le temps passé sur chacun pour facturer vos clients.</para>
<para><emphasis>Solution : </emphasis>créez une tâche principale pour chaque client et une sous-tâche pour chaque projet. Pour les projets qui requièrent plus de détails, créez d'autre sous-tâches. Pour chronométrer les tâches sur lesquelles vous travaillez, il vous suffit de double-cliquer sur celles-ci.</para>
<para>&karm; fait preuve d'une grande flexibilité dans le suivi des durées, ce qui lui permet de gérer un nombre illimité de tâches et sous-tâches. Les durées sont comptabilisées pour n'importe lesquelles et plusieurs peuvent être actives en même temps.</para>
<para>Pour créer une tâche principale, faites <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Tâche</guimenu> <guimenuitem>Nouvelle</guimenuitem> </menuchoice> Pour créer une sous-tâches, choisissez une tâche principale et faites <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;&Alt;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Tâches</guimenu> <guimenuitem>Nouvelle sous-tâche</guimenuitem> </menuchoice> </para>
<para>À la fermeture de &karm;, la liste des tâches est enregistrée dans le fichier spécifié dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer &karm;</guimenuitem> </menuchoice>. Au lancement suivant, elle sera rechargée à partir de ce fichier.</para>
<para>Pour vous faciliter la vie, &karm; peut importer et exporter des tâches. Voir <link linkend="interfaces">Autres systèmes</link>.</para>
<para><emphasis>Problème : </emphasis>pour rester solvable, vous devez facturer une moyenne de cinq heures par jour. Vous vous en assurez en regardant vos totaux journalier et hebdomadaire.</para>
<para><emphasis>Solution : </emphasis>réinitialisez le chronomètre de la session au début de chaque journée de travail et réinitialisez tous les compteurs au début de chaque semaine.</para> </informalexample>
<para>&karm; permet de chronométrer simplement. Pour commencer à comptabiliser la durée d'une tâche, double-cliquez sur celle-ci. Pour arrêter la comptabilisation, double-cliquez à nouveau. Les tâches actives affichent un petit chronomètre dans la colonne <guilabel>Durée de la session</guilabel>.</para>
<para>Un autre indice visuel de cette comptabilisation est la miniature de &karm;. Lorsqu'une tâche est active, le (tout) petit chronomètre bouge. Si vous passez votre souris au-dessus de cette icône, le nom de cette tâche s'affichera dans une bulle d'aide. Si plusieurs sont en cours, leurs noms seront séparés par des virgules.</para>
<para>&karm; maintient deux compteurs pour chaque tâche : un pour la durée de la session et l'autre pour la durée totale. Par défaut, &karm; affiche deux colonnes pour chaque compteur, ce qui donne quatre colonnes pour chaque tâche :</para>
<varlistentry> <term><guilabel>Durée de la session</guilabel></term>
<listitem><para>Le temps passé sur la tâche depuis le début de la session.</para></listitem> </varlistentry>
<varlistentry> <term><guilabel>Durée totale de la session</guilabel></term>
<listitem><para>Le temps passé sur la tâche et toutes ses sous-tâches depuis le début de la session.</para></listitem> </varlistentry>
<varlistentry> <term><guilabel>Durée</guilabel></term> <listitem><para>Le temps passé sur la tâche depuis la réinitialisation de tous les compteurs.</para></listitem>
<listitem><para>Le temps passé sur la tâche et toutes ses sous-tâches depuis la réinitialisation de tous les compteurs.</para></listitem> </varlistentry>
<para>Pour commencer une nouvelle session, faites <menuchoice> <guimenu>Fichier</guimenu> <guimenuitem>Démarrer une nouvelle session</guimenuitem> </menuchoice> </para>
<para>Pour réinitialiser toutes les durées, faites <menuchoice> <guimenu>Fichier</guimenu> <guimenuitem>Réinitialiser toutes les durées</guimenuitem> </menuchoice> </para>
<para><emphasis>Problème : </emphasis>vous avez deux projets principaux et vous passez d'un à l'autre au cours de la journée. Pour faciliter l'organisation de votre travail, vous avez les fichiers de votre projet 1 sur le Bureau 1 et ceux de votre projet 2 sur le Bureau 2.</para>
<para><emphasis>Solution : </emphasis>associez la tâche du projet 1 au Bureau 1 et celle du projet 2 au Bureau 2. Lorsque vous passerez d'un bureau à l'autre, &karm; stoppera automatiquement le projet sur lequel vous étiez et commencera l'autre.</para>
<para>Pour associer une tâche à un ou plusieurs bureaux, faites <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> </shortcut> <guimenu>Tâche</guimenu> <guimenuitem>Modifier</guimenuitem> </menuchoice>. Activez <guilabel>Suivi automatique</guilabel> et sélectionnez le ou les bureaux à associer. Lorsqu'un de ces bureaux deviendra actif, &karm; déclenchera automatiquement (après un court délai) le chronomètre correspondant à la tâche.</para>
<sect2><title>Détection des moments de pause</title>
<informalexample> <para><emphasis>Problème : </emphasis> vous quittez votre travail un peu plus tôt le vendredi pour faire une course et vous oubliez d'arrêter le chronomètre. À votre retour le lundi, le compteur continue de tourner.</para>
<para><emphasis>Solution : </emphasis>activez la détection d'inactivité.</para>
<para>&karm; peut être configuré pour détecter l'inactivité de vos clavier et souris. Si cela ce produit pour une durée plus longue que celle définie, &karm; affiche la boîte de dialogue suivante :</para>
<varlistentry><term><guibutton>Revenir en arrière et arrêter</guibutton></term>
<listitem><para>Soustrait la durée d'inactivité à tous les compteurs actifs et les stoppent.</para><para>Vous ne travailliez pas sur la/les tâche(s) pendant que l'ordinateur était inactif et ce n'est toujours pas le cas.</para></listitem></varlistentry>
<varlistentry> <term><guibutton>Revenir en arrière et continuer</guibutton></term>
<listitem><para>Soustrait la durée d'inactivité à tous les compteurs actifs tout en les laissant actifs.</para><para>Vous ne travailliez pas sur la/les tâche(s) pendant que l'ordinateur était inactif mais vous reprenez là où vous vous êtes arrêté. </para></listitem></varlistentry>
<varlistentry> <term><guibutton>Continuer à chronométrer</guibutton></term>
<listitem><para>Ajoute la durée d'inactivité à tous les compteurs actifs tout en les laissant actifs.</para><para>Vous travailliez sur la/les tâche(s) pendant que l'ordinateur était inactif et c'est toujours le cas. </para></listitem></varlistentry> </variablelist>
<para>&karm; fournit trois manières de rapporter les durées que vous avez enregistrées. Vous pouvez envoyer à une imprimante les totaux globaux et de sessions, copier les totaux de durées dans le presse-papiers ou copier l'historique des durées dans le presse-papiers.</para>
<sect2><title>Imprimer les totaux</title>
<para>Pour imprimer un rapport sur les totaux, faites <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Imprimer</guimenuitem> </menuchoice>. Ceci génère un compte rendu sur trois colonnes pour la liste complète des tâches. La première colonne contient le nom de la tâche, la seconde colonne contient la <guilabel>Durée totale de la session</guilabel> et la troisième colonne, la <guilabel>Durée Totale</guilabel>.</para>
<sect2><title>Totaux pour le presse-papiers</title>
<para>Pour envoyer le rapport des totaux dans le presse-papiers, faites <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Copier les totaux dans le presse-papiers</guimenuitem> </menuchoice>. </para>
<para>Le rapport est généré pour la tâche actuellement sélectionnée ainsi que pour toutes ses sous-tâches. S'il s'agit d'une tâche principale, &karm; demandera si vous souhaitez obtenir un compte rendu pour la tâche actuelle et ses sous-tâches ou pour toute les tâches de la liste.</para>
<para>La première colonne contient la <guilabel>Durée totale</guilabel> et elle est indentée (tout comme les noms) pour indiquer les relations entre les tâches et sous-tâches. Les durées indiquées incluent celles des sous-tâches.</para>
<sect2><title>Historique pour le presse-papiers</title>
<para>Pour envoyer l'historique des totaux dans le presse-papiers, faites <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;&Alt;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Copier l'historique dans le presse-papiers</guimenuitem> </menuchoice>. </para>
<important><para>Vous devez activer l'option <guilabel>Historique</guilabel> dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer &karm;</guimenuitem> </menuchoice>. Autrement, &karm; ne comptabilise que les totaux et pas l'historique détaillé des tâches.</para></important>
<para>Le rapport est crée pour la tâche actuellement sélectionnée et toutes ses sous-tâches. Contrairement au rapport sur les totaux, celui-ci ne vous donne pas la possibilité d'avoir la liste complète des tâches. Vous pouvez seulement faire un rapport sur la tâche actuelle et ses sous-tâches.</para>
<para>La première chose que &karm; vous demande est de saisir une gamme de dates :</para>
<para>L'historique, groupé par semaine, inclut le total pour chaque jour et tâche. Les sept premières colonnes vont du lundi au dimanche. La huitième contient le total pour la semaine et la neuvième colonne, le nom de la tâche. Les noms sont indentés pour indiquer les relations entre les tâches et sous-tâches.</para>
<para>&karm;, comme KOrganizer et iCal d'Apple, utilise le format industriel standard <ulink url="http://developer.kde.org/documentation/standards/index.html">iCalendar</ulink> pour ses données. &karm; peut lire et écrire les listes générées par ces deux applications.</para>
<warning><para>Si &karm; et KOrganizer ont tous les deux le même fichier ouvert et que vous le modifiez avec KOrganizer, vous risquez de perdre des données. Par précaution, il vaut mieux modifier le fichier avec un seul de ces programmes.</para></warning>
<para>Une utilisation typique serait de planifier un projet avec l'outil de gestion de projets <ulink url="http://planner.imendio.org">Planner</ulink> et d'importer ses tâches dans &karm; pour les avoir au format industriel standard <ulink url="http://developer.kde.org/documentation/standards/index.html">iCalendar</ulink>. Après cela, vous pourrez programmer les tâches dans KOrganizer et compté le temps passé sur celle-ci avec &karm;. C'est une manière de s'assurer que votre projet sera dans les temps et ne dépassera pas le budget.</para>
<para>&DCOP; est un mécanisme utilisé par les programmes KDE pour communiquer entre eux. Un programme KDE fournit une liste de fonctions que les autres programmes (un script Bash, par exemple) peuvent utiliser.</para>
<para>L'interface &DCOP; de &karm; et actuellement utilisée principalement pour automatiser des tests, ce qui la rend plutôt limitée. Pour une définition complète de l'interface voyez l'annexe <link linkend="dcopappendix">Interface &DCOP;</link>.</para>
<sect2 id="csv-export"><title>Exporter les totaux dans un fichier CSV</title>
<para>&karm; peut exporter les totaux et l'historique dans un format de fichier dont les données sont séparées par des virgules. Pour exporter les totaux, faites <menuchoice> <guimenu>Fichier</guimenu> <guisubmenu>Importer / exporter</guisubmenu> <guimenuitem>Exporter dans un fichier CSV...</guimenuitem> </menuchoice> et &karm; affiche la boîte de dialogue d'exportation suivante :</para>
<para>Saisissez le fichier vers lequel vous souhaitez exporter les données, et modifiez les autres options si nécessaire. Notez que la gamme de dates n'est pas disponible puisque vous exportez les totaux de durées, pas l'historique. Cliquez sur <guibutton>Exporter</guibutton> afin que &karm; exporte les totaux de toutes les tâches.</para>
<para>Les tâches principales se trouvent dans la première colonne, les sous-tâches dans la seconde et ainsi de suite. Les durées s'affichent après la profondeur maximale de tâches (cinq dans cet exemple). La première colonne de temps contient la <guilabel>Durée de la session</guilabel>, la seconde : la <guilabel>Durée</guilabel>, la troisième : la <guilabel>Durée totale de la session</guilabel> et la quatrième : la <guilabel>Durée totale</guilabel>. </para>
<sect2 id="csv-export-history"><title>Exporter l'historique dans un fichier CSV</title>
<para>Pour exporter l'historique de la tâche, faites <menuchoice> <guimenu>Fichier</guimenu> <guisubmenu>Importer / exporter</guisubmenu> <guimenuitem>Exporter l'historique dans un fichier CSV...</guimenuitem> </menuchoice> et &karm; affiche la même boîte de dialogue d'exportation que ci-dessus.</para>
<para>Saisissez le fichier vers lequel vous souhaitez exporter les données, et sélectionnez une gamme de dates pour l'historique. Modifiez les autres options si nécessaire. Cliquez sur <guibutton>Exporter</guibutton> pour que &karm; exporte l'historique de toutes les tâches vers le fichier que vous avez sélectionné.</para>
<para>Voici un exemple de sortie de ce format :</para>
<para>Les trois premières lignes indiquent quand le rapport a été généré et pour quelle intervalle. La quatrième ligne contient une liste de dates de la gamme séparé par des virgules, au format ISO 8601 (AAAA-MM-JJ). Les autres lignes listent les durées de chaque tâche. La dernière colonne des nombres représente le total de tous les jours. Le nom de la tâche s'affiche après le total et le nombre de colonnes indique les relations entre les tâches et sous-tâches. Les tâches principales apparaissent dans la première colonne après le total.</para>
<para>La fenêtre principale de &karm; présente les composants suivants: barre de menus, barre d'outils, fenêtre de tâches et de durées et barre d'état.</para>
<para>Les différentes tâches sont affichées dans cette fenêtre, avec le temps accumulé pour chacune dans la session en cours et au total. Celles actuellement en cours ont une icône en forme d'horloge à côté de la durée de la session.</para>
<para>Des sous-tâches peuvent être créées pour chaque tâche. Un clic sur les signes plus et moins, affiche ou cache celles qui sont associées. La durée totale pour la tâche inclut les durées de ses sous-tâches, ainsi que sa propre durée.</para>
<term><menuchoice><guimenu>Fichier</guimenu> <guisubmenu>Importer / exporter</guisubmenu> <guimenuitem>Importer un ancien fichier plat...</guimenuitem> </menuchoice></term>
<term><menuchoice><guimenu>Fichier</guimenu> <guisubmenu>Importer / exporter</guisubmenu> <guimenuitem>Importer des tâches de Planner...</guimenuitem> </menuchoice></term>
<para><action>Importe</action> un projet de <ulink url="http://planner.imendio.org">Planner</ulink>. Toutes les tâches, sous-tâches et leurs états seront importés depuis le fichier. Vous pouvez les importer en tant que sous-tâches : créez en une, sélectionnez-la, puis importez. </para>
<menuchoice><guimenu>Fichier</guimenu> <guisubmenu>Importer / exporter</guisubmenu> <guimenuitem>Exporter dans un fichier CSV...</guimenuitem> </menuchoice></term>
<para><action>Exporte</action> la <guilabel>Durée totale de la session</guilabel>, la <guilabel>Durée de la session</guilabel>, la <guilabel>Durée</guilabel> et la <guilabel>Durée totale</guilabel> dans un fichier texte.</para>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Copier les totaux dans le presse-papiers</guimenuitem> </menuchoice></term>
<menuchoice><shortcut><keycap>&Echap;</keycap></shortcut> <guimenu>Chronomètre</guimenu> <guimenuitem>Arrêter tous les chronomètres</guimenuitem> </menuchoice>
<para><action>Modifie le nom ou la durée accumulée</action> pour la tâche courante</para><para>Il y a deux options pour modifier les durées: Modifier les valeurs absolues, les durées totale et de session peuvent être changées séparément, et Modifier les valeurs relatives qui ajoute ou soustrait un nombre dans les deux catégories à la fois (session et totale).</para><para>L'option de suivi automatique permet de démarrer et d'arrêter le chronomètre automatiquement lorsque vous changez de ou vers un bureau &kde; précis.</para>
<listitem><para><action>Ouvre</action> une boîte de dialogue pour configurer &karm;</para>
<para>La boîte de dialogue est divisée en trois catégories : <guilabel>Comportement</guilabel>, qui vous permet de spécifier un alerte en cas d'inactivité ainsi qu'un message d'alerte lorsque vous supprimez une tâche, <guilabel>Affichage</guilabel>, qui configure les champs à afficher dans la fenêtre principale et <guilabel>Stockage</guilabel>, qui paramètre l'emplacement du fichier d'enregistrement, si l'enregistrement se fait automatiquement et au bout de combien de temps.</para> </listitem>
<para>&karm; s'inspire de l'utilitaire de Harald Tveit Alvestrand nommé <application>titrax</application>, dont le seul défaut est d'être basé sur la boîte à outils Xt.</para>
<para>Copyright pour la documentation 2000-2004 Jonathan Singer <email>jsinger@leeta.net</email> et Sirtaj Singh Kang <email>taj@kde.org</email>.</para>
<glossdef><para>Le protocole de communication entre processus utilisé par KDE. Abréviation de Desktop COmmunication Protocol (Protocole de communication pour le bureau).</para></glossdef>
<glossdef><para>GNU/Linux, FreeBSD et les autres systèmes qui utilisent X-Windows ont plusieurs bureaux. En général, quatre bureaux sont accessibles par défaut. Chacun peut afficher ses propres programmes et fichiers. Au démarrage de KDE, le bureau que vous voyez s'appelle Bureau 1. Si vous faites <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>, vous verrez le Bureau 2. faites <keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo> pour revenir au Bureau 1. </para></glossdef> </glossentry>
<glossdef><para>Si &karm; est configuré pour conserver l'historique, il enregistrera tous les démarrages et arrêts des chronomètres. Cette historique n'est pas vider lorsque les compteurs sont réinitialisés et reste intact jusqu'à la suppression de la tâche.</para></glossdef>
<glossdef><para>Un point de départ défini par l'utilisateur pour les chronomètres de session. Une nouvelle session commence quand vous faites <menuchoice> <guimenu>Fichier</guimenu> <guimenuitem>Démarrer une nouvelle session</guimenuitem> </menuchoice>. Les données de la session ne sont pas enregistrées lorsque vous créez une nouvelle session. </para></glossdef> </glossentry>
<glossentry id="gloss-system-time"> <glossterm><guilabel>Durée de la session</guilabel></glossterm> <glossdef><para>Le temps passé sur la tâche depuis le début de la session.</para></glossdef> </glossentry>
<glossentry id="gloss-system-tray"> <glossterm>Boîte à miniatures</glossterm>
<glossdef><para>La boîte à miniatures est dans la barre qui apparaît (par défaut) en bas de l'écran. Dans cette boîte <inlinemediaobject> <imageobject> <imagedata fileref="systray.png" format="PNG"/></imageobject> </inlinemediaobject> la miniature de &karm; se trouve complètement à droite.</para></glossdef>
<glossentry id="gloss-total-session-time"> <glossterm><guilabel>Durée totale de la session</guilabel></glossterm> <glossdef><para>Le temps passé sur la tâche et toutes ses sous-tâches depuis le début de la session.</para></glossdef> </glossentry>
<glossdef><para>Le temps passé sur la tâche et toutes ses sous-tâches depuis la réinitialisation de tous les compteurs.</para></glossdef> </glossentry>
<para><function>version()</function> est un appel &DCOP; qui renvoi le numéro de version de &karm; : par exemple 1.5.0. Ce numéro est renvoyé en tant que chaîne dans le format GNU habituel : majeure.mineure.correction.</para>
<para><function>hastodo(TQString nom_de_la_tâche)</function> est un appel &DCOP; qui recherche une tâche portant un nom précis. Si ce nom est trouvé, un UID iCalendar est renvoyé pour identifier cette tâche. Sinon, une chaîne vide est renvoyée. </para>
<para>C'est dans le fichier iCalendar utilisé actuellement par &karm; que la recherche est faites. Elle porte sur toute l'arborescence, pas seulement sur les tâches principales. Si plusieurs tâches correspondent, c'est la première trouvée qui est renvoyée.</para>
<para><function>addtodo(TQString tâche_à_faire)</function> est un appel &DCOP; qui ajoute une tâche principale au fichier en cours d'utilisation. L'UID de la nouvelle tâche est renvoyé. </para>
