# &kontact;i käsiraamat

## Sissejuhatus

&kontact; kujutab endast personaalse info haldamise integreeritud lahendust. See koondab teada-tuntud &kde; e-posti, ajakavade, aadressiraamatu, märkmete ja uudistegruppide rakendused (&kmail;, &korganizer;, &kaddressbook;, &knotes; ja &knode;) ühte liidesesse. Korralikule raamistikule tuginedes pakub &kontact; kõiki neid võimalusi, mida pakuvad ka kõik rakendused eraldi, ning lisab neile omalt poolt uusi võimalusi, mida lubab luua rakenduste kasutamine &kontact;i komponentidena. Kasutajad saavad siiski määrata, millist rakendust kasutada &kontact;i raames ja millist eraldi.

Lisaks konkreetsete rakenduste võimalustele pakub &kontact; kokkuvõttevaadet ning täiustatud lohistamisvõimalust komponentide vahel.

## &kontact;i komponendid

&kontact; koondab endasse allpool loetletud rakendused. Kõigil neil on oma käsiraamatud, kus kirjeldatakse põhjalikult vastavat rakendust. Kõiki neid saab kasutada nii &kontact;i komponentidena kui iseseisvalt.

- &kde; e-posti klient &kmail;.

- &kde; organiseerija ja ajakavade rakendus &korganizer;.

- &kde; kontaktide haldur &kaddressbook;.

- Märkmete rakendus &knotes;.

- &kde; uudistelugeja &knode;.

- &kde; pihuseadmete sünkroniseerimise rakendus &kpilot;.

- &kde; sünkroniseerimisrakendus &kitchensync;.

- &kde; RSS-kanalite lugeja &akregator;.

## &kontact;i peaaken

Peaaken koosneb vasakul asuvast külgpaneelist, mis näitab saadaolevate komponentide ikoone, paremal asuvast peavaatest, kus on näha parajasti aktiivse komponendi peaaken, ning tavapärasest menüü-, tööriista- ja olekuribast.

### Külgpaneel

Külgpaneelil on õigupoolest mitu funktsiooni: see võimaldab lülituda ühelt komponendilt teisele, näitab, milline komponent on parajasti aktiivne, ning kujutab endast ka märklauda erinevate komponentide vahel teostatavate lohistamisoperatsioonide jaoks.

&kontact;i külgpaneel &kontact;i külgpaneel

&kontact;i külgpaneel

Komponentide vahel liikumiseks klõpsa lihtsalt vajalikule ikoonile. Seejärel näidatakse antud komponendi peaakent ning vastavalt muutub ka olekuriba. Kui komponent esimest korda aktiveerida, võib peaakna vahetumine võtta veidi aega, sest komponendid laetakse ainult vajadusel. See tähendab, et rakendus ei kuluta asjatult mälu neile komponentidele, mida sa ei pruugi.

Külgpaneeli ikoonid on abiks ka lohistamisel. Nii võib näiteks lohistada kirja e-posti komponendist ülesannete nimekirja või kalendrisse, et luua antud kirjaga seotud ülesanne või sündmus.

Külgpaneeli ikoonide suurust saab muuta. Hiire parema nupuga külgpaneelile klõpsates saab valida suured, tavalised või väikesed ikoonid või ka üldse ikoonide asemel ainult teksti näitamise.

Kui külgpaneel sulle ei meeldi, võid selle peita eraldajat lohistades. Komponentide vahel saab liikuda ka täiesti vabalt asetatava navigeerimisriba abil.

### Peavaade

Paremal asuv vaade, mis hõlmab enamiku &kontact;i peaaknast, näitab parajasti aktiivset komponenti. See on täpselt samasugune nagu antud komponendi peaaken juhul, kui see käivitatakse iseseisvalt. Külgpaneelil esile tõstetud ikoon annab märku, millisele rakendusele peavaade parajasti kuulub. &kontact; jätab sulgemisel meelde, milline komponent oli aktiivne, nii et &kontact;i taaskäivitamisel näidatakse alguses just seda komponenti, mis oli aktiivne &kontact;ist väljumisel.

&kontact;i peavaade &kontact;i peavaade

&kontact;i peavaade

Lisaks saab kahel viisil muuta seda, millise komponendiga &kontact; käivitub. Kõigepealt saab selle anda argumendina &kontact;i avamisel käsurealt (vt. command-line). Teiseks saab selle määrata &kontact;i seadistustedialoogis, kus saab panna &kontact;i alati käivituma just soovitud moel.

