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

<book lang="&language;">

<bookinfo>
<title
>&karm;-håndbogen</title>

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

<author
><firstname
>Mark</firstname
> <surname
>Bucciarelli</surname
> <affiliation
> <address
><email
>mark@hubcapconsulting.com</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
>Tester</contrib>
<affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
</othercredit>
&erik.kjaer.pedersen.role; 
</authorgroup>

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

<copyright>
<year
>2004-2005</year>
<holder
>Mark Bucciarelli</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2005-02-02</date>
<releaseinfo
>1.5.0</releaseinfo>

<abstract
><para
>&karm; holder øje med tiden der bruges til forskellige opgaver.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>karm</keyword>
<keyword
>kdeutils</keyword>
<keyword
>tid</keyword>
<keyword
>sporer</keyword>
<keyword
>projekt</keyword>
</keywordset>

</bookinfo>

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

<para
>&karm; holder øje med tiden som bruges til forskellige opgaver. Den er nyttig til at huske timer som skal beregnes for forskellige kunder pr opgave og pr dag.</para>

<para
>denne tidshistorik kan eksporteres til en komma-adskilt tekstfil til import i andre regnings- og/eller projekthåndteringsværktøjer.</para>

<para
>&karm; detekterer hvornør dit tastatur og mus er i tomgang og kan tilknytte forskellige opgaver til forskellige desktoppe, to værktøjer der kan hjælpe med at holde tidsmåleren kørende på den rigtige opgave.</para>

<para
>&karm; er oprindelig skrevet af Sirtaj Singh Kang. Ordet <quote
>karm</quote
> betyder <quote
>arbejde</quote
> eller <quote
>dåd</quote
> på forfatterens modersmål Punjabi og det er det samme ord (men en bedre transliteration) som <quote
>karma</quote
>.</para>

</chapter>


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

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

<para
>Skriv <command
>karm</command
> på kommandolinjen eller vælg <guimenuitem
>Personlig tidsmåler</guimenuitem
> fra gruppen <guisubmenu
>Værktøj</guisubmenu
> i <guimenu
>KDE's startmenu</guimenu
>. De almindelige &Qt;- og &kde;-kommandoflag er tilgængelige, og kan ses på en liste ved at skrive <userinput
><command
>karm</command
> <option
>--help</option
></userinput
> på kommandolinjen.</para>

<para
>&karm; sørger for yderligere et kommandolinjeflag som lader dig angive navnet på den ICalendar-fil som bruges til at opbevare din arbejdshistorik. Du indskriver en fjernkalenderfil ved at bruge http eller ftp som en del af filnavnet, for eksempel http://www.min_arbejdsplads.dk/mine_data/mit_arbejde.ics.</para>

</sect1>

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

<informalexample>
<para
><emphasis
>Problem:</emphasis
> Du er en konsulent for fri software med mange klienter. Nogle klienter har flere projekter. I løbet af en dag, skifter du frem og tilbage mellem forskellige projekter. Du har brug for at holde styre den tid du bruger for at kunne generere månedlige regninger.</para>
<para
><emphasis
>Løsning:</emphasis
>Lav én opgave på øverste niveau for hver kunde og en underopgave for hver af kundens projekter. For projekter der kræver mere detaljeret forfølgning, lav en liste af underopgaver for projektet. Følg tiden ved at dobbeltklikke på den opgave du arbejder på for øjeblikket.</para>
</informalexample>

<para
>&karm; giver stor fleksibilitet i at følge din tid, tillader ubegrænsede opgaver og opgavedybde. Tiden kan følges til enhver opgave, og mere end en opgave kan være aktiv på et giver tidspunkt.</para>

<para
>For at lave en opgave på øverste niveau vælges <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Ny</guimenuitem
> </menuchoice
>. For at lave en underopgave vælges opgaven og så bruges <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Ny underopgave</guimenuitem
> </menuchoice
> </para>

<para
>Når &karm; afslutter, bliver opgavelisten gemt til den fil der er angivet i <menuchoice
> <guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil KArm</guimenuitem
> </menuchoice
>. Når den åbnes næste gang, genindlæser den opgavelisten fra den samme fil.</para>

<para
>&karm; kan importere og eksportere opgaver for at minimere arbejdet. Se <link linkend="interfaces"
>Andre systemer</link
>.</para>

</sect1>

<sect1 id="timers"
><title
>Tidsmålere</title>

<informalexample>
<para
><emphasis
>Problem:</emphasis
> For ikke at gå fallit, må du udsende gennemsnitligt en regning for fem af dagens timer. For at styre dette overvåger du dine daglige og ugentlige timer i alt.</para>
<para
><emphasis
>Løsning:</emphasis
> Nulstil sessionsmåleren i begyndelsen af hver arbejdsdag og nulstil alle tidsmålere i begyndelsen af hver uge.</para
> </informalexample>

<para
>&karm; gør det nemt at følge tiden. For at starte med at logge tiden mod en opgave, dobbeltklikkes på opgaven. For at holde opmed at logge tiden, dobbeltklikkes på opgaven igen. Aktive opgaver viser et lille ur i søjlen <guilabel
>Sessionstid</guilabel
>.</para>
	
<para
>En anden visuel indikation af at aktiviteten logges er &karm;'s statusikon. Når en opgave er aktiv, bevæger minutviseren i ikonen sig. Hvis du lader musemarkøren  hvile over denne ikon, vil navnet på den aktive opgave blive vist som et værktøjsvink. Hvis mere end en opgave er aktiv, vil opgavernes navne i værktøjsvinket være adskilt af kommaer.</para>

<para
>&karm; vedligeholder to tidsmålere for hver opgave: en for sessionstiden og en for den totale tid. I standardindstillingen viser &karm; to søjler for hver tidsmåler, resulterende i at der er fire søjler i alt for hver opgave:</para>

<variablelist>
<varlistentry
> <term
><guilabel
>Sessionstid</guilabel
></term>
<listitem
><para
>Tiden brugt på opgaven siden sidste session begyndte.</para
></listitem
> </varlistentry
> 

<varlistentry
> <term
><guilabel
>Sessionstid i alt</guilabel
></term>
<listitem
><para
>Tiden brugt på opgaven og alle dens underopgaver siden sidste session begyndte.</para
></listitem
> </varlistentry
> 
<varlistentry
> <term
><guilabel
>Tid</guilabel
></term
> <listitem
><para
>Tiden brugt på opgaven siden alle tider blev nulstillet.</para
></listitem>
</varlistentry
> 

<varlistentry
> <term
><guilabel
>Tid i alt</guilabel
></term>
<listitem
><para
>Tiden brugt på opgaven og dens underopgaver siden alle tider blev nulstillet.</para
></listitem
> </varlistentry
> 
</variablelist>

<para
>For at starte en ny session, vælges <menuchoice
> <guimenu
>Fil</guimenu
> <guimenuitem
>Start ny session</guimenuitem
> </menuchoice
> </para>

<para
>For at nulstille alle tider vælges <guimenu
>Fil</guimenu
> <guimenuitem
>Nulstil alle tider</guimenuitem
> </para>

<sect2
><title
>Følgning af desktop</title>

<informalexample>
<para
><emphasis
>Problem:</emphasis
> Du har to hovedprojekter som du skifter imellem hver dag. For athjælpemed at organisere dit arbejde, har du dine filer for projekt 1 på desktop 1 og for projekt 2 på desktop 2.</para>

<para
><emphasis
>Løsning:</emphasis
> Tilknyt projekt 1's opgave med desktop 1 og projekt 2 med desktop 2. Når du skifter fra desktop 2 til desktop 1, stopper &karm; automatisk projekt 2 opgaven og starter projekt 1 opgaven.</para>
</informalexample>

<para
>For at knytte en opgave til en eller flere desktoppe, vælges <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Redigér</guimenuitem
> </menuchoice
>. Slå <guilabel
>Auto-sporing</guilabel
> til og vælg den desktop eller de desktoppe der skal knyttes til denne opgave. Når en af de valgte  desktoppe bliver aktive, vil &karm; automatisk, efter en kort ventetid, begynde at logge tiden mod denne opgave.</para>

</sect2>

<sect2
><title
>Tomgangsdetektion</title>

<informalexample
> <para
><emphasis
>Problem:</emphasis
> Du forlader dit arbejde tidligt fredag fordi du har et ærinde og glemmer at standse tidsmåleren. Når du vender tilbage mandag, kører tidsmåleren stadigvæk.</para>
<para
><emphasis
>Løsning:</emphasis
> Slå tomgangsdetektion til.</para>
</informalexample>

<para
>&karm; kan indstilles til at detektere hvornår  mus og tastatur er i tomgang. Hvis musen og tastaturet ikke bliver brugt længere end et angivet antal minutter, viser &karm; følgende dialog:</para>

<screenshot>
 <screeninfo
>&karm; tomgangsdetektion</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="idle-detect.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>&karm; dialog for tomgangsdetektion</phrase>
          </textobject>
        </mediaobject>
