<para>&konsolekalendar; est une interface en ligne de commande aux agendas de &kde;. Il vous permet d'afficher, insérer, supprimer ou modifier des évènements de l'agenda par le biais de la ligne de commande ou d'un langage de scriptage. De plus, &konsolekalendar; peut créer un nouvel agenda &kde;, exporter un agenda &kde; vers divers autres formats et importer un autre agenda &kde;.</para>
<para>Dans son mode de base, &konsolekalendar; affiche la liste des évènements dans votre agenda par défaut pour la journée d'aujourd'hui (de 7:00 à 17:00).</para>
<para>Fonctionnalités principales de &konsolekalendar;: <itemizedlist>
<listitem><para>Affichage des éléments de l'agenda à partir d'une date ou d'une heure de début jusqu'à une date ou une heure de fin</para></listitem>
<listitem><para>Insertion (ajout) d'éléments de l'agenda</para></listitem>
<listitem><para>Suppression (retrait) d'éléments de l'agenda</para></listitem>
<listitem><para>Modification (changement) d'éléments de l'agenda</para></listitem>
<listitem><para>Création d'un nouvel agenda</para></listitem>
<listitem><para>Exportation d'éléments de l'agenda vers d'autres formats de fichiers</para></listitem>
<listitem><para>Importation d'un agenda &kde; existant</para></listitem>
</itemizedlist></para>
<para>&konsolekalendar; <emphasis>n'</emphasis>est <emphasis>pas</emphasis> une autre interface graphique à un agenda de &kde; (&cad; &korganizer;). &konsolekalendar; est prévu uniquement pour des utilisations où une interface graphique utilisateur n'est pas pratique ou possible.</para>
<para>&konsolekalendar; <emphasis>ne</emphasis> fournit <emphasis>pas</emphasis> un langage complet pour effectuer les requêtes d'agenda de l'utilisateur: il n'est pas non plus dans l'intention des auteurs de jamais écrire une telle fonction. Les options initiales en ligne de commande sont prévues pour accéder aux évènements de l'agenda au sein d'un intervalle consécutif de pointages de dates ou d'heures. </para>
<para>Dans ce chapitre, vous étudierez les principales fonctionnalités de &konsolekalendar; et comment les contrôler à l'aide des paramètres en ligne de commande (n'oubliez pas que &konsolekalendar; n'est pas une interface graphique utilisateur; il ne s'agit que d'un programme en ligne de commande).</para>
<para>Vous y apprendrez à insérer, supprimer, modifier des évènements de l'agenda et comment exporter des évènements vers d'autres formats de fichiers. La création et l'importation d'agendas &kde; seront également abordées dans ce chapitre. </para>
<para>Dans son mode par défaut, ou grâce à l'option<parameter>--view</parameter>, &konsolekalendar; répertorie tous les évènements compris dans l'intervalle d'une date ou d'une heure spécifiée.</para>
<para>&konsolekalendar; peut insérer des évènements dans un agenda ou une ressource de l'agenda &kde; à l'aide de l'argument en ligne de commande <parameter>--add</parameter>.</para>
<informalexample><para>Dans l'exemple suivant, un évènement commençant le 2003-06-04 (4juin2003) à 10:00 et se terminant à 12:00 avec le résumé "Consultation chez le médecin" sera inséré dans la ressource de l'agenda par défaut de l'utilisateur:</para>
<option>--end-time <replaceable>12:00</replaceable></option> <option>--summary <replaceable>"Consultation chez le médecin"</replaceable></option></userinput></screen>
<note><para>La version actuelle de &konsolekalendar; ne prend pas en charge l'insertion d'évènements <quote>libres</quote> (les évènements libres sont ceux qui n'occupent pas de créneau horaire dans la journée; &cad; que l'horaire n'est pas marqué comme étant occupé. Les anniversaires, vacances, commémorations, &etc; devraient dans l'idéal être insérés en tant qu'évènements libres. Nous espérons pour la prochaine version de &konsolekalendar; avoir une fonctionnalité évènement <quote>libre</quote>. </para></note>
<option>--end-date <replaceable>2003-08-01</replaceable></option> <option>--summary <replaceable>"Vacances"</replaceable></option> <option>--description <replaceable>"Je ne suis là pour personne!"</replaceable></option></userinput></screen>
<para>&konsolekalendar; prend en charge la suppression d'éléments dans un fichier ou une ressource de l'agenda à l'aide de l'argument en ligne de commande <parameter>--delete</parameter>. Les éléments de l'agenda à supprimer sont spécifiés de façon exacte par leur identifiant unique (<acronym>UID</acronym>) à l'aide l'option <parameter>--uid</parameter>. Vous trouverez les <acronym>UID</acronym>s en affichant d'abord l'évènement, à l'aide de l'option <parameter>--view</parameter>.</para>
<warning><para>Quand vous supprimez quelque chose de l'agenda, vous <emphasis>ne</emphasis> pouvez <emphasis>pas</emphasis> l'annuler! En d'autres termes, quand vous supprimez un élément, vous ne pouvez pas annuler la suppression. Elle est définitive.</para></warning>
<informalexample><para>Ici, nous supprimons un élément de l'agenda avec l'<acronym>UID</acronym> de <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>
<para>&konsolekalendar; prend en charge la modification d'éléments existants dans un fichier ou une ressource de l'agenda à l'aide de l'argument en ligne de commande <parameter>--change</parameter>. Les éléments de l'agenda à modifier sont spécifiés de façon exacte par leur identifiant unique (<acronym>UID</acronym>) à l'aide de l'option <parameter>--uid</parameter>. Vous trouverez les <acronym>UID</acronym>s en affichant d'abord l'option <parameter>--view</parameter>.</para>
<para>La modification se comporte de la même manière que l'insertion: vous pouvez modifier la date et l'heure de début, la date et l'heure de fin, la description et le résumé d'un évènement. </para>
<para><emphasis>Exemple:</emphasis> ici nous modifions le résumé et la description d'un élément de l'agenda avec l'<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>"Me faire examiner la tête"</replaceable></option> <option>--description <replaceable>"ne plus retourner chez ce médecin!"</replaceable></option> </userinput> </para>
<para>Vous pouvez utiliser &konsolekalendar; pour créer un nouveau fichier d'agenda de &kde;. Puisque vous ne pouvez pas insérer un élément dans un agenda qui n'existe pas, créez le fichier à l'aide des arguments en ligne de commande <parameter>--create</parameter> et <parameter>--file</parameter>.</para>
<para>&konsolekalendar; peut exporter un agenda &kde; vers d'autres formats connus. L'exportation est une forme spéciale d'affichage. Par défaut, les évènements sont affichés au format <quote>texte de &konsolekalendar;</quote>. Pour changer le format d'affichage, utilisez l'argument en ligne de commande <parameter>--export-type</parameter>.</para>
<para>Pour afficher une liste de tous les formats d'exportation pris en charge, utilisez l'option <parameter>--export-list</parameter>, comme dans:</para>
<para>Le format texte de &konsolekalendar; est le format natif de &konsolekalendar;; il est conçu pour être facile à lire et pour pouvoir être analysé par des suivis de scripts.</para>
<title>Format <acronym>CSV</acronym> (valeurs séparées par des virgules)</title>
<para>Le format CSV affiche les valeurs d'évènements dans le même ordre que le format texte de &konsolekalendar;. La seule différence est que toutes les informations sont sur la même ligne, chaque champ étant séparé par une virgule. Les fichiers exportés qui en résultent peuvent être importés directement dans des tableurs comme &kspread;, <application>OpenOffice.org Calc</application> et <application>&Microsoft; Excel</application>. En outre, le format <acronym>CSV</acronym> est facile à analyser avec des suivis de scripts.</para>
<para>Le format <acronym>CSV</acronym> est: <informalexample> <screen>AAAA-MM-JJ,HH:MM,AAAA-MM-JJ,HH:MM,Résumé,Description,UID
<para>Le format d'exportation <acronym>HTML</acronym> produira un fichier <acronym>HTML</acronym> valable qui peut être publié sur le Web. Ce format d'exportation ne convient pas pour l'analyse par suivi de script, mais il est très pratique pour la publication d'agendas pour un affichage public aisé.</para>
<para><emphasis>À FAIRE:</emphasis> insérer une capture d'écran ici</para>
<para>&konsolekalendar; peut importer un fichier d'agenda <acronym>ICS</acronym> dans un agenda &kde;. Tous les évènements provenant de l'agenda dont ils sont importés seront insérés, y compris les évènements identiques. Dans la prochaine version de &konsolekalendar;, les évènements identiques ne seront pas insérés.</para>
<informalexample><para>Pour importer le fichier d'agenda <filename><replaceable>un_autre.ics</replaceable></filename> dans l'agenda <filename><replaceable>actuel.ics</replaceable></filename> exécutez:</para>
<entry>Affiche ce qui aurait été fait, mais sans exécuter. Ne change aucun fichier, n'insère, ne supprime, ne modifie aucun fichier existant et ne crée aucun nouveau fichier.</entry>
<para>&konsolekalendar; rejettera les dates indiquées sur la ligne de commande, à moins qu'elles ne soient spécifiées conformément aux normes ISO8601, à savoir: AAAA-MM-JJ. Où AAAA représente une année sur quatre chiffres (comme 2003), MM un mois sur deux chiffres (01,02,..,12) et JJ un jour sur deux chiffres (01,02,...,31).</para>
<para>&konsolekalendar; exporte toujours les dates conformément au format ISO8601.</para>
<para>&konsolekalendar; rejettera les heures indiquées sur la ligne de commande, à moins qu'elles ne soient spécifiées conformément aux normes ISO8601, à savoir: HH:MM:SS. Où HH représente une heure sur deux chiffres (01,02,...,24), MM une minute sur deux chiffres (01,02,..,60) et SS une seconde sur deux chiffres (01,02,...,60).</para>
<para>&konsolekalendar; exporte toujours les heures conformément au format ISO8601.</para>
<para>&konsolekalendar; vérifie la date et l'heure de début, la date et l'heure de fin ainsi que le résumé indiqués par rapport à tous les évènements dans l'agenda. Une correspondance d'évènement est déterminée si l'ensemble des trois valeurs correspond à un évènement existant. </para>
<para>L'installation de &konsolekalendar; exige l'installation des bibliothèques standard de &kde; (le paquetage <filename>tdelibs</filename>). Pour compiler à partir du source, vous aurez également besoin des paquetages de développement de &Qt; et de <filename>tdelibs</filename>.</para>
<para>Vous trouverez une liste des changements dans le fichier <filename>ChangeLog</filename>.</para>
<para>Cette section offre un bref aperçu du processus de compilation. Lisez <ulink url="http://developer.kde.org/build/compile_kde3_2.html"> Compiler &kde;3.2.x</ulink> pour les instructions complètes.</para>
<para>Si vous ne pouvez pas vous procurer un paquetage exécutable précompilé convenable, vous devrez compiler &konsolekalendar; vous-même à partir des fichiers sources. Téléchargez le fichier du paquetage source <filename>tdepim-x.x.tar.bz2</filename>. Décompactez-le dans un nouveau dossier à l'aide d'une commande similaire à <userinput><command>tar</command> <option>xvfj <replaceable>paquetage.tar.bz2</replaceable></option></userinput> et placez-vous dans le dossier qui a été créé.</para>
&install.compile.documentation; <note><para>Si vous avez plusieurs versions de &kde; sur votre ordinateur (&pex;, &kde;2 et &kde;3), cette commande est susceptible d'installer &konsolekalendar; dans le mauvais dossier &kde;. Si nécessaire, attribuez au dossier &kde; un paramètre à <userinput><command>./configure</command></userinput>. Par exemple, si votre &kde; est installé dans <filename>/opt/kde3</filename>: </para>