<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY karm"<application>KArm</application>">
  <!ENTITY kappname "&karm;" -- this only *seems* redundant -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % German "INCLUDE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>

<book lang="&language;">


<bookinfo>
<title>Das &karm;-Handbuch</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>Gegengelesen von</contrib>
<affiliation><address><email>vampyr@atconnex.net</email></address></affiliation>
</othercredit>

<othercredit role="translator">
<firstname>Gregor</firstname>
<surname>Zumstein</surname>
<contrib>Deutsche &Uuml;bersetzung</contrib>
<affiliation><address><email>zumstein@ssd.ethz.ch</email></address></affiliation>
</othercredit>

</authorgroup>

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

<legalnotice>&FDLNotice;</legalnotice>

<date>14/12/2000</date>
<releaseinfo>1.00.00</releaseinfo>

<abstract>
<para>&karm; misst die Zeit, die f&uuml;r verschiedene laufende Aufgaben 
ben&ouml;tigt wird.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>karm</keyword>
<keyword>kdeutils</keyword>
<keyword>zeit</keyword>
<keyword>verfolger</keyword>
<keyword>projekt</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Einleitung</title>

<para>&karm; misst die Zeit, die f&uuml;r verschiedene Aufgaben
aufgewendet wird. Das Programm ist n&uuml;tzlich, wenn die f&uuml;r
verschiedene Kunden aufgewendeten Stunden verrechnet werden m&uuml;ssen
oder einfach nur, wenn Sie wissen m&ouml;chten, wieviele Stunden am Tag Sie
Doom spielen oder den Heise-Newsticker lesen. </para>

<para>&karm; wurde von Sirtaj Singh Kang geschrieben und bedeutet in
seiner Muttersprache Pandschabi "Arbeit".</para>

</chapter>


<chapter id="using-Karm">
<title>Wie benutze ich &karm;</title>

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

<para>Geben Sie <userinput><command>karm</command></userinput> an der Befehlszeile ein oder 
w&auml;hlen Sie
<guimenuitem>Pers&ouml;nlicher Zeiterfassung</guimenuitem> aus der Gruppe
<guisubmenu>Dienstprogramme</guisubmenu> im <guimenu>KDE Startmen&uuml;
</guimenu>. Die Standard-Befehlszeilenoptionen von Qt und KDE sind
verf&uuml;gbar und k&ouml;nnen mit dem Befehl <command>karm
<option>--help</option></command> auf der Befehlszeile abgefragt
werden.</para>

</sect1>

<sect1 id="general-use">
<title>Allgemeine Vorgehensweise beim Gebrauch von &karm;</title>

<para>Geben Sie die verschiedenen Aufgaben ein, die Sie verfolgen 
m&ouml;chten.</para>
<para>Um die Zeitmessung f&uuml;r eine Aufgabe zu starten, machen Sie einen Doppelklick auf die Aufgabe, w&auml;hlen Sie <guimenuitem>Start</guimenuitem> aus dem <guimenu>Stoppuhr</guimenu>-Men&uuml; oder dr&uuml;cken Sie das <guiicon>Start</guiicon>-Symbol in der Werkzeugleiste. Wiederholen Sie diesen Vorgang, um die Zeitmessung zu beenden.
</para>
<para>Es k&ouml;nnen mehrere Aufgaben gleichzeitig gemessen werden.</para>
<para>Aufgaben k&ouml;nnen beim Beenden von &karm; gespeichert und beim 
n&auml;chsten Gebrauch automatisch wieder geladen werden.</para>

</sect1>

</chapter>

<chapter id="interface">
<title>Die Benutzeroberfl&auml;che von  &karm; </title>

<para>Das Hauptfenster von &karm; besteht aus den folgenden Komponenten:
Men&uuml;leiste, Werkzeugleiste, Zeit/Aufgaben-Fenster und
Statusleiste.</para>

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

<sect1 id="main-window">
<title>Das Zeit/Aufgaben-Fenster</title>

<para>Hier werden die verschiedenen Aufgaben angezeigt inklusive der mit dieser Aufgabe verbrachten Zeit (aktuelle Sitzung und total). Aufgaben, die gemessen werden, haben ein kleines Symbol in der Spalte Sitzungszeit.</para>
<para>
Für jede Aufgabe k&ouml;nnen Unteraufgaben erstellt werden. Ein Doppelklick auf eine Aufgabe zeigt alle Teilaufgaben an, ein weiterer Doppelklick verbirgt alle. Die Gesamtzeit einer Aufgabe setzt sich zusammen aus der Zeit aller Teilaufgaben und der eigenen Zeit.
</para> </sect1>

