<para>&konsolekalendar; är ett kommandoradgränssnitt för &kde;:s kalendrar. Det låter dig visa, infoga, ta bort eller ändra kalenderhändelser via kommandoraden eller från ett skriptspråk. Dessutom kan &konsolekalendar; skapa en ny &kde;-kalender, exportera en &kde;-kalender till ett antal andra format, och importera en annan &kde;-kalender.</para>
<para>I sitt grundläggande läge visar &konsolekalendar; händelselistan i standardkalendern för aktuellt datum (från 7:00 till 17:00).</para>
<para>Huvudfunktioner i &konsolekalendar;: <itemizedlist>
<listitem><para>Visa kalenderposter från ett startdatum och -tid till ett slutdatum och -tid</para></listitem>
<listitem><para>Skapa en ny kalender</para></listitem>
<listitem><para>Exportera kalenderposter till andra filformat</para></listitem>
<listitem><para>Importera en befintlig &kde;-kalender</para></listitem>
</itemizedlist></para>
<para>&konsolekalendar; är <emphasis>inte</emphasis> ett annat grafiskt gränssnitt till en &kde;-kalender (dvs. &korganizer;) &konsolekalendar; är bara avsett för användning där ett grafiskt användargränssnitt inte är praktiskt eller möjligt.</para>
<para>&konsolekalendar; tillhandahåller <emphasis>inte</emphasis> ett fullständigt språk för att göra förfrågningar om användarens kalender, det är heller inte upphovsmännens avsikt att någonsin lägga till en sådan möjlighet. Enkla kommandoradsväljare tillhandahålls för att komma åt kalenderhändelser i ett datum- och tidsintervall. </para>
<para>I det här kapitlet lär du dig om huvudfunktionerna i &konsolekalendar;, och hur du kan styra dem med kommandoradsväljare (kom ihåg att &konsolekalendar; inte har ett grafiskt användargränssnitt, utan bara är ett kommadoradsprogram).</para>
<para>Du lär dig om att infoga, ta bort och ändra kalenderhändelser, och hur händelser kan exporteras till andra filformat. Att skapa och importera &kde;-kalendrar täcks också i det här kapitlet. </para>
<para>I normalläge, eller genom att använda väljaren <parameter>--view</parameter>, listar &konsolekalendar; händelser i ett angivet datum- och tidsintervall.</para>
<para>&konsolekalendar; kan infoga händelser i en &kde;-kalender eller kalenderresurs med kommandoradsväljaren <parameter>--add</parameter>. Händelser som infogas med lyckat resultat, visas omedelbart av &kde;:s kalenderprogram (som &korganizer;).</para>
<informalexample><para>I följande exempel infogas en händelse som börjar 2003-06-04 (4:e juni, 2003) klockan 10:00 och slutar klockan 12:00 med sammanfattningen "Läkarbesök" i användarens standardkalenderresurs:</para>
<para>&konsolekalendar; stöder att ta bort poster i en kalenderfil eller resurs med kommandoradsväljaren <parameter>--delete</parameter>. Kalenderposter som ska tas bort specificeras exakt med en unik identifieringssträng (<acronym>UID</acronym>) med väljaren <parameter>--uid</parameter>. Unika identifierare hittas genom att först titta på händelsen med väljaren <parameter>--view</parameter>.</para>
<para>Händelser som tas bort med lyckat resultat, tas omedelbart bort inne i &kde;:s kalenderprogram (till exempel &korganizer;).</para>
<warning><para>När du tar bort något från kalendern kan du <emphasis>inte</emphasis> ångra det! Med andra ord, när du tar bort en post kan du inte få tillbaka den borttagna posten. Den är borta för alltid.</para></warning>
<para>&konsolekalendar; stöder att ändra befintliga poster i en kalenderfil eller resurs med kommandoradsväljaren <parameter>--change</parameter>. Kalenderposter som ska ändras specificeras exakt med en unik identifieringssträng (<acronym>UID</acronym>) med väljaren <parameter>--uid</parameter>. Unika identifierare hittas genom att först titta på händelsen med väljaren <parameter>--view</parameter>.</para>
<para>Att ändra beter sig på samma sätt som att infoga: Du kan ändra startdatum och -tid, slutdatum och -tid, beskrivning, plats och sammanfattning för en händelse. För händelser som ändras med lyckat resultat, visas ändringen omedelbart av &kde;:s kalenderprogram (som &korganizer;).</para>
<para><emphasis>Exempel:</emphasis> Här ändrar vi sammanfattningen och beskrivningen för en kalenderpost med <acronym>UID</acronym> <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>
<para>&konsolekalendar; kan användas för att skapa en ny &kde;-kalenderfil. Eftersom du inte kan infoga en post i en kalender som inte finns, måste du först skapa filen med kommandoradsväljarna <parameter>--create</parameter> och <parameter>--file</parameter>.</para>
<para>&konsolekalendar; kan exportera en &kde;-kalender till andra välkända format. Att exportera är ett särskilt sätt att visa. Normalt visas händelser med <quote>&konsolekalendar; textformat</quote>. För att ändra visningsformat använd kommandoradsväljaren <parameter>--export-type</parameter>.</para>
<para>&konsolekalendar;-textformat är &konsolekalendar;s eget format och det är konstruerat för att vara bekvämt att läsa och kunna tolkas av efterföljande skript.</para>
<title>Format med värden åtskilda av kommatecken (<acronym>CSV</acronym>)</title>
<para>Formatet med värden åtskilda av kommatecken visar händelsevärden i samma ordning som &konsolekalendar;s textformat. Den enda skillnaden är att informationen finns på samma rad med varje fält åtskilt av ett kommatecken. De skapade exportfilerna kan direkt importeras i kalkylark som &kspread;, <application>OpenOffice.org Calc</application> och <application>&Microsoft; Excel</application>. Dessutom är <acronym>CSV</acronym>-formatet lätt att tolka med efterföljande skript.</para>
<para>Formatet med värden åtskilda av kommatecken (<acronym>CSV</acronym>) är: <informalexample> <screen>ÅÅÅÅ-MM-DD,TT:MM,ÅÅÅÅ-MM-DD,TT:MM,sammanfattning,plats,beskrivning,UID
<para>Exportformatet <acronym>HTML</acronym> skapar en giltig <acronym>HTML</acronym>-fil som kan publiceras på <acronym>WWW</acronym>. Exportformatet är inte lämpligt för efterföljande tolkning av ett skript, men är mycket trevligt för att publicera kalendrar så att de enkelt kan beskådas.</para>
<para>Formatet skapar en <acronym>HTML</acronym>-fil som visar alla möten under de månader som anges av tidsintervallet. Exportformatet är inte lämpligt för efterföljande tolkning av ett skript, men är mycket trevligt för att publicera kalendrar så att de enkelt kan beskådas.</para>
<para>&konsolekalendar; kan importera en <acronym>ICS</acronym>-kalenderfil till en &kde;-kalender. Alla händelser från kalendern som importeras infogas, inklusive identiska händelser. I nästa utgåva av &konsolekalendar; kommer inte identiska händelser att infogas.</para>
<informalexample><para>För att importera kalenderfilen <filename><replaceable>annan.ics</replaceable></filename> i kalendern <filename><replaceable>aktuell.ics</replaceable></filename>, kör:</para>
<entry>Skriv ut vad som skulle ha gjorts, men utför det inte. Ändrar inga filer: infogar, tar bort eller ändrar inga befintliga filer, eller skapar några nya filer.</entry>
<entry>Börja med tiden [TT:MM]. Standardvärde för visning är 07:00. <para>För att lägga till eller ändra en flytande händelse, använd alternativen <option>--time float</option> eller <option>--end-time float</option>.</para></entry>
<entry>Sluta med tiden [TT:MM]. Standardvärde för visning är 17:00. <para>För att lägga till eller ändra en flytande händelse, använd alternativen <option>--time float</option> eller <option>--end-time float</option>.</para></entry>
<para>&konsolekalendar; förkastar datum som anges på kommandoraden om de inte anges enligt standarden ISO 8601, det vill säga ÅÅÅÅ-MM-DD, där ÅÅÅÅ representerar år med fyra siffror (som 2003), MM representerar månader med två siffror (01, 02, ... 12), och DD representerar dagar med två siffror (01, 02, ... 31).</para>
<para>&konsolekalendar; exporterar alltid datum enligt formatet ISO 8601.</para>
<para>&konsolekalendar; förkastar tider som anges på kommandoraden om de inte anges enligt standarden ISO 8601, det vill säga TT:MM:SS, där TT representerar timmar med två siffror (01, 02, ... 24), MM representerar minuter med två siffror (01, 02, ... 60), och SS representerar sekunder med två siffror (01, 02, ... 60).</para>
<para>&konsolekalendar; exporterar alltid tider enligt formatet ISO 8601.</para>
<para>&konsolekalendar; kontrollerar angivet startdatum och -tid, slutdatum och -tid, och sammanfattningen mot alla händelser i kalendern. En träff sker om alla tre värden passar ihop med en befintlig händelse. </para>
<para>Eftersom du måste ange <acronym>UID</acronym>:er för att ta bort eller ändra händelser. Om du inte vill se händelsernas <acronym>UID</acronym>:er, använd då exportformatet <emphasis>kort</emphasis> (<option>--export-type short</option>). </para>
<para>&konsolekalendar; kräver att &kde;:s standardbibliotek är installerade (paketet <filename>tdelibs</filename>). För att kompilera från källkod, behöver du också &Qt; och <filename>tdelibs</filename> utvecklingspaket.</para>
<para>Du hittar en lista över ändringar i filen <filename>ChangeLog</filename>.</para>
<para>Det här avsnittet ger en snabb översikt av byggprocessen. Läs gärna <ulink url="http://developer.kde.org/build/compile_kde3_2.html">Kompilera &kde; 3.2.x</ulink> för fullständiga instruktioner.</para>
<para>Om du inte kan skaffa ett lämpligt förkompilerat binärpaket, måste du kompilera &konsolekalendar; själv från källkod. Hämta källkodspaketfilen <filename>tdepim-x.x.tar.bz2</filename>. Packa upp den i en ny katalog med ett kommando som liknar <userinput><command>tar</command> <option>xvfj <replaceable>paket.tar.bz2</replaceable></option></userinput>, och gå till katalogen som har skapats.</para>
&install.compile.documentation; <note><para>Om du har mer än en version av &kde; installerad (t.ex. &kde; 2 och &kde; 3), kan &konsolekalendar; möjligen installeras i fel &kde;-katalog. Om det behövs, kan du ange &kde;-katalogen som en väljare till <userinput><command>./configure</command></userinput>. Till exempel, om &kde; är installerad i <filename>/opt/kde3</filename>: </para>