</screenshot>

<variablelist>
<varlistentry
><term
><guibutton
>Vend tilbage &amp; stop</guibutton
></term>
<listitem
><para
>Træk tomgangstiden fra fra alle aktive tidsmålere og stop dem.</para
><para
>Du arbejdede ikke på opgaverne mens din computer var i tomgang og du gør det stadigvæk ikke.</para
></listitem
></varlistentry
> 

<varlistentry
> <term
><guibutton
>Vend tilbage og &amp; fortsæt</guibutton
></term>
<listitem
><para
>Træk den tomgangstiden fra alle aktive tidsmålere men hold em kørende.</para
><para
>Du arbejdede ikke på opgaverne mens din computer var i tomgang men du gør det nu. </para
></listitem
></varlistentry
> 

<varlistentry
> <term
><guibutton
>Fortsæt med at tage tid</guibutton
></term>
<listitem
><para
>Anvend tomgangstiden på alle aktive tidsmålere og hold dem kørende.</para
><para
>Du arbejdede på opgaverne mens din computer var i tomgang og du gør det stadigvæk. </para
></listitem
></varlistentry
> </variablelist>

</sect2>

</sect1>

<sect1 id="reporting"
><title
>Rapportering</title>

<para
>&karm; giver dig tre måder at rapportere den tid du har logget. Du kan sende summer for session og tid til printeren, kopiere tidssummer til klippebordet, eller kopiere tidshistorikken til klippebordet.</para>

<sect2
><title
>Udskriv totalsummer</title>
<para
>For at generere sumrapporter til printeren, vælges <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Udskriv</guimenuitem
> </menuchoice
>. Dette genererer en tre-søjle-rapport for den fuldstændige liste af opgaver. Den første søjle er opgavens navn, den anden søjle er  <guilabel
>Sessionstid i alt</guilabel
> og dne tredje søjle er <guilabel
>Tid i alt</guilabel
>.</para>
</sect2>

<sect2
><title
>Udklip summer</title>
<para
>For at generere totalrapport til klippebordet vælges <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Kopiér totalsummer til klippebordet</guimenuitem
> </menuchoice
>. </para>

<para
>Denne rapport bliver genereret for den opgave der er valgt nu og alle dens underopgaver. Hvis den nuværende opgave er på det øverste niveau, spørger &karm; dig om du ønsker at generere  rapporten for denne opgaver og dens underopgaver eller for hele opgavelisten.</para>

<screenshot>
<screeninfo
>&karm; Kopiér denne opgave</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="copy-this-task.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>&karm;-dialogen Kopiér denne opgave</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Når rapporten er genereret, åbnes KEdit eller en anden teksteditor og rapportens data indsættes.</para>

<literallayout
><computeroutput>
Opgavesummer
2004-07-10 02:26

  Tid    Opgave
----------------------------------------------
  9:14    kde
   9:14    karm
    1:08    fejl
    0:00    tjek ændringer ind
   0:00    promo
   0:00    net ting
----------------------------------------------
  9:14 I alt
</computeroutput
>
</literallayout>

<para
>Den første søjle er <guilabel
>Tid i alt</guilabel
> og den er indrykket (ligesom opgavens navn) for at indikere opgave/underopgave-forhold. De rapporterede tider inkluderer tider for underopgaver.</para
> 

</sect2>

<sect2
><title
>Udklipshistorik</title>

<para
>For at generere totalrapporter til klippebordet vælges <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>C</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Kopiér historik til klippebord</guimenuitem
>  </menuchoice
>. </para>

<important
><para
>Du skal slå tilvalget <guilabel
>Log historik</guilabel
> til i <menuchoice
> <guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil KArm</guimenuitem
> </menuchoice
>. Ellers holder &karm; kun styr på summer og ikke den detaljerede opgavehistorik.</para
></important>

<para
>Denne rapport bliver genereret for den nuværende opgave og alle dens underopgaver. I modsætning til sum-rapporter, giver denne rapport dig ikkemuligheden for at rapportere om den fuldstændige opgaveliste. Du kan kun rapport den nuværende opgave og alle dens underopgaver.</para>

<para
>Når du vælger historikrapporten, beder &karm; dig først om at indtaste  datoområdet for rapporten:</para>

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

<para
>Efter at have indtastet et datoområde, åbnes KEdit eller en anden teksteditor og rapportens data indsættes.</para>

<literallayout
><computeroutput>
Opgavehistorik
Fra torsdag den 1. juli, 2004 til mandag den 12. juli, 2004
Udskrevet: 2004-07-12 17:18

                               Ugen for mandag den 5. juli, 2004
     5     6     7     8     9    10    11
-------------------------------------------------------------------------
                                             0:00 kde
                                             0:00  dc
              !:22  1:46  3:14  1:44         8:06  karm
                                             0:00   3.2 egenskabsplan
              1:08                           1:08   fejl
                                             0:00   tjek ændringer ind
                                             0:00  promo
                                             0:00  net ting
-------------------------------------------------------------------------
              2:30  1:46  3:14  1:44         9:14 I alt
</computeroutput
>
</literallayout>

<para
>Opgavehistorikken bliver summet op for hver dag og opgave, grupperet efter uge. De første syv søjler er mandag til søndag. Den ottende søjle er ugen i alt og den niende er opgavens navn. Opgavenavnene bliver indrykket for at indikere opgave/underopgave-forhold.</para>

</sect2>
</sect1>

<sect1 id="interfaces">
<title
>Andre systemer</title>
<sect2 id="korganizer"
><title
>KOrganizer</title>

<para
>&karm;, såvelsom KOrganizer og Apple's iCal, bruger industristandarden <ulink url="http://developer.kde.org/documentation/standards/index.html"
>iCalendar</ulink
>-formatet til sine data. &karm; kan læse og skrive gøremålslister der er lavet af disse to programmer.</para>

<warning
><para
>Hvis både &karm; og KOrganizer har åbnet den samme fil, og du redigerer filen med KOrganizer, risikerer du at miste data. For at være på den sikre side bør du kun redigere filen enten med det ene program, eller med det andet.</para
></warning>

</sect2>

<sect2 id="planner"
><title
>Planner</title>

<para
>Som et typisk brugertilfælde, kunne du ville planlægge et projekt med projekthåndteringsværktøjet Imendio Planner (fra <ulink url="http://planner.imendio.org"
>planner.imendio.org</ulink
>) og importere dets aktiviteter til &karm;, for at få dem på industristandard-formatet <ulink url="http://developer.kde.org/documentation/standards/index.html"
> iCalendar</ulink
>. Når du har gjort det kan du skemalægge aktiviteterne i Korganizer og holde styr på tiden du arbejder med dem i &karm;. Dette er en måde at kontrollere om projektet holder sig indenfor budget- og tidsrammerne.</para>

</sect2>

<sect2 id="dcop"
><title
>&DCOP;</title>

<para
>&DCOP; er mekanismen som KDE-programmer bruger til at kommunikere med hinanden. Et KDE-program sørger for en liste med funktioner som andre programmer (for eksempel et Bash-script) kan bruge.</para>

<example
><title
>Bash-script som ekkoer &karm;s version</title>
<programlisting
>DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                VERS=`dcop $DCOPID KarmDCOPIface version`
                echo "&karm; version er $VERS"
        else
                echo "&karm; kører ikke"
        fi
</programlisting>
</example>

<para
>&karm;s nuværende &DCOP;-grænseflade bruges for øjeblikket i hovedsagen til automatiserede tester, så det er meget begrænset. For den fuldstændige definitionen af grænsefladen, se appendix <link linkend="dcopappendix"
>&DCOP;-grænseflade</link
>.</para>

<para
>For at se den fuldstændige &DCOP;-grænseflade for versionen af &karm; som er installeret på dit system, kør følgende Bash-script.</para>

<example
><title
>Vis liste med &karm;s &DCOP;-grænseflade på terminalen</title>
<programlisting
>DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                dcop $DCOPID KarmDCOPIface
        else
                echo "&karm; kører ikke"
        fi
</programlisting>
</example>
</sect2>

<sect2 id="csv-export"
><title
>Eksportér totalsummer til CSV</title>

<para
>&karm; kan både eksportere totalsummer og historik til et komma-adskilt filformat. For at eksportere totalsummer, vælges <menuchoice
> <guimenu
>Fil</guimenu
> <guisubmenu
>Import/Eksport</guisubmenu
> <guimenuitem
>Eksport til CSV-fil...</guimenuitem
> </menuchoice
> så vil &karm; vise følgende eksportdialog:</para>

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

<para
>Indtast den fil du gerne vil eksportere data til, og ændre den anden  dialogs forvalg om nødvendigt. Bemærk at datoområdets kontrol er deaktiveret idet du eksporterer totalsummer angående tid, ikke historikdata. Klik på <guibutton
>Eksportér</guibutton
> så vil &karm; eksportere totalsummer for alle opgaver til den fil du valgte.</para>

<para
>Her er et eksempel på uddataformatet:</para>

<literallayout
><computeroutput>
"kde",,,,,0.00,0.00,6.88,9.83
,"karm",,,,6.88,8.70,6.88,9.83
,,"3.2 plan over egenskaber",,,0.00,0.00,0.00,0.00
,,"fejl",,,0.00,1.13,0.00,1.13
,,"tjek ændringer ind - oversættelsesstrenge",,,0.00,0.00,0.00,0.00
,,"rapport over tidskort",,,0.00,0.00,0.00,0.00
,"kopete",,,,0.00,0.00,0.00,0.00
,"promo",,,,0.00,0.00,0.00,0.00
,"netting",,,,0.00,0.00,0.00,0.00
</computeroutput
>
</literallayout>

<para
>Opgaver på top-niveau skrives i første søjle, underopgaver i anden og så videre. Tidsdata skrives efter den maksimale opgavedybde (fem i dette eksempel). Den første tidssøjle er <guilabel
>Sessionstid</guilabel
>, den anden <guilabel
>Tid</guilabel
>, den tredje er <guilabel
>Sessionstid i alt</guilabel
> og den fjerde er  <guilabel
>Tid i alt</guilabel
>. </para>


</sect2>

<sect2 id="csv-export-history"
><title
>Eksportér historik til CSV</title>

<para
>For at eksportere opgavehistorikken vælges <menuchoice
> <guimenu
>Fil</guimenu
> <guisubmenu
>Importér/Eksportér</guisubmenu
> <guimenuitem
>Eksportér historik til CSV-fil...</guimenuitem
> </menuchoice
> og &karm; viser så den samme eksportdialog som vist ovenfor.</para>

<para
>Indtast den fil du gerne vil eksportere data til, og vælg det datoområde som du ønsker for opgavehistorikken. Ændr de andre forvalg i dialogen om nødvendigt. Klik på <guibutton
>Eksportér</guibutton
> så vil &karm; eksportere opgavehistorikken for alle opgaver til den fil du valgte.</para>

<para
>Her er et eksempel på uddataformatet:</para>

<literallayout
><computeroutput>
Opgavehistorik
Fra tirsdag den 6. juli, 2004 til tirsdag den 13. juli, 2004
Udskrevet den: 2004-07-13 18:10
2004-07-06,2004-07-07,2004-07-08,2004-07-09,2004-07-10,2004-07-11,2004-07-12,2004-07-13,
,,,,,,,,0.00,"kde"
,,1.77,3.23,1.73,,1.37,0.82,8.95,,"karm"
,,,,,,,,0.00,,,"3.2 plan over egenskaber"
,1.13,,,,,,,1.13,,,"fejl"
,,,,,,,,0.00,,,"tjek ændringer ind -oversættelsesstrenge"
,,,,,,,,0.00,,,"rapport over tidskort"
,,,,,,,,0.00,,"kopete"
,,,,,,,,0.00,,"promo"
,,,,,,,,0.00,,"netting"
</computeroutput
>
</literallayout>

<para
>De tre linjer identificerer hvornår rapporten blev genereret og for hvilket datoområde. Den fjerde række er en komma-afgrænset liste af datoerne i datoområdet, i ISO 8601 format (ÅÅÅÅ-MM-DD). Alle efterfølgende rækker er en liste af tiden logget mod hver opgave. Den sidste numeriske søjle er rækkesummen henover alle dage. Opgavens navn udskrives efter total-søjlen, og indrykkes for at  indikere opgavek/underopgave-forholdet. Navne på opgaver på øverste niveau ses i første søjle efter totalsummen.</para>

</sect2>
</sect1>

</chapter>

<chapter id="interface">
<title
>&karm;s grænseflade</title>

<para
>Hovedvinduet for &karm; har følgende dele: menulinje, værktøjslinje, opgave/tidsvindue og en statuslinje.</para>

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

<sect1 id="main-window">
<title
>Opgave/tidsvinduet</title>

<para
>De forskellige opgaver vises i dette vindue, sammen med tiden som er gået for hver i den nuværende session og i alt. Opgaver som tidsmåless har et lille ur ved siden af sessionstiden.</para>

<para
>Underopgaver kan laves for hver opgave. Klik på plus-tegnet eller minus-tegnet foran hovedopgaven skifter visningen af de tilknyttede underopgaver. Den totale tid som gået med en opgave indeholder tiderne for dens underopgaver samt dens egen akkumulerede tid.</para>

</sect1>

