<para>&konsolekalendar; is een toepassing om op de commandoregel de &kde;-kalender te kunnen raadplegen. U kunt evenementen bekijken, wijzigen of verwijderen vanaf een commandoregel of via een scripttaal. Tevens is het mogelijk om via &konsolekalendar; een nieuwe kalender te beginnen, een bestaande kalender te exporteren naar verschillende formaten of een andere &kde;-kalender te importeren.</para>
<para>De eenvoudigste toepassing van &konsolekalendar; is om de evenementen in uw standaardkalender van vandaag (tussen 7:00u en 17:00u) weer te geven.</para>
<para>De hoofdfuncties van &konsolekalendar;: <itemizedlist>
<listitem><para>Evenementen tussen twee data en tijdstippen bekijken</para></listitem>
<para>&konsolekalendar; heeft <emphasis>geen</emphasis> grafische schil voor de &kde;-kalender. Dit heeft &korganizer; bijvoorbeeld wel. &konsolekalendar; is gemaakt voor gebruikers die geen grafische desktop geactiveerd hebben of waarvoor een grafische desktop onhandig zou zijn.</para>
<para>&konsolekalendar; is <emphasis>geen</emphasis> complete set met alle mogelijke commando's om kalenders te raadplegen. Dat is ook nooit de bedoeling geweest van de auteur. Er kunnen alleen eenvoudige opties worden gebruikt om evenementen van de kalender op te roepen, te wijzigen en te verwijderen. </para>
<para>In dit hoofdstuk vindt u uitleg over de belangrijkste mogelijkheden van &konsolekalendar; en hoe u deze via parameters op de commandoregel kunt gebruiken (bedenk dat &konsolekalendar; geen grafische schil biedt, het kan alleen op de commandoregel gebruikt worden).</para>
<para>U vindt uitleg over het toevoegen, verwijderen en wijzigen van evenementen en hoe u evenementen kunt exporteren naar bepaalde bestandsformaten. Tevens wordt er aandacht besteed aan het importeren en creëren van &kde;-kalenders. </para>
<para>Standaard, of door het opgeven van de parameter <parameter>--view</parameter> zal &konsolekalendar; de evenementen weergeven die in een bepaalde periode vallen.</para>
<para>&konsolekalendar; kan evenementen toevoegen in een &kde;-kalender door de parameter <parameter>-add</parameter> te gebruiken. Evenementen die succesvol toegevoegd zijn, worden direct getoond in &kde;-kalendertoepassingen, zoals &korganizer;.</para>
<informalexample><para>In het volgende voorbeeld voegen we een evenement toe op )4 juni 2005, 10:00u. Het eindigt om 12:00u en heeft als titel "Tandarts bezoek".</para>
<para>U kunt evenementen verwijderen met behulp van &konsolekalendar; door de volgende parameter te gebruiken: <parameter>--delete</parameter>. Evenementen worden verwijderd door de unieke identificatie-code (<acronym>UID</acronym>) te gebruiken bij de parameter <parameter>--uid</parameter>. <acronym>UID</acronym>s kunnen gevonden worden door het evenement te bekijken met de <parameter>--view</parameter> parameter.</para>
<para>Evenementen die succesvol worden verwijderd, worden ook direct verwijderd uit &kde;-kalendertoepassingen zoals &korganizer;.</para>
<warning><para>Wanneer u evenementen verwijdert kan dit <emphasis>niet</emphasis> ongedaan gemaakt worden. Met andere woorden, weg is weg, voorgoed.</para></warning>
<informalexample><para>Voorbeeld van het verwijderen van een evenement met het <acronym>UID</acronym> <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>
<para>In &konsolekalendar; kunnen evenementen gewijzigd worden door gebruik te maken van de parameter <parameter>--change</parameter>. Het wijzigen van evenementen gaat aan de hand van de unieke identificatie-code (<acronym>UID</acronym>), die wordt opgegeven bij de parameter <parameter>--uid</parameter>. <acronym>UID</acronym>s kunnen worden gevonden door het evenement met de <parameter>--view</parameter> parameter te bekijken.</para>
<para>Wijzigen werkt op dezelfde manierals toevoegen: u kunt de start- en eindtijd wijzigen, de start- en einddatum, de titel, de samenvatting, de locatie en de beschrijving. Gewijzigde evenementen worden direct zichtbaar in &kde;-kalendertoepassingen zoals &korganizer;.</para>
<para><emphasis>Voorbeeld:</emphasis> het wijzigen van de titel en beschrijving van een evenement met <acronym>UID</acronym> <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>
<para>&konsolekalendar; kan gebruikt worden om een nieuw &kde;-kalenderbestand te creëren. Aangezien het niet mogelijk is om een evenement toe te voegen aan een kalender die niet bestaat, moet het bestand eerst aangemaakt worden met de parameters <parameter>--create</parameter> en <parameter>--file</parameter>.</para>
<informalexample><para>Creëer een kalenderbestand met de naam <filename><replaceable>/data/share/calendars/vacation.ics</replaceable></filename>:</para>
<para>&konsolekalendar; kan &kde;-kalenders exporteren naar andere populaire formaten. Exporteren is eigenlijk een aparte manier van bekijken. Standaard worden evenementen bekeken in het <quote>&konsolekalendar; tekst</quote>-formaat. Om het formaat te wijzigen, wordt de parameter <parameter>--export-type</parameter> gebruikt.</para>
<para>Het &konsolekalendar; tekst-formaat is het standaardformaat dat door &konsolekalendar; gebruikt wordt. Het is ontwikkeld om op een prettige manier de evenementen te kunnen bekijken en om andere scripts de mogelijkheid te geven de gegevens te verwerken.</para>
<para>Het verkorte &konsolekalendar;-tekstformaat ziet er als volgt uit: <informalexample> <screen>[--------------------------------------------------]
<para>In het door komma's gescheiden formaat staan de velden in dezelfde volgorde als het &konsolekalendar;-tekstformaat. Het enige verschil is dat alle gegevens op één regel staan en gescheiden worden door een komma. Indien de gegevens in een bestand worden opgeslagen, kunnen deze zonder veel problemen in een spreadsheet worden geïmporteerd. Voorbeelden hiervan zijn &kspread;, <application>OpenOffice.org Calc</application> en <application>&Microsoft; Excel</application>. Ook is dit formaat uitermate geschikt voor verdere verwerking door andere scripts en toepassingen.</para>
<para>Het door komma's gescheiden formaat ziet er als volgt uit: <informalexample> <screen>JJJJ-MM-DD,UU:MM,JJJJ-MM-DD,UU:MM,Titel,Locatie,Omschrijving,UID
<para>Het <acronym>HTML</acronym>-formaat zal een <acronym>HTML</acronym>-bestand aanmaken dat geschikt is om op het <acronym>WWW</acronym> te publiceren. Dit formaat is niet geschikt voor verdere bewerkingen door andere scripts, maar is erg goed voor het publiceren van kalenders op het internet.</para>
<para><emphasis>TODO:</emphasis> hier komt een schermafdruk</para>
<para>Dit formaat maakt een <acronym>HTML</acronym>-bestand aan dat alle afspraken in de maanden uit het opgegeven datumbereik toont. Dit formaat is niet geschikt voor verdere bewerkingen door andere scripts, maar is erg goed voor het publiceren van kalenders op het internet.</para>
<para>&konsolekalendar; kan <acronym>ICS</acronym>-kalenders importeren in een &kde;-kalender. Alle evenementen van de kalender die worden geïmporteerd, worden ook toegevoegd aan de kalender. Dit zou kunnen leiden tot twee identieke evenementen op dezelfde datum en tijd. In de volgende uitgave van &konsolekalendar; zal dit waarschijnlijk verholpen worden.</para>
<informalexample><para>Om een <filename><replaceable>andere.ics</replaceable></filename> te importeren in de <filename><replaceable>huidige.ics</replaceable></filename>-kalender voert u het volgende commando uit:</para>
<entry>Drukt af wat er gedaan zou gaan worden zonder deze parameter. Nu veranderen er geen bestanden, er wordt niets toegevoegd, gewijzigd of verwijderd. Ook worden geen nieuwe bestanden aangemaakt.</entry>
<entry>Start vanaf dit tijdstip [UU:MM]. Standaard is dit 07:00u. <para>Om een evenement toe te voegen of te wijzigen zonder dat deze een vaste tijd heeft, gebruikt u <option>--time float</option> of <option>--end-time float</option>.</para></entry>
<entry>Eindig op dit tijdstip [UU:MM]. Standaard is dit 17:00u. <para>Om een evenement toe te voegen of te wijzigen zonder dat deze een vaste tijd heeft, gebruikt u <option>--time float</option> of <option>--end-time float</option>.</para></entry>
<para>&konsolekalendar; weigert alle data op de commandoregel die niet voldoen aan de ISO 8601 standaard. Dit formaat is: JJJJ-MM-DD. JJJJ staat voor het jaartal in vier cijfers (zoals 2003). MM staat voor de maand in twee cijfers (01,02,..,12) en DD staat voor de dag (01,02,..,31).</para>
<para>&konsolekalendar; gebruikt bij het exporteren altijd het ISO 8601-formaat.</para>
<para>&konsolekalendar; weigert alle tijden op de commandoregel die niet voldoen aan de ISO 8601 standaard. Dit formaat is: HH:MM:SS. HH staat voor de uren in twee cijfers (00,01,..,24). MM staat voor de minuten in twee cijfers (01,02,..,60) en SS staat voor de seconden (01,02,..,60).</para>
<para>&konsolekalendar; gebruikt bij het exporteren altijd het ISO 8601-formaat.</para>
<para>&konsolekalendar; kijkt naar de opgegeven start- en eindtijd, start- en einddatum, titel en omschrijving. Een evenement is identiek als alle waarden hetzelfde zijn. </para>
<para>Omdat u de <acronym>UID</acronym> moet opgeven als u een evenement wilt wijzigen of verwijderen. Indien u de <acronym>UID</acronym> van evenementen niet wilt zien, kunt u gebruik maken van het <emphasis>verkorte</emphasis> exportformaat (<option>--export-type short</option>). </para>
<para>&konsolekalendar; vereist de standaard &kde;-bibliotheken. Deze zijn te vinden in het <filename>tdelibs</filename>-pakket. Om vanuit de broncode te compileren zijn ook &Qt; en de <filename>tdelibs</filename> ontwikkelpakketten (development packages) nodig.</para>
<para>Een lijst van verbeteringen en aanpassingen is te vinden in het <filename>ChangeLog</filename>-bestand.</para>
<para>Dit gedeelte geeft een kort overzicht over het compilatie- en installatieproces. Bekijk de internetpagina <ulink url="http://developer.kde.org/build/compile_kde3_2.html">Compiling &kde; 3.2.x</ulink> voor een volledig overzicht.</para>
<para>Indien u geen geschikt voorgecompileerd pakket kunt verkrijgen, kunt u &konsolekalendar; zelf compileren vanuit de broncode. Haal de broncode op door het bestand met de naam <filename>tdepim-x.x.tar.bz2</filename> te downloaden. Pak dit uit in een nieuwe map met een commando soortgelijk aan <userinput><command>tar</command> <option>xvfj <replaceable>pakket.tar.bz2</replaceable></option></userinput> en ga naar de zojuist gecreëerde map.</para>
&install.compile.documentation; <note><para>Indien u meer dan één versie van &kde; hebt geïnstalleerd, bijvoorbeeld &kde;2 en &kde;3, dan kan het gebeuren dat &konsolekalendar; in de verkeerde map wordt geïnstalleerd. Het is mogelijk om de juiste &kde;-map als parameter mee te geven aan <userinput><command>./configure</command></userinput>. Bijvoorbeeld als &kde; geïnstalleerd is in <filename>/opt/kde3</filename>: </para>