&kontact;i käivitatava komponendi määramine &kontact;i käivitatava komponendi määramine

&kontact;i käivitatava komponendi määramine

### Menüü-, tööriista- ja olekuriba

Menüü-, tööriista ja olekuriba kohanduvad vastavalt aktiivsele komponendile. See tähendab, et lisaks mõningatele üldistele funktsioonidele, näiteks abimenüü, mida näidatakse kõigi komponentide korral, on toiminguid, mis leiduvad ribadel ainult teatud komponendi puhul. Need on samad, mida saab kasutada siis, kui vastavat rakendust pruugitakse iseseisvalt.

&kontact;i menüüribad kokkuvõttevaates, e-posti vaates ja kalendrivaates &kontact;i menüüribad kokkuvõttevaates, e-posti vaates ja kalendrivaates &kontact;i menüüribad kokkuvõttevaates, e-posti vaates ja kalendrivaates &kontact;i menüüribad kokkuvõttevaates, e-posti vaates ja kalendrivaates &kontact;i menüüribad kokkuvõttevaates, e-posti vaates ja kalendrivaates &kontact;i menüüribad kokkuvõttevaates, e-posti vaates ja kalendrivaates

&kontact;i menüüribad kokkuvõttevaates, e-posti vaates ja kalendrivaates

Üks kõigile komponentidele ühine eriline toiming on käsk Uus. See võimaldab luua uusi objekte, näiteks meile, kontakte, kokkusaamisi ja ülesandeid sõltumata sellest, milline komponent on parajasti aktiivne. Vajadusel käivitatakse vastava objektiga tegelev komponent.

&kontact;i menüü 'Uus' &kontact;i menüü 'Uus'

&kontact;i menüü 'Uus'

### Lohistamisvõimalused

&kontact; võimaldab igati lohistada elemente enda programmide vahel. Järgnevalt kirjeldame lühidalt kõiki spetsiifilisi lohistamisoperatsioone ning nende tulemusi.

#### &kmail; -> &korganizer;i ülesannete nimekiri

Kirja lohistamine &kmail;i kirjade paneelilt &korganizer;i ülesannete nimekirja ikoonile ( ) loob uue ülesande, mille tiitliks on Kiri: `Subjekt` ning sisuks Kellelt: `Saatja` Kellele: `Saaja` Subjekt: `Subjekt` (kusjuures tekst, mis näeb välja `nii`, on pärit kirjast endast), ning lisab ülesandele kaasatud failina ka kirja enda.

#### &kmail; -> &korganizer;i kalender

Kirja lohistamine &kmail;i kirjade paneelilt &korganizer;i kalendri ikoonile ( ) loob uue sündmuse, mille tiitliks on Kiri: `Subjekt` ja sisuks Kellelt: `Saatja` Kellele: `Saaja` Subjekt: `Subjekt` (kusjuures tekst, mis näeb välja `nii`, on pärit kirjast endast), ning lisab sündmusele kaasatud failina ka kirja enda.

Pane tähele, et lohistamine ülesannete nupule loob ülesande, lohistamine kalendrile aga sündmuse. Täpsemalt selgitab nende vahet &korganizer;i käsiraamat.

#### &kmail; -> &kaddressbook;

Kirja lohistamine &kmail;i kirjade paneelilt &kaddressbook;u ikoonile ( ) loob kirja saatja aadressi põhjal kontakti, kui just samanimelist kontakti ei ole juba olemas. Loomisaktist annab teada ilmuv dialoog.

#### &kaddressbook; -> &korganizer;i ülesannete nimekiri

Mis tahes kirjete lohistamine &kaddressbook;u peaaknast &korganizer;i ülesannete nimekirja ikoonile ( ) loob uue ülesande, mille tiitliks on "Kohtumine" ning osalejateks lohistatud kontaktid.

Pane tähele, et lohistamine ülesannete nupule loob ülesande, lohistamine kalendrile aga sündmuse. Täpsemalt selgitab nende vahet &korganizer;i käsiraamat.

#### &kaddressbook; -> &korganizer;i kalender

Mis tahes kirjete lohistamine &kaddressbook;u peaaknast &korganizer;i kalendri ikoonile ( ) loob uue sündmuse, mille tiitliks on "Kohtumine" ning osalejateks lohistatud kontaktid.