<sect1 id="menus">
<title
>&karm;s menulinje</title>
<sect2>
<title
><guimenu
>Fil</guimenu
>-menuen</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Gem</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Gemmer de nuværende opgaver og underopgaver og deres totale tid.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Udskriv</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Udskriver</action
> &karm;s vindue</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fil</guimenu
> <guimenuitem
>Start ny session</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Sætter </action
>alle sessionstider til nul</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fil</guimenu
> <guimenuitem
>Nulstil alle tidspunkter</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Sætter </action
>alle tidspunkter til nul</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guisubmenu
>Import/Eksport</guisubmenu
> <guimenuitem
>Importér gammeldags flad fil...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Importerer </action
>gemte &karm;-filer i gammeldags stil (&karm; bruger nu at gemme filer i iCalendar-stil.)</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guisubmenu
>Import/Eksport</guisubmenu
> <guimenuitem
>Importér opgaver fra Planner</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Importér</action
> et Imendio Planner-projekt (se <ulink url="http://planner.imendio.org"
>planner.imendio.org</ulink
>). Alle aktiviteter, delaktiviteter og deres "færdig" markering importeres fra en .planner-fil. Du kan importere dem som en delopgave ved at oprette en delopgave, efterladende den som markeret, og derefter importere. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Fil</guimenu
> <guisubmenu
>Import/Eksport</guisubmenu
> <guimenuitem
>Eksportér til CSV-fil...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Eksportér </action
> <guilabel
>Sessionstid i alt</guilabel
>, <guilabel
>Sessionstid</guilabel
>, <guilabel
>Tid</guilabel
>, og <guilabel
>Tid i alt</guilabel
> til en tekstfil.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fil</guimenu
> <guisubmenu
>Import/Eksport</guisubmenu
> <guimenuitem
>Eksport historik til CSV-fil...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Eksportér </action
> opgavehistorik til en tekstfil. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Kopiér totale summer til klippebord</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Kopierer </action
> den nuværende totale tid for en task or all tasks to the &kde; clipboard</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>C</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Kopiér historik til klippebord</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Kopierer </action
> daglige tider for en given periode til &kde;'s klippebord</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Afslut</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Lukker</action
> &karm;</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
><guimenu
>Ur</guimenu
>-menuen</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycap
>S</keycap
> </shortcut
> <guimenu
>Ur</guimenu
> <guimenuitem
>Start</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Starter</action
> tidsmåling for den markerede opgave</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Ur</guimenu
> <guimenuitem
>Stop</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Stopper</action
> tidsmåling for den markerede opgave</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
><keycap
>&Esc;</keycap
></shortcut
> <guimenu
>Ur</guimenu
> <guimenuitem
>Stop alle tidsmålere</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Stopper</action
> tidsmåling af alle opgaver</para
></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title
><guimenu
>Opgave</guimenu
>-menuen</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Ny</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Tilføjer</action
> en ny opgave</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Ny underopgave</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Tilføjer</action
> en ny underopgave til den markerede opgaven</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycap
>Del</keycap
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Slet</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Sletter</action
> den markerede opgave eller underopgave</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Redigér</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Ændrer navn eller total tid</action
> for den nuværende opgave</para
><para
>Der er to måder at ændre tiden: Redigér absolut, hvor sessionstiden og totale tider kan ændres separat; og Redigér relativt, hvor en vis ændring lægges til eller fjernes både fra sessionstiden og den totale tid.</para
><para
>Autosporing tillader tidsmåling at starte og stoppe automatisk når du skifter til eller fra et bestemt af &kde;'s desktoppe.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title
><guimenu
>Opsætnings</guimenu
>menuen</title>
<variablelist>


<varlistentry>
<term>
<menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil genveje</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Åbner</action
> en dialog til at lade brugeren indstille genvejstaster</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil KArm</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Åbner</action
> en dialog til at lade brugeren indstille &karm;</para>

<para
>Dialogen har tre ruder i faneblade: <guilabel
>Opførsel </guilabel
>, som tillader dig at angive en advarsel for ingen aktivitet og give en advarselsbesked når du sletter et sæt opgaver, <guilabel
>Visning </guilabel
>, som indstiller felterne vist i hovedvinduet <guilabel
>Opbevaring</guilabel
>, som indstiller stedet hvor filer gemmes, om automatisk gemning er aktivere og intervallet mellem at gemme automatisk.</para
> </listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
><guimenu
>Hjælpe</guimenu
>menuen</title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="tool-bar">
<title
>Værktøjslinjen</title>
<para
>Værktøjslinjen indeholder ikoner for følgende kommandoer:</para>

