Le manuel de KonsoleKalendar
Copyright © 2002, 2003 Tuukka Pasanen
Copyright © 2003 Allen Winter
Permission est accordée de copier, distribuer et/ou modifier ce document selon les termes de la Licence de Documentation Libre GNU (GNU Free Documentation License), version 1.1 ou toute version ultérieure publiée par la Free Software Foundation sans section invariante, sans texte de première de couverture, ni texte de quatrième de couverture. Une copie de la licence est fournie dans la section intitulée " GNU Free Documentation License ".
KonsoleKalendar est une interface en ligne de commande aux agendas de KDE.
Table des matières
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.
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).
Fonctionnalités principales de KonsoleKalendar :
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
Insertion (ajout) d'éléments de l'agenda
Suppression (retrait) d'éléments de l'agenda
Modification (changement) d'éléments de l'agenda
Création d'un nouvel agenda
Exportation d'éléments de l'agenda vers d'autres formats de fichiers
Importation d'un agenda KDE existant
KonsoleKalendar n'est pas une autre interface graphique à un agenda de KDE (c'est-à-dire KOrganizer). KonsoleKalendar est prévu uniquement pour des utilisations où une interface graphique utilisateur n'est pas pratique ou possible.
KonsoleKalendar ne fournit pas 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.
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).
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.
Dans son mode par défaut, ou grâce à l'option--view, KonsoleKalendar répertorie tous les évènements compris dans l'intervalle d'une date ou d'une heure spécifiée.
Pour afficher tous les évènements d'aujourd'hui (de 7:00 à 17:00), exécutez simplement :
%konsolekalendar
Dans l'exemple ci-après, nous affichons tous les évènements pour la semaine du 18 au 22 août :
%konsolekalendar--view--date2003-18-08--end-date2003-02-22
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 --add.
Dans l'exemple suivant, un évènement commençant le 2003-06-04 (4 juin 2003) à 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 :
%konsolekalendar--add--date2003-06-04--time\10:00--end-time12:00--summary"Consultation chez le médecin"
Dans cet exemple, un évènement anniversaire est ajouté dans la ressource de l'agenda par défaut de l'utilisateur :
%konsolekalendar--add--date2003-06-06--summary\"Mon anniversaire"--description"Réception"
La version actuelle de KonsoleKalendar ne prend pas en charge l'insertion d'évènements « libres » (les évènements libres sont ceux qui n'occupent pas de créneau horaire dans la journée; c'est-à-dire 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 « libre ».
Ici, on a inséré une semaine de vacances dans un agenda vacances partagé :
%konsolekalendar--add--filevacances.ics--date\2003-08-01--end-date2003-08-01--summary"Vacances"--description"Je ne suis là pour personne !"
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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 --delete. Les éléments de l'agenda à supprimer sont spécifiés de façon exacte par leur identifiant unique (UID) à l'aide l'option --uid. Vous trouverez les UIDs en affichant d'abord l'évènement, à l'aide de l'option --view.
Quand vous supprimez quelque chose de l'agenda, vous ne pouvez pas l'annuler ! En d'autres termes, quand vous supprimez un élément, vous ne pouvez pas annuler la suppression. Elle est définitive.
Ici, nous supprimons un élément de l'agenda avec l'UID de KonsoleKalendar-1887551750.196 :
%konsolekalendar--delete--uidKonsoleKalendar-1887551750.196
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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 --change. Les éléments de l'agenda à modifier sont spécifiés de façon exacte par leur identifiant unique (UID) à l'aide de l'option --uid. Vous trouverez les UIDs en affichant d'abord l'option --view.
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.
Exemple : ici nous modifions le résumé et la description d'un élément de l'agenda avec l'UID KonsoleKalendar-1887551750.196:
% konsolekalendar --change --uid KonsoleKalendar-1887551750.196--summary "Me faire examiner la tête"--description "ne plus retourner chez ce médecin !"
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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 --create et --file.
Créez un fichier agenda dénommé /data/share/agendas/vacances.ics
%konsolekalendar--create--file/data/share/agendas/vacances.ics
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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 « texte de KonsoleKalendar ». Pour changer le format d'affichage, utilisez l'argument en ligne de commande --export-type.
Pour afficher une liste de tous les formats d'exportation pris en charge, utilisez l'option --export-list, comme dans :
%konsolekalendar--export-list
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Certains, mais pas nécessairement la totalité des formats pris en charge sont décrits dans cette section.
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.
Le format texte de KonsoleKalendar est :
Informations de date et d'heure : 1. ligne Date : AAAA-MM-JJ 2. ligne HH:MM Résumé : 3. ligne Résumé : 4. ligne texte de résumé. Description : 5. ligne Description : 6. ligne texte de description UID : 7. ligne UID : 8. ligne UID.
Date : 2003-11-01
8:00 - 9:00
Résumé :
Réunion du personnel
Description :
Réunion dans la grande salle de conférences avec l'ensemble du personnel.
UID :
KonsoleKalendar-1128954167.1013
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, OpenOffice.org Calc et Microsoft® Excel. En outre, le format CSV est facile à analyser avec des suivis de scripts.
Le format CSV est :
AAAA-MM-JJ,HH:MM,AAAA-MM-JJ,HH:MM,Résumé,Description,UID
2003-11-01,08:00,2003-11-01,09:00,Réunion du personnel,Réunion dans la grande salle de conférences \
avec l'ensemble du personnel.,KonsoleKalendar-1128954167.1013
Le format d'exportation HTML produira un fichier HTML 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é.
À FAIRE : insérer une capture d'écran ici
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar peut importer un fichier d'agenda ICS 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.
Pour importer le fichier d'agenda un_autre.icsactuel.ics
%konsolekalendar--importun_autre.ics--fileactuel.ics
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar prend en charge les options suivantes :
| Option | Description |
|---|---|
--help, --help-all | Affiche l'aide sur les options du programme. |
--author | Affiche les informations sur l'auteur du programme. |
-v, --version | Affiche les informations sur la version du programme. |
--license | Affiche les informations sur la licence du programme. |
--verbose | Affiche des messages utiles pendant l'exécution. |
--dryrun | 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. |
--file fichier-agenda | Spécifie un fichier d'agenda à utiliser. S'il n'est pas spécifié, votre ressource KOrganizer par défaut est utilisée. |
| Modes d'opération principaux : | |
--view | Affiche les évènements de l'agenda dans le format d'exportation indiqué. |
--add | Insère un évènement dans l'agenda. |
--change | Modifie un évènement existant de l'agenda. |
--delete | Supprime un évènement existant de l'agenda. |
--create | Crée un nouveau fichier d'agenda s'il n'en existe aucun. |
--import fichier-importation | Importe cet agenda vers l'agenda principal. |
| Modificateurs d'opération : | |
--all | Affiche tous les éléments de l'agenda. |
--uid UID | Affiche, supprime ou modifie l'évènement avec cet Identifiant unique (UID).. |
--date date | Commence ce jour [AAAA-MM-JJ]. La date par défaut est Aujourd'hui. |
--time | Commence à cette heure [HH:MM]. L'heure par défaut est 07:00. |
--end-date fin-date | Prend fin ce jour [AAAA-MM-JJ]. La valeur par défaut est fixée par --date. |
--end-time fin-heure | Prend fin à cette heure [HH:MM]. L'heure par défaut est 17:00 |
--epoch-start epoch-heure | Commence à cette heure [secondes depuis le 1er janvier 1970]. |
--epoch-end epoch-heure | Prend fin à cette heure [secondes depuis le 1er janvier 1970]. |
--summary résumé | Ajoute un résumé à un évènement (fonctionne avec Ajout et Modification). |
--description description | Ajoute une description à un évènement (fonctionne avec Ajout et Modification). |
| Options d'exportation : | |
--export-type exportation-type | Type de fichier d'exportation. Le type de fichier d'exportation par défaut est Texte |
--export-file exportation-fichier | Exportation vers un fichier. Par défaut, la sortie est écrite vers la sortie standard. |
--export-list | Affichage d'une liste des types d'exportation pris en charge et se termine. |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Ce document a peut-être été mis à jour depuis son installation sur votre ordinateur. Vous trouverez la dernière version sur http://docs.kde.org/current/kdepim/.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Programme KonsoleKalendar Copyright 2002,2003 :
Tuukka Pasanen (illuusio AT mailcity.com)
Allen Winter (awinterz AT users.sourceforge.net)
Documentation Copyright 2003 :
Allen Winter (awinterz AT users.sourceforge.net)
Tuukka Pasanen(illuusio AT mailcity.com)
Traduction française par Joëlle Cornavin (jcornavi AT club-internet.fr)
Cette documentation est soumise aux termes de la Licence de Documentation Libre GNU (GNU Free Documentation License).
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Table des matières
KonsoleKalendar fait partie du projet KDE http://www.kde.org/.
KonsoleKalendar se trouve dans le paquetage kdepim à l'adresse ftp://ftp.kde.org/pub/kde/, le site FTP principal du projet KDE.
KonsoleKalendar est inclus dans KDE3 est n'est pas disponible séparément.
L'installation de KonsoleKalendar exige l'installation des bibliothèques standard de KDE (le paquetage kdelibs). Pour compiler à partir du source, vous aurez également besoin des paquetages de développement de Qt™ et de kdelibs.
Vous trouverez une liste des changements dans le fichier ChangeLog.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Cette section offre un bref aperçu du processus de compilation. Lisez Compiler KDE 3.2.x pour les instructions complètes.
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 kdepim-x.x.tar.bz2. Décompactez-le dans un nouveau dossier à l'aide d'une commande similaire à tar et placez-vous dans le dossier qui a été créé.xvfj paquetage.tar.bz2
Pour compiler et installer KonsoleKalendar sur votre système, saisissez les lignes suivantes dans le dossier de base de la distribution de KonsoleKalendar :
%./configure%make%make install
Étant donné que KonsoleKalendar utilise autoconf et automake, vous ne devriez pas rencontrer de problèmes pour le compiler. Si c'est le cas, veuillez les signaler aux listes de discussions de KDE.
Si vous avez plusieurs versions de KDE sur votre ordinateur (par exemple, KDE2 et KDE3), cette commande est susceptible d'installer KonsoleKalendar dans le mauvais dossier KDE. Si nécessaire, attribuez au dossier KDE un paramètre à ./configure. Par exemple, si votre KDE est installé dans /opt/kde3 :
./configure --prefix=/opt/kde3
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Aucune configuration spéciale n'est requise pour installer KonsoleKalendar pour qu'il s'exécute sur le bureau KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team