Pane tähele, et lohistamine ülesannete nupule loob ülesande, lohistamine kalendrile aga sündmuse. Täpsemalt selgitab nende vahet &korganizer;i käsiraamat.

## Kokkuvõttevaade

&kontact;i esmakäivitusel avatakse vaikimisi kokkuvõttevaade. See annab ülevaate &kontact;i komponentide pakutavast infost, milleks võivad olla uudistejälgija viimased pealkirjad, vahetult eesseisvad kohtumised või sünnipäevad, tegemist ootavad ülesanded, ilmateade jne. Seda, millist infot näidatakse, saab määrata vastavaid komponente &kontact;i seadistustedialoogis valides.

&kontact;i kokkuvõttevaade &kontact;i kokkuvõttevaade

&kontact;i kokkuvõttevaade

### Kokkuvõttevaate komponentide ümberpaigutamine

Kokkuvõttevaates saab määrata ka seda, kus mingi komponent asub. Kui näiteks tahad näha tähtpäevi all vasakul ja ülesandeid üleval paremal, tuleb sul lihtsalt vaate komponendid ümber paigutada.

Ümberpaigutamine käib imelihtsalt - lohistades. Klõpsa selle komponendi hallikal tiitlialal, mida soovid mujale paigutada, ning lohista komponent vajalikku kohta. Pane tähele, et ümberpaigutamisel arvestatakse komponentide omavahelist suhet. Nii saab näiteks liigutada e-posti komponendi ülesannete komponendist allapoole, aga seda ei saa paigutada täiesti suvalisse kohta. Kui kokkuvõttevaates on ainult üks komponent, siis seda ei saa muudmoodi ümber paigutada kui ainult ühest veerust teise. Kahe komponendi korral võivad mõlemad paikneda ühes veerus või kumbkis veerus eraldi ja nii edasi. Komponenti lohistades näed ka väikest eelvaatluse kasti, mis järgib hiire liikumist.

&kontact;i kokkuvõttevaate ümberkorraldamine &kontact;i kokkuvõttevaate ümberkorraldamine

&kontact;i kokkuvõttevaate ümberkorraldamine

## &kontact;i seadistamine

### &kontact;i seadistustedialoog

Kui valida &kontact;i menüüst Seadistused käsk &kontact;i seadistamine, ilmub nähtavale seadistustedialoog. See toob ära kõigi &kontact;i aktiivsete komponentide seadistuste nimekirja. Komponendi nime juures seisvale sümbolile - klõpsates saab antud komponendi valikud kokku kerida, et paremini näha mõne muu komponendi võimalusi. Komponendi mõnda seadistuskirjet nimekirjast valides näidatakse vastavat dialoogi akna parempoolses osas.

&kontact;i seadistustedialoog &kontact;i seadistustedialoog

&kontact;i seadistustedialoog

Klõpsuga nupule Seadista... avaneb dialoog, kus saab valida, millised komponendid üldse aktiveerida. Komponendi nime juures olevat kastikest märkides ilmub see nähtavale nii külgpaneelil kui kokkuvõttevaates. Komponent laaditakse ja selle peavaadet näidatakse peaaknas, kui külgpaneelil klõpsatakse esimest korda vastavale ikoonile. Kui komponendi nime juures olevast kastist märge eemaldada, eemaldatakse komponent ka külgpaneelilt ja kokkuvõttevaatest. Muutused rakenduvad siis, kui klõpsad nupule Rakenda või OK.

&kontact;i komponentide valimise dialoog &kontact;i komponentide valimise dialoog

&kontact;i komponentide valimise dialoog

Konkreetse komponendi seadistamiseks aktiveeri komponent peaaknas sellele vastavale külgpaneeli ikoonile klõpsates ning vali seejärel menüüst Seadistused käsk <rakenduse nimi> seadistamine.

&kontact;i seadistustemenüü aktiivse KMailiga &kontact;i seadistustemenüü aktiivse KMailiga

&kontact;i seadistustemenüü aktiivse KMailiga

### &kontact;i kokkuvõttevaate seadistamine

Kui valid &kontact;i menüüst Seadistused käsu Kokkuvõttevaate seadistamine... (saadaval ainult juhul, kui peavaates on aktiivne kokkuvõte), ilmub dialoog, kus saab valida, milliseid kokkuvõttepluginaid peaks &kontact; näitama oma kokkuvõttevaates. Toome siin ära praeguste kokkuvõtepluginate nimekirja ja lühikirjelduse:

#### &kontact;i kokkuvõttepluginad: kalender

&kontact;i kokkuvõttevaate kalendri plugin lisab vaatesse ala nimetusega Kokkusaamised. Selles on näha kõik sinu parajasti määratud kokkusaamised.

&kontact;i kalendri kokkuvõtteplugin &kontact;i kalendri kokkuvõtteplugin

&kontact;i kalendri kokkuvõtteplugin

#### &kontact;i kokkuvõttepluginad: kontaktid

&kontact;i kokkuvõttevaate kontaktide plugin lisab vaatesse ala nimetusega Sünnipäevad ja muud tähpäevad, kus näidatakse sinu kontaktide sünnipäevi ja muid tähtpäevi (mõistagi kontaktide puhul, kellel on vastav info olemas - vaata selle kohta lähemalt &kaddressbook;u käsiraamatut). Seal on näha järgmine info:

- Mitme päeva pärast antud sündmus juhtub

- Sünnipäeva/tähtpäeva kuupäev

- Nimi (sellele klõpsates saab saata kontaktile kirja, hiire parema nupuga klõpsates aga näha kontakti infot)

- Vanus

&kontact;i kontaktide kokkuvõtteplugin &kontact;i kontaktide kokkuvõtteplugin

&kontact;i kontaktide kokkuvõtteplugin

#### &kontact;i kokkuvõttepluginad: KPilot

&kontact;i kokkuvõttevaate KPiloti plugin lisab vaatesse ala nimetusega KPiloti info. See sisaldab hulga infot KPiloti kohta, sealhulgas:

- Viimane sünkroniseerimine (koos sünkrologiga)

- Kasutaja, kes viimase sünkroniseerimise sooritas

- Viimati sünkroniseeritud seade

- Praegune olek

- Saadaolevad kanalid

&kontact;i KPiloti kokkuvõtteplugin &kontact;i KPiloti kokkuvõtteplugin

&kontact;i KPiloti kokkuvõtteplugin

#### &kontact;i kokkuvõttepluginad: kirjad

&kontact;i kokkuvõttevaate kirjade plugin lisab vaatesse ala nimetusega Uued kirjad. See uueneb pidevalt, kui sa saad uue kirja, andes teada, kui palju on uusi kirju ja millistes kaustades nad paiknevad.

&kontact;i kirjade kokkuvõtteplugin &kontact;i kirjade kokkuvõtteplugin

&kontact;i kirjade kokkuvõtteplugin

#### &kontact;i kokkuvõttepluginad: uudistejälgija

&kontact;i kokkuvõttevaate uudistejälgija plugin lisab vaatesse ala nimetusega Uudistekanalid. Selles näidatakse värskeimaid uudiseid seadistatud uudistekanalitest. Kanaleid saab lisada ja eemaldada ka &kontact;i kokkuvõttevaate seadistustedialoogis. Palun arvesta, et &kde; 3.4 korral on kõige tõhusam viis RSS-kanalite info hankimiseks uus rakendus &akregator;, mis kasutab märguandeid ega nõua selleks, et teada saada, kas on mõni uus artikkel, pidevat kokkuvõttevaate kontrollimist.

&kontact;i uudistejälgija plugin &kontact;i uudistejälgija plugin

&kontact;i uudistejälgija plugin

#### &kontact;i kokkuvõttepluginad: sedelid

&kontact;i kokkuvõttevaate sedelite plugin lisab vaatesse ala nimetusega Sedelid. See näitab kõiki parajasti olemasolevate sedelite tiitleid (vaikimisi on neiks sedeli loomise kuupäev/kellaaeg). Sedeli tiitlil klõpsates see avatakse.

&kontact;i sedelite kokkuvõtteplugin &kontact;i sedelite kokkuvõtteplugin

&kontact;i sedelite kokkuvõtteplugin

#### &kontact;i kokkuvõttepluginad: ülesannete nimekiri

&kontact;i kokkuvõttevaate ülesannete nimekirja plugin lisab vaatesse ala nimetusega Ülesanded. Sellel on näha kõik aktiivsed ülesanded, sealhulgas ka lõpetatud. Näidatakse ülesande tiitlit, täitmise protsenti ja parajasti kehtivat olekut. Pane tähele, et soovi korral võid &kontact;i ülesannete nimekirjast kustutada kõik lõpetatud ülesanded. Praegu ei tee ülesande tiitlil klõpsamine veel midagi.