<note
><para
>(Alle opfører sig på samme måde som menukommandoen.)</para
></note>

<itemizedlist>
<listitem
><para
><guiicon
>Start</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Stop</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Ny</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Ny underopgave</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Slet</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Redigér</guiicon
></para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="status-bar">
<title
>Statuslinjen</title>

<para
>Rapporterer den totalt tid der er gået for en session.</para>
</sect1>

</chapter>

<chapter id="credits">

<title
>Medvirkende og licens</title>

<para
>&karm; </para>

<para
>Program ophavsret: </para>

<itemizedlist>

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

<listitem
><para
>2001-2002 Tomas Pospisek <email
>tpo_deb@sourcepole.ch</email
></para
></listitem>

<listitem
><para
>2003-2004 Mark Bucciarelli<email
>mark@hubcapconsulting.com</email
></para
></listitem>

</itemizedlist>

<para
>Bidragydere (i alfabetisk rækkefølge)</para>
<itemizedlist>
<listitem
><para
>Allen Winter <email
>winterz@verizon.net</email
></para
></listitem>
<listitem
><para
>David Faure <email
>faure@kde.org</email
></para
></listitem>
<listitem
><para
>Espen Sand <email
>espen@kde.org</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>
<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
>Mark Bucciarelli <email
>mark@hubcapconsulting.com</email
></para
></listitem>
<listitem
><para
>Thorsten St&auml;rk <email
>dev@staerk.de</email
></para
></listitem>
<listitem
><para
>Tomas Pospisek <email
>tpo_deb@sourcepole.ch</email
></para
></listitem>
<listitem
><para
>Willi Richert <email
>w.richert@cox.net</email
></para
></listitem>
</itemizedlist>

<para
>&karm; er inspireret af Harald Tveit Alvestrands meget nyttige værktøj som hedder <application
>titrax</application
>, hvis eneste fejl er at det er baseret på Xt-værktøjskassen.</para>

<para
>Dokumentation ophavsret 2000+2004 Jonathan Singer <email
>jsinger@leeta.net</email
> og Sirtaj Singh Kang <email
>taj@kde.org</email
>.</para>
&underFDL; &underGPL; </chapter>

<glossary id="glossary">

<glossentry id="gloss-active-task">
<glossterm
>aktiv opgave</glossterm>
<glossdef
><para
>En opgave der har tidsmåleren kørende.</para
></glossdef>
</glossentry>

<glossentry id="gloss-dcop">
<glossterm
>&DCOP;</glossterm>
<glossdef
><para
>Protokollen for kommunikation mellem processer som bruges i KDE. Kort for Desktop COmmunication Protocol.</para
></glossdef>
</glossentry>

<glossentry id="gloss-desktop">
<glossterm
>desktop</glossterm>
<glossdef
><para
>GNU/Linux, FreeBSD og andre systemer der kører X-Windows har flere desktoppe. Du har typisk fire forskellige desktoppe installeret som standard. Hver desktop kan vise sit eget sæt programmer og filer. Når KDE først startes op, er den desktop du ser Desktop 1. Hvis du trykker på <keycombo action="simul"
>&Alt;<keycap
>F2</keycap
></keycombo
>, ser du Desktop 2. Tryk på <keycombo action="simul"
>&Alt;<keycap
>F1</keycap
></keycombo
> vil få Desktop 1 tilbage. </para
></glossdef
> </glossentry>

<glossentry id="gloss-history">
<glossterm
>historik</glossterm>
<glossdef
><para
>Hvis &karm; er indstillet til at logge historik, vil den optage hver start/stop tidsmålingsbegivenhed. Denne historik bliver aldrig ryddet når tider nulstilles, men forbliver i filen indtil opgaven bliver slettet.</para
></glossdef>
</glossentry>

<glossentry id="gloss-session"
> <glossterm
>session</glossterm>
<glossdef
><para
>Et brugerdefineret startpunkt for sessionens tidsmålere. En ny session begynder when you select <menuchoice
> <guimenu
>File</guimenu
> <guimenuitem
>Start New Session</guimenuitem
> </menuchoice
>. Session data is not saved when you create a new session. </para
></glossdef
> </glossentry>

<glossentry id="gloss-system-time"
> <glossterm
><guilabel
>Sessionstid</guilabel
></glossterm
> <glossdef
><para
>Tiden brugt på opgaven siden sidste session begyndte.</para
></glossdef
> </glossentry
> 

