<para>&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.</para>
<para>I sin basale tilstand viser &konsolekalendar; listen af begivenheder i standardkalenderen for den aktuelle dato (fra 7:00 til 17:00).</para>
<para>Hovedfunktioner i &konsolekalendar;: <itemizedlist>
<listitem><para>Vis kalenderindgange fra en startdato og -tid til en slutdato og -tid</para></listitem>
<listitem><para>Lav en ny kalender</para></listitem>
<listitem><para>Eksportér kalenderindgange til andre filformater</para></listitem>
<listitem><para>Importér en eksisterende &kde;-kalender.</para></listitem>
</itemizedlist></para>
<para>&konsolekalendar; er <emphasis>ikke</emphasis> 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.</para>
<para>&konsolekalendar; sørger <emphasis>ikke</emphasis> 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. </para>
<para>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).</para>
<para>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. </para>
<para>I normaltilstand, eller ved at bruge flaget <parameter>--view</parameter>, vil &konsolekalendar; give en liste af begivenheder i et angivet dato- og tidsinterval.</para>
<para>&konsolekalendar; kan indsætte begivenheder i en &kde;-kalender eller kalenderressource med kommandolinjeflaget <parameter>--add</parameter>. Begivenheder som det lykkes at indsætte vil blive vist i &kde;'s kalenderprogrammer (såsom &korganizer;) med det samme.</para>
<informalexample><para>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:</para>
<option>--end-date <replaceable>2003-08-07</replaceable></option> <option>--summary <replaceable>"Ferie"</replaceable></option> <option>--description <replaceable>"Ingen vil nogensinde finde mig!"</replaceable></option></userinput></screen>
<para>&konsolekalendar; understøtter fjernelse af indgange i en kalenderfil eller ressource ved brug af <parameter>--delete</parameter> kommandlinjeargument. Kalenderindgange der skal fjernes bliver angivet ved deres entydige strengidentifikator (<acronym>UID</acronym>) ved brug af <parameter>--uid</parameter> flaget. <acronym>UID'er</acronym> findes ved først at kigge på begivenehden, ved brug af <parameter>--view</parameter> flaget.</para>
<para>Begivenheder som det lykkes at slette vil blive fjernet fra &kde;'s kalenderprogrammer (såsom &korganizer;) med det samme.</para>
<warning><para>Når du sletter noget fra en kalender kan du <emphasis>ikke</emphasis> fortryde det! Med andre ord, når du sletter en indgang kan du ikke reversere sletningen. Den er væk for evigt.</para></warning>
<informalexample><para>Her sletter vi en kalenderindgang med <acronym>UID</acronym> <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>
<para>&konsolekalendar; understøtter ændring af eksisterende indgange i en kalenderfil eller ressource ved brug af <parameter>--change</parameter> kommandolinjeargumentet. Kalenderindgange der skal ændres angives ved deres entydige strengidentifikator (<acronym>UID</acronym>) ved brug af <parameter>--uid</parameter> flaget. <acronym>UID'er</acronym> findes ved først at se begivenheden ved brug af <parameter>--view</parameter> flaget.</para>
<para>Æ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.</para>
<para><emphasis>Eksempel:</emphasis> Her ændrer vi sammendraget og beskrivelsen af en kalenderindgang med <acronym>UID</acronym> <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>"Få mit hovede undersøgt"</replaceable></option> <option>--description <replaceable>"gå ikke til den læge igen!"</replaceable></option> </userinput> </para>
<para>&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 <parameter>--create</parameter> og <parameter>--file</parameter> kommandolinjeargumenterne.</para>
<para>&konsolekalendar; kan eksportere en &kde;-kalender til andre velkendte formater. Eksport er en speciel form for visning. Som standard, vises begivenheder i <quote>&konsolekalendar; tekst</quote>-format. For at ændre visningsformater bruges <parameter>--export-type</parameter> kommandolinjeargumenter.</para>
<para>&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.</para>
<para>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;, <application>OpenOffice.org Calc</application>, og <application>&Microsoft; Excel</application>. <acronym>CSV</acronym>-formatet er også nemt at tolke med opfølgningsscripter.</para>
<para><acronym>HTML</acronym> eksportformatet vil producere en gyldig <acronym>HTML</acronym>-fil der kan publiceres til <acronym>WWW</acronym>. Dette eksportformat er ikke passende for tolkning af opfølgningsscripter, men er meget godt til at publicere kalendere for nem offentlig læsning.</para>
<para>Dette format producerer en <acronym>HTML</acronym>-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.</para>
<para>&konsolekalendar; kan importere en <acronym>ICS</acronym> 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.</para>
<informalexample><para>For at importere kalenderfilen <filename><replaceable>enanden.ics</replaceable></filename> i kalenderen <filename><replaceable>denne.ics</replaceable></filename> køres:</para>
<entry>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.</entry>
<entry>Begynd med tiden [TT:MM]. Standardværdi for visning er 07:00. <para>For at tilføje eller ændre en flydende begivenhed, bruges <option>--time float</option> eller <option>--end-time float</option> flagene.</para></entry>
<entry>Slut på tidspunktet [TT:MM]. Standard sluttidspunkt for visning er 17:00. <para>For at tilføje eller ændre en flydende begivenhed, bruges <option>--time float</option> eller <option>--end-time float</option> flagene.</para></entry>
<para>&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).</para>
<para>&konsolekalendar; eksporterer altid datoer i ISO 8601 formatet.</para>
<para>&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).</para>
<para>&konsolekalendar; eksporterer altid tider i ISO 8601 formatet.</para>
<para>&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. </para>
<para>Fordi du har brug for at angive <acronym>UID'er</acronym> for at slette eller ændre begivenheder. Hvis du ikke ønsker at se begivenhedernes <acronym>UID'er</acronym> så brug den <emphasis>korte</emphasis> eksporttype (<option>--export-type short</option>). </para>
<para>&konsolekalendar; kræver at &kde;:s standardbibliotek er installeret (pakken <filename>tdelibs</filename>). For at kompilere fra kildekode, behøver du også &Qt; og <filename>tdelibs</filename> udviklingspakke.</para>
<para>Du finder en liste over ændringer i filen <filename>ChangeLog</filename>.</para>
<para>Dette afsnit giver et hurtigt overblik af byggeprocessen. Læs venligst <ulink url="http://developer.kde.org/build/compile_kde3_2.html"> Kompilering af &kde; 3.2.x</ulink> for fuldstændige instruktioner.</para>
<para>Hvis du ikke kan skaffe en passende forkompilerat binærpakke, skal du kompilere &konsolekalendar; selv fra kildekode. Hent kildekodefilen <filename>tdepim-x.x.tar.bz2</filename>. Pak den ud i en ny mappe med en kommando noget i retning af <userinput><command>tar</command> <option>xvfj <replaceable>pakke.tar.bz2</replaceable></option></userinput>, og gå til mappen som er blevet lavet.</para>
&install.compile.documentation; <note><para>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 <userinput><command>./configure</command></userinput>. For eksempel, hvis &kde; er installeret i <filename>/opt/kde3</filename>: </para>