&kontact;i ülesannete nimekirja kokkuvõtteplugin &kontact;i ülesannete nimekirja kokkuvõtteplugin

&kontact;i ülesannete nimekirja kokkuvõtteplugin

#### &kontact;i kokkuvõttepluginad: tähtpäevad

&kontact;i kokkuvõttevaate tähtpäevade plugin lisab vaatesse ala nimetusega Tähtpäevad. Selles näidatakse infot vastavalt &kontact;i kokkuvõttevaate seadistustedialoogis antud pluginale määratud valikutele. Tähtpäevade plugin on eriti kasulik selle poolest, et see näitab sünnipäevi, mitmesuguseid tähtpäevi, pühasid ja muid erisündmusi nii kalendrist kui kontaktide nimekirjast üheskoos.

&kontact;i tähtpäevade kokkuvõtteplugin &kontact;i tähtpäevade kokkuvõtteplugin

&kontact;i tähtpäevade kokkuvõtteplugin

#### &kontact;i kokkuvõttepluginad: ilm

&kontact;i kokkuvõttevaate ilmateate plugin lisab vaatesse ala nimetusega Ilmateade. Sellel leidub parajasti määratud ilmajaama info. Täpsemalt kõneleb &kontact;i pluginana kasutatud ilmateaterakenduse KWeather seadistamisest KWeatheri käsiraamat.

&kontact;i ilmateate kokkuvõtteplugin &kontact;i ilmateate kokkuvõtteplugin

&kontact;i ilmateate kokkuvõtteplugin

## &kontact; käsurealt

&kontact; kasutab mitmeid käsurea argumente, millega saab ette võtta teatud toiminguid.

Kõigepealt toetab &kontact; kõiki argumente, mida toetavad muudki KDE/Qt rakendused. Neist saab ülevaate järgmise käsuga:

`%` `kontact --help-all`

&kontact; pakub aga ka mõningaid omaenda argumente.

### Käsurea argumendid

#### Moodulitega seotud argumendid

Kõigi olemasolevate &kontact;i moodulite nimekirja annab käsk:

`%` `kontact --list`

&kontact;i käivitamiseks aktiivse mooduliga tuleb anda käsk:

`%` `kontact --module `moodulinimi``

kus `moodulinimi` on üks eelmise käsuga leitud moodulitest.

## Tagaplaanil

&kontact; kasutab ulatuslikult mitmeid &kde; võtmetehnoloogiaid, eriti just KPartsi ja &DCOP;i.

Komponentide &GUI; integreeritus saavutatakse pluginate abil, mis pakuvad välja vastavate rakenduste KParts-versioone. Selleks on vaja kõigest väikest lisakihti omaenda aknas töötava autonoomse rakenduse juba olemasolevale koodile.

Komponentidevaheliseks suhtlemiseks on kasutusel &DCOP;. Selle heaks küljeks on asjaolu, et nii ei ole üldse vahet, kas rakendus on käivitatud iseseisvalt või KPartina &kontact;i põimitult. &kontact;i raames töötades kasutatakse &DCOP;i tõhusat protsessisisest režiimi.

## Autorid ja litsents

&kontact;

Rakenduse autoriõigus 2004: &kde; arendajad

Kaasautorid:

- Cornelius Schumacher schumacher@kde.org

- Daniel Molkentin molkentin@kde.org

- Don Sanders sanders@kde.org

- Tobias König tokoe@kde.org

- Matthis Hölzer-Klüpfel mhk@kde.org: &kontact; raamistiku esialgne autor.

- Kõik &kontact;i põimitud rakenduste kallal vaeva näinud kullahinda väärt arendajad, kelle päralt ongi suurim panus.

Dokumentatsiooni autoriõigus 2004-2005:

Kaasautorid:

- Cornelius Schumacher schumacher@kde.org

- Antonio Salazar savedfastcool@gmail.com

- Daniel Molkentin molkentin@kde.org

- Kõik KDE dokumentatsiooni meililisti liikmed, kes aitasid kaasa märkekeele ja stiili juures.

Tõlge eesti keelde: Marek Laane bald@starman.ee

&kontact;i kodulehekülg on http://kontact.kde.org

&underFDL; &underGPL;
&documentation.index;