<sect1 id="menus">
<title>Die &karm; Men&uuml;zeile</title>
<sect2>
<title>Das <guimenu>Datei</guimenu>-Men&uuml;</title>

<variablelist>
<varlistentry>
<term>
<menuchoice><shortcut>
<keycombo action="simul"><keycap>Strg</keycap><keycap>S</keycap></keycombo>
</shortcut>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>S<accel>p</accel>eichern</guimenuitem>
</menuchoice></term>
<listitem><para><action>Speichert die aktuellen Aufgaben und Teilaufgaben mitsamt allen Zeitangaben.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Strg</keycap><keycap>D</keycap></keycombo>
</shortcut>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem><accel>D</accel>rucken</guimenuitem>
</menuchoice></term>
<listitem><para><action>Druckt</action> das &karm;-Fenster.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Strg</keycap><keycap>R</keycap></keycombo>
</shortcut>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>Sitzungszeit zu<accel>r</accel>&uuml;cksetzen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Die an dieser Aufgabe verbrachte Zeit wird auf Null 
zur&uuml;ckgesetzt.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Strg</keycap><keycap>Q</keycap></keycombo>
</shortcut>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>B<accel>e</accel>enden</guimenuitem>
</menuchoice></term>
<listitem><para><action>Beendet</action> &karm;.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>Das <guimenu>Stoppuhr</guimenu>-Men&uuml;</title>

<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Strg</keycap><keycap>S</keycap></keycombo>
</shortcut>
<guimenu><accel>S</accel>toppuhr</guimenu>
<guimenuitem>S<accel>t</accel>art</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>Startet</action> die Zeitmessung f&uuml;r die ausgew&auml;hlte Aufgabe.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Strg</keycap><keycap>T</keycap></keycombo>
</shortcut>
<guimenu><accel>S</accel>toppuhr</guimenu>
<guimenuitem><accel>S</accel>topp</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>H&auml;lt</action> die Zeitmessung f&uuml;r die ausgew&auml;hlte Aufgabe an.</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>Das <guimenu>Aufgaben</guimenu>-Men&uuml;</title>

<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Strg</keycap><keycap>N</keycap></keycombo>
</shortcut>
<guimenu><accel>A</accel>ufgabe</guimenu>
<guimenuitem><accel>N</accel>eu</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>F&uuml;gt</action> eine neue Aufgabe
hinzu.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Strg</keycap> <keycap>Alt</keycap> <keycap>N</keycap></keycombo>
</shortcut>
<guimenu><accel>A</accel>ufgabe</guimenu>
<guimenuitem>Neue <accel>T</accel>eilaufgabe</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>F&uuml;gt</action> eine neue Teilaufgabe zur ausgew&auml;hlten Aufgabe hinzu.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycap>Entf</keycap>
</shortcut>
<guimenu><accel>A</accel>ufgabe</guimenu>
<guimenuitem><accel>L</accel>&ouml;schen</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>L&ouml;scht</action> die ausgew&auml;hlte Aufgabe oder Teilaufgabe.</para></listitem> </varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Strg</keycap><keycap>E</keycap></keycombo>
</shortcut>
<guimenu><accel>A</accel>ufgabe</guimenu>
<guimenuitem><accel>B</accel>earbeiten</guimenuitem>
</menuchoice>
</term>
<listitem><para>Den Namen oder die aufgelaufene Zeit f&uuml;r die
ausgew&auml;hlte Aufgabe <action>&auml;ndern.</action></para>
<para>Es gibt zwei M&ouml;glichkeiten, die Zeit zu &auml;ndern: Absolut, womit die  Sitzungs- oder Gesamtzeit einer Aufgabe gesetzt wird oder aber relativ, womit ein bestimmter Zeitbetrag von Sitzungs- oder Gesamtzeit abgezogen oder ihr hinzugef&uuml;gt werden kann.</para>
</listitem>
</varlistentry> </variablelist>
</sect2>

