fyb/calcurse-edge
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
calcurse-edge/doc/manual_de.html
Frederic Culot fb58bcb38a German manual updated by Chris M.
2006-10-01 18:00:57 +00:00

815 lines
38 KiB
HTML
Executable File
Raw Blame History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
/*
* $calcurse: manual_de.html,v 1.5 2006/10/01 18:00:57 culot Exp $
*
* Calcurse - text-based organizer
* Copyright (c) 2004-2006 Frederic Culot
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*
* Send your feedback or comments to : calcurse@culot.org
* Calcurse home page : http://culot.org/calcurse
*
*/
-->
<html>
<head>
<title>CALCURSE documentation</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body bgcolor="white" text="black" link="blue" vlink="navy">
<h1><code>CALCURSE - textbasierter Terminkalender</code></h1>
<p>
<p><hr><p>
<h1>Inhaltsverzeichnis</h1>
<ul>
<li><a href="#intro">Einleitung</a>
<li><a href="#overview">&Uuml;berblick</a>
<ul>
<li><a href="#overview_history">Anlass</a>
<li><a href="#overview_features">Wichtige Eigenschaften</a>
</ul>
<li><a href="#install">Installation</a>
<ul>
<li><a href="#install_requirements">Voraussetzungen</a>
<ul>
<li><a href="#install_requirements_ncurses"><code>ncurses</code> Bibliothek</a>
<li><a href="#install_requirements_gettext"><code>gettext</code> Bibliothek</a>
</ul>
<li><a href="#install_process">Installationsprozess</a>
</ul>
<li><a href="#basics"><code>calcurse</code> Grundlagen</a>
<ul>
<li><a href="#basics_invocation">Programmaufruf</a>
<ul>
<li><a href="#basics_invocation_commandline">Programmargumente</a>
<li><a href="#basics_invocation_variable">Umgebungsvariable f&uuml;r i18n</a>
</ul>
<li><a href="#basics_interface">Benutzer-Interface</a>
<ul>
<li><a href="#basics_interface_noninteractive">Nicht-interaktiver Modus</a>
<li><a href="#basics_interface_interactive">Interaktiver Modus</a>
</ul>
<li><a href="#basics_files"><code>calcurse</code> Dateien</a>
<li><a href="#basics_help">Onlinehilfe</a>
</ul>
<li><a href="#options">Optionen</a>
<ul>
<li><a href="#options_general">Allgemeine Optionen</a>
<li><a href="#options_colors">Einstellen der Terminalfarben</a>
<li><a href="#options_layout">Einstellen des Layouts</a>
<li><a href="#options_notify">Einstellen der Benachrichtigungszeile</a>
</ul>
<li><a href="#known_bugs">Bekannte Fehler</a>
<li><a href="#bugs">Mitteilung von Fehlern und Anregungen</a>
<li><a href="#contribute">Wie kann ich einen Beitrag leisten?</a>
<ul>
<li><a href="#contribute_documentation">&Uuml;bersetzung der Dokumentation</a>
<li><a href="#contribute_i18n"><code>calcurse</code> i18n</a>
<ul>
<li><a href="#contribute_i18n_overview">&Uuml;berblick</a>
<li><a href="#contribute_i18n_translator">Aufgaben des &Uuml;bersetzers</a>
<li><a href="#contribute_i18n_po-files">po-Dateien</a>
</ul>
</ul>
<li><a href="#links">Links</a>
<ul>
<li><a href="#links_homepage"><code>calcurse</code> Internetseite</a>
<li><a href="#links_list"><code>calcurse</code> Ank&uuml;ndigungsliste</a>
</ul>
<li><a href="#thanks">Danksagungen</a>
</ul>
<p><hr><p>
<a name="intro"></a><h1>Einleitung</a></h1>
<p>
<code>calcurse</code> ist ein textbasierter pers&ouml;nlicher Terminkalender, der
Ihnen bei der Organisation von Terminen und t&auml;glichen Aufgaben
hilft. Er beinhaltet einen Kalender sowie eine 'todo'-Liste, die Ihre
Termine ordnen. Die Terminalfarben und das Layout des Benutzer-Interfaces
lassen sich individuell anpassen. Alle Kommandos sind
dokumentiert und k&ouml;nnen zur Laufzeit jederzeit erfragt werden.
<a name="overview"></a><h1>&Uuml;berblick</h1>
<a name="overview_history"></a><h2>Anlass</h2>
<p>
Nachdem ich mein Diplom in Astrophysik absolviert hatte, kam mir die
Idee dieses Programm zu schreiben. Alles begann etwas unorganisiert zu
werden. Ein Programm, dass mir bei meiner Terminplanung etwas hilft,
war wirklich vonn&ouml;ten. ;)<br>
Ich mag Programme mit Textinterfaces, weil sie einfach, schnell,
portabel und effizient sind. Also dachte ich dar&uuml;ber nach ein
Programm mit textorientiertem Benutzer-Interface zu entwickeln.
Dar&uuml;ber hinaus wollte ich meine Kenntnisse in der Programmiersprache
<code>C</code> erweitern. Im Grundstudium kam ich mit <code>C</code>
erstmals in Kontakt. Ich denke es ist eine gute Idee ein solches
Projekt zu beginnen und dabei meine Kenntnisse in <code>C</code> zu
erweitern! Mein Diplom habe ich nun absolviert, <code>calcurse</code>
ist aber noch immer nicht fertig. Nach wie vor entwickle ich dieses
Programm weiter, in der Hoffnung, dass es f&uuml;r andere von Nutzen sein
wird. Also hier ist es...<br>
<br>
Doch warum nenne ich es 'calcurse'? Nun, es ist einfach
zusammengesetzt aus den W&ouml;rtern 'CALendar' und 'nCurses', dem Namen
der Bibliothek die f&uuml;r das Benutzer-Interface verwendet wird.
<a name="overview_features"></a><h2>Wichtige Eigenschaften</h2>
<p>
<code>Calcurse</code> ist portabel und setzt sich zum Ziel klein,
schnell und sicher zu sein. Es ist auf einer Konsole oder einem
Terminal zu verwenden, entweder lokal oder auf einem entfernten System
mithilfe einer ssh-Verbindung (oder &Auml;hnlichem).<br>
<code>Calcurse</code> kann in zwei unterschiedlichen Modi gestartet
werden: Im interaktiven und im nicht-interaktiven Modus. Der erste Modus
erzeugt Dank des textbasierten Interfaces die Ansicht eines eigenen
pers&ouml;nlichen Terminkalenders. Mit dem zweiten Modus ist es m&ouml;glich
sich ein Erinnerungstool (Reminder) zu erstellen, wenn
<code>calcurse</code> mit den entsprechenden Argumenten in 'cron tab'
oder einem 'init script' eingebunden wird.<br>
Dar&uuml;ber hinaus ist <code>calcurse</code> f&uuml;r Benutzer erstellt worden,
mit der Absicht so benutzerfreundlich wie m&ouml;glich zu sein. Das
bedeutet, dass eine komplette Onlinehilfe im Programm zu Verf&uuml;gung
steht, sowie alle m&ouml;gliche Aktionen jederzeit in einer Statuszeile
ersichtlich sind. Das Benutzer-Interface ist ebenfalls
einstellbar. Ebenso kann man verschiedene Textfarben und Layouts
w&auml;hlen.
<a name="install"></a><h1>Installation</h1>
<a name="install_requirements"></a><h2>Voraussetzungen</h2>
<a name="install_requirements_ncurses"></a><h3><code>ncurses</code> Bibliothek</h3>
<p>
<code>Calcurse</code> ben&ouml;tigt einen C-Compiler wie etwa
<code>cc</code> oder <code>gcc</code>. Ferner wird die
ncurses-Bibliothek ben&ouml;tigt, die jedoch auf den meisten Unix-Systemen
verf&uuml;gbar sein sollte. Falls nicht, k&ouml;nnen Sie sie von folgender URL herunter
laden:<br>
<pre>
http://ftp.gnu.org/pub/gnu/ncurses/
</pre>
<a name="install_requirements_gettext"></a><h3><code>gettext</code> Bibliothek</h3>
<p>
<code>calcurse</code> unterst&uuml;tzt die Internationalisierung
(k&uuml;nftig <em>i18n</em>) durch <code>gettext</code>.
Das bedeutet, dass <code>calcurse</code> mehrsprachige Mitteilungen
erzeugen kann, wenn es mit der entsprechenden Sprachunterst&uuml;tzung
kompiliert wurde (z.B. <em>NLS</em>).
Dennoch, <em>NLS</em> ist optional und wenn keine mehrsprachigen Mitteilungen
gew&uuml;nscht sind, kann diese Eigenschaft abgestellt werden.
Rufen Sie hierzu einfach das <code>configure</code> Skript mit der Option
<code>--disable-nls</code> auf (siehe Abschnitt <ahref="#install_process">
Installationsprozess</a>). <br>
Um zu &uuml;berpr&uuml;fen, ob <code>gettext</code> auf dem System installiert ist,
kann man nach der <code>libintl.h</code> Datei suchen:
<pre>
locate libintl.h
</pre>
Wurde diese Datei nicht gefunden, kann <code>gettext</code> von folgender URL herunter
geladen werden:<br>
<pre>
http://ftp.gnu.org/pub/gnu/gettext/
</pre>
<u>Beachte:</u> Auch wenn <code>libintl.h</code> auf dem System
gefunden wurde, kann es erforderlich sein den Pfad dieser Datei w&auml;hrend des <ahref="#install_process"> Installationsprozesses</a> anzugeben. Die entsprechende
Option f&uuml;r das <code>configure</code> Skript lautet dann <code>--with-libintl-prefix</code>.
Das <code>configure</code> Skript wird nat&uuml;rlich vorzeitig abbrechen, wenn die dazugeh&ouml;rige Bibliothek nicht gefunden wurde.
<a name="install_process"></a><h2>Installationsprozess</h2>
<p>
Als erstes m&uuml;ssen die Dateien entpackt werden:
<pre>
tar zxvf calcurse-1.6.tar.gz
</pre>
Ist diese Voraussetzung erf&uuml;llt und das Archiv entpackt,
sind nur noch die drei &uuml;blichen Schritte erforderlich:
<OL>
<li><code>./configure</code>
<li><code>make</code>
<li><code>make install</code> (mit Root-Rechten)
</OL>
Rufen Sie <code>./configure --help</code> auf, um die
verf&uuml;gbaren Optionen aufgelistet zu bekommen.
<a name="basics"></a><h1><code>calcurse</code> Grundlagen</h1>
<a name="basics_invocation"></a><h2>Programmaufruf</h2>
<a name="basics_invocation_commandline"></a><h3>Programmargumente</h3>
<p>
<code>Calcurse</code> kann mit folgenden Optionen aufgerufen werden:
<dl compact>
<dt><code>-a</code>
<dd>Gibt die Termine des heutigen Tags aus.<br>
<u>Beachte:</u> Die Kalender-Datei, aus der die Termine gelesen
werden sollen, kann mit mit Hilfe der -c Option angegeben werden.<br>
<br>
<dt><code>-c</code>
<dd>
Gibt die zu lesende Kalender-Datei an.<br>
Der Standardkalender ist <code>~/.calcurse/apts</code> (beachte auch
Abschnitt: <a href="#basics_files"><code>calcurse</code> Dateien</a>).<br>
<br>
<dt><code>-d</code>
<dd>
Gibt die Termine eines angegebenen Datums oder alle Termine der
anzugebenden nachfolgenden Tage aus. Somit sind zwei Formate m&ouml;glich:
<ul>
<li>Datum: 'MM/TT/JJJJ' (Monat, Tag, Jahr).
<li>Anzahl der Tage: 'n'.
</ul>
Im ersten Fall wird eine Liste mit allen Terminen des angegebenen
Datums ausgegeben. Der zweite Fall listet alle folgenden Termine auf,
die in den n&auml;chsten 'n' Tagen zu erledigen sind.<br>
Beispiel: Die Eingabe <code>calcurse -d 3</code> gibt alle Termine des
heutigen und der beiden folgenden Tage aus.<br>
<br>
<dt><code>-h</code>
<dd>
Gibt eine Hilfe zu den unterst&uuml;tzten Optionen aus.<br>
<br>
<dt><code>-n</code>
<dd>
Gibt den Termin aus, der innerhalb der kommenden 24 Stunden als
n&auml;chstes stattfindet.<br>
<br>
<dt><code>-t</code>
<dd>
Gibt die 'todo' Liste aus.<br>
<br>
<dt><code>-v</code>
<dd>
Gibt die aktuelle Version von Calcurse aus.
</dl>
<a name="basics_invocation_variable"></a><h3>Umgebungsvariable f&uuml;r i18n</h3>
<p>
<code>calcurse</code> kann mit Unterst&uuml;tzung f&uuml;r verschiedene Sprachen
kompiliert werden (siehe <a
href="#install_requirements_gettext"><code>gettext</code>
Bibliothek</a>). Um Meldungen in anderen Sprachen zu erhalten,
sollte zun&auml;chst gepr&uuml;ft werden, ob die <code>po/LINGUAS</code> Datei verf&uuml;gbar ist.
Diese Datei zeigt alle verf&uuml;gbaren Sprachen durch
zweibuchstabige K&uuml;rzel an (beispielsweise steht <em>fr</em>
f&uuml;r Franz&ouml;sisch). Ist Ihre Muttersprache nicht aufgef&uuml;hrt, w&auml;re es
nat&uuml;rlich gro&szlig;artig, wenn Sie sich an der &Uuml;bersetzung von <code>calcurse</code>
in andere Sprachen beteiligen k&ouml;nnten (siehe Abschnitt <a href="#contribute">Wie kann
ich einen Beitrag leisten?</a>).<br>
Wird Ihre Sprache bereits unterst&uuml;tzt, k&ouml;nnen Sie
<code>calcurse</code> mit dem folgenden Aufruf starten:
<pre>
LC_ALL=fr_FR calcurse
</pre>
wobei <em>fr_FR</em> der Name der gew&uuml;nschten Spracheausgabe ist und durch
das K&uuml;rzel Ihrer Sprache ersetzt werden kann.<br>
Zus&auml;tzlich sollten Sie den verwendeten Zeichensatz angeben, da in einigen F&auml;llen Sonderzeichen wie etwa Akzente und Umlaute nicht korrekt dargestellt werden.
Auf den der entsprechende Sprache gew&uuml;nschten Zeichensatz wird am Anfang der po-Datei hingewiesen.
Der Datei fr.po k&ouml;nnen Sie beispielsweise entnehmen, dass der Zeichensatz iso-8859-1 verwendet wird.
Sie k&ouml;nnten <code>calcurse</code> folgenderma&szlig;en aufrufen:
<pre>
LC_ALL=fr_FR.ISO8859-1 calcurse
</pre>
<a name="basics_interface"></a><h2>Benutzer-Interface</h2>
<a name="basics_interface_noninteractive"></a><h3>Nicht interaktiver Modus</h3>
<p>
Wird <code>calcurse</code> mit den Optionen:<br>
<code>-a</code>, <code>-d</code>, <code>-h</code>,
<code>-n</code>, <code>-t</code>, <code>-v</code><br>
gestartet, wird das Programm im nicht-interaktiven Modus
ausgef&uuml;hrt. Das bedeutet, dass die gew&uuml;nschten Informationen
ausgegeben werden und das Programm anschlie&szlig;end sofort wieder beendet
wird. Durch das Einbinden von <code>calcurse -ta</code> in eine init config
Datei ist es beispielsweise m&ouml;glich, sich seine zu erledigenden Aufgaben
und alle Termine des heutigen Tages beim Logon anzeigen zu lassen.
<a name="basics_interface_interactive"></a><h3>Interaktiver Modus</h3>
<p>
Wird keine, oder nur Option -c angegeben, startet
<code>calcurse</code> im interaktiven Modus. In diesem Modus erh&auml;lt
man ein Interface mit drei unterschiedlichen Panels, einer
Benachrichtigungszeile, sowie einer Status-Zeile (siehe unten).
Die einzelnen Panels lassen sich durch die 'TAB'-Taste ansteuern.
<pre>
Termin-Panel---. .---Kalender-Panel
| |
v v
+------------------------------------++----------------------------+
| Termine || Kalender |
|------------------------------------||----------------------------|
| 6. Oktober 2006 || September 2006 |
| || Mo Di Mi Do Fr Sa So |
| || 1 2 |
| || 3 4 5 6 7 8 9 |
| || 10 11 12 13 14 15 16 |
| || 17 18 19 20 21 22 23 |
| || 24 25 26 27 28 29 30 |
| || |
| |+----------------------------+
| |+----------------------------+
| || Aufgaben | todo-
| ||----------------------------| Panel
| || | |
| || | |
| || |&lt;--.
| || |
+------------------------------------++----------------------------+
|---[ So 2006-10-01 | 10:11:43 ]---(apts)----&gt; 01:20 :: lunch &lt;---|&lt;--.
+------------------------------------------------------------------+ Benachrichtigungszeile
| ? Hilfe S Speichern H/L -/+1 Tag Tab &auml;ndere Ansicht |
| Q Beenden G Gehe zu J/K -/+1 Woche C Einstellung |&lt;-.
+------------------------------------------------------------------+ |
|
Statuszeile
</pre>
Das Kalender-Panel hebt den gew&uuml;nschten Tag farblich hervor, w&auml;hrend
das Termin-Panel die Liste mit Terminen des angesteuerten Tags
anzeigt. Das todo-Panel dagegen zeigt eine Liste mit den zu
erledigenden Aufgaben, die keinem bestimmten Tage zugeordnet sind.
Die letzten beiden Zeilen des Interfaces zeigen die Status-Zeile, die
&uuml;ber die m&ouml;glichen Befehle und ihre entsprechenden Tasten informiert.
Direkt &uuml;ber der Statuszeile befindet sich die Benachrichtigungszeile, die
von links nach rechts gesehen die folgenden Elemente anzeigt: Das aktuelle Datum,
die aktuelle Uhrzeit, die momentan verwendete Kalenderdatei (im obigen Beispiel
die standardm&auml;&szlig;ig verwendete Kalenderdatei apts [Vergleiche hierzu
den folgenden Abschnitt]) und der n&auml;chste Termin, der in den kommenden 24
Stunden ansteht. Im Beispiel ist dies der Termin lunch, der in 1 Stunde und
zwanzig Minuten beginnt.
<a name="basics_files"></a><h2><code>calcurse</code> Dateien</h2>
<p>
Die folgende Verzeichnisstruktur wird im $HOME-Verzeichnis angelegt,
wenn <code>calcurse</code> das erste Mal gestartet wird:
<pre>
$HOME/.calcurse/
|___conf
|___apts
|___todo
</pre>
Die <em>conf</em> Datei enth&auml;lt die Informationen zur Benutzerkonfiguration.<br>
Die <em>apts</em> Datei enth&auml;lt alle Termine.<br>
Die <em>todo</em> Datei enth&auml;lt die todo-Liste.
<a name="basics_help"></a><h2>Online Hilfe</h2>
<p>
Das integrierte Hilfe-System kann jederzeit mit '?' aufgerufen
werden. Informationen &uuml;ber bestimmte Befehle k&ouml;nnen mit der
entsprechenden Taste des Befehls aufgerufen werden.
<a name="options"></a><h1>Optionen</h1>
<p>
S&auml;mtliche in <code>calcurse</code> ver&auml;nderbaren Parameter lassen sich
Konfigurationsmen&uuml; einstellen. Dr&uuml;cken Sie hierzu die Taste 'C'.
Daraufhin erscheint ein Untermen&uuml; mit vier weiteren Wahlm&ouml;glichkeiten:
Das erneute Bet&auml;tigen von 'C' f&uuml;hrt Sie zu den Farbeinstellungen und
&uuml;ber 'L' gelangen Sie in ein Untermen&uuml;, in dem Sie die Anordnung der
drei Panel &auml;ndern k&ouml;nnen. Dr&uuml;cken Sie 'G' um ins Auswahlmen&uuml;
der allgemeinen Optionen zu gelangen. Zu guter Letzt k&ouml;nnen Sie die
Einstellungen der Benachrichtigungszeile &auml;ndern, indem Sie die Taste 'N'
bet&auml;tigen.
<a name="options_general"></a><h1>Allgemeine Optionen</h1>
<p>
Die im Folgenden beschriebenen Optionen steuern <code>calcurse</code>s
allgemeines Verhalten.
<ul>
<li><code>automatisches_Speichern</code> (Voreinstellung: <em>ja</em>)<br>
Ist diese Option aktiviert, werden die Benutzerdaten automatisch beim
Verlassen gespeichert. Warnung: Beim Verlassen werden keine Daten gespeichert,
wenn <em>automatisches_Speichern</em> auf <em>nein</em> gesetzt wurde. Um Ihre
Eingaben dennoch zu speichern, m&uuml;ssen Sie als Nutzer die Taste 'S'
bet&auml;tigen.<br>
<br>
<li><code>Beenden_best&auml;tigen</code> (Voreinstellung: <em>ja</em>)<br>
Wenn <em>ja</em> eingestellt worden ist, wird nachgefragt, ob das
Programm wirklich beenden werden soll. Wurde <em>nein</em> gew&auml;hlt,
wird das Programm durch die Eingabe von 'Q' ohne Nachfrage sofort beendet.<br>
<br>
<li><code>L&ouml;schen_best&auml;tigen</code> (Voreinstellung: <em>ja</em>)<br>
Wurde <em>ja</em> eingestellt, fragt das Programm nach, ob ein
Eintrag wirklich gel&ouml;scht werden soll (entweder ein todo-Eintrag oder
ein Termin). Wurde <em>nein</em> gew&auml;hlt, wird beim Dr&uuml;cken von 'D'
ohne Nachfrage gel&ouml;scht.<br>
<br>
<li><code>Systemdialoge_&uuml;berspringen</code> (Voreinstellung: <em>nein</em>)<br>
Durch Setzen auf <em>ja</em> werden die Dialoge beim Speichern und
Laden umgangen. N&uuml;tzlich, wenn es mal schnell gehen muss.<br>
<br>
<li><code>Fortschrittsanzeige_&uuml;berspringen</code> (Voreinstellung: <em>nein</em>)<br>
Wird diese Option aktiviert, wird die beim Speichern von Daten normalerweise
erscheinende Fortschrittsanzeige nicht mehr angezeigt.
Ist diese Option auf <em>nein</em> gesetzt, werden ein
Zustandsbalken und der Name der zu speichernden Datei (siehe
Abschnitt <a href="#basics_files">Calcurse Dateien</a>) angezeigt.<br>
<br>
<li><code>Wochenbeginn_am_Montag</code> (Voreinstellung: <em>ja</em>)<br>
Es ist m&ouml;glich zwischen Montag und Sonntag als ersten Tag der Woche
zu w&auml;hlen. Wird die Option auf <em>ja</em> gesetzt, wird Montag
als erster Tag der Woche festgelegt. Ist <em>nein</em> gew&auml;hlt,
beginnt die Woche sonntags.
</ul>
<a name="options_colors"></a><h2>Textfarben einstellen</h2>
<p>
Die verwendeten Textfarben k&ouml;nnen nach eigenen Vorlieben eingestellt
werden. Durch Bet&auml;tigung der entsprechenden Taste kann die gew&uuml;nschte
Farbkombination ausgew&auml;hlt werden. Die gew&auml;hlte Farbkombination werden
dem Rahmen, dem Titel und der Status-Zeile zugewiesen.
Eine schwarz/wei&szlig; Kombination ist ebenfalls verf&uuml;gbar, um
Terminals ohne Farben zu unterst&uuml;tzen.<br>
<u>Beachte:</u>
<ul>
<li> Der Farbunterst&uuml;tzung ist vom verwendeten Terminal und des der
Umgebungsvariablen <code>$TERM</code> zugewiesenen Werts abh&auml;ngig.
Es erscheint eine Fehlermeldung, wenn versucht wird die Farbeinstellung
zu &auml;ndern, obwohl das Terminal keine Farben unterst&uuml;tzt.<br>
<br>
<li> Wenn sie sicher sind, dass ihr Terminal Farben darstellen kann,
in <code>calcurse</code> aber keine Farben erscheinen, versuchen Sie
die <code>$TERM</code> Variable auf einen anderen Wert zu setzen
(etwa <em>xterm-xfree86</em>).
</ul>
<a name="options_layout"></a><h2>Layout einstellen</h2>
<p>
Das Layout bezieht sich auf die Positionen der einzelnen Panel. Das
Standard-Layout zeigt das Kalender-Panel in der oberen linken Ecke des
Terminals, das todo-Panel befindet sich in der unteren rechten Ecke
und das Termin-Panel auf der linken Seite des Terminals (vgl. die
im Abschnitt <a href="#basics_interface_interactive">Interaktiver Modus</a>
dargestellte Zeichnung des Standard-Layouts).<br>
Durch Auswahl eines anderen Layouts kann der Benutzer das
Erscheinungsbild von <code>calcurse</code> seinen eigenen W&uuml;nschen
entsprechend anpassen.
<a name="options_notify"></a><h2>Benachrichtigungszeile einstellen</h2>
<p>
Folgende Optionen &auml;ndern das Verhalten der Benachrichtigungszeile:
<ul>
<li><code>Benachrichtigungszeile_anzeigen</code> (Voreinstellung: <em>ja</em>)<br>
Mit dieser Option legen Sie fest, ob die Benachrichtigungszeile anzeigt werden soll. <br>
<br>
<li><code>Benachrichtigungszeile_Datum</code> (Voreinstellung: <em>%a %F</em>)<br>
Hiermit kann das Format festgelegt werden, wie das aktuelle Datum innerhalb
der Benachrichtigungszeile angezeigt werden soll.
Die m&ouml;glichen Formatdefinitionen k&ouml;nnen Sie sich durch die Eingabe
von <tt>man 3 strftime</tt> auf der Kommandozeile anzeigen lassen.<br>
<br>
<li><code>Benachrichtigungszeile_Uhrzeit</code> (Voreinstellung: <em>%T</em>)<br>
Hiermit kann das Format festgelegt werden, wie die aktuelle Uhrzeit
innerhalb der Benachrichtigungszeile angezeigt werden soll.
Die m&ouml;glichen Formatdefinitionen k&ouml;nnen Sie sich durch die
Eingabe von <tt>man 3 strftime</tt> auf der Kommandozeile anzeigen
lassen.<br>
<br>
<li><code>Benachrichtigungszeile_Alarm</code> (Voreinstellung: <em>300</em>)<br>
Beginnt ein Termin innerhalb der n&auml;chsten, in 'Benachrichtigungszeile_Alarm'
festgelegten Sekunden, wird der Termin innerhalb der Benachrichtigungszeile
blinkend dargestellt. Auf diese Weise wird der Nutzer auf einen baldigen Termin
hingewiesen.
</ul>
<a name="known_bugs"></a><h1>Bekannte Fehler</h1>
<p>
Es kommt vor, dass W&ouml;rter bei Verwendung der schwarz/wei&szlig;en
Farbkombination falsch hervorgehoben werden, wenn die
<code>$TERM</code> Variable auf <em>xterm-color</em> gesetzt ist.
Um diesen Fehler zu vermeiden, sollte nach Aussage von
Thomas E. Dickey (zust&auml;ndig f&uuml;r <code>xterm</code>),
<em>xterm-xfree86</em> an Stelle f&uuml;r <em>xterm-color</em> als
<code>$TERM</code> Variable gesetzt werden:<br>
<blockquote>
"The xterm-color value for $TERM is a bad choice for XFree86 xterm
because it is commonly used for a terminfo entry which happens to
not support bce. Use the xterm-xfree86 entry which is distributed
with XFree86 xterm (or the similar one distributed with ncurses)."
</blockquote>
<a name="bugs"></a><h1>Mitteilung von Fehlern und Anregungen</h1>
<p>
Bitte mailen Sie Fehler oder auch Anregungen an:
<pre>
calcurse@culot.org
</pre>
Oder an den Autor:
<pre>
frederic@culot.org
</pre>
<a name="contribute"></a><h1>Wie kann ich einen Beitrag leisten?</h1>
<p>
Wenn Sie gerne dieses Projekt unterst&uuml;tzen m&ouml;chten, k&ouml;nnen Sie mir
zuerst eine kurze R&uuml;ckmeldung geben. Was finden Sie an diesem Programm gut
oder was k&ouml;nnte besser sein? Gibt es vielleicht Programmeigenschaften, die
Sie vermissen? Teilen Sie sie mir mit!<br>
Von nun an ist es auch m&ouml;glich, sich an der &Uuml;bersetzung der Programmmitteilungen
und der Dokumentation von <code>calcurse</code> zu beteiligen. <br>
<br>
<u>Beachte:</u> Jegliche Unterst&uuml;tzung <code>calcurse</code>
in andere Sprachen zu &uuml;bersetzen ist sehr willkommen. Bevor Sie beginnen, sollten
Sie jedoch eine E-Mail an <code>calcurse-i18n@culot.org</code> senden: So erfahren Sie,
ob jemand die &Uuml;bersetzung in Ihrer Sprache schon begonnen hat.
<a name="contribute_documentation"></a><h2>&Uuml;bersetzung der Dokumentation</h2>
<p>
Das <em>doc/</em> Verzeichnis des Quellcodearchivs enth&auml;lt bereits
&uuml;bersetzte Versionen des <code>calcurse</code> Handbuchs.
Ist eine &Uuml;bersetzung in Ihrer Sprache noch nicht vorhanden,
w&auml;re es gro&szlig;artig, wenn Sie eine solche erstellen k&ouml;nnten.<br>
Kopieren Sie dazu eine der vorhandenen Version mit dem Dateinamen
<code>manual_XX.html</code>, wobei <em>XX</em>
das entsprechende K&uuml;rzel Ihrer Sprache ist. &Uuml;bersetzen Sie diese
Datei anschlie&szlig;end und senden Sie sie dann an den Autor
(siehe <a href="#bugs">Mitteilung von Fehlern und Anregungen</a>), damit Ihre
&Uuml;bersetzung der n&auml;chsten <code>calcurse</code> Version
hinzugef&uuml;gt werden kann.
<a name="contribute_i18n"></a><h2><code>calcurse</code> i18n</h2>
<p>
Wie bereits erw&auml;hnt, verwendet <code>calcurse</code> die <code>gettext</code>
Utilities um mehrsprachige Programmmitteilungen zu erzeugen.
Dieser Abschnitt informiert Sie dar&uuml;ber, wie Programmmitteilungen in Ihre
Muttersprache &uuml;bersetzt werden. Dieses Howto zur &Uuml;bersetzung von
<code>calcurse</code> mittels <code>gettext</code> ist nat&uuml;rlich nur als Einstieg
gedacht und mit Absicht recht knapp gehalten. Um umfassendere Informationen
zu erhalten und sich die gro&szlig;e weite Welt der Internationalisierung von Software zu
erschlie&szlig;en, sollten Sie die Seite der <code>GNU gettext</code>-Anleitung besuchen:
<pre>
http://www.gnu.org/software/gettext/manual/
</pre>
An der &Uuml;bersetzung sind im Grunde drei verschiedene Entwickler beteiligt:
Programmierer, Sprachkoordinator und &Uuml;bersetzer.
Nach einem kurzen &Uuml;berblick, wie so etwas funktioniert, werden anschlie&szlig;end die
Aufgaben des &Uuml;bersetzers beschrieben.
<a name="contribute_i18n_overview"></a><h3>&Uuml;berblick</h3>
<p>
Um Text in der Muttersprache des Benutzers erscheinen zu lassen, sind zwei Schritte n&ouml;tig:
<em>Internationalisierung</em>
(i18n) und <em>Lokalisierung</em> (l10n).
Bei der i18n geht es darum, <code>calcurse</code> auf die Unterst&uuml;tzung mehrerer
Sprachen vorzubereiten. Dies ist die Aufgabe des Programmierers, der die zu
&uuml;bersetzenden Texte markiert und andererseits sicherstellen muss, dass zur Laufzeit
des Programms der &uuml;bersetzt Text erscheint.
Bei der l10n geht es darum, dem bereits internationalisierten - also i18n markierten -
<code>calcurse</code> die entsprechende &Uuml;bersetzung des Benutzers zur Verf&uuml;gung
zu stellen.
Gem&auml;&szlig; den Umgebungsvariablen ersetzt <code>calcurse</code> die zuvor vom
Programmierer markierten Texte durch die entsprechenden &Uuml;bersetzungen.<br>
<br>
Die zu &uuml;bersetzenden Texte werden also zun&auml;chst vom Programmierer im
<code>C</code>-Quellcode markiert und in einem Template (<em>calcurse.pot</em> -
die Dateierweiterung <em>pot</em> steht f&uuml;r <em>portable object template</em>)
gesammelt. Anschlie&szlig;end wird der Inhalt dieses Templates mit den Dateien, die
die &Uuml;bersetzungen enthalten zusammengef&uuml;hrt (<em>fr.po</em> enth&auml;lt
beispielsweise die Franz&ouml;sische &Uuml;bersetzung (<em>po</em> steht hierbei
f&uuml;r <em>portable object</em>, also ein von Menschen les- und ver&auml;nderbares
Dateiformat),
Der &Uuml;bersetzer kann diese Datei &ouml;ffnen, die enthaltenen Texte &uuml;bersetzen
und sie dann an den Programmierer zur&uuml;ck senden.
Wird das Programm compiliert, erzeugt der Compiler (aus Gr&uuml;nden der Effizienz)
eine bin&auml;re Version dieser Datei, die sp&auml;ter installiert wird (<em>fr.mo</em>
- <em>mo</em> steht f&uuml;r <em>machine object</em>; dieses Format kann nur von
Programmen gelesen werden). <code>calcurse</code> nutzt diese Datei zur Laufzeit,
um die Texte in Abh&auml;ngigkeit der lokalen Einstellungen des Benutzers zu
&uuml;bersetzen.
<a name="contribute_i18n_translator"></a><h3>Aufgaben des &Uuml;bersetzers</h3>
<p>
Wenn Sie mit der &Uuml;bersetzung in eine neue Sprache beginnen m&ouml;chten,
finden Sie hierzu die n&ouml;tigen Schritte:
<ul>
<li>Finden Sie zun&auml;chst das K&uuml;rzel Ihrer Sprache heraus.
Beispielsweise ist das K&uuml;rzel f&uuml;r Franz&ouml;sisch 'fr_FR', oder
einfach nur 'fr'. Diesen Wert muss der Benutzer der Umgebungsvariablen
<code>LC_ALL</code> zuweisen, um die Software &uuml;bersetzt starten zu k&ouml;nnen
(siehe <a href="#basics_invocation_variable">Umgebungsvariable f&uuml;r i18n</a>).<br>
<br>
<li>Wechseln Sie dann ins <em>po/</em> Verzeichnis und erzeugen Sie aus dem Template
mit dem folgendem Aufruf eine neue po-Datei:
<pre>
'msginit -i calcurse.pot -o fr.po -l fr --no-translator'
</pre>
Sollte <code>msginit</code> nicht auf Ihrem System installiert sein, kopieren Sie einfach
die Datei <em>calcurse.pot</em> nach <em>fr.po</em> und &auml;nderen Sie den Inhalt am
Anfang der Datei von Hand.<br>
Wurde die Datei <em>fr.po</em> erstellt, kann mit der eigentlichen &Uuml;bersetzung
begonnen werden.
</ul>
<a name="contribute_i18n_po-files"></a><h3>po-Dateien</h3>
<p>
Das Format der po-Dateien ist relativ einfach. po-Dateien gliedern sich in lediglich
vier Bestandteile:
<ol>
<li><em>location Zeilen:</em> geben an, wo sich der Text befindet (Name der Datei und Zeilennummer).
<li><em>msgid Zeilen:</em> der urspr<70>ngliche, also zu &uuml;bersetzende Text.
<li><em>msgstr Zeilen:</em> der &uuml;bersetzte Text.
<li><em>Zeilen, die mit '#' beginnen:</em> Kommentare (einige mit spezieller Bedeutung,
wie wir weiter unten noch sehen werden).
</ol>
&Uuml;bersetzen Sie die <em>msgid</em> Zeilen und tragen Sie den &uuml;bersetzten Text in die
sich direkt darunterbefindlichen, mit <em>msgstr</em> gekennzeichneten Zeilen ein.
<p>
<u>Einige Anmerkungen:</u>
<ul>
<li><em>Fuzzy Texte</em><br>
Einige Texte sind mit <code>"#, fuzzy"</code> kommentiert. <code>calcurse</code> nutzt
derart markierte Texte nicht. Ein als fuzzy markierter Text deutet entweder darauf hin, dass
der Text schon &uuml;bersetzt wurde, aber die Stelle im Programmcode ver&auml;ndert wurde, oder
aber es handelt sich um einen neuen Text, f&uuml;r welchen <code>gettext</code> eine sog. 'wild
guess' vornimmt, also selbst eine &Uuml;bersetzung versucht.
Das bedeutet, die &Uuml;bersetzung sollte noch einmal &uuml;berarbeitet werden.
Manchmal wurde der Originaltext ver&auml;ndert, weil ein Rechtschreibfehler korrigiert wurde.
In einem solchen Fall muss nichts ge&auml;ndert werden.
Mitunter ist die &Uuml;bersetzung aber nicht mehr passend oder schlichtweg falsch und muss
abge&auml;ndert werden.
Entfernen Sie die <code>"#, fuzzy"</code>-Zeilen, wenn Sie mit Ihrer &Uuml;bersetzung fertig
sind, damit <code>calcurse</code> die <20>bersetzten Zeilen wieder verwendet und anzeigt.<br>
<br>
<li><em>c-Format Texte und besondere Sequenzen</em><br>
Einige Texte haben folgende Kommentare: <code>"#,
c-format"</code>.
Dieser Kommentar weist darauf hin, dass Teile dieses Textes eine besondere Bedeutung
haben und dieser Text nicht ver&auml;ndert werden sollte.
Beispielsweise bedeuten die %-Sequenzen, wie <code>"%s"</code>, dass <code>calcurse</code>
dort Text einf&uuml;gen wird. Es ist also wichtig, diese nicht zu ver&auml;ndern.
Ebenso kommen \-Sequenzen , wie etwa <code>\n</code> oder <code>\t</code> vor. Bitte
nehmen Sie auch hier keine Ver&auml;nderungen vor. Erstere stellt das Zeilenende dar,
letztere einen Tabulator.<br>
<br>
<li><em>&Uuml;bersetzungen k&ouml;nnen in Bl&ouml;cke geschrieben werden</em><br>
Sollten Zeilen zu lang werden, k&ouml;nnen sie auf mehrere verteilt werden:
<pre>
msgid ""
"some very long line"
"another line"
</pre>
<li><em>po-Header</em><br>
Ganz zu Anfang einer po-Datei befindet sich der Header, der einige Informationen enth<74>lt.
Die wichtigste Information ist der Zeichensatz. Er sollte diesem &auml;hnlich sein
<pre>
"Content-Type: text/plain; charset=utf-8\n"
</pre>
Auch das &Uuml;bersetzer-Feld sollte ausgef&uuml;llt sein, damit potentielle Mitstreiter,
die sich an der &Uuml;bersetzung beteiligen wollen, mit Ihnen Kontakt aufnehmen k&ouml;nnen.
Ebenso k&ouml;nnen von anderen entdeckte Fehler an den &Uuml;bersetzer gemeldet werden. Geben
Sie Ihren Namen an, oder tragen Sie Ihre E-Mail-Adresse ein. Zum Beispiel folgenderma<6D>en:
<pre>
"Last-Translator: Frederic Culot &lt;frederic@culot.org&gt;\n"
</pre>
<li><em>Kommentare</em><br>
Das Hinzuf&uuml;gen von Kommentaren (Zeilen beginnen mit dem '#' Zeichen) ist eine gute
M&ouml;glichkeit, um Probleme und &Uuml;bersetzungsschwierigkeiten anderen besser
mitteilen zu k&ouml;nnen.<br>
<br>
<li><em>L&auml;ngen der Texte</em><br>
<code>calcurse</code> ist ein curses/Konsolen Programm und ist somit stark von der
Gr&ouml;&szlig;e des Terminals (Anzahl der Spalten) abh&auml;ngig. Dies sollte bei
der &Uuml;bersetzung ber&uuml;cksichtigt werden. H&auml;ufig m&uuml;ssen Texte in
eine einzige Zeile passen (Standardl&auml;nge ist 80 Zeichen).
&Uuml;bersetzen Sie nicht blindlings darauf los! Versuchen Sie herauszufinden, wo der
Text angezeigt wird, um die &Uuml;bersetzung entsprechend anzupassen.
<br>
<br>
<li><em>Ein paar n&uuml;tzliche Programme</em><br>
Das po-Dateiformat ist sehr einfach und kann mit jedem Standard-Editor bearbeitet werden.
Es gibt aber auch einige spezielle Tools die das Erstellen und &Auml;nder der po-Dateien
vereinfachen:
<ul>
<li><code>poEdit</code> (<a
href="http://www.poedit.org/" target="_blank">
http://www.poedit.org/</a>)
<li><code>KBabel</code> (<a
href="http://i18n.kde.org/tools/kbabel/" target="_blank">
http://i18n.kde.org/tools/kbabel/</a>)
<li><code>GTranslator</code> (<a
href="http://gtranslator.sourceforge.net/" target="_blank">
http://gtranslator.sourceforge.net/</a>)
<li><code>Emacs</code> po mode
<li><code>Vim</code> po mode
</ul>
<br>
<li><em>Zu Schluss noch</em><br>
Ich hoffe es wird Ihnen Freude bereiten, wenn Sie sich an diesem Projekt und
seiner Internationalisierung beteiligen :). Bitte scheuen Sie sich nicht, mir
eine E-Mail, <em>frederic@culot.org</em>, zu schreiben, sollten noch Fragen offen sein.
</ul>
<a name="links"></a><h1>Links</h1>
<p>
Dieser Abschnitt enth&auml;lt Links und Angaben, die Sie interessieren
k&ouml;nnten.
<a name="links_homepage"></a><h2><code>calcurse</code> Internetseite</h2>
<p>
Die Internetseite des Projekts <code>calcurse</code> lautet:
<pre>
http://culot.org/calcurse
</pre>
<a name="links_list"></a><h2><code>calcurse</code> Ank&uuml;ndigungsliste</h2>
<p>
Wenn Sie an <code>calcurse</code> Interesse gefunden haben und Sie gerne
&uuml;ber Neuerscheinungen informiert werden m&ouml;chten, k&ouml;nnen Sie sich
gerne in <code>calcurse</code>s Ank<6E>ndigungsliste eintragen.
Sobald eine neue Version ver&ouml;ffentlicht wird, werden Sie per E-Mail &uuml;ber
die neusten Eigenschaften von <code>calcurse</code> informiert<br>
Um sich in die Liste einzutragen, schicken Sie einfach eine E-Mail mit dem Betreff
"subscribe" an <code>calcurse-announce@culot.org</code>.
<a name="thanks"></a><h1>Danksagungen</h1>
<p>
Folgenden Leuten m&ouml;chte ich gerne f&uuml;r Ihre Unterst&uuml;tzung danken, ohne
die dieses Projekt nicht m&ouml;glich gewesen w&auml;re. Hier ist die Liste
derjenigen, denen ich Danke sagen m&ouml;chte:
<ul>
<li>Alex f&uuml;r die Patches, Hilfen und Erl&auml;uterungen zur <code>C</code> Programmierung.
<li>Gwen f&uuml;rs Testen und die Anregungen, wie <code>calcurse</code> verbessert werden kann.
<li>Kevin und Ryan f&uuml;r das Binary-Packet auf Debian.
<li>Steffen f&uuml;r das Binary-Packet auf Archlinux
<li>Alexandre f&uuml;r das Binary-Packet auf Mac OsX.
<li>Joel f&uuml;r sein Kalender-Skript, das mich zum Calcurse-Layout inspiriert hat.
<li>Michael Schulz und Chris M. f&uuml;r die &Uuml;bersetzung der Dokumentation ins Deutsche.
<li>Jose Lopez f&uuml;r die &Uuml;bersetzung der Dokumentation ins Spanische.
<li>Neil Williams f&uuml;r die &Uuml;bersetzung ins Englische.
<li>Leute die Programme geschrieben haben, die ich mag und mich inspiriert haben, insbesondere :
<ul>
<li><code>vim</code> f&uuml;r die Befehlssteuerung
<li><code>orpheus</code> und <code>abook</code> f&uuml;r die Dokumentation
<li><code>pine</code> und <code>aptitude</code> f&uuml;r das Text-Benutzer-Interface
</ul>
</ul>
Und zuletzt, vielen vielen Dank an alle <code>calcurse</code>
Benutzer, die mir Ihr Feedback mitgeteilt haben.
<hr>
<small><em>
Copyright (c) 2004-2006 Fr&eacute;d&eacute;ric Culot<br>
German translation by Michael Schulz <code>&lt;bloodshower.at.web.dot.de&gt;</code><br>
Calcurse version 1.6 - Last change: October 1, 2006
<em></small>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink