KonsoleKalendar"> ]> Tuukka Pasanen

illuusio@mailcity.com

Allen Winter

awinterz@users.sourceforge.net

Malcolm Hunter

malcolm.hunter@gmx.co.uk

Tester &erik.kjaer.pedersen.role; 20022004Tuukka Pasanen 20032005Allen Winter &FDLNotice; 2004-04-15 1.1.1 &konsolekalendar; er en kommandolinjegrænseflade for &kde;'s kalender. KDE &package; &kappname; KOrganizer &konsolekalendar; er en kommandolinjegrænseflade for &kde;'s kalender. Den lader dig vise, indsætte, fjerne eller ændre kalenderbegivenheder via kommandolinjen eller fra et scriptsprog. Desuden kan &konsolekalendar; lave en ny &kde;-kalender, eksportere en &kde;-kalender til forskellige slags andre formater, og importere en anden &kde;-kalender. I sin basale tilstand viser &konsolekalendar; listen af begivenheder i standardkalenderen for den aktuelle dato (fra 7:00 til 17:00). Hovedfunktioner i &konsolekalendar;: Vis kalenderindgange fra en startdato og -tid til en slutdato og -tid Indsæt (tilføj) kalenderindgange Fjern (slet) kalenderindgange Modificér (ændr) kalenderindgange Lav en ny kalender Eksportér kalenderindgange til andre filformater Importér en eksisterende &kde;-kalender. &konsolekalendar; er ikke en anden grafisk grænseflade for en &kde;-kalender (&ie; &korganizer;) &konsolekalendar; er kun beregnet til brug hvor en grafisk brugergrænseflade ikke er praktisk eller mulig. &konsolekalendar; sørger ikke for et fuldstændigt sprog til at lave forespørgsler om brugerens kalender, det er heller ikke forfatternes hensigt nogensinde at tilføje en sådan mulighed. Enkle kommandolinjeflag findes der giver adgang til kalenderbegivenheder i et dato- og tidsinterval. I dette kapitel lærer du om de hovedfunktionerne i &konsolekalendar;, og hvordan de kontrolleres med parametre du kan angive på kommandolinjen (husk at &konsolekalendar; ikke har en grafisk brugergrænseflade; det er kun et kommandolinjeprogram). Du vil lære også om at indsætte, slette og ændre kalenderbegivenheder, og hvordan begivenheder eksporteres til andre filformater. Oprettelse og import af &kde;-kalendere vil også blive dækket i dette kapitel. I normaltilstand, eller ved at bruge flaget --view, vil &konsolekalendar; give en liste af begivenheder i et angivet dato- og tidsinterval. For at se alle dagens begivenheder (fra 7:00 til 17:00), køres simpelthen: % konsolekalendar I det næste eksempel, ser vi en liste af begivenheder for ugen fra 18. til 22. august: % konsolekalendar --view --date 2003-08-18 --end-date 2003-08-22 Vis de næste begivenheder på kalenderen fra nuværende tidspunkt og fremover: % konsolekalendar --next For at se alle begivenheder for de næste 5 dage: % konsolekalendar --show-next 5 &konsolekalendar; kan indsætte begivenheder i en &kde;-kalender eller kalenderressource med kommandolinjeflaget --add. Begivenheder som det lykkes at indsætte vil blive vist i &kde;'s kalenderprogrammer (såsom &korganizer;) med det samme. I det følgende eksempel indsættes en begivenhed som begynder 2003-06-04 (4. juni, 2003) klokken 10:00 og slutter klokken 12:00 med sammendraget "Lægebesøg" i brugerens standardkalenderressource: % konsolekalendar --add --date 2003-06-04 --time 10:00 \ --end-time 12:00 --summary "Doctor Visit" I dette eksempel tilføjes en fødselsdag til brugerens standardkalenderressource: % konsolekalendar --add --date 2003-06-06 --summary "My Birthday" \ --description "Party Time" Her indsættes en uges ferie i en delt ferie-kalender: % konsolekalendar --add --file vacation.ics --date 2003-08-01 \ --end-date 2003-08-07 --summary "Ferie" --description "Ingen vil nogensinde finde mig!" &konsolekalendar; understøtter fjernelse af indgange i en kalenderfil eller ressource ved brug af --delete kommandlinjeargument. Kalenderindgange der skal fjernes bliver angivet ved deres entydige strengidentifikator (UID) ved brug af --uid flaget. UID'er findes ved først at kigge på begivenehden, ved brug af --view flaget. Begivenheder som det lykkes at slette vil blive fjernet fra &kde;'s kalenderprogrammer (såsom &korganizer;) med det samme. Når du sletter noget fra en kalender kan du ikke fortryde det! Med andre ord, når du sletter en indgang kan du ikke reversere sletningen. Den er væk for evigt. Her sletter vi en kalenderindgang med UID &konsolekalendar;-1887551750.196: % konsolekalendar --delete --uid &konsolekalendar;-1887551750.196 &konsolekalendar; understøtter ændring af eksisterende indgange i en kalenderfil eller ressource ved brug af --change kommandolinjeargumentet. Kalenderindgange der skal ændres angives ved deres entydige strengidentifikator (UID) ved brug af --uid flaget. UID'er findes ved først at se begivenheden ved brug af --view flaget. Ændringer opfører sig på samme måde som indsætning: du kan ændre begivenhedens startdato og tid, slutdato og tid, sammendrag, sted og beskrivelse. Begivenheder som det lykkes at ændre vil blive vist ændret i &kde;'s kalenderprogrammer (såsom &korganizer;) med det samme. Eksempel: Her ændrer vi sammendraget og beskrivelsen af en kalenderindgang med UID &konsolekalendar;-1887551750.196: % konsolekalendar --change --uid &konsolekalendar;-1887551750.196 --summary "Få mit hovede undersøgt" --description "gå ikke til den læge igen!" &konsolekalendar; kan bruges til at lave en ny &kde;-kalenderfil. Da du ikke kan indsætte en indgang i en kalender der ikke eksisterer, må du først lave filen ved brug af --create og --file kommandolinjeargumenterne. Opret en kalenderfil ved navn /data/share/calendars/vacation.ics: % konsolekalendar --create --file /data/share/calendars/vacation.ics &konsolekalendar; kan eksportere en &kde;-kalender til andre velkendte formater. Eksport er en speciel form for visning. Som standard, vises begivenheder i &konsolekalendar; tekst-format. For at ændre visningsformater bruges --export-type kommandolinjeargumenter. For at se en liste af alle understøttede eksportformater, bruges --export-list flaget som i: % konsolekalendar --export-list Nogle, men ikke nødvendigvis alle, de understøttede formater er beskrevet i dette afsnit. &konsolekalendar; Tekstformat er &konsolekalendar;'s indfødte format og er designet til at være behageligt at læse til at kunne tolkes af opfølgningsscripter. &konsolekalendar;'s tekstformat er: Dato:\t<Tilfældets dato>(dddd åååå-MM-dd) [\t<Tilfældets starttid>(hh:mm) - <Tilfældets sluttid>(tt:mm)] Sammendrag: \t<Tilfældets sammendrag | "(intet tilgængeligt sammendrag)"> Sted: \t<Tilfældets sted | "(intet sted tilgængeligt)"> Beskrivelse: \t<Tilfældets beskrivelse | "(ingen beskrivelse tilgængelig)"> UID: \t<Tilfældets UID> -------------------------------------------------- For eksempel: Dato: Tirsdag 2003-11-01 8:00 - 9:00 Sammendrag: Møde med chefen Sted: Konferenceværelset Beskrivelse: Alle ansatte mødes med chefen i det store konferencerum. UID: &konsolekalendar;-1128954167.1013 Kort tekstformat er en mere kompakt, mindre ordrig udgave af &konsolekalendar;'s indfødte format. &konsolekalendar;'s kort tekstformat er: [--------------------------------------------------] {<Tilfældets dato>(dddd åååå-MM-dd)] [<Tilfældets starttid>(hh:mm) - <Tilfældets sluttid>(tt:mm) | "\t"] \t<Tilfældets sammendrag | \t>[, <Tilfældets sted>] \t\t<Tilfældets beskrivelse | "\t"> For eksempel: -------------------------------------------------- Tirsdag 2003-11-01 08:00 - 09:00 Møde med chefen, konferenceværelset Møde med alle medarbejdere for at diskutere projektet. Komma-adskilte værdier formatet viser begivenhedernes værdier i samme rækkefølge som &konsolekalendar;'s tekstformat. Den eneste forskel er at al informationen er på samme række med hvert felt adskilt af et komma. De resulterende eksporterede filer kan importeres direkte til regnearkprogrammer såsom &kspread;, OpenOffice.org Calc, og &Microsoft; Excel. CSV-formatet er også nemt at tolke med opfølgningsscripter. Komma-adskilt værdi (CSV) formatet er: ÅÅÅÅ-MM-DD,TT:MM,ÅÅÅÅ-MM-DD,HH:MM,Sammendrag,Sted,Beskrivelse,UID For eksempel: 2003-11-01,08:00,2003-11-01,09:00,Møde med chefen,Koneferenceværelset,Alle ansatte mødes \ med chefen i det store konferencerum.,&konsolekalendar;-1128954167.1013 HTML eksportformatet vil producere en gyldig HTML-fil der kan publiceres til WWW. Dette eksportformat er ikke passende for tolkning af opfølgningsscripter, men er meget godt til at publicere kalendere for nem offentlig læsning. TODO: Indsæt skærmaftryk her Dette format producerer en HTML-fil der viser alle aftaler i et bestemt datoområde.Dette eksportformat er ikke passende for tolkning af opfølgningsscripter, men er meget godt til at publicere kalendere for nem offentlig læsning. TODO: Indsæt skærmaftryk her &konsolekalendar; kan importere en ICS kalenderfil til en &kde; kalender. Alle begivenheder fra kalender der bliver importeret fra vil blive indsat, inklusive identiske begivenheder. I næste udgave af &konsolekalendar; vil identiske begivenheder ikke blive indsat. For at importere kalenderfilen enanden.ics i kalenderen denne.ics køres: % konsolekalendar --import enanden.ics --file denne.ics &konsolekalendar; understøtter følgende valg: Tilvalg Beskrivelse --help, --help-all Viser hjælp om programmets valg. --author Viser information om programmets forfattere. -v, --version Viser programmets versionsinformation. --license Viser programmets licensinformation. --verbose Udskriver hjælpsomme meddelelser under kørsel. --dry-run Udskriv hvad som ville være sket, men gør det ikke. Ændrer ingen filer: indsætter, fjerner eller ændrer ingen eksisterende filer, eller laver nogen nye filer. --file  kalenderfil Angiv en kalenderfil at bruge. Hvis andet ikke er angivet bruuges &korganizer;'s standardressource. Større virkningstilstande: --view Udskriv kalenderbegivenheder i angivet eksportformat. --add Indsæt en begivenhed i kalenderen. --change Ændr en eksisterende begivenhed i kalenderen. --delete Fjern en eksisterende begivenhed i kalenderen. --create Opret en ny kalenderfil hvis den ikke findes. --import  importfil Importér kalenderen i hovedkalenderen. Operationsændrerer: --all Vis alle kalenderindgange. --next Vis næste aktivitet i kalenderen. --show-next  dage Startende på det angivne tidspunkt, vis de næste # dages aktiviteter. --uid  UID Vis, slet eller ændr begivenheden med denne entydige strengidentifikator. --date  dato Begynd med dagen [ÅÅÅÅ-MM-DD]. Standardværdi er dagens dato. --time  tid Begynd med tiden [TT:MM]. Standardværdi for visning er 07:00. For at tilføje eller ændre en flydende begivenhed, bruges --time float eller --end-time float flagene. --end-date  slutdato Slut på dagen [ÅÅÅÅ-MM-DD]. Standardværdi angives af --date. --end-time  sluttid Slut på tidspunktet [TT:MM]. Standard sluttidspunkt for visning er 17:00. For at tilføje eller ændre en flydende begivenhed, bruges --time float eller --end-time float flagene. --epoch-start  epoke-start Start fra dette tidspunkt [sekunder efter epoken]. --epoch-end  epoke-tid Slut på dette tidspunkt [sekunder efter epoken]. --summary  sammenfatning Tilføj sammenfatning til begivenhed (virker ved tilføj og ændring). --description  beskrivelse Tilføj beskrivelse af begivenhed (virker ved tilføj og ændring). --location  location Tilføj sted til begivenhed (virker ved tilføj og ændring). Eksport-tilvalg: --export-type  eksporttype Eksportér filtypen. Standardfiltype for eksport er tekst. --export-file  eksportfil Eksportér til fil. Normalt skrives uddata til standardudskriften. --export-list Udskriv liste med eksporttyper som understøttes og slut af. &reporting.bugs; &updating.documentation; Hvilke indstillingsfiler anvender &konsolekalendar;? Ingen. Hvad er programnavnet for &konsolekalendar;? &konsolekalendar;s programnavn er konsolekalendar. Hvad er datospecifikationsformatet? &konsolekalendar; vil afslå datoer angivet på kommandolinjen med mindre de er angivet i følge ISO 8601 standarder, nemlig: ÅÅÅÅ-MM-DD. Hvor ÅÅÅÅ repræsenterer året med fire cifre (såsom 2003), MM repræsenterer måneden med to cifre (01,02,..,12), og DD repræsenterer dagen med to cifre (01,02,...,31). &konsolekalendar; eksporterer altid datoer i ISO 8601 formatet. Hvad er tidsspecifikationsformatet? &konsolekalendar; vil afslå tidspunkter angivet på kommandolinjen med mindre de er angivet i følge ISO 8601 standarder, nemlig: TT:MM:SS. Hvor TT repræsenterer timer med to cifre (01,02,...24), MM repræsenterer minutter med to cifre (01,02,..,60), og SS repræsenterer sekunder med to cifre (01,02,...,60). &konsolekalendar; eksporterer altid tider i ISO 8601 formatet. Vil &konsolekalendar; indsætte en ny begivenhed der er identisk med en der allerede eksisterer i kalenderen? Nej. Se næste spørgsmål. Hvordan afgør &konsolekalendar; om en begivenhed er identisk med en der allerede eksisterer i kalenderen? &konsolekalendar; tjekker den angiven startdato og tidspunkt, slutdato og tidspunkt, og sammndrag mod alle begivenheder i kalenderen. En begivenhed matcher hvis alle tre værdier er de samme som en eksisterende begivenhed. Kan en ikke-flydende begivenhed ændres til en flydende begivenhed? Ja. Brug --time float flaget med --change. Hvorfor bliver begivenhedernes UID'er udskrevet i de fleste eksportformater? Fordi du har brug for at angive UID'er for at slette eller ændre begivenheder. Hvis du ikke ønsker at se begivenhedernes UID'er så brug den korte eksporttype (--export-type short). Hvordan får jeg mit spørgsmål tilføjet til denne OSS? Send dine spørgsmål til illuusio@lycos.com. &konsolekalendar; Program ophavsret 2002,2003: Tuukka Pasanen illuusio@mailcity.com Allen Winter awinterz@users.sourceforge.net Dokumentation ophavsret 2003: Allen Winter awinterz@users.sourceforge.net Tuukka Pasanenilluusio@mailcity.com &erik.kjaer.pedersen.credit; &underFDL; &underGPL; &install.intro.documentation; &konsolekalendar; levereres sammen med &kde; 3, og er ikke separat tilgængeligt. &konsolekalendar; kræver at &kde;:s standardbibliotek er installeret (pakken tdelibs). For at kompilere fra kildekode, behøver du også &Qt; og tdelibs udviklingspakke. Du finder en liste over ændringer i filen ChangeLog. Dette afsnit giver et hurtigt overblik af byggeprocessen. Læs venligst Kompilering af &kde; 3.2.x for fuldstændige instruktioner. Hvis du ikke kan skaffe en passende forkompilerat binærpakke, skal du kompilere &konsolekalendar; selv fra kildekode. Hent kildekodefilen tdepim-x.x.tar.bz2. Pak den ud i en ny mappe med en kommando noget i retning af tar xvfj pakke.tar.bz2, og gå til mappen som er blevet lavet. &install.compile.documentation; Hvis du har mere end en version af &kde; installeret (f.eks. &kde; 2 og &kde; 3), kan &konsolekalendar; muligvis installeres i forkert &kde;-mappe. Hvis det behøves, kan du angive &kde;-mappen som et flag til ./configure. For eksempel, hvis &kde; er installeret i /opt/kde3: ./configure --prefix=/opt/kde3 Ingen særlige indstillinger kræves for at få &konsolekalendar; til at køre i &kde;'s desktopmiljø. &documentation.index;