From f7e7a923aca8be643f9ae6f7252f9fb27b3d2c3b Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sat, 3 Dec 2011 11:05:10 -0600 Subject: Second part of prior commit --- .../docs/tdepim/konsolekalendar/index.docbook | 1408 ++++++++++++++++++++ 1 file changed, 1408 insertions(+) create mode 100644 tde-i18n-de/docs/tdepim/konsolekalendar/index.docbook (limited to 'tde-i18n-de/docs/tdepim/konsolekalendar/index.docbook') diff --git a/tde-i18n-de/docs/tdepim/konsolekalendar/index.docbook b/tde-i18n-de/docs/tdepim/konsolekalendar/index.docbook new file mode 100644 index 00000000000..3dc2ddee60f --- /dev/null +++ b/tde-i18n-de/docs/tdepim/konsolekalendar/index.docbook @@ -0,0 +1,1408 @@ + + +KonsoleKalendar"> + + + + +]> + + + + + + +Handbuch zu &konsolekalendar; + + +Tuukka Pasanen
illuusio@mailcity.com
 + + +Allen Winter
awinterz@users.sourceforge.net
 + + +Malcolm Hunter
malcolm.hunter@gmx.co.uk
 +Korrektur + +NochNiemandDeutsche Übersetzung + + + +20022004Tuukka Pasanen + + + +20032005Allen Winter + + +&FDLNotice; + + + +2004-04-15 +1.1.1 + + +&konsolekalendar; ist eine Kommandozeilenschnittstelle für &kde;-Kalender. + + + + +KDE +&package; +&kappname; +KOrganizer + + + + + + +Einleitung + +&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. + + + + +Merkmale +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. + + +Termine anzeigen lassen + +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 + + + + + + + +Zeigt das nächste Ereignis oder die nächsten Ereignisse ab der aktuellen Uhrzeit an: + + +% konsolekalendar + + + + + + + +Um alle Ereignisse der nächsten 5 Tage zu sehen, geben Sie ein: + + +% konsolekalendar 5 + + + + + + + + + + +Termine einfügen + +&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 \ + + + + + + +Das folgende Beispiel fügt den eigenen Geburtstag in den Standardkalender ein: + + +% konsolekalendar \ + + + + + + +Eine Woche Urlaub wird in einen gemeinsam genutzten Kalender eingefügt: + + +% konsolekalendar \ + + + + + + + + +Einträge entfernen + +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 + + + + + + + +Einträge ändern + +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 + + + + + + +Einen neuen Kalender erzeugen + +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 wird erzeugt: + + +% konsolekalendar + + + + + + + +Kalender in andere Formate exportieren + +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 + + + + + + + +Exportformate + +Einige der wichtigsten Exportformate werden im folgenden Abschnitt beschrieben. + + +&konsolekalendar;-Textformat + +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 + + + + + + + +&konsolekalendar;-Kurztextformat + +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. + + + + + + + +durch Kommas getrennte Werte ("<acronym +>CSV</acronym +>"-Format) + +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 + + + + + + + +<acronym +> HTML</acronym +>-Format + +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 + + + + +<acronym +> HTMLmonth</acronym +>-Format + +Dieses Format produziert eine HTML-Datei, die alle Termine im angegebenen Zeitraum enthält. Das Format ist nicht geeignet zur Verarbeitung durch Skripte aber zur einfachen Veröffentlichung. + +TODO: Bildschirmphoto einfügen + + + + + + +Kalender importieren + +&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.ics in den Kalender current.ics übernommen: + + +% konsolekalendar + + + + + + + + + +Kommandozeilenparameter + +Folgende Optionen versteht &konsolekalendar;: + + + + + + Option + Beschreibung + + + + + + Zeigt Hilfetexte zu den Optionen an. + + + + Zeigt Informationen über die Programmautoren. + + + + Zeigt die Versionsnummer des Programms an. + + + + Zeigt Informationen zu den Lizenzbestimmungen. + + + + Gibt nützliche Laufzeitmeldungen aus. + + + + Es wird ausgegeben, was getan würde, die Aktionen werden aber nicht wirklich durchgeführt (eignet sich gut für Testzwecke). + + +  Kalenderdatei + Legt die zu benutzende Kalenderdatei fest. Ansonsten wird die Standardeinstellung von &korganizer; verwendet. + + + Hauptarbeitsmodi: + + + + Gibt Termine im angegebenen Ausgabeformat aus. + + + + Fügt einen Termin in den Kalender ein. + + + + Ändert die Daten eines bestehenden Termins. + + + + Entfernt einen bestehenden Termin. + + + + Erstellt eine neue Kalenderdatei, falls noch keine existiert. + + +  Dateiname + Importiert diesen Kalender in den Hauptkalender. + + + Parameter für die Operationen: + + + + Zeigt alle Kalendereinträge an. + + + + Nächste Aktivität im Kalender anzeigen. + + +  Tage + Ab dem angegebenen Datum die Aktivitäten der nächsten n Tage anzeigen. + + +  Kennung + Der Termin mit dieser Kennung wird angezeigt, entfernt oder geändert. + + +  Datum + Beginnt mit dem angegebenen Tag [JJJJ-MM-DD]. Der Standardwert ist heute. + + +  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 oder . + + +  Datum + Endet am angegebenen Tag [JJJJ-MM-DD]. Der Standardwert ist der unter angegebene Tag. + + +  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 oder . + + +  Zeit + Beginnt zu dieser Zeit [Sekunden seit epoch]. + + +  Zeit + Endet zu dieser Zeit [Sekunden seit epoch]. + + +  Zusammenfassung + Fügt eine Zusammenfassung zum Termin hinzu (bei "add" und "change"). + + +  Beschreibung + Fügt eine Beschreibung zum Termin hinzu (bei "add" und "change"). + + +  Ort + Fügt einen Ort zum Termin hinzu (bei "add" und "change"). + + + Exportparameter: + + +  Typ + Export zum angegebenen Typ. Der Standardtyp ist Text. + + +  Dateiname + Export in die angegebene Datei. Standardmäßig wird der Export zur Standardausgabe durchgeführt. + + + + Zeigt eine Liste der unterstützten Exportformate an. + + + + + + + + +Fragen und Antworten +&reporting.bugs; &updating.documentation; + + +Welche Konfigurationsdateien verwendet &konsolekalendar;? + + +Keine. + + + + + + +Wie lauten die Namen von &konsolekalendar;? + + +Der Name von &konsolekalendar; ist konsolekalendar. + + + + + +In welchem Format müssen Datumsangaben gemacht werden? + + + erfordert die Eingabe von Datumsangaben nach dem ISO-8601-Standard, also: JJJJ-MM-DD. Dabei bedeutet JJJJ die Jahresangabe mit vier Ziffern (z.B. 2003), MM die Monatsangabe mit zwei Ziffern (01,02,...,12) und DD die Tagesangabe mit zwei Ziffern (01,02,...,31). &konsolekalendar; +&konsolekalendar; exportiert Datumsangaben immer nach dem ISO-8601-Format. + + + + + +In welchem Format müssen Zeitangaben gemacht werden? + + +Zeitangaben für &konsolekalendar; müssen unbedingt in Übereinstimmung mit dem ISO-8601-Standard eingegeben werden, also HH:MM:SS. Dabei bedeutet HH die Stunde zweiziffrig (01,02,...,24), MM die Minuten zweiziffrig (01,02,...,60), und SS die Sekunden ebenfalls zweiziffrig (01,02,...,60). +&konsolekalendar; exportiert Zeitangaben immer entsprechend dem ISO-8601-Standard. + + + + + +Fügt &konsolekalendar; bei übereinstimmenden Zeiten einen neuen Termin ein, der identisch zu einem bereits vorhandenen ist? + + +Nein. Sie nächste Frage. + + + + + +Wie stellt &konsolekalendar; fest, ob ein Termin identisch zu einem bereits im Kalender vorhandenen ist? + + +&konsolekalendar; vergleicht Startzeitpunkt, Endzeitpunkt und Zusammenfassung mit allen im Kalender vorhandenen Terminen. Falls alle drei Angaben übereinstimmen, sind die Termine identisch. + + + + + +Kan ein nicht-beweglicher Termin in einen beweglichen Termin umgewandelt werden? + + +Yes. Use the option with . + + + + + +Warum werden in den meisten Exportformaten die Kennungen (UIDs) ausgegeben? + + +Weil Sie die Kennungen (UIDs) zum Löschen oder Ändern von Ereignissen benötigen. Wenn Sie die UIDs von Terminen nicht sehen möchten, dann verwenden Sie den kurzen Exporttyp (). + + + + + +Wie kann ich eine Frage zu den FAQ hinzufügen? + + +Senden Sie eine E-Mail an illuusio@lycos.com. + + + + + + + + + +Mitwirkende und Lizenz + +&konsolekalendar; ProgrammCopyright 2002,2003: + + +Tuukka Pasanen illuusio@mailcity.com +Allen Winter awinterz@users.sourceforge.net + + +Dokumentation Copyright 2003: + +Allen Winter awinterz@users.sourceforge.net +Tuukka Pasanenilluusio@mailcity.com + + +Noch niemand +&underFDL; &underGPL; + + +Installation + + +Wie bekomme ich &konsolekalendar;? +&install.intro.documentation; ist in &kde;3 enthalten und nicht separat erhältlich. &konsolekalendar; + + + + +Voraussetzungen + +Für &konsolekalendar; müssen die &kde;-Standardbibliotheken (also das tdelibs-Paket) installiert sein. Zur Kompilierung wird außerdem &Qt; und das Entwicklerpaket zu tdelibs benötigt. + +Ein Liste von Änderungen finden Sie in der Datei ChangeLog. + + + +Kompilierung und Installation + +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 tdepim-x.x.tar.bz2 herunterladen. Durch den Befehl tar wird das Paket in einen Ordner ausgepackt. Wechseln Sie in diesen Ordner. +&install.compile.documentation; Falls Sie mehr als eine Version von &kde; installiert haben (also z.B. &kde;2 und &kde;3), 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 + + + + +Einrichtung + +Zur Verwendung von &konsolekalendar; mit der &kde;-Arbeitsoberfläche sind keine weiteren Konfigurationen notwendig. + + + + + +&documentation.index; + + -- cgit v1.2.1