<sect2>
<title>Das <guimenu>Einstellungen</guimenu>-Men&uuml;</title>
<variablelist>
<varlistentry>
<term>
<menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu>
<guimenuitem><accel>T</accel>astenzuordnungen vornehmen...</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>&Ouml;ffnet</action> einen Dialog, wo die Tastaturk&uuml;rzel vom Benutzer definiert werden k&ouml;nnen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu>
<guimenuitem>Pers&ouml;nliche <accel>E</accel>instellungen...</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>&Ouml;ffnet</action> einen Dialog, wo &karm; konfiguriert werden kann.</para>
<para>Der Dialog hat zwei Karteikarten. "<guilabel>Speichern</guilabel>": Dort wird der Ort, wo die Daten gespeichert werden festgehalten, dar&uuml;ber hinaus, ob die Aufgaben automatisch gespeichert werden sollen und wenn ja, wie oft. Die zweite Karteikarte "<guilabel>Unt&auml;tigkeit feststellen</guilabel>", schaltet das Entdecken von Unt&auml;tigkeit ein oder aus. Wenn diese Einstellung gew&auml;hlt ist, so wird nach einer bestimmten Zeit der Unt&auml;tigkeit ein Dialogfenster zur Warnung ge&ouml;ffnet.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>Das <guimenu>Hilfe</guimenu>-Men&uuml;</title>
<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut><keycap>F1</keycap></shortcut>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem><accel>I</accel>nhalt</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>Zeigt</action> dieses Dokument an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Umschalt</keycap><keycap>F1</keycap></keycombo></shortcut>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem>Was ist <accel>d</accel>as?</guimenuitem>
</menuchoice>
</term>
<listitem><para>Klicken Sie auf ein GUI-Element, um mehr dar&uuml;ber zu
erfahren.</para> </listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem>Be<accel>r</accel>ichten Sie &uuml;ber Probleme und W&uuml;nsche</guimenuitem>
</menuchoice>
</term>
<listitem><para>Ein einfacher Dialog, um Fehler und
Erweiterungsw&uuml;nsche f&uuml;r &karm; mitzuteilen.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem>&Uuml;<accel>b</accel>er KArm</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>Zeigt Informationen zu
&karm; an</action></para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem>&Uuml;ber <accel>K</accel>DE</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>Zeigt Informationen zu KDE an.</action></para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

</sect1>

<sect1 id="tool-bar">
<title>Die Werkzeugleiste</title>
<para>Die Werkzeugleiste enth&auml;lt Symbole f&uuml;r die folgenden Befehle:</para>

<note><para>(Alle verhalten sich genau gleich wie die Men&uuml;befehle)</para></note>

<itemizedlist>
<listitem><para><guiicon>Start</guiicon></para></listitem>
<listitem><para><guiicon>Stopp</guiicon></para></listitem>
<listitem><para><guiicon>Neu</guiicon></para></listitem>
<listitem><para><guiicon>Neue Teilaufgabe</guiicon></para></listitem>
<listitem><para><guiicon>L&ouml;schen</guiicon></para></listitem>
<listitem><para><guiicon>Bearbeiten</guiicon></para></listitem>
</itemizedlist>

</sect1>

<sect1 id="status-bar">
<title>Die Statusleiste</title>

<para>Zeigt die in dieser Sitzung verbrachte Zeit an.</para> </sect1>

</chapter>

<chapter id="credits">

<title>Danksagung und Lizenz</title>

<para>
&karm;
</para>
<para>
Copyright 1997-2000 Sirtaj Singh Kang <email>taj@kde.org</email>.</para>

<para>Beitr&auml;ge von:</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>
</itemizedlist>

<para>&karm; wurde von Harald Tveit Alvestrands n&uuml;tzlichem Werkzeug
<application>Titrax</application> inspiriert, dessen einziger Mangel das
verwendete Xt-Toolkit ist. </para>

<para>Copyright f&uuml;r die Dokumentation 2000 Jonathan Singer 
<email>jsinger@leeta.net</email>
und Sirtaj Singh Kang <email>taj@kde.org</email>.</para>

&underFDL;
&underGPL;
</chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-kapp">
<title>Woher Sie &karm; erhalten</title>

<para>&karm; ist Teil des kdeutils-Pakets und sollte wie im
Hauptverzeichnis des Pakets beschrieben kompiliert und installiert
werden. Neue Versionen von kdeutils finden Sie auf der Seite <ulink
url="ftp://ftp.kde.org/pub/kde">ftp://ftp.kde.org/pub/kde/</ulink>.
</para>

<para>&karm; installieren Sie wie folgt:</para>

<screen><userinput><command>cd <filename class="directory">kdeutils/karm</filename></command></userinput>
<userinput><command>./configure</command></userinput>
<userinput><command>make</command></userinput>
<userinput><command>su</command></userinput>
<userinput><command>make install</command></userinput>
</screen>

</sect1>

</appendix>

<![ %addindex; [ &kdedocindex; ]]>
</book>

