<othercredit role="translator"><firstname>Marek</firstname><surname>Laane</surname><affiliation><address><email>bald@starman.ee</email></address></affiliation><contrib>Tõlge eesti keelde</contrib></othercredit>
<para>&karm; jälgib mitmesugustele ülesannetele kuluvat aega. Sellest on kasu näiteks selgitamaks, kui palju aega kulub mingile kliendile või mitu tundi päevas on näiteks pandud Doomi mängimise või Slashdoti lugemise alla.</para>
<para>Ajaarvestust on võimalik salvestada komadega eraldatud vormingus tekstifaili ning siis kasutada muudes arvestus- ja/või projektihaldusvahendites.</para>
<para>&karm; tuvastab, kas klaviatuur ja hiir on kasutusel või mitte ning oskab siduda erinevaid ülesandeid erinevate töölaudadega. Need mõlemad võimalused aitavad pidada arvestust just vajaliku ülesande üle.</para>
<para>&karm;i originaali kirjutas Sirtaj Singh Kang. Sõna <quote>karm</quote> tähendab tema emakeeles ehk pandžabi keeles <quote>töö</quote> ja on sisuliselt sama, mis levinum <quote>karma</quote>.</para>
<para>Selleks kirjuta käsureale <command>karm</command> või vali <guimenu>KDE käivitusmenüü</guimenu>st grupi <guisubmenu>Utiliidid</guisubmenu> alt <guimenuitem>Personaalne ajaarvestus</guimenuitem>. Käsureal saab kasutada tavalisi &Qt; ja &kde; argumente, millest saab ülevaate käsuga <userinput><command>karm</command> <option>--help</option></userinput>.</para>
<para>&karm; pakub lisaks võimaluse määrata iCalendar-faili nimi, mida kasutada sinu tegemiste salvestamiseks. Võrgus asuva iCalendar-faili saab anda, kui kirjutada failinimes ka http- või ftp-osa, näiteks http://www.minusait.ee/minuandmed/minutegemised.ics.</para>
<para><emphasis>Probleem:</emphasis> oled vabakutseline tarkvarakonsultant, kel on palju kliente. Mitmel kliendil on omakorda hulk projekte. Päeva jooksul tegeled korduvalt mitme projektiga. Kuu koguarve esitamiseks tuleb sul aga ajal silm peal hoida.</para>
<para><emphasis>Lahendus:</emphasis> loo igale kliendile tipptaseme ülesanne ning iga kliendi igale projektile omaette alamülesanne. Üksikasjalikumat jälgimist nõudvate projektide puhul loo projekti alamülesannete nimekiri. Aega saab jälgida parajasti tegeldava ülesande nimel topeltklõpsu tehes.</para>
<para>&karm; võimaldab oma ajakulutust väga paindlikult jälgida - luua on võimalik piiramatul arvul ülesandeid ja neisse piramatul arvul alamülesandeid. Aega saab logida suvalise ülesande puhul ning korraga võivad aktiivsed olla ka mitu ülesannet.</para>
<para>Tipptaseme ülesande loomiseks vali käsk <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Ülesanne</guimenu> <guimenuitem>Uus</guimenuitem> </menuchoice>. Alamülesande loomiseks vali ülesanne ning seejärel käsk <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;&Alt;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Ülesanne</guimenu> <guimenuitem>Uus alamülesanne</guimenuitem> </menuchoice> </para>
<para>Kui sulged &karm;i, salvestatakse ülesannete loend faili, mille saab määrata käsuga <menuchoice> <guimenu>Seadistused</guimenu> <guimenuitem>KArmi seadistamine</guimenuitem> </menuchoice>. Kui nüüd rakenduse uuesti avad, laetakse samast failid uuesti ülesanded.</para>
<para>&karm; võib sinu vaeva minimeermiseks ülesandeid importida ja eksportida. Vaata osa <link linkend="interfaces">Muud süsteemid</link>.</para>
<para><emphasis>Probleem:</emphasis> sissetuleku tagamiseks tuleb sul töötada keskmiselt viis tundi päevas. Selle kontrollimiseks soovid kasutada igapäevaseid ja -nädalasi kokkuvõtteid.</para>
<para><emphasis>Lahendus:</emphasis> lähtesta seansitaimer iga tööpäeva ja kõik taimerid iga nädala algul.</para> </informalexample>
<para>&karm; muudab ajakulutuse jälgimise imelihtsaks. Kui soovid alustada ülesande jälgimist, tee sellel lihtsalt topeltklõps. Jälgimise peatamiseks tee uuesti tipeltklõps. Aktiivsed ülesanded näitavad väikest kella veerus <guilabel>Seansi aeg</guilabel>.</para>
<para>Teine võimalus ajaarvestust visuaalselt jälgida on &karm;i ikoon süsteemses salves. Kui ülesanne on aktiivne, liigub ikoonil üks seier. Kui viid hiirekursori ikooni kohale, näed ilmuvas kohtspikris aktiivse ülesande nime. Kui aktiivne on enam kui üks ülesanne, näidatakse nende nimesid kohtspikris komadega eraldatult.</para>
<para>&karm; kasutab iga ülesande korral kaht taimerit: üks mõõdab seansi aega, teine koguaega. Vaikeseadistuses näitab &karm; iga taimeri kohta kaht veergu ehk siis iga ülesande kohta kokku nelja veergu:</para>
<para><emphasis>Probleem:</emphasis> sul on kaks projekti, millega iga päev korduvalt tegeled. Töö paremaks korraldamiseks oled I projekti failid paigutanud I töölauale ja II projekti failid II töölauale.</para>
<para><emphasis>Lahendus:</emphasis> seosta I projekti ülesanne I töölauaga ja II projekti ülesanne II töölauaga. Kui nüüd lülitud II töölaualt I töölauale, peatab &karm; automaatselt II projekti ülesande ja käivitab I projekti ülesande.</para>
<para>Ülesande sidumiseks ühe või enama töölauaga vali menüükäsk <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> </shortcut> <guimenu>Ülesanne</guimenu> <guimenuitem>Muuda</guimenuitem> </menuchoice>. Lülita sisse <guilabel>Automaatne jälgimine</guilabel> ning vali töölaud/töölauad, mille soovid ülesandega siduda. Kui mõni valitud töölaudadest nüüd aktiivseks muutub, alustab &karm; väikese viivitusega automaatselt antud ülesande ajaarvestust.</para>
<informalexample> <para><emphasis>Probleem:</emphasis> lahkusid reedel mingil põhjusel ootamatult vara töölt ja unustasid taimeri peatamast. Esmaspäeval naastes avastad, et taimer töötab endiselt.</para>
<para>&karm;i saab panna tuvastama, kas hiir ja klaviatuur on rakkes või mitte. Kui hiir ja klaviatuur on olnud jõude enam kui määartud arv minuteid, näitab &karm; järgmist dialoogi:</para>
<varlistentry><term><guibutton>Arvesta maha ja peatu</guibutton></term>
<listitem><para>Jõudeaeg lahutatakse kõigilt aktiivsetelt taimeritelt ja need peatatakse.</para><para>Sa ei töötanud ülesannetega, kui arvuti oli jõude, ega tee seda ka praegu.</para></listitem></varlistentry>
<varlistentry> <term><guibutton>Arvesta maha ja jätka</guibutton></term>
<listitem><para>Jõudeaeg lahutatakse kõigilt aktiivsetelt taimeritelt, kuid need jäävad edasi tööle.</para><para>Sa ei töötanud ülesannetega, kui arvuti oli jõude, aga hakkasid nüüd uuesti tööle. </para></listitem></varlistentry>
<varlistentry> <term><guibutton>Jätka aja lugemist</guibutton></term>
<listitem><para>Jõudeaeg lisatakse kõigile aktiivsetele taimeritele ja need jäävad edasi tööle.</para><para>Töötasid ülesannetega, kui arvuti oli jõude, ja teed seda endiselt. </para></listitem></varlistentry> </variablelist>
<para>&karm; võimaldab logitud ajast kolmel viisil aru anda: seansi ja koguaja võib saata printerile või siis kopeerida lõikepuhvrisse (ja sealt asetada, kuhu vaja) kas koguaja või kogu ajaarvestuse üldse.</para>
<sect2><title>Koguaja trükkimine</title>
<para>Printerisse saadetava koguajaaruande loomiseks vali menüükäsk <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>Fail</guimenu> <guimenuitem>Trüki</guimenuitem> </menuchoice>. See loob kõigi ülesannete kohta kolmeveerulise aruande. Esimeses veerus seisab ülesande nimi, teine veerg on <guilabel>seansi koguaeg</guilabel> ja kolmas <guilabel>koguaeg</guilabel>.</para>
<para>Aruanne luuakse parajasti valitud ülesande ja kõigi selle alamülesannete kohta. Kui valitud on tipptaseme ülesanne, pärib &karm;, kas soovid luua aruande antud ülesande ja selle alamülesannete või kogu ülesannete nimekirja kohta.</para>
<para>Esimene veerg on <guilabel>koguaeg</guilabel> ning siin on kasutatud ülesannete nimede puhul treppimist, mis osutab ülesannete ja nende alamülesannete seostele. Aja hulka arvestatakse ka alamülesannete aeg.</para>
<important><para>Selleks peab olema sisse lülitatud valik <guilabel>Ajaloo logimine</guilabel> (selle leiab <menuchoice> <guimenu>Seadistused</guimenu> <guimenuitem>KArmi seadistamine</guimenuitem> </menuchoice>). Vastasel juhul peab &karm; silma peal ainult ülesannete kogusummal ega hoia alal üksikasjalikku ülesannete ajalugu.</para></important>
<para>Aruanne luuakse parajasti valitud ülesande ja kõigi selle alamülesannete kohta. Võimalik on valida ka aruande koostamine kõigi ülesannete kohta.</para>
<para>Kui valid ajalooaruande loomise võimaluse, palub &karm; sul kõigepealt määrata kindlaks aruandesse kaasatav ajavahemik:</para>
<para>Ülesande ajalugu näitab kogusummat iga päeva ja iga ülesande kohta nädala kaupa. Esimesed seitse tulpa on nädalapäevad esmaspäevast pühapäevani. Kaheksandas veerus on nädala kogusumma ning üheksandas ülesande nimi. Ülesannete nimed on trepitud, mis osutab ülesannete ja nende alamülesannete seosele.</para>
<para>&karm; kasutab sarnaselt KOganizeri ja Apple'i iCaliga oma andmete puhul üldlevinud standardit <ulink url="http://developer.kde.org/documentation/standards/index.html">iCalendar</ulink>. &karm; võib nii avada kui salvestada nende kahe rakenduse loodud ülesannete nimekirju.</para>
<warning><para>Kui üks ja sama fail on lahti nii &karm;is kui KOrganizeris, siis seda Korganizeris redigeerides tekib oht andmed kaotada. Kindluse mõttes oleks parem faili redigeerida korraga ainult ühes rakenduses.</para></warning>
<para>Üsna tüüpiline on ka projekti planeerimine projektihalduri Imendio Planneriga (vaata <ulink url="http://planner.imendio.org">planner.imendio.org</ulink>) ning selle ülesannete importimine &karm;i, et need oleksid standardses <ulink url="http://developer.kde.org/documentation/standards/index.html">iCalendari</ulink> vormingus. Sellisel juhul saab ajastada oma ülesandeid KOrganizeris ning arvestada neile kuluvat aega &karm;iga. Nii on võimalik kontrollida, kas projekt püsib ikka ettenähtud eelarve ja aja piirides.</para>
<para>&DCOP; on mehhanism, millega KDE rakendused saavad üksteisega shelda. KDE rakendused pakuvad selleks välja teatud funktsioonid, mida teised programmid (näiteks bash'i skript) saavad ära kasutada.</para>
<para>&karm;i praegune &DCOP;-liides on mõeldud peamiselt automaatseks testimiseks, mistõttu see on ka üpris piiratud. Liidese täieliku ülevaate annab <link linkend="dcopappendix">&DCOP;-liidese lisa</link>.</para>
<sect2 id="csv-export"><title>Kogusumma eksport CSV-faili</title>
<para>&karm; võib nii kogusumma kui ajaloo eksportida komadega eraldatud failivormingusse (CSV). Kogusumma eksportimiseks vali menüükäsk <menuchoice> <guimenu>Fail</guimenu> <guisubmenu>Import/eksport</guisubmenu> <guimenuitem>Ekspordi CSV faili...</guimenuitem> </menuchoice> ning &karm; avab järgmise dialoogi:</para>
<para>Määra fail, kuhu soovid andmed eksportida, ning muuda vajaduse korral ka muid etteantud väärtusi. Pane tähele, et ajavahemikku ei saa siin muuta, sest tegemist on ju aja kogusumma, mitte ajalooandmete eksportimisega. Klõpsa nupule <guibutton>Eksport</guibutton> ning &karm; salvestabki kõigi ülesannete koguaja sinu valitud faili.</para>
<para>Tipptaseme ülesanded on esimeses veerus, alamülesanded teises ja nii edasi. Ajaandmed salvestatakse ülesande maksimaalse sügavuse järel (antud juhul viis). Esimeses veerus on <guilabel>seansi aeg</guilabel>, teises <guilabel>aeg</guilabel>, kolmandas <guilabel>seansi koguaeg</guilabel> ja neljandas <guilabel>koguaeg</guilabel>. </para>
<sect2 id="csv-export-history"><title>Ajaloo eksport CSV-faili</title>
<para>Ajaloo eksportimiseks vali menüükäsk <menuchoice> <guimenu>Fail</guimenu> <guisubmenu>Import/eksport</guisubmenu> <guimenuitem>Ekspordi ajalugu CSV faili...</guimenuitem> </menuchoice> ning &karm; avab eespool näidatud eksportimisdialoogi.</para>
<para>Määra fail, kuhu soovid andmed eksportida, ja vali vajalik ajavahemik. Vajaduse korral võid muuta ka muid etteantud väärtusi. Klõpsa nupule <guibutton>Eksport</guibutton> ning &karm; salvestabki kõigi ülesannete ajaloo sinu valitud faili.</para>
<para>Toome siin näite väljundi vormindusest:</para>
<para>Kolm rida näitavad, millal aruanne on loodud ja millist ajavahemikku see hõlmab. Neljandas reas on komadega eraldatud ajavahemikku kaasatud kuupäevade loetelu ISO-8601 vormingus (YYYY-MM-DD). Ülejäänud ridades on kirjas ülesannetele kulutatud aeg. Viimane numbriveerg kujutab endast rea kõigi päevade kogusummat. Ülesande nimi seisab pärast kogusumma veergu ning nimed on trepitud, et näidata ülesande ja selle alamülesannete seoseid. Tipptaseme ülesannete nimed seisavad esimeses veerus pärast kogusummat.</para>
<para>Selles aknas on näha ülesanded ning neile kulunud aeg nii praeguse seansi ajal kui kokku. Jälgitavatel ülesannetel on seansi aega näitavas veerus näha väike kell.</para>
<para>Igale ülesandele saab luua alamülesandeid. Klõps ülesande ees seisval pluss- või miinusmärgil vastavalt kas näitab või varjab alamülesandeid. Ülesande koguaega on arvestatud nii selle enda kui tema alamülesannete aeg.</para>
<term><menuchoice><guimenu>Fail</guimenu> <guisubmenu>Import/eksport</guisubmenu> <guimenuitem>Impordi vanema versiooni fail...</guimenuitem> </menuchoice></term>
<para><action>Impordib</action> Imendio Planneri projekti (vaata <ulink url="http://planner.imendio.org">planner.imendio.org</ulink>). Kõik ülesanded, alamülesanded ja nende lipud "lõpetatud" imporditakse .planner-failist. Neid saab importida alamülesandena, luues alamülesande, märkides selle ja siis importides. </para>
<para><action>Muudab valitud ülesande nime või aega</action></para><para>Aja muutmiseks on kaks võimalust: absoluutse aja muutmine, mille korral seansi aega ja koguaega saab muuta eraldi, ning suhteline muutmine, mille puhul teatud hulk aega lisatakse või lahutatakse nii seansi kui koguajalt.</para><para>Automaatse jälgimise võimalus lubab ajaarvestust automaatselt alustada ja peatada, kui lülitud konkreetsele &kde; töölauale või lahkud sellelt.</para>
<listitem><para><action>Avab</action> dialoogi, kus saab &karm;i seadistada</para>
<para>Dialoogil on kolm kaartidega osa: <guilabel>Käitumine</guilabel>, mis võimaldab määrata häire mitteaktiivsuse korral ja hoiatuse ülesannet kustutades, <guilabel>Vaade</guilabel>, kus saab määrata peaaknas näidatavaid välju, ning <guilabel>Salvestamine</guilabel>, kus saab määrata salvestatava faili asukoha, automaatse salvestamise sisse või välja lülitada ning paika panna automaatse salvestamise intervalli.</para> </listitem>
<para>&karm;i idee aluseks oli Harald Tveit Alvestrandi väga kasulik utiliit nimetusega <application>titrax</application>, mille ainus häda oli see, et ta põhines Xt tööriistakomplektil.</para>
<para>Dokumentatsiooni autoriõigus 2000-2004: Jonathan Singer <email>jsinger@leeta.net</email> ja Sirtaj Singh Kang <email>taj@kde.org</email>.</para>
<glossdef><para>KDE protsessidevahelise suhtlemise protokoll. Lühend sõnadest Desktop COmmunication Protocol (töölaua suhtlemisprotokoll).</para></glossdef>
<glossdef><para>GNU/Linuxil, FreeBSD-l ja muudel X-Windowsi kasutavatel süsteemidel võib tarvitada ka mitut töölauda korraga. Tavaliselt on neis süsteemides juba vaikimisi paigaldatud neli töölauda. Igal töölaual saab kasutada omaette programme ja faile. Kui KDE esimest korda käivitada, satud esimesele töölauale. Kiirklahvi <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> vajutades saad liikuda teisele töölauale ning sealt tagasi toob sind <keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo>. </para></glossdef> </glossentry>
<glossdef><para>Kui &karm;ile on antud korraldus ajalugu logida, salvestab rakendust kõigi taimerite iga käivitamise ja peatamise. Seda ajalugu ei puhastata ka aja nullimisel ning see püsib alal seni, kuni sa vastava faili füüsiliselt hävitad.</para></glossdef>
<glossdef><para>Kasutaja määratud seansi taimerite alguspunkt. Uut seanssi saab alustada menüükäsuga <menuchoice> <guimenu>Fail</guimenu> <guimenuitem>Käivita uus seanss</guimenuitem> </menuchoice>. Uut seanssi luues senise seansi andmeid ei salvestata. </para></glossdef> </glossentry>
<glossentry id="gloss-system-time"> <glossterm><guilabel>Seansi aeg</guilabel></glossterm> <glossdef><para>Ülesandele kulutatud aeg alates seansi algusest.</para></glossdef> </glossentry>
<glossdef><para>Süsteemne salv on riba, mis (vaikisimi) on näha ekraani allservas <inlinemediaobject> <imageobject> <imagedata fileref="systray.png" format="PNG"/></imageobject> </inlinemediaobject>. &karm;i ikoon on selles kõige parempoolsem,</para></glossdef>
<glossentry id="gloss-total-session-time"> <glossterm><guilabel>Seansi koguaeg</guilabel></glossterm> <glossdef><para>Ülesandele ja kõigile selle alamülesannetele kulutatud aeg alates seansi algusest.</para></glossdef> </glossentry>
<para><function>version()</function> on &DCOP;-väljakutse, mis tagastab &karm;i versiooni, näiteks 1.5.0. Versioon tagastatakse stringina tüüpilises GNU vormingus versioon.alamversioon.tase.</para>
<para><function>hastodo(QString taskname)</function> on &DCOP;-väljakutse, mis otsib etteantud nime. Leidmisel tagastatakse ülesannet tuvastav iCalendari UID. Mitteleidmisel tagastatakse tühi string. </para>
<para>Otsitakse iCalendari failis, mis on &karm;is parajasti avatud. Otsitakse läbi kõik ülesandepuud, mitte ainult tipptaseme ülesande. Kui nimega sobib enam kui üks ülesanne, tagastatakse esimesena leitu.</para>
<para><function>addtodo(QString todoname)</function> on &DCOP;-väljakutse, mis lisab aktiivsesse faili uue tipptaseme ülesande. Tagastatakse uue ülesande UID. </para>
