<para>&konsolekalendar; &kde; kalendrite käsurealiides. See võimaldab vaadata, lisada, eemaldada või muuta kalendris esinevaid sündmusi käsureal või skriptikeele vahendusel. Lisaks võib &konsolekalendar; luua uue &kde; kalendri, eksportida &kde; kalendri paljudesse muudesse vormingutesse ning importida mõne muu &kde; kalendri.</para>
<para>Põhirežiimis näitab &konsolekalendar; käesoleva päeva vaikekalendri sündmusi (ajavahemikus 7:00 kuni 17:00).</para>
<listitem><para>Uue kalendri loomine</para></listitem>
<listitem><para>Kalendrikirjete eksport muudesse failivormingutesse</para></listitem>
<listitem><para>Olemasoleva &kde; kalendri import</para></listitem>
</itemizedlist></para>
<para>&konsolekalendar; <emphasis>ei ole</emphasis> lihtsalt veel üks &kde; kalendri (st. &korganizer;i) graafiline kasutajaliides. &konsolekalendar; on mõeldud just sellisteks juhtumiteks, kus graafilise kasutajaliidese kasutamine ei ole mõttekas või võimalikki.</para>
<para>&konsolekalendar; <emphasis>ei paku</emphasis> kõiki võimalusi kasutaja kalendrile päringute esitamiseks ning autoril ei ole ka kavas midagi sellist kunagi pakkuda. Küll pakutakse põhilisi käsurea võtmeid ligipääsuks kalendri sündmustele ajalises järgnevuses ehk ajatemplite alusel. </para>
<para>Selles peatükis tutvustame &konsolekalendar;i mitmesuguseid võimalusi ehk siis asju, mida saab määrata käsureal (pea meeles, et &konsolekalendar; ei ole mitte graafiline kasutajaliides, vaid ainult ja ainult käsureaprogramm).</para>
<para>Samuti tuleb siin juttu kalendri sündmuste lisamisest, kustutamisest ja muutmisest ning sündmuste eksportimisest muudesse failivormingutesse. Käsitleme ka &kde; kalendrite loomis ja importimist. </para>
<para>&konsolekalendar; võib lisada sündmusi &kde; kalendrisse, kui anda käsureal võti <parameter>--add</parameter>. Edukalt sisestatud sündmused ilmuvad kohe nähtavale &kde; kalendrirakendustes (näiteks &korganizer;).</para>
<informalexample><para>Järgmises näites lisatakse kasutaja vaikekalendrisse sündmus, mis algab 2003-06-04 (4. juunil 2003) 10:00 ja lõpeb 12:00 ning mille kokkuvõte on "Arsti visiit":</para>
<option>--end-date <replaceable>2003-08-07</replaceable></option> <option>--summary <replaceable>"Puhkus"</replaceable></option> <option>--description <replaceable>"Keegi ei saa mind kätte!"</replaceable></option></userinput></screen>
<para>&konsolekalendar; toetab kirjete eemaldamist kalendrifailist, kui anda käsureal võti <parameter>--delete</parameter>. Eemaldatavaid kalendrikirjeid saab täpselt määrata nende unikaalse identifikaatori (<acronym>UID</acronym>) abil, kasutades võtit <parameter>--uid</parameter>. <acronym>UIDs</acronym> leidmiseks tuleks esmalt sündmust vaadata, mida saab teha võtmega <parameter>--view</parameter>.</para>
<para>Edukalt eemaldatud sündmused kustutatakse kohe ka &kde; kalendrirakendustest (näiteks &korganizer;).</para>
<warning><para>Kui midagi kalendrist kustutada, <emphasis>ei saa</emphasis> seda tagasi võtta! See tähendab, et kui sündmus on kustutatud, siis on see lõplik.</para></warning>
<informalexample><para>Selles näites kustutame kalendrist kirje, mille <acronym>UID</acronym> on <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>
<para>&konsolekalendar; toetab olemasolevate kirjete muutmist kalendrifailis, kui anda käsureal võti <parameter>--change</parameter>. Muudetavaid kalendrikirjeid saab täpselt määrata nende unikaalse identifikaatori (<acronym>UID</acronym>) abil, kasutades võtit <parameter>--uid</parameter>. <acronym>UIDs</acronym> leidmiseks tuleks esmalt sündmust vaadata, mida saab teha võtmega <parameter>--view</parameter>.</para>
<para>Muutmine käib sarnaselt lisamisega: muuta saab sündmuse algus- ja lõppkuupäeva, algus- ja lõppaega, kirjeldust ja kokkuvõtet. Edukalt muudetud sündmused on muudetud kujul kohe näha ka &kde; kalendrirakendustes (näiteks &korganizer;).</para>
<para><emphasis>Näide:</emphasis> muudame kokkuvõtet ja kirjeldust kalendrikirjel, mille <acronym>UID</acronym> on <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>
<para><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--change</option> <option>--uid <replaceable>&konsolekalendar;-1887551750.196</replaceable></option> <option>--summary <replaceable>"Lasen oma pead uurida"</replaceable></option> <option>--description <replaceable>"selle arsti juurde ma enam ei lähe!"</replaceable></option> </userinput> </para>
<para>&konsolekalendar;i abil võib luua uue &kde; kalendrifaili. Et kirjet ei saa lisada kalendrisse, mida ei ole olemas, tuleb esmalt luua fail, mida saab teha võtmetega <parameter>--create</parameter> ja <parameter>--file</parameter>.</para>
<para>&konsolekalendar; võib eksportida &kde; kalendri muudesse levinud vormingutesse. Eksportimine om vaatamise spetsiifiline vorm. Vaikimisi vaadatakse sündmusi <quote>&konsolekalendar;i teksti</quote> vormingus. Vaatevormingu muutmisest tuleb kasutada võtit <parameter>--export-type</parameter>.</para>
<para>&konsolekalendar;i teksti vorming on &konsolekalendar;i loomupärane vorming, mis on mõeldud võimalikult mugavaks lugemiseks ja võimalikele skriptidele parsitavaks.</para>
<title>Komadega eraldatud väärtuste (<acronym>CSV</acronym>) vorming</title>
<para>Komadega eraldatud väärtuste vorming näitab sündmuste väärtusi samas järjekorras nagu &konsolekalendar;i teksti vorming. Ainus erinevus on see, et kogu info on esitatud ühes reas, iga väli eraldatud komaga. Tulemuseks olevat eksportfaili saab vahetult importida tabelarvutusprogrammidesse, näiteks &kspread;, <application>OpenOffice.org Calc</application> ja <application>&Microsoft; Excel</application>. Ka skriptid tulevad <acronym>CSV</acronym> vorminguga hõlpsasti toime.</para>
<para>Komadega eraldatud väärtuste (<acronym>CSV</acronym>) vorming on: <informalexample> <screen>YYYY-MM-DD,HH:MM,YYYY-MM-DD,HH:MM,Kokkuvõte,Asukoht,Kirjeldus,UID
<para><acronym>HTML</acronym> ekspordivorming annab tulemuseks korrektse <acronym>HTML</acronym>-faili, mida saab avaldada veebis (<acronym>WWW</acronym>). See ekspordivorming ei sobi eriti skriptidele, kuid on samas väga mõnus avalikult väljapandavate kalendrite loomiseks.</para>
<para><emphasis>TEGEMATA:</emphasis> lisada siia pilt</para>
<para>See vorming annab tulemuseks <acronym>HTML</acronym>-faili, mis näitab kõiki kohtumisi kuus määratud ajavahemikus. See ekspordivorming ei sobi eriti skriptidele, kuid on samas väga mõnus avalikult väljapandavate kalendrite loomiseks.</para>
<para>&konsolekalendar; suudab importida <acronym>ICS</acronym> kalendrifaili &kde; kalendriks. Lisatakse kõik imporditava kalendri sündmused, ka siis, kui need peaksid olema identsed. Loodetavasti juba järgmises &konsolekalendar;i versioonis identseid sündmusi enam ei lisata.</para>
<entry>Näitab, mida mingi käsk teeb, kuid ei rakenda seda tegelikult. Ei muuda ühtegi faili, ei lisa, eemalda ega muuda olemasolevaid faile ega loo uusi faile.</entry>
<entry>Alustab määratud ajaga [HH:MM]. Vaikimisi 07:00. <para>Liikuva sündmuse lisamiseks või muutmiseks kasuta võtit <option>--time float</option> või <option>--end-time float</option>.</para></entry>
<entry>Lõpetab määratud ajal [HH:MM]. Vaikimisi 17:00 <para>Liikuva sündmuse lisamiseks või muutmiseks kasuta võtit <option>--time float</option> või <option>--end-time float</option>.</para></entry>
<para>&konsolekalendar; ei arvesta käsureal antud kuupäevi, kui need ei vasta ISO 8601 standardile, see tähendab, ei ole kujul YYYY-MM-DD, kus YYYY on neljakohaline aastanumber (näiteks 2003), MM kahekohaline kuu (01, 02...12) ja DD kahekohaline päev (01, 02...31).</para>
<para>&konsolekalendar; ekspordib kuupäeva alati vastavalt ISO 8601 vormingule.</para>
<para>&konsolekalendar; ei arvesta käsureal antud kellaaegu, kui need ei vasta ISO 8601 standardile, see tähendab, ei ole kujul HH:MM:SS, kus HH on kahekohaline tundide number (01, 02...24), MM kahekohaline minutite number (01, 02...60) ja DD kahekohaline sekundite number (01, 02...60).</para>
<para>&konsolekalendar; ekspordib kellaaja alati vastavalt ISO 8601 vormingule.</para>
<para>&konsolekalendar; võrdleb lisatava sündmuse algus- ja lõppkuupäeva, algus- ja lõppkellaaega ning kokkuvõtet kõigi kalendris olemasolevate sündmuste vastavate väärtustega. Sündmused loetakse identseks, kui kõik kolm vääartust kattuvad. </para>
<para>Sündmuse kustutamiseks või muutmiseks on vaja teada selle <acronym>UID</acronym>-d. Kui sa ei soovi <acronym>UIDs</acronym> lisamist, kasuta <emphasis>lühikest</emphasis> eksporditüüpi (<option>--export-type short</option>). </para>
<para>&konsolekalendar;i paigaldamiseks on vajalikud &kde; standardteegid (pakett <filename>tdelibs</filename>). Lähtetekstist kompileerimiseks on vajalikud ka &Qt; ja <filename>tdelibs</filename> arenduspaketid.</para>
<para>Muudatuste nimekirja leiab failist <filename>ChangeLog</filename>.</para>
<para>See osa annab põgusa ülevaate ehitamisprotsessist. Põhjalikke juhiseid loe palun veebis <ulink url="http://developer.kde.org/build/compile_kde3_2.html"> Compiling &kde; 3.2.x</ulink>.</para>
<para>Kui sul ei õnnestu hankida sobivat eelnevalt kompileeritud binaarpaketti, tuleb &konsolekalendar; lähtetekstist ise kompileerida. Hangi lähtepakett <filename>tdepim-x.x.tar.bz2</filename>. Paki see lahti uude kataloogi käsuga <userinput><command>tar</command> <option>xvfj <replaceable>pakett.tar.bz2</replaceable></option></userinput> ja liigu loodud kataloogi.</para>
&install.compile.documentation; <note><para>Kui paigaldatud on enam kui üks &kde; versioon (nt. &kde;2 ja &kde;3), võib juhtuda, et paigaldad &konsolekalendar;i valesse &kde; kataloogi. Vajadusel anna &kde; kataloog parameetrina käsule <userinput><command>./configure</command></userinput>. Kui näiteks &kde; on paigaldatud kataloogi <filename>/opt/kde3</filename>: </para>