<glossentry id="gloss-system-tray"
> <glossterm
>statusfelt</glossterm>
<glossdef
><para
>Statusfeltet er som standard er i panelet for neden. I dette statusfelt <inlinemediaobject
> <imageobject
> <imagedata fileref="systray.png" format="PNG"/></imageobject
> </inlinemediaobject
> er &karm;-ikonen længst til højre.</para
></glossdef>
</glossentry>

<glossentry id="gloss-top-level-task">
<glossterm
>opgave på øverste niveau</glossterm>
<glossdef
><para
>En opgave uden overopgave.</para
></glossdef>
</glossentry>

<glossentry id="gloss-total-session-time"
> <glossterm
><guilabel
>Sessionstid i alt</guilabel
></glossterm
> <glossdef
><para
>Tiden brugt på opgaven og alle dens underopgaver siden sidste session begyndte.</para
></glossdef
> </glossentry>
<glossentry
> <glossterm
><guilabel
>Tid</guilabel
></glossterm>
<glossdef
><para
>Tiden brugt på opgaven siden alle tider blev nulstillet.</para
></glossdef
> </glossentry
> 

<glossentry id="gloss-total-time"
> <glossterm
><guilabel
>Tid i alt</guilabel
></glossterm>
<glossdef
><para
>Tiden brugt på opgaven og dens underopgaver siden alle tider blev nulstillet.</para
></glossdef
> </glossentry
> 

</glossary>

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

<sect1 id="getting-karm">
<title
>Hvordan får man fat på &karm;</title>
&install.intro.documentation; &install.compile.documentation; </sect1>

</appendix>

<appendix id="dcopappendix"
><title
>&DCOP;-grænseflade</title>

<refentry id="dcop-version">
<refmeta>
<refentrytitle
>version</refentrytitle>
</refmeta>
<refnamediv>
<refname
>version</refname>
<refpurpose
>Returnerer &karm;s version.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString version()
</synopsis>
</refsynopsisdiv>
<refsect1>
<title
>Beskrivelse</title>
<para
><function
>version()</function
> er et &DCOP;-kald som returnerer &karm;s versionsnummer, for eksempel 1.5.0. Versionsnummeret returneres som en streng med det typiske GNU-format hovedversion.delversion.fejlretning.</para>
</refsect1>
</refentry>

<refentry id="dcop-quit">
<refmeta>
<refentrytitle
>quit</refentrytitle>
</refmeta>
<refnamediv>
<refname
>quit</refname>
<refpurpose
>Returnerer &karm;s afslutning.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString quit()
</synopsis>
</refsynopsisdiv>
<refsect1>
<title
>Beskrivelse</title>
<para
><function
>quit()</function
> er et &DCOP;-kald som sørger for en måde for et eksternt program at afslutte &karm; på en pæn måde. </para>
</refsect1>
</refentry>

<refentry id="dcop-hastodo">
<refmeta>
<refentrytitle
>hastodo</refentrytitle>
</refmeta>
<refnamediv>
<refname
>hastodo</refname>
<refpurpose
>Tjek om en aktivitet på topniveau findes.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString hastodo(QString aktivitetsnavn)
</synopsis>
<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>opgavenavn</parameter
></term>
<listitem>
	<para
>Navnet på gøremålet at lede efter.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>
<refsect1>
<title
>Beskrivelse</title>
<para
><function
>hastodo(QString taskname)</function
> er et &DCOP;-kald som leder efter en opgave med angivet navn. Hvis den findes, returneres iCalendar-brugerid som identifierer opgaven. Hvis den ikke findes, returneres en tom streng. </para>
<para
>Filen som gennemsøges er iCalendar-filen som &karm; for øjeblikket har åben. Alle opgavetræer gennemsøges, ikke kun opgaver på øverste niveau. Hvis mere end en opgave har et matchende navn, returneres den første som findes.</para>
</refsect1>
</refentry>

<refentry id="dcop-addtodo">
<refmeta>
<refentrytitle
>addtodo</refentrytitle>
</refmeta>
<refnamediv>
<refname
>addtodo</refname>
<refpurpose
>Tilføj et nyt gøremål.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString addtodo(QString gøremålsnavn)
</synopsis>
<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>gøremålsnavn</parameter
></term>
<listitem>
	<para
>Navnet på det nye gøremål.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivelse</title>
<para
><function
>addtodo(QString todoname)</function
> er en &DCOP;-funktion som tilføjer en ny opgave  på øverste niveau i nuværende lagringsobjekt. Den nye opgaves brugerid returneres. </para>
</refsect1>
</refentry>

</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
-->
