KonsoleKalendar"> ]> &konsolekalendar;i käsiraamat Tuukka Pasanen
illuusio@mailcity.com
Allen Winter
awinterz@users.sourceforge.net
Malcolm Hunter
malcolm.hunter@gmx.co.uk
Korrektor
Marek Laane
bald@online.ee
Tõlge eesti keelde
20022004Tuukka Pasanen 20032005Allen Winter &FDLNotice; 2004-04-15 1.1.1 &konsolekalendar; on &kde; kalendrite käsurealiides. KDE &package; &kappname; KOrganizer
Sissejuhatus &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. Põhirežiimis näitab &konsolekalendar; käesoleva päeva vaikekalendri sündmusi (ajavahemikus 7:00 kuni 17:00). &konsolekalendar;i põhiomadused: Kalendrikirjete näitamine alguskuupäevast/ajast lõppkuupäeva/ajani Kalendrikirjete lisamine Kalendrikirjete kustutamine Kalendrikirjete muutmine Uue kalendri loomine Kalendrikirjete eksport muudesse failivormingutesse Olemasoleva &kde; kalendri import &konsolekalendar; ei ole 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. &konsolekalendar; ei paku 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. Võimalused 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). 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. Sündmuste vaatamine Vaikerežiimis või võtmega --view näitab &konsolekalendar; kõiki määratud ajavahemikku jäävaid sündmusi. Kõigi tänaste sündmuste (7:00 kuni 17:00) vaatamiseks anna käsk: % konsolekalendar Järgmises näites saab näha kõiki nädalasse 18.-22. august jäävaid sündmusi: % konsolekalendar Järgnevate sündmuste nägemiseks kalendris alates käesolevast hetkest anna käsk: % konsolekalendar Kõigi järgmise viie päeva sündmuste vaatamiseks anna käsk: % konsolekalendar 5 Sündmuste lisamine &konsolekalendar; võib lisada sündmusi &kde; kalendrisse, kui anda käsureal võti --add. Edukalt sisestatud sündmused ilmuvad kohe nähtavale &kde; kalendrirakendustes (näiteks &korganizer;). 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": % konsolekalendar \ Selles näites lisatakse kasutaja vaikekalendrisse sünnipäev: % konsolekalendar \ Siin aga lisatakse jagatud puhkuse kalendrisse nädal puhkust: % konsolekalendar \ Kirjete eemaldamine &konsolekalendar; toetab kirjete eemaldamist kalendrifailist, kui anda käsureal võti --delete. Eemaldatavaid kalendrikirjeid saab täpselt määrata nende unikaalse identifikaatori (UID) abil, kasutades võtit --uid. UIDs leidmiseks tuleks esmalt sündmust vaadata, mida saab teha võtmega --view. Edukalt eemaldatud sündmused kustutatakse kohe ka &kde; kalendrirakendustest (näiteks &korganizer;). Kui midagi kalendrist kustutada, ei saa seda tagasi võtta! See tähendab, et kui sündmus on kustutatud, siis on see lõplik. Selles näites kustutame kalendrist kirje, mille UID on &konsolekalendar;-1887551750.196: % konsolekalendar Kirjete muutmine &konsolekalendar; toetab olemasolevate kirjete muutmist kalendrifailis, kui anda käsureal võti --change. Muudetavaid kalendrikirjeid saab täpselt määrata nende unikaalse identifikaatori (UID) abil, kasutades võtit --uid. UIDs leidmiseks tuleks esmalt sündmust vaadata, mida saab teha võtmega --view. 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;). Näide: muudame kokkuvõtet ja kirjeldust kalendrikirjel, mille UID on &konsolekalendar;-1887551750.196: % konsolekalendar Uue kalendrifaili loomine &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 --create ja --file. Loome kalendrifaili nimega /data/share/calendars/vacation.ics: % konsolekalendar Eksportimine muudesse vormingutesse &konsolekalendar; võib eksportida &kde; kalendri muudesse levinud vormingutesse. Eksportimine om vaatamise spetsiifiline vorm. Vaikimisi vaadatakse sündmusi &konsolekalendar;i teksti vormingus. Vaatevormingu muutmisest tuleb kasutada võtit --export-type. Kõigi toetatud ekspordivormingute nägemiseks kasuta võtit --export-list: % konsolekalendar Ekspordivormingud Selles osas kirjeldatakse mõningaid, kuid tingimata mitte kõiki toetatud vorminguid. &konsolekalendar;i teksti vorming &konsolekalendar;i teksti vorming on &konsolekalendar;i loomupärane vorming, mis on mõeldud võimalikult mugavaks lugemiseks ja võimalikele skriptidele parsitavaks. &konsolekalendar;i teksti vorming on: Date:\t<Sündmuse kuupäev>(dddd yyyy-MM-dd) [\t<Sündmuse algusaeg>(hh:mm) - <Sündmuse lõpuaeg>(hh:mm)] Summary: \t<Sündmuse kokkuvõte | "(kokkuvõte puudub)"> Location: \t<Sündmuse asukoht | "(asukoht puudub)"> Description: \t<Sündmuse kirjeldus | "(kirjeldus puudub)"> UID: \t<Sündmuse UID> -------------------------------------------------- Näiteks: Date: Teisipäev 2003-11-01 08:00 - 09:00 Summary: Üldkoosolek Location: Konverentsisaal Description: Kõigi töötajate koosolek projekti arutamiseks. UID: &konsolekalendar;-1128954167.1013 &konsolekalendar;i lühikese teksti vorming Lühikese teksti vorming võimaldab &konsolekalendar;i loomupärase vormingu kompaktsemat ja napisõnalisemat esitust. &konsolekalendar;i lühikese teksti vorming on: [--------------------------------------------------] {<Sündmuse kuupäev>(dddd yyyy-MM-dd)] [<Sündmuse algusaeg>(hh:mm) - <Sündmuse lõpuaeg>(hh:mm) | "\t"] \t<Sündmuse kokkuvõte | \t>[, <Sündmuse asukoht>] \t\t<Sündmuse kirjeldus | "\t"> Näiteks: -------------------------------------------------- Teisipäev 2003-11-01 08:00 - 09:00 Üldkoosolek, Konverentsisaal Kõigi töötajate koosolek projekti arutamiseks. Komadega eraldatud väärtuste (<acronym>CSV</acronym>) vorming 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;, OpenOffice.org Calc ja &Microsoft; Excel. Ka skriptid tulevad CSV vorminguga hõlpsasti toime. Komadega eraldatud väärtuste (CSV) vorming on: YYYY-MM-DD,HH:MM,YYYY-MM-DD,HH:MM,Kokkuvõte,Asukoht,Kirjeldus,UID Näiteks: 2003-11-01,08:00,2003-11-01,09:00,Üldkoosolek,Konverentsisaal,Kõigi töötajate koosolek \ suures konverentsisaalis.,&konsolekalendar;-1128954167.1013 <acronym>HTML</acronym> vorming HTML ekspordivorming annab tulemuseks korrektse HTML-faili, mida saab avaldada veebis (WWW). See ekspordivorming ei sobi eriti skriptidele, kuid on samas väga mõnus avalikult väljapandavate kalendrite loomiseks. TEGEMATA: lisada siia pilt <acronym>HTMLmonth</acronym> vorming See vorming annab tulemuseks HTML-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. TEGEMATA: lisada siia pilt Kalendrite importimine &konsolekalendar; suudab importida ICS 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. Importimaks kalendrifaili another.ics kalendrisse current.ics: % konsolekalendar Käsurea võtmed &konsolekalendar; toetab järgmisi võtmeid: Võti Kirjeldus Näitab abiteadet rakenduse võtmete kohta. Näitab infot rakenduse autori kohta. Näitab rakenduse versiooni. Näitab infot rakenduse litsentsi kohta. Näitab töö ajal selgitavaid teateid. 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.  kalendrifail Määrab, millist kalendrifaili kasutada. Kui on määramata, kasutatakse &korganizer;i vaikekalendrit. Peamised töörežiimid: Näitab kalendris olevaid sündmusi määratud vormingus. Lisab kalendrisse sündmuse. Muudab kalendris olevat sündmust. Eemaldab kalendrist sündmuse. Loob uue kalendrikirje, kui sellist veel ei ole.  importfail Impordib määratud kalendri põhikalendrisse. Töörežiimide lisavõtmed: Näitab kõiki kalendrikirjeid. Näitab järgmist sündmust kalendris.  päevad Näitab alates määratud päevast sündmusi järgneval # päeval.  UID Näitab, kustutab või muudab sündmust, millel on määratud unikaalne identifikaator.  kuupäev Alustab määratud kuupäevaga [YYYY-MM-DD]. Vaikimisi on see täna (Today)  kellaaeg Alustab määratud ajaga [HH:MM]. Vaikimisi 07:00. Liikuva sündmuse lisamiseks või muutmiseks kasuta võtit või .  lõppkuupäev Lõpetab määratud kuupäevaga [YYYY-MM-DD]. Vaikimisi sama, mis --date.  lõppaeg Lõpetab määratud ajal [HH:MM]. Vaikimisi 17:00 Liikuva sündmuse lisamiseks või muutmiseks kasuta võtit või .  epohhiaeg Alustab määratud ajast [sekundit alates epohhist].  epohhiaeg Lõpetab määratud ajal [sekundit alates epohhist].  kokkuvõte Lisab sündmusele kokkuvõtte (lisamisel ja muutmisel).  kirjeldus Lisab sündmusele kirjelduse (lisamisel ja muutmisel).  asukoht Lisab sündmusele asukoha (lisamisel ja muutmisel). Ekspordivõtmed:  eksporttüüp Eksportfaili tüüp. Vaikimisi on see tekst (Text)  eksportfail Ekspordib faili. Vaikimisi kirjutatakse väljund standardväljundisse (stdout). Näitab toetatud eksporttüüpide nimekirja. Küsimused ja vastused &reporting.bugs; &updating.documentation; Milliseid konfiguratsioonifaile &konsolekalendar; kasutab? Mitte ühtki. Mis on &konsolekalendar;i rakenduse nimi? &konsolekalendar;i rakenduse nimi on konsolekalendar. Milline on kuupäeva vorming? &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). &konsolekalendar; ekspordib kuupäeva alati vastavalt ISO 8601 vormingule. Milline on kellaaja vorming? &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). &konsolekalendar; ekspordib kellaaja alati vastavalt ISO 8601 vormingule. Kas &konsolekalendar; lisab uue sündmuse, kui see on identne kalendris juba leiduva sündmusega? Ei. Vaata järgmist küsimust. Kuidas &konsolekalendar; määrab, kas lisatav sündmus on identne mõne juba kalendris olemasoleva sündmusega? &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. Kas mitteliikuvat sündmust saab muuta liikuvaks? Jah. Kasuta võtit koos võtmega . Miks enamik eksportimisvorminguid lisab UID? Sündmuse kustutamiseks või muutmiseks on vaja teada selle UID-d. Kui sa ei soovi UIDs lisamist, kasuta lühikest eksporditüüpi (). Kuidas saan lisada oma küsimuse sellele FAQ-ile? Saada oma küsimus aadressile illuusio@lycos.com. Autorid ja litsents &konsolekalendar;i rakenduse autoriõigus 2002, 2003: Tuukka Pasanen illuusio@mailcity.com Allen Winter awinterz@users.sourceforge.net Dokumentatsiooni autoriõigus 2003: Allen Winter awinterz@users.sourceforge.net Tuukka Pasanen illuusio@mailcity.com Tõlge eesti keelde: Marek Laane bald@online.ee &underFDL; &underGPL; Paigaldamine &konsolekalendar;i hankimine &install.intro.documentation; &konsolekalendar; kuulub &kde;3 koosseisu ega ole omaette saadaval. Nõuded &konsolekalendar;i paigaldamiseks on vajalikud &kde; standardteegid (pakett tdelibs). Lähtetekstist kompileerimiseks on vajalikud ka &Qt; ja tdelibs arenduspaketid. Muudatuste nimekirja leiab failist ChangeLog. Kompileerimine ja paigaldamine See osa annab põgusa ülevaate ehitamisprotsessist. Põhjalikke juhiseid loe palun veebis Compiling &kde; 3.2.x. Kui sul ei õnnestu hankida sobivat eelnevalt kompileeritud binaarpaketti, tuleb &konsolekalendar; lähtetekstist ise kompileerida. Hangi lähtepakett tdepim-x.x.tar.bz2. Paki see lahti uude kataloogi käsuga tar ja liigu loodud kataloogi. &install.compile.documentation; 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 ./configure. Kui näiteks &kde; on paigaldatud kataloogi /opt/kde3: ./configure --prefix=/opt/kde3 Seadistamine Et &konsolekalendar; töötaks &kde; töölaual, ei ole vaja midagi spetsiaalselt seadistada. &documentation.index;