Handbuch zu KonsoleKalendar
Copyright © 2002, 2004 Tuukka Pasanen
Copyright © 2003, 2005 Allen Winter
Es ist erlaubt, dieses Dokument zu kopieren, zu vertreiben und/oder zu ändern gemäß den Bedingungen der GNU Free Documentation Licence, Version 1.1 oder irgend einer späteren Version, wie sie von der Free Software Foundation veröffentlicht wurde; ohne die invarianten Abschnitte, ohne Texte auf der vorderen Umschlagseite, und ohne Texte auf der hinteren Umschlagseite. Eine Kopie der Lizenz findet sich im Abschnitt "GNU Free Documentation License".
KonsoleKalendar ist eine Kommandozeilenschnittstelle für KDE-Kalender.
Inhaltsverzeichnis
KonsoleKalendar ist eine Kommandozeilenschnittstelle für KDE-Kalender. Mit seiner Hilfe kann man Termine über die Kommandozeile oder eine Skriptsprache ansehen, einfügen, löschen oder verändern. Weiterhin kann KonsoleKalendar einen neuen KDE-Kalender erstellen, ihn in einer ganzen Anzahl Formate exportieren und andere KDE-Kalender importieren.
Standardmäßig zeigt KonsoleKalendar die Terminliste des Standardkalenders für den heutigen Tag (von 7:00 bis 17:00 Uhr) an.
Die Hauptfunktionen von KonsoleKalendar:
Anzeigen von Kalendereinträgen mit Startzeitpunkt und Endzeitpunkt
Einfügen (add) von Kalendereinträgen
Entfernen (delete) von Kalendereinträgen
Ändern (modify) von Kalendereinträgen
Erstellen eines neuen Kalenders
Exportieren eines Kalender in fremde Dateiformate
Importieren eines KDE-Kalenders
Bei KonsoleKalendar handelte es sich nicht um eine weitere grafische Benutzeroberfläche eines KDE-Kalenders (also KOrganizer). Stattdessen kommt KonsoleKalendar genau dann zum Einsatz, wenn eine grafische Oberfläche nicht gewünscht oder nicht nutzbar ist.
KonsoleKalendar bietet weder eine vollständige Programmiersprache zur Abfrage von Kalendern noch ist es die Absicht der Autoren, solch eine Programmiersprache jemals zu erstellen. Mit einfachen Kommandozeilenparametern kann eine Liste von Terminen bearbeitet werden.
Dieses Kapitel erläutert die Funktionen von KonsoleKalendar und deren Kontrolle über Kommandozeilenparameter (wiederum: KonsoleKalendar ist keine grafische Benutzeroberfläche, sondern lediglich ein Kommandozeilenprogramm).
Das Einfügen, Entfernen und Verändern von Terminen und der Export in andere Dateiformate wird erläutert. Weiterhin wird die Erzeugung und der Import eines KDE-Kalenders erklärt.
Der Standardmodus entspricht dem Parameter --view und zeigt alle Termine in einem angegebenen Zeitrahmen an.
Alle heutigen Termine zwischen 7:00 Uhr und 17:00 Uhr:
%konsolekalendar
Das folgende Beispiel zeigt alle Termine der Woche vom 18. - 22. August an:
%konsolekalendar--view--date2003-08-18--end-date2003-08-22
Zeigt das nächste Ereignis oder die nächsten Ereignisse ab der aktuellen Uhrzeit an:
%konsolekalendar--next
Um alle Ereignisse der nächsten 5 Tage zu sehen, geben Sie ein:
%konsolekalendar--show-next5
KonsoleKalendar kann Ereignisse in einen KDE-Kalender oder eine Kalender-Ressource mit dem Kommandozeilenparameter --add eintragen. Erfolgreich eingetragene Ereignisse werden von den KDE-Kalenderapplikationen (wie KOrganizer) unmittelbar angezeigt.
Das folgende Beispiel fügt einen Termin für den 4. Juni 2003 um 10:00 Uhr ein, der um 12:00 Uhr ende. Der Termin mit dem Titel "Arztbesuch" wird im Standardkalender des Benutzers eingefügt:
%konsolekalendar--add--date2003-06-04--time\10:00--end-time12:00--summary"Arztbesuch"
Das folgende Beispiel fügt den eigenen Geburtstag in den Standardkalender ein:
%konsolekalendar--add--date2003-06-06--summary\"Mein Geburtstag"--description"Feier"
Eine Woche Urlaub wird in einen gemeinsam genutzten Kalender eingefügt:
%konsolekalendar--add--filevacation.ics--date\2003-08-01--end-date2003-08-07--summary"Urlaub"--description"Ich löse mich in Luft auf!"
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Einträge werden durch den Parameter --delete von KonsoleKalendar aus der Kalenderdatei oder anderen Ressourcen entfernt. Dazu muss die eindeutige Kennung (UID) über den Parameter --uid angegeben werden. Diese UID findet man, indem man den Termin zunächst über den Parameter --view anzeigen lässt.
Erfolgreich gelöschte Ereignisse werden unmittelbar aus den KDE-Kalender-Applikationen (wie KOrganizer) gelöscht.
Ein Fehler kann nicht rückgängi gemacht werden. Ein entfernter Eintrag ist und bleibt entfernt.
Im folgenden Beispiel wird der Termin mit der UID KonsoleKalendar-1887551750.196 entfernt:
%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
Der Parameter zum Ändern von Einträgen in KonsoleKalendar lautet --change. Auch hier muss der Termin über die eindeutige Kennung (UID) mit dem Parameter --uid identifiziert werden. Die UID kann man ermitteln, indem man sich den Termin mit --view anzeigen lässt.
Änderungen verhalten sich genauso wie neu eingefügte Termine: Sie können Startzeitpunkt, Endzeitpunkt, Beschreibung, Ort und Zusammenfassung angeben. Erfolgreich geänderte Termine werden unmittelbar in den KDE-Kalenderapplikationen (wie KOrganizer) geändert.
Beispiel: Die Zusammenfassung (summary) und Beschreibung (description) eines Termins mit der UID KonsoleKalendar-1887551750.196 wird verändert.
% konsolekalendar --change --uid KonsoleKalendar-1887551750.196--summary "Untersuchung"--description "Termin beim Nervenarzt."
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Mit KonsoleKalendar kann man auch eine neue KDE-Kalenderdatei erzeugen. Bevor man Einträge in den neuen Kalender einfügen kann, muss er zunächst mit Hilfe von --create und --file erzeugt werden.
Die Kalenderdatei /data/share/calendars/vacation.ics
%konsolekalendar--create--file/data/share/calendars/vacation.ics
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Mit KonsoleKalendar können KDE-Kalender in einige gängige Formate exportiert werden. Dabei handelt es sich um eine besondere Form der Anzeige. Standardmäßig werden Termine im Format „KonsoleKalendar-Text“ angezeigt. Ein davon abweichendes Format stellt man über den Parameter --export-type ein.
Eine vollständige Liste aller unterstützten Exportformate erhält man durch den Parameter --export-list:
%konsolekalendar--export-list
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Einige der wichtigsten Exportformate werden im folgenden Abschnitt beschrieben.
Das KonsoleKalendar-Textformat ist das Standardformat von KonsoleKalendar und dazu gedacht, einfach lesbar und für nachfolgende Skripte verarbeitbar zu sein.
Das KonsoleKalendar-Textformat lautet:
Datum:\t<Ereignisdatum>(dddd jjjj-MM-tt) [\t<Ereignisstartzeit>(hh:mm) - <Ereignisendzeit>(hh:mm)] Zusammenfassung: \t<Ereigniszusammenfassung | "(keine Zusammenfassung verfügbar)"> Ort: \t<Ereignisort | "(kein Ort verfügbar)"> Beschreibung: \t<Ereignisbeschreibung | "(keine Beschreibung verfügbar)"> UID: \t<Ereignis-UID> --------------------------------------------------
Beispiel:
Date: 01.11.2003
8:00 - 9:00
Summary:
Besprechung
Ort:
Konferenzraum
Description:
Die gesamte Abteilung trifft sich im großen Konferenzraum.
UID:
KonsoleKalendar-1128954167.1013
Das Kurztextformat ist eine kompaktere, weniger wortreiche Variante des nativen Formats von KonsoleKalendar.
Das KonsoleKalendar-Kurztextformat lautet:
[--------------------------------------------------]
{<Ereignisdatum>(dddd jjjj-MM-tt)]
[<Ereignisstartzeit>(hh:mm) - <Ereignisendzeit>(hh:mm) | "\t"]
\t<Ereigniszusammenfassung | \t>[, <Ereignisort>]
\t\t<Ereignisbeschreibung | "\t">
Beispiel:
--------------------------------------------------
Tuesday 2003-11-01
08:00 - 09:00 Mitarbeiterbesprechung, Konferenzraum
Das gesamte Team trifft sich zu einer Projektbesprechung.
Die Informationen des Termins werden in der gleichen Reihenfolge wie im KonsoleKalendar-Textformat angezeigt. Der einzige Unterschied ist, alle Informationen befinden sich in einer Zeile in einer durch Kommas getrennten Liste. Dieses Format kann z.B. von Tabellenkalkulationsprogrammen wie KSpread, OpenOffice.org und Microsoft® Excel gelesen werden. Das CSV-Format eignet sich auch gut zur Weiterverarbeitung durch Skripte.
Das CSV-Format lautet:
YYYY-MM-DD,HH:MM,YYYY-MM-DD,HH:MM,Zusammenfassung,Ort,Beschreibung,Kennung
Beispiel:
2003-11-01,08:00,2003-11-01,09:00,Besprechung,Konferenzraum,Die gesamte Abteilung trifft sich \
im großen Konferenzraum.,KonsoleKalendar-1128954167.1013
Der HTML-Export erzeugt eine gültige HTML-Datei zur Veröffentlichung im WWW. Das Format ist nicht geeignet zur Verarbeitung durch Skripte aber zur einfachen Veröffentlichung.
TODO: Bildschirmphoto einfügen
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar kann ICS-Kalenderdateien in das KDE-Kalenderformat importieren. Alle Termine, auch identische Termine, werden eingefügt. Dieser letzte Punkt soll in der nächsten Version von KonsoleKalendar bereinigt werden.
Folgendermaßen wird die Kalenderdatei irgendein_Name.icscurrent.ics
%konsolekalendar--importirgendein_Name.ics--filecurrent.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
Folgende Optionen versteht KonsoleKalendar:
| Option | Beschreibung |
|---|---|
--help, --help-all | Zeigt Hilfetexte zu den Optionen an. |
--author | Zeigt Informationen über die Programmautoren. |
-v, --version | Zeigt die Versionsnummer des Programms an. |
--license | Zeigt Informationen zu den Lizenzbestimmungen. |
--verbose | Gibt nützliche Laufzeitmeldungen aus. |
--dry-run | Es wird ausgegeben, was getan würde, die Aktionen werden aber nicht wirklich durchgeführt (eignet sich gut für Testzwecke). |
--file Kalenderdatei | Legt die zu benutzende Kalenderdatei fest. Ansonsten wird die Standardeinstellung von KOrganizer verwendet. |
| Hauptarbeitsmodi: | |
--view | Gibt Termine im angegebenen Ausgabeformat aus. |
--add | Fügt einen Termin in den Kalender ein. |
--change | Ändert die Daten eines bestehenden Termins. |
--delete | Entfernt einen bestehenden Termin. |
--create | Erstellt eine neue Kalenderdatei, falls noch keine existiert. |
--import Dateiname | Importiert diesen Kalender in den Hauptkalender. |
| Parameter für die Operationen: | |
--all | Zeigt alle Kalendereinträge an. |
--next | Nächste Aktivität im Kalender anzeigen. |
--show-next Tage | Ab dem angegebenen Datum die Aktivitäten der nächsten n Tage anzeigen. |
--uid Kennung | Der Termin mit dieser Kennung wird angezeigt, entfernt oder geändert. |
--date Datum | Beginnt mit dem angegebenen Tag [JJJJ-MM-DD]. Der Standardwert ist heute. |
--time Zeitpunkt | Beginnt mit der angegebenen Zeit [HH:MM]. Der Standardwert ist 07:00. Um einen beweglichen Termin einzutragen oder zu ändern, verwenden Sie eine der Optionen |
--end-date Datum | Endet am angegebenen Tag [JJJJ-MM-DD]. Der Standardwert ist der unter --date angegebene Tag. |
--end-time Zeitpunkt | Endet zu dieser Zeit [HH:MM]. Der Standardwert für die Ansicht ist 17:00. Um einen beweglichen Termin einzutragen oder zu ändern, verwenden Sie eine der Optionen |
--epoch-start Zeit | Beginnt zu dieser Zeit [Sekunden seit epoch]. |
--epoch-end Zeit | Endet zu dieser Zeit [Sekunden seit epoch]. |
--summary Zusammenfassung | Fügt eine Zusammenfassung zum Termin hinzu (bei "add" und "change"). |
--description Beschreibung | Fügt eine Beschreibung zum Termin hinzu (bei "add" und "change"). |
--location Ort | Fügt einen Ort zum Termin hinzu (bei "add" und "change"). |
| Exportparameter: | |
--export-type Typ | Export zum angegebenen Typ. Der Standardtyp ist Text. |
--export-file Dateiname | Export in die angegebene Datei. Standardmäßig wird der Export zur Standardausgabe durchgeführt. |
--export-list | Zeigt eine Liste der unterstützten Exportformate an. |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Berichten Sie über Probleme und Wünsche auf der Internetseite http://bugs.kde.org.
Dieses Dokument wurde seit der Installation möglicherweise bearbeitet. Etwaige neuere Versionen dieser Dokumentation finden Sie unter http://docs.kde.org/.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar ProgrammCopyright 2002,2003:
Tuukka Pasanen (illuusio AT mailcity.com)
Allen Winter (awinterz AT users.sourceforge.net)
Dokumentation Copyright 2003:
Allen Winter (awinterz AT users.sourceforge.net)
Tuukka Pasanen(illuusio AT mailcity.com)
Noch niemand
Diese Dokumentation ist unter den Bedingungen der GNU Free Documentation License veröffentlicht.
Dieses Programm ist unter den Bedingungen der GNU General Public License veröffentlicht.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Inhaltsverzeichnis
KonsoleKalendar ist Teil des KDE-Projekts http://www.kde.org/.
KonsoleKalendar finden Sie im kdepim-Paket auf ftp://ftp.kde.org/pub/kde/, dem Haupt-FTP-Server des KDE-Projekts.
ist in KDE3 enthalten und nicht separat erhältlich. KonsoleKalendar
Für KonsoleKalendar müssen die KDE-Standardbibliotheken (also das kdelibs-Paket) installiert sein. Zur Kompilierung wird außerdem Qt™ und das Entwicklerpaket zu kdelibs benötigt.
Ein Liste von Änderungen finden Sie in der Datei ChangeLog.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Dieser Abschnitt gibt dazu einen kurzen Überblick. Weitere Hinweise sind unter KDE 3.2.x kompilieren zu finden.
Falls Sie kein geeignetes Binärpaket finden können, müssen Sie KonsoleKalendar aus den Quelltexten selbst kompilieren. Dazu müssen Sie die Datei kdepim-x.x.tar.bz2 herunterladen. Durch den Befehl tar wird das Paket in einen Ordner ausgepackt. Wechseln Sie in diesen Ordner.xvfjkdepim-x.x.tar.bz2
Um KonsoleKalendar auf Ihrem System zu kompilieren und zu installieren, geben Sie folgende Befehle im Hauptordner der Programm-Quellen von KonsoleKalendar ein:
%./configure%make%make install
Da KonsoleKalendar autoconf und automake benutzt, sollte es dabei keine Schwierigkeiten geben. Sollten dennoch Probleme auftauchen, wenden Sie sich bitte an die KDE-Mailinglisten.
Falls Sie mehr als eine Version von KDE installiert haben (also z.B. KDE2 und KDE3), besteht die Gefahr, dass KonsoleKalendar in den falschen Ordner installiert wird. Sie können gegebenenfalls den KDE-Ordner als Parameter beim Befehl ./configure mit angeben. Falls sich die gewünschte KDE-Version in /opt/kde3 befindet:
./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
Zur Verwendung von KonsoleKalendar mit der KDE-Arbeitsoberfläche sind keine weiteren Konfigurationen notwendig.
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