diff options
| -rwxr-xr-x | ChangeLog | 3 | ||||
| -rw-r--r-- | doc/manual.css | 6 | ||||
| -rwxr-xr-x | doc/manual_de.html | 1057 | ||||
| -rwxr-xr-x | doc/manual_en.html | 1051 | ||||
| -rwxr-xr-x | doc/manual_es.html | 1069 | ||||
| -rwxr-xr-x | doc/manual_fr.html | 263 | ||||
| -rwxr-xr-x | doc/manual_nl.html | 1045 |
7 files changed, 2349 insertions, 2145 deletions
@@ -1,3 +1,6 @@ +10 Feb 2008: + manuals updated to make use of css style sheet + 03 Feb 2008: doc/manual.css added doc/manual_fr.html updated to make use of css style sheet diff --git a/doc/manual.css b/doc/manual.css index cdb3cc5..636be4f 100644 --- a/doc/manual.css +++ b/doc/manual.css @@ -1,4 +1,4 @@ -/* $Id: manual.css,v 1.1 2008/02/03 11:13:21 culot Exp $ */ +/* $Id: manual.css,v 1.2 2008/02/10 11:33:23 culot Exp $ */ /* * Calcurse - text-based organizer @@ -242,6 +242,10 @@ a { padding-left: 1cm; } +div.todo { + color: green; +} + div.warn { margin-top: 1cm; margin-bottom: 1cm; diff --git a/doc/manual_de.html b/doc/manual_de.html index fdec0d9..e1cfb05 100755 --- a/doc/manual_de.html +++ b/doc/manual_de.html @@ -1,10 +1,10 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!-- /* - * $calcurse: manual_de.html,v 1.12 2007/10/07 17:14:56 culot Exp $ + * $calcurse: manual_de.html,v 1.13 2008/02/10 11:33:23 culot Exp $ * * Calcurse - text-based organizer - * Copyright (c) 2004-2007 Frederic Culot + * Copyright (c) 2004-2008 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 @@ -31,76 +31,92 @@ <head> <title>CALCURSE documentation</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<style type="text/css" media="all"> + @import url(manual.css); +</style> </head> -<body bgcolor="white" text="black" link="blue" vlink="navy"> +<body> -<h1><code>CALCURSE - textbasierter Terminkalender</code></h1> -<p> -<p><hr><p> +<div id="mainContent"> + +<h1 id="title"> +<span class="main">CALCURSE - textbasierter Terminkalender</span></h1> +<div class="warn"> +<div class="todo"> +<h1>Abstract</h1> This manual describes <code>calcurse</code> functionnalities, +and how to use them. The installation from source is first described, together +with the available command line arguments. The user interface +is then presented, with all of the customizable options that change +<code>calcurse</code> behavior. Last, bug reporting procedure is explained, as +well as the way one can contribute to <code>calcurse</code> development. +</div> +</div> + +<div id="toc"> <h1>Inhaltsverzeichnis</h1> <ul> -<li><a href="#intro">Einleitung</a> -<li><a href="#overview">Ü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ü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">Übersetzung der Dokumentation</a> -<li><a href="#contribute_i18n"><code>calcurse</code> i18n</a> -<ul> -<li><a href="#contribute_i18n_overview">Überblick</a> -<li><a href="#contribute_i18n_translator">Aufgaben des Ü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ündigungsliste</a> -<li><a href="#links_rss"><code>calcurse</code> RSS -</ul> -<li><a href="#thanks">Danksagungen</a> + <li><a href="#intro">1. Einleitung</a></li> + <li><a href="#overview">2. Überblick</a> + <ul> + <li><a href="#overview_history">2.1 Anlass</a></li> + <li><a href="#overview_features">2.2 Wichtige Eigenschaften</a></li> + </ul></li> + <li><a href="#install">3. Installation</a> + <ul> + <li><a href="#install_requirements">3.1 Voraussetzungen</a> + <ul> + <li><a href="#install_requirements_ncurses">3.1.1 <code>ncurses</code> Bibliothek</a></li> + <li><a href="#install_requirements_gettext">3.1.2 <code>gettext</code> Bibliothek</a></li> + </ul></li> + <li><a href="#install_process">3.2 Installationsprozess</a></li> + </ul></li> + <li><a href="#basics">4. <code>calcurse</code> Grundlagen</a> + <ul> + <li><a href="#basics_invocation">4.1 Programmaufruf</a> + <ul> + <li><a href="#basics_invocation_commandline">4.1.1 Programmargumente</a></li> + <li><a href="#basics_invocation_variable">4.1.2 Umgebungsvariable für i18n</a></li> + </ul></li> + <li><a href="#basics_interface">4.2 Benutzer-Interface</a> + <ul> + <li><a href="#basics_interface_noninteractive">4.2.1 Nicht-interaktiver Modus</a></li> + <li><a href="#basics_interface_interactive">4.2.2 Interaktiver Modus</a></li> + </ul></li> + <li><a href="#basics_files">4.3 <code>calcurse</code> Dateien</a></li> + <li><a href="#basics_help">4.4 Onlinehilfe</a></li> + </ul></li> + <li><a href="#options">5. Optionen</a> + <ul> + <li><a href="#options_general">5.1 Allgemeine Optionen</a></li> + <li><a href="#options_colors">5.2 Einstellen der Terminalfarben</a></li> + <li><a href="#options_layout">5.3 Einstellen des Layouts</a></li> + <li><a href="#options_notify">5.4 Einstellen der Benachrichtigungszeile</a></li> + </ul></li> + <li><a href="#known_bugs">6. Bekannte Fehler</a></li> + <li><a href="#bugs">7. Mitteilung von Fehlern und Anregungen</a></li> + <li><a href="#contribute">8. Wie kann ich einen Beitrag leisten?</a> + <ul> + <li><a href="#contribute_documentation">8.1 Übersetzung der Dokumentation</a></li> + <li><a href="#contribute_i18n">8.2 <code>calcurse</code> i18n</a> + <ul> + <li><a href="#contribute_i18n_overview">8.2.1 Überblick</a></li> + <li><a href="#contribute_i18n_translator">8.2.2 Aufgaben des Übersetzers</a></li> + <li><a href="#contribute_i18n_po-files">8.2.3 po-Dateien</a></li> + </ul></li> + </ul></li> + <li><a href="#links">9. Links</a> + <ul> + <li><a href="#links_homepage">9.1 <code>calcurse</code> Internetseite</a></li> + <li><a href="#links_list">9.2 <code>calcurse</code> Ankündigungsliste</a></li> + <li><a href="#links_rss">9.3 <code>calcurse</code> RSS</a></li> + </ul></li> + <li><a href="#thanks">10. Danksagungen</a></li> </ul> -<p><hr><p> +</div> -<a name="intro"></a><h1>Einleitung</a></h1> +<h1>1. Einleitung<a name="intro"></a></h1> <p> <code>calcurse</code> ist ein textbasierender Kalender, der Ihnen bei der Organisation von @@ -109,14 +125,17 @@ konfigurierbares Notitzsystem erinnert Benutzer an bevorstehende Termine. Die curses basierende Benutzeroberflache kann auf eigene die Bedürfnisse angepaßt werden. Alle Programmbefehle sind in einem online Hilfesystem dokumentiert. +</p> -<a name="overview"></a><h1>Überblick</h1> -<a name="overview_history"></a><h2>Anlass</h2> +<h1>2. Überblick<a name="overview"></a></h1> +<h2>2.1 Anlass<a name="overview_history"></a></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öten. ;)<br> +war wirklich vonnöten. ;) +</p> +<p> Ich mag Programme mit Textinterfaces, weil sie einfach, schnell, portabel und effizient sind. Also dachte ich darüber nach ein Programm mit textorientiertem Benutzer-Interface zu entwickeln. @@ -124,29 +143,37 @@ Darü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> +erweitern! +</p> +<p> +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ür andere von Nutzen sein -wird. Also hier ist es...<br> -<br> +wird. Also hier ist es... +</p> +<p> Doch warum nenne ich es 'calcurse'? Nun, es ist einfach zusammengesetzt aus den Wörtern 'CALendar' und 'nCurses', dem Namen der Bibliothek die für das Benutzer-Interface verwendet wird. +</p> - -<a name="overview_features"></a><h2>Wichtige Eigenschaften</h2> +<h2>2.2 Wichtige Eigenschaften<a name="overview_features"></a></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 Ähnlichem).<br> +mithilfe einer ssh-Verbindung (oder Ähnlichem). +</p> +<p> <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önlichen Terminkalenders. Mit dem zweiten Modus ist es mö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> +oder einem 'init script' eingebunden wird. +</p> +<p> Darüber hinaus ist <code>calcurse</code> für Benutzer erstellt worden, mit der Absicht so benutzerfreundlich wie möglich zu sein. Das bedeutet, dass eine komplette Onlinehilfe im Programm zu Verfügung @@ -155,194 +182,186 @@ ersichtlich sind. Das Benutzer-Interface ist ebenfalls einstellbar. Ebenso kann man verschiedene Textfarben und Layouts wählen. Ein konfigurierbares Notizsystem erinnert den Benutzer an bevorstehende Termine. +</p> -<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> +<h1>3. Installation<a name="install"></a></h1> +<h2>3.1 Voraussetzungen<a name="install_requirements"></a></h2> +<h3>3.1.1 <code>ncurses</code> Bibliothek<a name="install_requirements_ncurses"></a></h3> <p> <code>Calcurse</code> benötigt einen C-Compiler wie etwa <code>cc</code> oder <code>gcc</code>. Ferner wird die ncurses-Bibliothek benötigt, die jedoch auf den meisten Unix-Systemen verfügbar sein sollte. Falls nicht, können Sie sie von folgender URL herunter -laden:<br> -<pre> - http://ftp.gnu.org/pub/gnu/ncurses/ -</pre> +laden:</p> +<pre>http://ftp.gnu.org/pub/gnu/ncurses/</pre> -<a name="install_requirements_gettext"></a><h3><code>gettext</code> Bibliothek</h3> +<h3>3.1.2 <code>gettext</code> Bibliothek<a name="install_requirements_gettext"></a></h3> <p> - <code>calcurse</code> unterstützt die Internationalisierung - (künftig <em>i18n</em>) durch <code>gettext</code>. + (künftig <span class="emp">i18n</span>) durch <code>gettext</code>. Das bedeutet, dass <code>calcurse</code> mehrsprachige Mitteilungen erzeugen kann, wenn es mit der entsprechenden Sprachunterstützung - kompiliert wurde (z.B. <em>NLS</em>). - Dennoch, <em>NLS</em> ist optional und wenn keine mehrsprachigen Mitteilungen + kompiliert wurde (z.B. <span class="emp">NLS</span>). +</p> +<p> + Dennoch, <span class="emp">NLS</span> ist optional und wenn keine mehrsprachigen Mitteilungen gewü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> - + Installationsprozess</a>). Um zu überprü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> + kann man nach der <code>libintl.h</code> Datei suchen:</p> + <pre>locate libintl.h</pre> +<p> 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 + herunter geladen werden:</p> + <pre>http://ftp.gnu.org/pub/gnu/gettext/</pre> +<p> + <p class="rq"><span class="valorize">Beachte:</span> + Auch wenn <code>libintl.h</code> auf dem System gefunden wurde, kann es erforderlich sein den Pfad dieser Datei während des <ahref="#install_process"> Installationsprozesses</a> anzugeben. Die entsprechende Option für das <code>configure</code> Skript lautet dann <code>--with-libintl-prefix</code>. Das <code>configure</code> Skript wird natürlich vorzeitig abbrechen, wenn die - dazugehörige Bibliothek nicht gefunden wurde. + dazugehörige Bibliothek nicht gefunden wurde.</p> -<a name="install_process"></a><h2>Installationsprozess</h2> +<h2>3.2 Installationsprozess<a name="install_process"></a></h2> +<p> +Als erstes müssen die Dateien entpackt werden:</p> +<pre>tar zxvf calcurse-2.0.tar.gz</pre> <p> -Als erstes müssen die Dateien entpackt werden: -<pre> - tar zxvf calcurse-1.9.tar.gz -</pre> Ist diese Voraussetzung erfüllt und das Archiv entpackt, -sind nur noch die drei üblichen Schritte erforderlich: -<OL> - <li><code>./configure</code> - <li><code>make</code> - <li><code>make install</code> (mit Root-Rechten) -</OL> +sind nur noch die drei üblichen Schritte erforderlich:</p> + <ol> + <li><code>./configure</code></li> + <li><code>make</code></li> + <li><code>make install</code> (mit Root-Rechten)</li> + </ol> +<p> Rufen Sie <code>./configure --help</code> auf, um die verfügbaren Optionen aufgelistet zu bekommen. +</p> - -<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> +<h1>4. <code>calcurse</code> Grundlagen<a name="basics"></a></h1> +<h2>4.1 Programmaufruf<a name="basics_invocation"></a></h2> +<h3>4.1.1 Programmargumente<a name="basics_invocation_commandline"></a></h3> <p> <code>Calcurse</code> kann mit den folgenden Optionen aufgerufen werden. -Es werden sowohl kurze als auch lange Optionsangaben unterstützt. - -<dl compact> -<dt><code>-a, --appointment</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 <file>, --calendar <file></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 <date|num>, --day <date|num></code> -<dd> -Gibt die Termine eines angegebenen Datums oder alle Termine der -anzugebenden nachfolgenden Tage aus. Somit sind zwei Formate mö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ä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, --help</code> -<dd> -Gibt eine Hilfe zu den unterstützten Optionen aus.<br> -<br> -<dt><code>-n, --next</code> -<dd> -Gibt den Termin aus, der innerhalb der kommenden 24 Stunden als -nächstes stattfindet.<br> - Die dargestellte Zeitangabe weist darauf hin, in wie viel Stunden - und Minuten der Termin beginnen wird.<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>-t[num], --todo[=num]</code> -<dd> -Gibt die 'todo' Liste aus.<br> - Wird die optionale Angabe <code>num</code> übergeben, werden nur diejenigen - Aufgaben angezeigt, denen die Prioriät <code>num</code> zugewiesen wurde.<br> - <u>Beachte:</u> Die angegebene Priorität muss zwischen 1 (höchste) und 9 - (niedrigste) liegen.<br> -<br> -<dt><code>-v, --version</code> -<dd> -Gibt die aktuelle Version von Calcurse aus.<br> -<br> - <dt><code>-x, --export</code> - <dd> - Exportiert Benutzerdaten in das iCalendar-Format. Ereignisse, - Termine und Aufgaben werden konvertiert und nach stdout - ausgegeben.<br> - <u>Beachte:</u> leiten Sie die Ausgabe in eine Datei, - etwa wie im folgenden Beispiel: - <pre> - $ calcurse --export > my_data.ics - </pre> +Es werden sowohl kurze als auch lange Optionsangaben unterstützt.</p> + +<p> +<dl> + <dt><code>-a, --appointment</code></dt> + <dd>Gibt die Termine des heutigen Tags aus. + <p class="rq"><span class="valorise">Beachte:</span> + Die Kalender-Datei, aus der die Termine gelesen + werden sollen, kann mit mit Hilfe der '-c' Option angegeben werden.</p> + </dd> + <dt><code>-c <file>, --calendar <file></code></dt> + <dd>Gibt die zu lesende Kalender-Datei an. + Der Standardkalender ist <code>~/.calcurse/apts</code> (beachte auch + Abschnitt: <a href="#basics_files"><code>calcurse</code> Dateien</a>). + </dd> + <dt><code>-d <date|num>, --day <date|num></code></dt> + <dd>Gibt die Termine eines angegebenen Datums oder alle Termine der + anzugebenden nachfolgenden Tage aus. Somit sind zwei Formate möglich: + <ul> + <li>Datum: 'MM/TT/JJJJ' (Monat, Tag, Jahr).</li> + <li>Anzahl der Tage: 'n'.</li> + </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ächsten 'n' Tagen zu erledigen sind. + Beispiel: Die Eingabe <code>calcurse -d 3</code> gibt alle Termine des + heutigen und der beiden folgenden Tage aus. + </dd> + <dt><code>-h, --help</code></dt> + <dd>Gibt eine Hilfe zu den unterstützten Optionen aus. + </dd> + <dt><code>-n, --next</code></dt> + <dd>Gibt den Termin aus, der innerhalb der kommenden 24 Stunden als + nächstes stattfindet. + Die dargestellte Zeitangabe weist darauf hin, in wie viel Stunden + und Minuten der Termin beginnen wird. + <p class="rq"><span class="valorise">Beachte:</span> + Die Kalender-Datei, aus der die Termine gelesen + werden sollen, kann mit mit Hilfe der '-c' Option angegeben werden.</p> + </dd> + <dt><code>-t[num], --todo[=num]</code></dt> + <dd>Gibt die 'todo' Liste aus. + Wird die optionale Angabe <code>num</code> übergeben, werden nur diejenigen + Aufgaben angezeigt, denen die Prioriät <code>num</code> zugewiesen wurde.<br> + <p class="rq"><span class="valorise">Beachte:</span> + Die angegebene Priorität muss zwischen 1 (höchste) und 9 + (niedrigste) liegen.</p> + </dd> + <dt><code>-v, --version</code></dt> + <dd>Gibt die aktuelle Version von Calcurse aus. + </dd> + <dt><code>-x, --export</code></dt> + <dd>Exportiert Benutzerdaten in das iCalendar-Format. Ereignisse, + Termine und Aufgaben werden konvertiert und nach stdout + ausgegeben. + <p class="rq"><span class="valorise">Beachte:</span> + leiten Sie die Ausgabe in eine Datei, etwa wie im folgenden Beispiel: + <code>$ calcurse --export > my_data.ics</code></p> + </dd> </dl> - -<a name="basics_invocation_variable"></a><h3>Umgebungsvariable für i18n</h3> +<h3>4.1.2 Umgebungsvariable für i18n<a name="basics_invocation_variable"></a></h3> <p> - <code>calcurse</code> kann mit Unterstützung fü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ächst geprüft werden, ob die <code>po/LINGUAS</code> Datei verfügbar ist. Diese Datei zeigt alle verfügbaren Sprachen durch - zweibuchstabige Kürzel an (beispielsweise steht <em>fr</em> + zweibuchstabige Kürzel an (beispielsweise steht <span class="emp">fr</span> für Französisch). Ist Ihre Muttersprache nicht aufgeführt, wäre es natürlich großartig, wenn Sie sich an der Übersetzung von <code>calcurse</code> in andere Sprachen beteiligen könnten (siehe Abschnitt <a href="#contribute">Wie kann - ich einen Beitrag leisten?</a>).<br> + ich einen Beitrag leisten?</a>).</p> +<p> Wird Ihre Sprache bereits unterstützt, kö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ünschten Spracheausgabe ist und durch - das Kürzel Ihrer Sprache ersetzt werden kann.<br> + <code>calcurse</code> mit dem folgenden Aufruf starten:</p> + <pre>LC_ALL=fr_FR calcurse</pre> +<p> + wobei <span class="emp">fr_FR</span> der Name der gewünschten Spracheausgabe ist und durch + das Kürzel Ihrer Sprache ersetzt werden kann.</p> +<p> Zusätzlich sollten Sie den verwendeten Zeichensatz angeben, da in einigen Fällen Sonderzeichen wie etwa Akzente und Umlaute nicht korrekt dargestellt werden. Auf den der entsprechende Sprache gewünschten Zeichensatz wird am Anfang der po-Datei hingewiesen. Der Datei fr.po können Sie beispielsweise entnehmen, dass der Zeichensatz iso-8859-1 verwendet wird. Sie könnten <code>calcurse</code> folgendermaßen - aufrufen: - <pre> - LC_ALL=fr_FR.ISO8859-1 calcurse - </pre> + aufrufen:</p> + <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> +<h2>4.2 Benutzer-Interface<a name="basics_interface"></a></h2> +<h3>4.2.1 Nicht interaktiver Modus<a name="basics_interface_noninteractive"></a></h3> <p> -Wird <code>calcurse</code> mit den Optionen:<br> +Wird <code>calcurse</code> mit den Optionen: <code>-a</code>, <code>-d</code>, <code>-h</code>, -<code>-n</code>, <code>-t</code>, <code>-v</code>, <code>-x</code><br> +<code>-n</code>, <code>-t</code>, <code>-v</code>, <code>-x</code> gestartet, wird das Programm im nicht-interaktiven Modus ausgeführt. Das bedeutet, dass die gewünschten Informationen ausgegeben werden und das Programm anschließend sofort wieder beendet -wird. Durch das Einbinden von <code>calcurse --todo --appointment</code> in eine init config +wird.</p> +<p> +Durch das Einbinden von <code>calcurse --todo --appointment</code> in eine init config Datei ist es beispielsweise möglich, sich seine zu erledigenden Aufgaben -und alle Termine des heutigen Tages beim Logon anzeigen zu lassen. +und alle Termine des heutigen Tages beim Logon anzeigen zu lassen.</p> -<a name="basics_interface_interactive"></a><h3>Interaktiver Modus</h3> +<h3>4.2.2 Interaktiver Modus<a name="basics_interface_interactive"></a></h3> <p> Wird keine, oder nur Option -c angegeben, startet <code>calcurse</code> im interaktiven Modus. In diesem Modus erhä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. +Die einzelnen Panels lassen sich durch die 'TAB'-Taste ansteuern.</p> <pre> Termin-Panel---. .---Kalender-Panel @@ -377,85 +396,101 @@ Die einzelnen Panels lassen sich durch die 'TAB'-Taste ansteuern. Statuszeile </pre> - +<p> Das Kalender-Panel hebt den gewünschten Tag farblich hervor, wä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.<br> - Im Termin-Panel kann man <em>'(|)'</em> Symbol vor das +erledigenden Aufgaben, die keinem bestimmten Tage zugeordnet sind.</p> +<p> + Im Termin-Panel kann man <span class="emp">'(|)'</span> Symbol vor das Datum setzen. Dies zeigt die aktuelle Mondfase. Je nach Mondfase können die folgenden Symbole erscheinen: - <ul> - - <li>'<b> |) </b>': Halbmond, erste Hälfte</li> - <li>'<b> (|) </b>': Vollmond</li> - <li>'<b> (| </b>': Halbmond, letzte Hälfte</li> - <li>'<b> | </b>': Neumond</li> - <li>Kein Symbol: die Mondfase ist keinem der oberen - zuzuordnen</li> - </ul> + <dl class="compact"> + <dt>'<code> |) </code>':</dt> + <dd>Halbmond, erste Hälfte</dd> + <dt>'<code> (|) </code>':</dt> + <dd>Vollmond</dd> + <dt>'<code> (| </code>':</dt> + <dd>Halbmond, letzte Hälfte</dd> + <dt>'<code> | </code>':</dt> + <dd>Neumond</dd> + <dt>Kein Symbol:</dt> + <dd>die Mondfase ist keinem der oberen zuzuordnen</dd> + </dl> +</p> <p> Die letzten beiden Zeilen des Interfaces zeigen die Status-Zeile, die über die möglichen Befehle und ihre entsprechenden Tasten -informiert.<br> +informiert.</p> +<p> Direkt ü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äßig verwendete Kalenderdatei apts [Vergleiche hierzu den folgenden Abschnitt]) und der nächste Termin, der in den kommenden 24 Stunden ansteht. Im Beispiel ist dies der Termin lunch, der in 1 Stunde und -zwanzig Minuten beginnt. -<p> -<u>Beachte:</u> Einige Handlungen, wie beispielsweise das Verändern oder - Hinzufügen eines Termins, benötigen Texteingaben, die - mithilfe des eingebauten Eingabeeditors eingegeben werden.<br> - Geht eine Zeile über die Bildschirmzeile hinaus, wird dies innerhalb - des Editors durch die Zeichen '>', '*', und '<' dargestellt. - Dadurch wird in der letzten Spalten darauf hingewiesen, dass sich - vor, vor und hinter, beziehungsweise nur hinter der momentanten - Position weiterer Text befindet. Gegebenenfalls wird Zeile - horizontal gescrollt.<br> - - Darüberhinaus sind einigen Editierfunktionen spezielle Tastenkürzel - zugewiesen, die in der folgenden Übersicht zusammengefasst sind. - Hierbei steht '^' für die Taste 'Strg' beziehungsweise 'Ctrl':<br> - <ul> - <li><b>^a</b>: Positioniert den Cursor an den Anfang der Eingabezeile - <li><b>^b</b>: Bewegt den Cursor rückwärts - <li><b>^d</b>: Löscht das folgende Zeichen - <li><b>^e</b>: Positioniert den Cursor an das Ende der Eingabezeile - <li><b>^h</b>: Löscht das vorhergehende Zeichen - <li><b>^k</b>: Löscht die Eingabe von der aktuellen Cursorposition bis - an das Zeileende - <li><b>ESCAPE</b>: Bricht die Bearbeitung ab - </ul> +zwanzig Minuten beginnt.</p> +<p class="rq"><span class="valorise">Beachte:</span> +Einige Handlungen, wie beispielsweise das Verändern oder +Hinzufügen eines Termins, benötigen Texteingaben, die +mithilfe des eingebauten Eingabeeditors eingegeben werden.</p> +<p> +Geht eine Zeile über die Bildschirmzeile hinaus, wird dies innerhalb +des Editors durch die Zeichen '>', '*', und '<' dargestellt. +Dadurch wird in der letzten Spalten darauf hingewiesen, dass sich +vor, vor und hinter, beziehungsweise nur hinter der momentanten +Position weiterer Text befindet. Gegebenenfalls wird Zeile +horizontal gescrollt.</p> +<p> +Darüberhinaus sind einigen Editierfunktionen spezielle Tastenkürzel +zugewiesen, die in der folgenden Übersicht zusammengefasst sind. +Hierbei steht '^' für die Taste 'Strg' beziehungsweise 'Ctrl': +<dl class="compact"> + <dt><code>^a</code>:</dt> + <dd>Positioniert den Cursor an den Anfang der Eingabezeile</dd> + <dt><code>^b</code>:</dt> + <dd>Bewegt den Cursor rückwärts</dd> + <dt><code>^d</code>:</dt> + <dd>Löscht das folgende Zeichen</dd> + <dt><code>^e</code>:</dt> + <dd>Positioniert den Cursor an das Ende der Eingabezeile</dd> + <dt><code>^h</code>:</dt> + <dd>Löscht das vorhergehende Zeichen</dd> + <dt><code>^k</code>:</dt> + <dd>Löscht die Eingabe von der aktuellen Cursorposition bis + an das Zeileende</dd> + <dt><code>ESCAPE</code>:</dt> + <dd>Bricht die Bearbeitung ab</dd> +</dl> +</p> -<a name="basics_files"></a><h2><code>calcurse</code> Dateien</h2> +<h2>4.3 <code>calcurse</code> Dateien<a name="basics_files"></a></h2> <p> - Die folgende Verzeichnisstruktur wird im $HOME-Verzeichnis angelegt, -wenn <code>calcurse</code> das erste Mal gestartet wird: +wenn <code>calcurse</code> das erste Mal gestartet wird:</p> <pre> - $HOME/.calcurse/ - |___conf - |___apts - |___todo +$HOME/.calcurse/ + |___conf + |___apts + |___todo </pre> +<dl class="compact"> + <dt><code>conf</code>:</dt> + <dd>Datei enthält die Informationen zur Benutzerkonfiguration.</dd> + <dt><code>apts</code>:</dt> + <dd>Datei enthält alle Termine.</dd> + <dt><code>todo</code>:</dt> + <dd>Datei enthält die todo-Liste.</dd> +</dl> - -Die <em>conf</em> Datei enthält die Informationen zur Benutzerkonfiguration.<br> -Die <em>apts</em> Datei enthält alle Termine.<br> -Die <em>todo</em> Datei enthält die todo-Liste. - - -<a name="basics_help"></a><h2>Online Hilfe</h2> +<h2>4.4 Online Hilfe<a name="basics_help"></a></h2> <p> Das integrierte Hilfe-System kann jederzeit mit '?' aufgerufen werden. Informationen über bestimmte Befehle können mit der entsprechenden Taste des Befehls aufgerufen werden. +</p> - -<a name="options"></a><h1>Optionen</h1> +<h1>5. Optionen<a name="options"></a></h1> <p> Sämtliche in <code>calcurse</code> veränderbaren Parameter lassen sich Konfigurationsmenü einstellen. Drücken Sie hierzu die Taste 'C'. @@ -465,51 +500,55 @@ Das erneute Betätigen von 'C' führt Sie zu den Farbeinstellungen und drei Panel ändern können. Drücken Sie 'G' um ins Auswahlmenü der allgemeinen Optionen zu gelangen. Zu guter Letzt können Sie die Einstellungen der Benachrichtigungszeile ändern, indem Sie die Taste 'N' -betätigen. +betätigen.</p> -<a name="options_general"></a><h1>Allgemeine Optionen</h1> +<h2>5.1 Allgemeine Optionen<a name="options_general"></a></h2> <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üssen Sie als Nutzer die Taste 'S' -betätigen.<br> -<br> -<li><code>Beenden_bestä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ählt, -wird das Programm durch die Eingabe von 'Q' ohne Nachfrage sofort beendet.<br> -<br> -<li><code>Löschen_bestätigen</code> (Voreinstellung: <em>ja</em>)<br> -Wurde <em>ja</em> eingestellt, fragt das Programm nach, ob ein -Eintrag wirklich gelöscht werden soll (entweder ein todo-Eintrag oder -ein Termin). Wurde <em>nein</em> gewählt, wird beim Drücken von 'D' -ohne Nachfrage gelöscht.<br> -<br> -<li><code>Systemdialoge_überspringen</code> (Voreinstellung: <em>nein</em>)<br> -Durch Setzen auf <em>ja</em> werden die Dialoge beim Speichern und -Laden umgangen. Nützlich, wenn es mal schnell gehen muss.<br> -<br> -<li><code>Fortschrittsanzeige_ü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öglich zwischen Montag und Sonntag als ersten Tag der Woche -zu wählen. Wird die Option auf <em>ja</em> gesetzt, wird Montag -als erster Tag der Woche festgelegt. Ist <em>nein</em> gewählt, -beginnt die Woche sonntags. -</ul> +allgemeines Verhalten.</p> +<dl> + <dt><code>automatisches_Speichern</code> + (Voreinstellung: <span class="emp">ja</span>)</dt> + <dd>Ist diese Option aktiviert, werden die Benutzerdaten automatisch beim + Verlassen gespeichert. + <p class="rq"><span class="valorise">warnung:</span> + Beim Verlassen werden keine Daten gespeichert, + wenn <code>automatisches_Speichern</code> auf <span class="emp">nein</span> gesetzt wurde. Um Ihre + Eingaben dennoch zu speichern, müssen Sie als Nutzer die Taste 'S' + betätigen.</p> + </dd> + <dt><code>Beenden_bestätigen</code> + (Voreinstellung: <span class="emp">ja</span>)</dt> + <dd>Wenn <span class="emp">ja</span> eingestellt worden ist, wird nachgefragt, ob das + Programm wirklich beenden werden soll. Wurde <span class="emp">nein</span> gewählt, + wird das Programm durch die Eingabe von 'Q' ohne Nachfrage sofort beendet.</dd> + <dt><code>Löschen_bestätigen</code> + (Voreinstellung: <span class="emp">ja</span>)</dt> + <dd>Wurde <span class="emp">ja</span> eingestellt, fragt das Programm nach, ob ein + Eintrag wirklich gelöscht werden soll (entweder ein todo-Eintrag oder + ein Termin). Wurde <span class="emp">nein</span> gewählt, wird beim Drücken von 'D' + ohne Nachfrage gelöscht.</dd> + <dt><code>Systemdialoge_überspringen</code> + (Voreinstellung: <span class="emp">nein</span>)</dt> + <dd>Durch Setzen auf <span class="emp">ja</span> werden die Dialoge beim Speichern und + Laden umgangen. Nützlich, wenn es mal schnell gehen muss.</dd> + <dt><code>Fortschrittsanzeige_überspringen</code> + (Voreinstellung: <span class="emp">nein</span>)</dt> + <dd>Wird diese Option aktiviert, wird die beim Speichern von Daten normalerweise + erscheinende Fortschrittsanzeige nicht mehr angezeigt. + Ist diese Option auf <span class="emp">nein</span> gesetzt, werden ein + Zustandsbalken und der Name der zu speichernden Datei (siehe + Abschnitt <a href="#basics_files">Calcurse Dateien</a>) angezeigt.</dd> + <dt><code>Wochenbeginn_am_Montag</code> + (Voreinstellung: <span class="emp">ja</span>)</dt> + <dd>Es ist möglich zwischen Montag und Sonntag als ersten Tag der Woche + zu wählen. Wird die Option auf <span class="emp">ja</span> gesetzt, wird Montag + als erster Tag der Woche festgelegt. Ist <span class="emp">nein</span> gewählt, + beginnt die Woche sonntags.</dd> +</dl> -<a name="options_colors"></a><h2>Textfarben einstellen</h2> +<h2>5.2 Textfarben einstellen<a name="options_colors"></a></h2> <p> <code>calcurse</code> Textfarben können nach eigenen Vorlieben eingestellt werden. Um die Standartfarben zu wechseln, @@ -517,147 +556,136 @@ zeigt die Konfigurationsseite mögliche Farbwerte für Vordergrund und Hintergrund. Benutze die Pfeiltasten zum bewegen und 'X' bzw. die Leertaste um eine Farbe zu wählen. Benutzer können das gewählte Farbschema vorher betrachten. Die Liste enthält -auch den Eintrag für die Standartfarben des Terminals. -<p> - <u>Beachte:</u> - <ul> - <li> Der Farbunterstützung ist vom verwendeten Terminal und des der +auch den Eintrag für die Standartfarben des Terminals.</p> +<div class="todo"> +<p> + The chosen color theme will then be applied to the panel borders, + to the titles, to the keystrokes, and to general informations + displayed inside status bar. A black and white theme is also + available, in order to support non-color terminals.</p> +</div> +<p class="rq"><span class="valorise">Beachte:</span> + Der Farbunterstützung ist vom verwendeten Terminal und des der Umgebungsvariablen <code>$TERM</code> zugewiesenen Werts abhängig. Es erscheint eine Fehlermeldung, wenn versucht wird die Farbeinstellung - zu ändern, obwohl das Terminal keine Farben unterstützt.<br> - <br> - <li> Wenn sie sicher sind, dass ihr Terminal Farben darstellen kann, + zu ändern, obwohl das Terminal keine Farben unterstützt. + 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> - + (etwa <span class="emp">xterm-xfree86</span>). +</p> -<a name="options_layout"></a><h2>Layout einstellen</h2> +<h2>5.3 Layout einstellen<a name="options_layout"></a></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> +dargestellte Zeichnung des Standard-Layouts). Durch Auswahl eines anderen Layouts kann der Benutzer das Erscheinungsbild von <code>calcurse</code> seinen eigenen Wünschen -entsprechend anpassen. +entsprechend anpassen.</p> -<a name="options_notify"></a><h2>Benachrichtigungszeile einstellen</h2> +<h2>5.4 Benachrichtigungszeile einstellen<a name="options_notify"></a></h2> <p> - Folgende Optionen ä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 + Folgende Optionen ändern das Verhalten der Benachrichtigungszeile:</p> + <dl> + <dt><code>Benachrichtigungszeile_anzeigen</code> (Voreinstellung: <span class="emp">ja</span>)</dt> + <dd>Mit dieser Option legen Sie fest, ob die Benachrichtigungszeile anzeigt werden soll. </dd> + <dt><code>Benachrichtigungszeile_Datum</code> (Voreinstellung: <span class="emp">%a %F</span>)</dt> + <dd>Hiermit kann das Format festgelegt werden, wie das aktuelle Datum innerhalb der Benachrichtigungszeile angezeigt werden soll. Die möglichen Formatdefinitionen kö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 + von <code>man 3 strftime</code> auf der Kommandozeile anzeigen lassen.</dd> + <dt><code>Benachrichtigungszeile_Uhrzeit</code> (Voreinstellung: <span class="emp">%T</span>)</dt> + <dd>Hiermit kann das Format festgelegt werden, wie die aktuelle Uhrzeit innerhalb der Benachrichtigungszeile angezeigt werden soll. Die möglichen Formatdefinitionen kö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ächsten, in 'Benachrichtigungszeile_Alarm' + Eingabe von <code>man 3 strftime</code> auf der Kommandozeile anzeigen + lassen.</dd> + <dt><code>Benachrichtigungszeile_Alarm</code> (Voreinstellung: <span class="emp">300</span>)</dt> + <dd>Beginnt ein Termin innerhalb der nä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. Außerdem wird der Befehl, der durch - <em>Benachrichtigungszeile_Befehl</em> definiert ist, ausgeführt. - <br><br> - <li> - <code>Benachrichtigungszeile_Befehl</code> - (Voreinstellungt: <em>printf '\a'</em>)<br> - Diese Option zeigt an, welcher Befehl ausgeführt wird, - wenn ein bevorstehender Termin durch 'wichtig' gekennzeichnet ist. - Dieser Befehl wird auf dem Terminal des Benutzers ausgeführt. - Die <code>$SHELL</code> Umgebungsvariable wird bei der Wahl des - richtigen Terminals berücksichtigt. Ist diese Variable nicht - gesetzt, wird stattdessen <code>/bin/sh</code> zur Ausführung - gewählt.<br> - <u>Beispiel:</u> Der <code>mail</code> Befehl ist auf dem System - des Benutzer verfügbar. Man kann den folgenden Befehl benutzen, - um an bevorstehende Termine erinnert zu werden (die Beschreibung - des Termins wird ebenso berücksichtigt im Mailkopf): - <pre> - calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com - </pre> - </ul> - - -<a name="known_bugs"></a><h1>Bekannte Fehler</h1> + <code>Benachrichtigungszeile_Befehl</code> definiert ist, ausgeführt.</dd> + <dt><code>Benachrichtigungszeile_Befehl</code> (Voreinstellungt: <span class="emp">printf '\a'</span>)</dt> + <dd>Diese Option zeigt an, welcher Befehl ausgeführt wird, + wenn ein bevorstehender Termin durch 'wichtig' gekennzeichnet ist. + Dieser Befehl wird auf dem Terminal des Benutzers ausgeführt. + Die <code>$SHELL</code> Umgebungsvariable wird bei der Wahl des + richtigen Terminals berücksichtigt. Ist diese Variable nicht + gesetzt, wird stattdessen <code>/bin/sh</code> zur Ausführung + gewählt. + <p class="rq"><span class="valorise">Beispiel:</span> + Der <code>mail</code> Befehl ist auf dem System + des Benutzer verfügbar. Man kann den folgenden Befehl benutzen, + um an bevorstehende Termine erinnert zu werden (die Beschreibung + des Termins wird ebenso berücksichtigt im Mailkopf):</p> + <code> +calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com + </code> + </dd> +</dl> + +<h1>6. Bekannte Fehler<a name="known_bugs"></a></h1> <p> - Es kommt vor, dass Wörter bei Verwendung der schwarz/weißen Farbkombination falsch hervorgehoben werden, wenn die - <code>$TERM</code> Variable auf <em>xterm-color</em> gesetzt ist. + <code>$TERM</code> Variable auf <span class="emp">xterm-color</span> gesetzt ist. Um diesen Fehler zu vermeiden, sollte nach Aussage von Thomas E. Dickey (zuständig für <code>xterm</code>), - <em>xterm-xfree86</em> an Stelle für <em>xterm-color</em> als - <code>$TERM</code> Variable gesetzt werden:<br> - <blockquote> + <span class="emp">xterm-xfree86</span> an Stelle für <span class="emp">xterm-color</span> als + <code>$TERM</code> Variable gesetzt werden:</p> + <blockquote class="rq"> "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> +<h1>7. Mitteilung von Fehlern und Anregungen<a name="bugs"></a></h1> <p> -Bitte mailen Sie Fehler oder auch Anregungen an: -<pre> - calcurse@culot.org -</pre> -Oder an den Autor: -<pre> - frederic@culot.org -</pre> - +Bitte mailen Sie Fehler oder auch Anregungen an:</p> +<pre>calcurse @ culot . org</pre> +<p> +Oder an den Autor:</p> +<pre>frederic @ culot . org</pre> -<a name="contribute"></a><h1>Wie kann ich einen Beitrag leisten?</h1> +<h1>8. Wie kann ich einen Beitrag leisten?<a name="contribute"></a></h1> <p> Wenn Sie gerne dieses Projekt unterstützen möchten, können Sie mir zuerst eine kurze Rückmeldung geben. Was finden Sie an diesem Programm gut oder was könnte besser sein? Gibt es vielleicht Programmeigenschaften, die -Sie vermissen? Teilen Sie sie mir mit!<br> - +Sie vermissen? Teilen Sie sie mir mit!</p> +<p> Von nun an ist es auch möglich, sich an der Übersetzung der Programmmitteilungen -und der Dokumentation von <code>calcurse</code> zu beteiligen. <br> - <br> - <u>Beachte:</u> Jegliche Unterstützung <code>calcurse</code> +und der Dokumentation von <code>calcurse</code> zu beteiligen. </p> + <p class="rq"><span class="valorise">Beachte:</span> + Jegliche Unterstützung <code>calcurse</code> in andere Sprachen zu ü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 Übersetzung in Ihrer Sprache schon begonnen hat. - - + Sie jedoch eine E-Mail an <code>calcurse-i18n @ culot . org</code> senden: So erfahren Sie, + ob jemand die Übersetzung in Ihrer Sprache schon begonnen hat.</p> -<a name="contribute_documentation"></a><h2>Übersetzung der Dokumentation</h2> +<h2>8.1 Übersetzung der Dokumentation<a name="contribute_documentation"></a></h2> <p> - - Das <em>doc/</em> Verzeichnis des Quellcodearchivs enthält bereits + Das <span class="emp">doc/</span> Verzeichnis des Quellcodearchivs enthält bereits übersetzte Versionen des <code>calcurse</code> Handbuchs. Ist eine Übersetzung in Ihrer Sprache noch nicht vorhanden, - wäre es großartig, wenn Sie eine solche erstellen könnten.<br> + wäre es großartig, wenn Sie eine solche erstellen könnten.</p> +<p> Kopieren Sie dazu eine der vorhandenen Version mit dem Dateinamen - <code>manual_XX.html</code>, wobei <em>XX</em> + <code>manual_XX.html</code>, wobei <span class="emp">XX</span> das entsprechende Kürzel Ihrer Sprache ist. Übersetzen Sie diese Datei anschließend und senden Sie sie dann an den Autor (siehe <a href="#bugs">Mitteilung von Fehlern und Anregungen</a>), damit Ihre Übersetzung der nächsten <code>calcurse</code> Version - hinzugefügt werden kann. + hinzugefügt werden kann.</p> -<a name="contribute_i18n"></a><h2><code>calcurse</code> i18n</h2> +<h2>8.2 <code>calcurse</code> i18n<a name="contribute_i18n"></a></h2> <p> Wie bereits erwähnt, verwendet <code>calcurse</code> die <code>gettext</code> Utilities um mehrsprachige Programmmitteilungen zu erzeugen. @@ -666,92 +694,92 @@ und der Dokumentation von <code>calcurse</code> zu beteiligen. <br> <code>calcurse</code> mittels <code>gettext</code> ist natürlich nur als Einstieg gedacht und mit Absicht recht knapp gehalten. Um umfassendere Informationen zu erhalten und sich die große weite Welt der Internationalisierung von Software zu - erschließen, sollten Sie die Seite der <code>GNU gettext</code>-Anleitung besuchen: - <pre> - http://www.gnu.org/software/gettext/manual/ - </pre> + erschließen, sollten Sie die Seite der <code>GNU + gettext</code>-Anleitung besuchen:</p> + <pre>http://www.gnu.org/software/gettext/manual/</pre> +<p> An der Übersetzung sind im Grunde drei verschiedene Entwickler beteiligt: Programmierer, Sprachkoordinator und Übersetzer. Nach einem kurzen Überblick, wie so etwas funktioniert, werden anschließend die - Aufgaben des Übersetzers beschrieben. + Aufgaben des Übersetzers beschrieben.</p> -<a name="contribute_i18n_overview"></a><h3>Überblick</h3> +<h3>8.2.1 Überblick<a name="contribute_i18n_overview"></a></h3> <p> Um Text in der Muttersprache des Benutzers erscheinen zu lassen, sind zwei Schritte nötig: - <em>Internationalisierung</em> - (i18n) und <em>Lokalisierung</em> (l10n). +<span class="emp">Internationalisierung</span> +(i18n) und <span class="emp">Lokalisierung</span> (l10n).</p> +<p> Bei der i18n geht es darum, <code>calcurse</code> auf die Unterstützung mehrerer Sprachen vorzubereiten. Dies ist die Aufgabe des Programmierers, der die zu übersetzenden Texte markiert und andererseits sicherstellen muss, dass zur Laufzeit - des Programms der übersetzt Text erscheint. + des Programms der übersetzt Text erscheint.</p> +<p> Bei der l10n geht es darum, dem bereits internationalisierten - also i18n markierten - <code>calcurse</code> die entsprechende Übersetzung des Benutzers zur Verfügung zu stellen. Gemäß den Umgebungsvariablen ersetzt <code>calcurse</code> die zuvor vom - Programmierer markierten Texte durch die entsprechenden Übersetzungen.<br> - <br> - + Programmierer markierten Texte durch die entsprechenden Übersetzungen.</p> +<p> Die zu übersetzenden Texte werden also zunächst vom Programmierer im - <code>C</code>-Quellcode markiert und in einem Template (<em>calcurse.pot</em> - - die Dateierweiterung <em>pot</em> steht für <em>portable object template</em>) + <code>C</code>-Quellcode markiert und in einem Template (<span class="emp">calcurse.pot</span> - + die Dateierweiterung <span class="emp">pot</span> steht für <span class="emp">portable object template</span>) gesammelt. Anschließend wird der Inhalt dieses Templates mit den Dateien, die - die Übersetzungen enthalten zusammengeführt (<em>fr.po</em> enthält - beispielsweise die Französische Übersetzung (<em>po</em> steht hierbei - für <em>portable object</em>, also ein von Menschen les- und veränderbares + die Übersetzungen enthalten zusammengeführt (<span class="emp">fr.po</span> enthält + beispielsweise die Französische Übersetzung (<span class="emp">po</span> steht hierbei + für <span class="emp">portable object</span>, also ein von Menschen les- und veränderbares Dateiformat), Der Übersetzer kann diese Datei öffnen, die enthaltenen Texte übersetzen und sie dann an den Programmierer zurück senden. Wird das Programm compiliert, erzeugt der Compiler (aus Gründen der Effizienz) - eine binäre Version dieser Datei, die später installiert wird (<em>fr.mo</em> - - <em>mo</em> steht für <em>machine object</em>; dieses Format kann nur von + eine binäre Version dieser Datei, die später installiert wird (<span class="emp">fr.mo</span> + - <span class="emp">mo</span> steht für <span class="emp">machine object</span>; dieses Format kann nur von Programmen gelesen werden). <code>calcurse</code> nutzt diese Datei zur Laufzeit, um die Texte in Abhängigkeit der lokalen Einstellungen des Benutzers zu - übersetzen. + übersetzen.</p> -<a name="contribute_i18n_translator"></a><h3>Aufgaben des Übersetzers</h3> +<h3>8.2.2 Aufgaben des Übersetzers<a name="contribute_i18n_translator"></a></h3> <p> Wenn Sie mit der Übersetzung in eine neue Sprache beginnen möchten, - finden Sie hierzu die nötigen Schritte: + finden Sie hierzu die nötigen Schritte:</p> <ul> <li>Finden Sie zunächst das Kürzel Ihrer Sprache heraus. Beispielsweise ist das Kürzel für Französisch 'fr_FR', oder einfach nur 'fr'. Diesen Wert muss der Benutzer der Umgebungsvariablen <code>LC_ALL</code> zuweisen, um die Software übersetzt starten zu können - (siehe <a href="#basics_invocation_variable">Umgebungsvariable für i18n</a>).<br> - <br> - <li>Wechseln Sie dann ins <em>po/</em> Verzeichnis und erzeugen Sie aus dem Template + (siehe <a href="#basics_invocation_variable">Umgebungsvariable für i18n</a>).</li> + <li>Wechseln Sie dann ins <span class="emp">po/</span> 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> + <code>'msginit -i calcurse.pot -o fr.po -l fr --no-translator'</code> 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 änderen Sie den Inhalt am - Anfang der Datei von Hand.<br> - Wurde die Datei <em>fr.po</em> erstellt, kann mit der eigentlichen Übersetzung - begonnen werden. - </ul> + die Datei <span class="emp">calcurse.pot</span> nach <span class="emp">fr.po</span> und änderen Sie den Inhalt am + Anfang der Datei von Hand.</li> + </ul> +<p> + Wurde die Datei <span class="emp">fr.po</span> erstellt, kann mit der eigentlichen Übersetzung + begonnen werden.</p> -<a name="contribute_i18n_po-files"></a><h3>po-Dateien</h3> +<h3>8.2.3 po-Dateien<a name="contribute_i18n_po-files"></a></h3> <p> Das Format der po-Dateien ist relativ einfach. po-Dateien gliedern sich in lediglich - vier Bestandteile: + vier Bestandteile:</p> <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üngliche, also zu übersetzende Text. - <li><em>msgstr Zeilen:</em> der übersetzte Text. - <li><em>Zeilen, die mit '#' beginnen:</em> Kommentare (einige mit spezieller Bedeutung, - wie wir weiter unten noch sehen werden). + <li><span class="emp">location Zeilen:</span> geben an, wo sich der Text befindet (Name der Datei und Zeilennummer).</li> + <li><span class="emp">msgid Zeilen:</span> der ursprüngliche, also zu übersetzende Text.</li> + <li><span class="emp">msgstr Zeilen:</span> der übersetzte Text.</li> + <li><span class="emp">Zeilen, die mit '#' beginnen:</span> Kommentare (einige mit spezieller Bedeutung, + wie wir weiter unten noch sehen werden).</li> </ol> - Übersetzen Sie die <em>msgid</em> Zeilen und tragen Sie den ü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 +<p> + Übersetzen Sie die <span class="emp">msgid</span> Zeilen und tragen Sie den übersetzten Text in die + sich direkt darunterbefindlichen, mit <span class="emp">msgstr</span> gekennzeichneten Zeilen ein.</p> +<p> + <span class="valorise">Einige Anmerkungen:</span> + <dl> + <dt><span class="emp">Fuzzy Texte</span></dt> + <dd>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 übersetzt wurde, aber die Stelle im Programmcode verändert wurde, oder aber es handelt sich um einen neuen Text, für welchen <code>gettext</code> eine sog. 'wild @@ -762,157 +790,144 @@ Um Text in der Muttersprache des Benutzers erscheinen zu lassen, sind zwei Schri Mitunter ist die Übersetzung aber nicht mehr passend oder schlichtweg falsch und muss abgeändert werden. Entfernen Sie die <code>"#, fuzzy"</code>-Zeilen, wenn Sie mit Ihrer Übersetzung fertig - sind, damit <code>calcurse</code> die ü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>. + sind, damit <code>calcurse</code> die übersetzten Zeilen wieder verwendet und anzeigt.</dd> + <dt><span class="emp">c-Format Texte und besondere Sequenzen</span></dt> + <dd>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ändert werden sollte. Beispielsweise bedeuten die %-Sequenzen, wie <code>"%s"</code>, dass <code>calcurse</code> dort Text einfügen wird. Es ist also wichtig, diese nicht zu verändern. Ebenso kommen \-Sequenzen , wie etwa <code>\n</code> oder <code>\t</code> vor. Bitte nehmen Sie auch hier keine Veränderungen vor. Erstere stellt das Zeilenende dar, - letztere einen Tabulator.<br> - <br> - <li><em>Übersetzungen können in Blöcke geschrieben werden</em><br> - Sollten Zeilen zu lang werden, können sie auf mehrere verteilt werden: + letztere einen Tabulator.</dd> + <dt><span class="emp">Übersetzungen können in Blöcke geschrieben werden</span></dt> + <dd>Sollten Zeilen zu lang werden, können sie auf mehrere verteilt werden: <pre> - msgid "" - "some very long line" - "another line" +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ält. + <dt><span class="emp">po-Header</span></dt> + <dd>Ganz zu Anfang einer po-Datei befindet sich der Header, der einige Informationen enthält. Die wichtigste Information ist der Zeichensatz. Er sollte diesem ähnlich sein <pre> - "Content-Type: text/plain; charset=utf-8\n" +"Content-Type: text/plain; charset=utf-8\n" </pre> - Auch das Übersetzer-Feld sollte ausgefüllt sein, damit potentielle Mitstreiter, die sich an der Übersetzung beteiligen wollen, mit Ihnen Kontakt aufnehmen können. Ebenso können von anderen entdeckte Fehler an den Übersetzer gemeldet werden. Geben Sie Ihren Namen an, oder tragen Sie Ihre E-Mail-Adresse ein. Zum Beispiel folgendermaßen: <pre> - "Last-Translator: Frederic Culot <frederic@culot.org>\n" - </pre> - <li><em>Kommentare</em><br> - Das Hinzufügen von Kommentaren (Zeilen beginnen mit dem '#' Zeichen) ist eine gute +"Last-Translator: Frederic Culot <frederic@culot.org>\n" + </pre></dd> + <dt><span class="emp">Kommentare</span></dt> + <dd>Das Hinzufügen von Kommentaren (Zeilen beginnen mit dem '#' Zeichen) ist eine gute Möglichkeit, um Probleme und Übersetzungsschwierigkeiten anderen besser - mitteilen zu können.<br> - <br> - <li><em>Längen der Texte</em><br> - <code>calcurse</code> ist ein curses/Konsolen Programm und ist somit stark von der + mitteilen zu können.</dd> + <dt><span class="emp">Längen der Texte</span></dt> + <dd><code>calcurse</code> ist ein curses/Konsolen Programm und ist somit stark von der Größe des Terminals (Anzahl der Spalten) abhängig. Dies sollte bei der Übersetzung berücksichtigt werden. Häufig müssen Texte in eine einzige Zeile passen (Standardlänge ist 80 Zeichen). Übersetzen Sie nicht blindlings darauf los! Versuchen Sie herauszufinden, wo der - Text angezeigt wird, um die Übersetzung entsprechend anzupassen. - <br> - <br> - <li><em>Ein paar nützliche Programme</em><br> - Das po-Dateiformat ist sehr einfach und kann mit jedem Standard-Editor bearbeitet werden. + Text angezeigt wird, um die Übersetzung entsprechend anzupassen.</dd> + <dt><span class="emp">Ein paar nützliche Programme</span></dt> + <dd>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 Änder der po-Dateien vereinfachen: <ul> <li><code>poEdit</code> (<a href="http://www.poedit.org/" target="_blank"> - http://www.poedit.org/</a>) + http://www.poedit.org/</a>)</li> <li><code>KBabel</code> (<a href="http://i18n.kde.org/tools/kbabel/" target="_blank"> - http://i18n.kde.org/tools/kbabel/</a>) + http://i18n.kde.org/tools/kbabel/</a>)</li> <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 + http://gtranslator.sourceforge.net/</a>)</li> + <li><code>Emacs</code> po mode</li> + <li><code>Vim</code> po mode</li> </ul> - <br> - <li><em>Zu Schluss noch</em><br> - Ich hoffe es wird Ihnen Freude bereiten, wenn Sie sich an diesem Projekt und + </dd> + <dt><span class="emp">Zu Schluss noch</span></dt> + <dd>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> + eine E-Mail, <span class="emp">frederic @ culot . org</span>, zu schreiben, sollten noch Fragen offen sein.</dd> + </dl> -<a name="links"></a><h1>Links</h1> +<h1>9. Links<a name="links"></a></h1> <p> Dieser Abschnitt enthält Links und Angaben, die Sie interessieren -könnten. +könnten.</p> - -<a name="links_homepage"></a><h2><code>calcurse</code> Internetseite</h2> +<h2>9.1 <code>calcurse</code> Internetseite<a name="links_homepage"></a></h2> <p> -Die Internetseite des Projekts <code>calcurse</code> lautet: -<pre> - http://culot.org/calcurse -</pre> - +Die Internetseite des Projekts <code>calcurse</code> lautet:</p> +<pre>http://culot.org/calcurse</pre> -<a name="links_list"></a><h2><code>calcurse</code> Ankündigungsliste</h2> +<h2>9.2 <code>calcurse</code> Ankündigungsliste<a name="links_list"></a></h2> <p> Wenn Sie an <code>calcurse</code> Interesse gefunden haben und Sie gerne über Neuerscheinungen informiert werden möchten, können Sie sich -gerne in <code>calcurse</code>s Ankündigungsliste eintragen. - +gerne in <code>calcurse</code>s Ankündigungsliste eintragen.</p> +<p> Sobald eine neue Version veröffentlicht wird, werden Sie per E-Mail ü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>. +"subscribe" an <span class="emp">calcurse-announce @ culot . org</span>.</p> -<a name="links_rss"></a><h2><code>calcurse</code> RSS feed</h2> +<h2>9.3 <code>calcurse</code> RSS feed<a name="links_rss"></a></h2> <p> Um über neue Programmversionen informiert zu werden, können Sie - auch einfach den folgenden RSS-Feed aufrufen: - <pre> - http://culot.org/calcurse/news_rss.xml - </pre> + auch einfach den folgenden RSS-Feed aufrufen:</p> + <pre>http://culot.org/calcurse/news_rss.xml</pre> +<p> Sobald eine neue <code>calcurse</code>-Version verfügbar ist wird der RSS-Feed aktualisiert und enthält eine Beschreibung der neu - hinzugekommenen Programmfunktionen. + hinzugekommenen Programmfunktionen.</p> -<a name="thanks"></a><h1>Danksagungen</h1> +<h1>10. Danksagungen<a name="thanks"></a></h1> <p> Folgenden Leuten möchte ich gerne für Ihre Unterstützung danken, ohne die dieses Projekt nicht möglich gewesen wäre. Hier ist die Liste derjenigen, denen ich Danke sagen möchte: <ul> -<li>Alex für die Patches, Hilfen und Erläuterungen zur <code>C</code> Programmierung. -<li>Gwen fürs Testen und die Anregungen, wie <code>calcurse</code> verbessert werden kann. -<li>Herbert für das Binary-Packet auf FreeBSD -<li>Zul für das Binary-Packet auf NetBSD -<li>Wain für das Binary-Packet auf Archlinux</font> -<li>Kevin, Ryan, und fEnIo für das Binary-Packet auf Debian und Ubuntu. -<li>Steffen für das Binary-Packet auf Archlinux -<li>Pascal für das Binary-Packet auf Slackware</font> -<li>Alexandre für das Binary-Packet auf Mac OsX und Darwin. -<li>Igor für das Binary-Packet auf ALT Linux</font> -<li>Joel für sein Kalender-Skript, das mich zum Calcurse-Layout inspiriert hat. -<li>Michael Schulz und Chris M. für die Übersetzung der Dokumentation ins Deutsche. -<li>Jose Lopez für die Übersetzung der Dokumentation ins Spanische. -<li>Neil Williams für die Übersetzung ins Englische. -<li>Tony für seine Patches, welche die Funktion -recur_item_inday() verbessern half -<li>Jeremy Roon für die Übersetzung ins Dutch. +<li>Alex für die Patches, Hilfen und Erläuterungen zur <code>C</code> Programmierung.</li> +<li>Gwen fürs Testen und die Anregungen, wie <code>calcurse</code> verbessert werden kann.</li> +<li>Herbert für das Binary-Packet auf FreeBSD</li> +<li>Zul für das Binary-Packet auf NetBSD</li> +<li>Wain, Steffen und Ronald für das Binary-Packet auf Archlinux</li> +<li>Kevin, Ryan, und fEnIo für das Binary-Packet auf Debian und Ubuntu.</li> +<li>Pascal für das Binary-Packet auf Slackware</li> +<li>Alexandre für das Binary-Packet auf Mac OsX und Darwin.</li> +<li>Igor für das Binary-Packet auf ALT Linux</li> +<li>Joel für sein Kalender-Skript, das mich zum Calcurse-Layout inspiriert hat.</li> +<li>Michael Schulz und Chris M. für die Übersetzung der Dokumentation ins Deutsche.</li> +<li>Jose Lopez für die Übersetzung der Dokumentation ins Spanische.</li> +<li>Neil Williams für die Übersetzung ins Englische.</li> +<li>Tony für seine Patches, welche die Funktion +recur_item_inday() verbessern half </li> +<li>Jeremy Roon für die Übersetzung ins Dutch.</li> <li>Leute die Programme geschrieben haben, die ich mag und mich inspiriert haben, insbesondere: -<ul> -<li><code>vim</code> für die Befehlssteuerung -<li><code>orpheus</code> und <code>abook</code> für die Dokumentation -<li><code>pine</code> und <code>aptitude</code> für das Text-Benutzer-Interface -</ul> + <ul> + <li><code>vim</code> für die Befehlssteuerung</li> + <li><code>orpheus</code> und <code>abook</code> für die Dokumentation</li> + <li><code>pine</code> und <code>aptitude</code> für das Text-Benutzer-Interface</li> + </ul></li> </ul> +</p> +<p> Und zuletzt, vielen vielen Dank an alle <code>calcurse</code> -Benutzer, die mir Ihr Feedback mitgeteilt haben. - - -<hr> -<small><em> -Copyright (c) 2004-2007 Frédéric Culot<br> -German translation by Michael Schulz -<code><bloodshower.at.web.dot.de></code>, and Chris.<br> -Calcurse version 1.9 - Last change: Oct 07, 2007 -</em></small> - +Benutzer, die mir Ihr Feedback mitgeteilt haben.</p> + +<div class="footer"> + Copyright (c) 2004-2007 Frédéric Culot<br> + German translation by Michael Schulz + <code><bloodshower .at. web .dot. de></code>, and Chris.<br> + Calcurse version 2.0 - Last change: February 07, 2008<br> +</div> +</div> </body> </html> diff --git a/doc/manual_en.html b/doc/manual_en.html index 587d7e2..6e43d70 100755 --- a/doc/manual_en.html +++ b/doc/manual_en.html @@ -1,10 +1,10 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!-- /* - * $calcurse: manual_en.html,v 1.12 2007/08/19 13:19:37 culot Exp $ + * $calcurse: manual_en.html,v 1.13 2008/02/10 11:33:24 culot Exp $ * * Calcurse - text-based organizer - * Copyright (c) 2004-2007 Frederic Culot + * Copyright (c) 2004-2008 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 @@ -31,90 +31,106 @@ <head> <title>CALCURSE documentation</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<style type="text/css" media="all"> + @import url(manual.css); +</style> </head> -<body bgcolor="white" text="black" link="blue" vlink="navy"> +<body> -<h1><code>CALCURSE - text-based organizer</code></h1> -<p> -<p><hr><p> +<div id="mainContent"> + +<h1 id="title"> +<span class="main">CALCURSE - text-based organizer</span></h1> +<div class="warn"> +<h1>Abstract</h1> This manual describes <code>calcurse</code> functionnalities, +and how to use them. The installation from source is first described, together +with the available command line arguments. The user interface +is then presented, with all of the customizable options that change +<code>calcurse</code> behavior. Last, bug reporting procedure is explained, as +well as the way one can contribute to <code>calcurse</code> development. +</div> + +<div id="toc"> <h1>Table of Contents</h1> <ul> -<li><a href="#intro">Introduction</a> -<li><a href="#overview">Overview</a> -<ul> -<li><a href="#overview_history">Creation history</a> -<li><a href="#overview_features">Important features</a> -</ul> -<li><a href="#install">Installation</a> -<ul> -<li><a href="#install_requirements">Requirements</a> -<ul> -<li><a href="#install_requirements_ncurses"><code>ncurses</code> library</a> -<li><a href="#install_requirements_gettext"><code>gettext</code> library</a> -</ul> -<li><a href="#install_process">Install process</a> -</ul> -<li><a href="#basics"><code>calcurse</code> basics</a> -<ul> -<li><a href="#basics_invocation">Invocation</a> -<ul> -<li><a href="#basics_invocation_commandline">Command line arguments</a> -<li><a href="#basics_invocation_variable">Environment variable for i18n</a> -</ul> -<li><a href="#basics_interface">User interface</a> -<ul> -<li><a href="#basics_interface_noninteractive">Non-interactive mode</a> -<li><a href="#basics_interface_interactive">Interactive mode</a> -</ul> -<li><a href="#basics_files"><code>calcurse</code> files</a> -<li><a href="#basics_help">Online help</a> -</ul> -<li><a href="#options">Options</a> -<ul> -<li><a href="#options_general">General options</a> -<li><a href="#options_colors">Color themes</a> -<li><a href="#options_layout">Layout configuration</a> -<li><a href="#options_notify">Notify-bar settings</a> -</ul> -<li><a href="#known_bugs">Known bugs</a> -<li><a href="#bugs">Reporting bugs and feedback</a> -<li><a href="#contribute">How to contribute?</a> -<ul> -<li><a href="#contribute_documentation">Translating documentation</a> -<li><a href="#contribute_i18n"><code>calcurse</code> i18n</a> -<ul> -<li><a href="#contribute_i18n_overview">Overview</a> -<li><a href="#contribute_i18n_translator">Translator tasks</a> -<li><a href="#contribute_i18n_po-files">po-files</a> -</ul> -</ul> -<li><a href="#links">Links</a> -<ul> -<li><a href="#links_homepage"><code>calcurse</code> homepage</a> -<li><a href="#links_list"><code>calcurse</code> announce list</a> -<li><a href="#links_rss"><code>calcurse</code> RSS feed</a> -</ul> -<li><a href="#thanks">Thanks</a> + <li><a href="#intro">1. Introduction</a></li> + <li><a href="#overview">2. Overview</a> + <ul> + <li><a href="#overview_history">2.1 Creation history</a></li> + <li><a href="#overview_features">2.2 Important features</a></li> + </ul></li> + <li><a href="#install">3. Installation</a> + <ul> + <li><a href="#install_requirements">3.1 Requirements</a> + <ul> + <li><a href="#install_requirements_ncurses">3.1.1 <code>ncurses</code> library</a></li> + <li><a href="#install_requirements_gettext">3.1.2 <code>gettext</code> library</a></li> + </ul></li> + <li><a href="#install_process">3.2 Install process</a></li> + </ul></li> + <li><a href="#basics">4. <code>calcurse</code> basics</a> + <ul> + <li><a href="#basics_invocation">4.1 Invocation</a> + <ul> + <li><a href="#basics_invocation_commandline">4.1.1 Command line arguments</a></li> + <li><a href="#basics_invocation_variable">4.1.2 Environment variable for i18n</a></li> + </ul></li> + <li><a href="#basics_interface">4.2 User interface</a> + <ul> + <li><a href="#basics_interface_noninteractive">4.2.1 Non-interactive mode</a></li> + <li><a href="#basics_interface_interactive">4.2.2 Interactive mode</a></li> + </ul></li> + <li><a href="#basics_files">4.3 <code>calcurse</code> files</a></li> + <li><a href="#basics_help">4.4 Online help</a></li> + </ul></li> + <li><a href="#options">5. Options</a> + <ul> + <li><a href="#options_general">5.1 General options</a></li> + <li><a href="#options_colors">5.2 Color themes</a></li> + <li><a href="#options_layout">5.3 Layout configuration</a></li> + <li><a href="#options_notify">5.4 Notify-bar settings</a></li> + </ul></li> + <li><a href="#known_bugs">6. Known bugs</a></li> + <li><a href="#bugs">7. Reporting bugs and feedback</a></li> + <li><a href="#contribute">8. How to contribute?</a> + <ul> + <li><a href="#contribute_documentation">8.1 Translating documentation</a></li> + <li><a href="#contribute_i18n">8.2 <code>calcurse</code> i18n</a> + <ul> + <li><a href="#contribute_i18n_overview">8.2.1 Overview</a></li> + <li><a href="#contribute_i18n_translator">8.2.2 Translator tasks</a></li> + <li><a href="#contribute_i18n_po-files">8.2.3 po-files</a></li> + </ul></li> + </ul></li> + <li><a href="#links">9. Links</a> + <ul> + <li><a href="#links_homepage">9.1 <code>calcurse</code> homepage</a></li> + <li><a href="#links_list">9.2 <code>calcurse</code> announce list</a></li> + <li><a href="#links_rss">9.3 <code>calcurse</code> RSS feed</a></li> + </ul></li> + <li><a href="#thanks">10. Thanks</a></li> </ul> -<p><hr><p> +</div> - -<a name="intro"></a><h1>Introduction</a></h1> +<h1>1. Introduction<a name="intro"></a></h1> <p> <code>calcurse</code> is a text-based calendar and scheduling application. It helps keeping track of events, appointments and everyday tasks. A configurable notification system reminds user of upcoming deadlines, and the curses based interface can be customized to suit user needs. All of the commands are documented within an online help system. +</p> -<a name="overview"></a><h1>Overview</h1> -<a name="overview_history"></a><h2>Creation history</h2> +<h1>2. Overview<a name="overview"></a></h1> +<h2>2.1 Creation history<a name="overview_history"></a></h2> <p> I started thinking about this project when I was finishing my Ph.D. in Astrophysics... It started to be a little hard to organize myself, and I really needed a good tool to help - me in that difficult task ;)<br> + me in that difficult task ;) +</p> +<p> I like programs which use Text User Interfaces, because they are simple, fast, portable and efficient, so I thought about working on coding a simple calendar using such an interface. @@ -122,30 +138,37 @@ All of the commands are documented within an online help system. language, which I only used for a while during my undergraduate studies. So I thought that would be the good project to start in order to get organized and to learn about a few - <code>C</code> things ! + <code>C</code> things ! +</p> +<p> Unfortunately, I finished my Ph.D. before finishing <code>calcurse</code>, but anyway, I still wanted to work on it, hoping it would - be helpful to other people. So here it is...<br> - <br> + be helpful to other people. So here it is... +</p> +<p> But why 'calcurse' anyway ? Well, it is simply the concatenation of 'CALendar' and 'nCURSEs', the name of the library used to build the user interface. +</p> - -<a name="overview_features"></a><h2>Important features</h2> +<h2>2.2 Important features<a name="overview_features"></a></h2> <p> <code>Calcurse</code> is multi-platform and intended to be lightweight, fast and reliable. It is to be used inside a console or terminal, locally or on a distant machine within - an ssh (or similar) connection. <br> + an ssh (or similar) connection. +</p> +<p> <code>Calcurse</code> can be run in two different modes : interactive or non-interactive mode. The first mode allows oneself to view its own personal organizer almost everywhere, thanks to the text-based interface. The second mode permits to easily build reminders just by adding <code>calcurse</code> with appropriate command line arguments - inside a cron tab or within a shell init script.<br> + inside a cron tab or within a shell init script. +</p> +<p> Moreover, <code>calcurse</code> was created with the end-user in mind, and tends to be as friendly as possible. This means a complete on-line help system, together with having all of @@ -154,149 +177,154 @@ All of the commands are documented within an online help system. between several color and layout combinations. Last, a configurable notification system reminds user of upcoming appointments. +</p> -<a name="install"></a><h1>Installation</h1> -<a name="install_requirements"></a><h2>Requirements</h2> -<a name="install_requirements_ncurses"></a><h3><code>ncurses</code> library</h3> +<h1>3. Installation<a name="install"></a></h1> +<h2>3.1 Requirements<a name="install_requirements"></a></h2> +<h3>3.1.1 <code>ncurses</code> library<a name="install_requirements_ncurses"></a></h3> <p> <code>Calcurse</code> requires only a <code>C</code> compiler, such as <code>cc</code> or <code>gcc</code>, and the <code>ncurses</code> library. It would be very surprising not to have a valid <code>ncurses</code> library already installed on your computer, but if not, you can - find it at the following url :<br> - <pre> - http://ftp.gnu.org/pub/gnu/ncurses/ - </pre> + find it at the following url :</p> + <pre>http://ftp.gnu.org/pub/gnu/ncurses/</pre> -<a name="install_requirements_gettext"></a><h3><code>gettext</code> library</h3> +<h3>3.1.2 <code>gettext</code> library<a name="install_requirements_gettext"></a></h3> <p> <code>calcurse</code> supports internationalization - (<em>i18n</em> hereafter) through the <code>gettext</code> + (<span class="emp">i18n</span> hereafter) through the <code>gettext</code> utilities. This means <code>calcurse</code> can produce multi-lingual messages if compiled with native language - support (i.e. <em>NLS</em>). However, <em>NLS</em> is + support (i.e. <span class="emp">NLS</span>). +</p> +<p> + However, + <span class="emp">NLS</span> is optionnal and if you do not want to have support for multi-lingual messages, you can disable this feature. This is done by giving the <code>--disable-nls</code> option to <code>configure</code> (see section <a - href="#install_process">Install process</a>). <br> + href="#install_process">Install process</a>). To check if the <code>gettext</code> utilities are installed on your system, you can search for the - <code>libintl.h</code> header file for instance: - <pre> - locate libintl.h - </pre> + <code>libintl.h</code> header file for instance:</p> + <pre>locate libintl.h</pre> +<p> If this header file is not found, then you can obtain the - <code>gettext</code> sources at the following url :<br> - <pre> - http://ftp.gnu.org/pub/gnu/gettext/ - </pre> - <u>Note:</u> Even if <code>libintl.h</code> is found on your + <code>gettext</code> sources at the following url :</p> + <pre>http://ftp.gnu.org/pub/gnu/gettext/</pre> +<p> + <p class="rq"><span class="valorize">Note:</span> + Even if <code>libintl.h</code> is found on your system, it can be wise to specify its location during the <a href="#install_process">install process</a>, by using the <code>--with-libintl-prefix</code> option with <code>configure</code>. Indeed, the <code>configure</code> could fail to locate this library if installed in an uncommon - place. + place.</p> -<a name="install_process"></a><h2>Install process</h2> +<h2>3.2 Install process<a name="install_process"></a></h2> +<p> + First you need to gunzip and untar the source archive:</p> + <pre>tar zxvf calcurse-2.0.tar.gz</pre> <p> - First you need to gunzip and untar the source archive: - <pre> - tar zxvf calcurse-1.9.tar.gz - </pre> Once you meet the requirements and have extracted the archive, the install process is quite simple, and follows the standard three steps process: - <OL> - <li><code>./configure</code> - <li><code>make</code> - <li><code>make install</code> (may require root privilege) - </OL> + <ol> + <li><code>./configure</code></li> + <li><code>make</code></li> + <li><code>make install</code> (may require root privilege)</li> + </ol> +</p> +<p> Use <code>./configure --help</code> to obtain a list of possible options. +</p> - -<a name="basics"></a><h1><code>calcurse</code> basics</h1> -<a name="basics_invocation"></a><h2>Invocation</h2> -<a name="basics_invocation_commandline"></a><h3>Command line arguments</h3> +<h1>4. <code>calcurse</code> basics<a name="basics"></a></h1> +<h2>4.1 Invocation<a name="basics_invocation"></a></h2> +<h3>4.1.1 Command line arguments<a name="basics_invocation_commandline"></a></h3> <p> <code>calcurse</code> takes the following options from the - command line (both short and long options are supported): + command line (both short and long options are supported):</p> <p> - <dl compact> - <dt><code>-a, --appointment</code> - <dd> - Print the appointments and events for the current day and exit.<br> - <u>Note:</u> the calendar from which to read the appointments - can be specified using the '-c' flag.<br> - <br> - <dt><code>-c <file>, --calendar <file></code> - <dd> - Specify the calendar file to use.<br> - The default calendar is <code>~/.calcurse/apts</code> - (see section <a href="#basics_files"><code>calcurse</code> files</a>).<br> - <br> - <dt><code>-d <date|num>, --day <date|num></code> - <dd> - Print the appointments for the given date or for the - given number of upcoming days, depending on the argument - format. Two possible formats are supported: - <ul> - <li>a date of the form 'mm/dd/yyyy'. - <li>a number 'n'. - </ul> - In the first case, the appointment list for the - specified date will be returned, while in the second - case the appointment list for the 'n' upcoming days - will be returned.<br> - As an example, typing <code>calcurse -d 3</code> - will display your appointments for today, tomorrow, - and the day after tomorrow.<br> - <u>Note:</u> as for the '-a' flag, the calendar from - which to read the appointments can be specified using - the '-c' flag.<br> - <br> - <dt><code>-h, --help</code> - <dd> - Print a short help text describing the supported - command-line options, and exit.<br> - <br> - <dt><code>-n, --next</code> - <dd> - Print the next appointment within upcoming 24 hours and exit.<br> - The indicated time is the number of hours and minutes left - before this appointment.<br> - <u>Note:</u> the calendar from which to read the appointments - can be specified using the '-c' flag.<br> - <br> - <dt><code>-t[num], --todo[=num]</code> - <dd> - Print the 'todo' list and exit. If the optional number - <code>num</code> is given, then only todos having a priority - equal to <code>num</code> will be returned.<br> - <u>Note:</u> proprity number must be between 1 (highest) and - 9 (lowest).<br> - <br> - <dt><code>-v, --version</code> - <dd> - Display <code>calcurse</code> version and exit.<br> - <br> - <dt><code>-x, --export</code> - <dd> - Export user data to iCalendar format. Events, appointments and - todos are converted and echoed to stdout.<br> - <u>Note:</u> redirect standard output to export data to a file, - by issuing a command such as: - <pre> - $ calcurse --export > my_data.ics - </pre> - </DL> - -<a name="basics_invocation_variable"></a><h3>Environment variable for i18n</h3> + <dl> + <dt><code>-a, --appointment</code></dt> + <dd> + Print the appointments and events for the current day and exit. + <p class="rq"><span class="valorise">Note:</span> the calendar from + which to read the appointments can be specified using the '-c' + flag.</p> + </dd> + <dt><code>-c <file>, --calendar <file></code></dt> + <dd> + Specify the calendar file to use. + The default calendar is <code>~/.calcurse/apts</code> + (see section <a href="#basics_files"><code>calcurse</code> + files</a>). + </dd> + <dt><code>-d <date|num>, --day <date|num></code></dt> + <dd> + Print the appointments for the given date or for the + given number of upcoming days, depending on the argument + format. Two possible formats are supported: + <ul> + <li>a date of the form 'mm/dd/yyyy'.</li> + <li>a number 'n'.</li> + </ul> + In the first case, the appointment list for the + specified date will be returned, while in the second + case the appointment list for the 'n' upcoming days + will be returned. + As an example, typing <code>calcurse -d 3</code> + will display your appointments for today, tomorrow, + and the day after tomorrow. + <p class="rq"><span class="valorise">Note:</span> as for the '-a' + flag, the calendar from which to read the appointments + can be specified using the '-c' flag.</p> + </dd> + <dt><code>-h, --help</code></dt> + <dd> + Print a short help text describing the supported + command-line options, and exit.</dd> + <dt><code>-n, --next</code></dt> + <dd> + Print the next appointment within upcoming 24 hours and exit. + The indicated time is the number of hours and minutes left + before this appointment. + <p class="rq"><span class="valorise">Note:</span> the calendar + from which to read the appointments can be specified using the + '-c' flag.</p> + </dd> + <dt><code>-t[num], --todo[=num]</code></dt> + <dd> + Print the 'todo' list and exit. If the optional number + <code>num</code> is given, then only todos having a priority + equal to <code>num</code> will be returned. + <p class="rq"><span class="valorise">Note:</span> proprity number + must be between 1 (highest) and 9 (lowest).</p> + </dd> + <dt><code>-v, --version</code></dt> + <dd> + Display <code>calcurse</code> version and exit. + </dd> + <dt><code>-x, --export</code></dt> + <dd> + Export user data to iCalendar format. Events, appointments and + todos are converted and echoed to stdout. + <p class="rq"><span class="valorise">Note:</span> + redirect standard output to export data to a file, + by issuing a command such as: + <code>$ calcurse --export > my_data.ics</code></p> + </dd> + </dl> + +<h3>4.1.2 Environment variable for i18n<a name="basics_invocation_variable"></a></h3> <p> <code>calcurse</code> can be compiled with native language support (see <a @@ -305,54 +333,55 @@ All of the commands are documented within an online help system. into your native language, first make sure it is available by looking at the <code>po/LINGUAS</code> file. This file indicates the set of available languages by showing - the two-letters corresponding code (for exemple, <em>fr</em> + the two-letters corresponding code (for exemple, + <span class="emp">fr</span> stands for french). If you do not find your language, it would be greatly appreciated if you could help translating <code>calcurse</code> (see the <a href="#contribute">How to - contribute?</a> section).<br> + contribute?</a> section).</p> +<p> If your language is available, run - <code>calcurse</code> with the following command: - <pre> - LC_ALL=fr_FR calcurse - </pre> - where <em>fr_FR</em> is the locale name in this exemple, but + <code>calcurse</code> with the following command:</p> + <pre>LC_ALL=fr_FR calcurse</pre> +<p> + where <span class="emp">fr_FR</span> is the locale name in this exemple, but should be replaced by the locale corresponding to the desired - language.<br> + language.</p> +<p> You should also specify the charset to be used, because in some cases the accents and such are not displayed correctly. This charset is indicated at the beginning of the po file corresponding to the desired language. For instance, you can see in the fr.po file that it uses the iso-8859-1 charset, so you - could run <code>calcurse</code> using the following command: - <pre> - LC_ALL=fr_FR.ISO8859-1 calcurse - </pre> + could run <code>calcurse</code> using the following command:</p> + <pre>LC_ALL=fr_FR.ISO8859-1 calcurse</pre> -<a name="basics_interface"></a><h2>User interface</h2> -<a name="basics_interface_noninteractive"></a><h3>Non-interactive mode</h3> +<h2>4.2 User interface<a name="basics_interface"></a></h2> +<h3>4.2.1 Non-interactive mode<a name="basics_interface_noninteractive"></a></h3> <p> - When called with at least one of the following arguments:<br> + When called with at least one of the following arguments: <code>-a</code>, <code>-d</code>, <code>-h</code>, <code>-n</code>, <code>-t</code>, <code>-v</code>, - <code>-x</code><br> + <code>-x</code>, <code>calcurse</code> is started in non-interactive mode. This means the desired information will be displayed, and after that, <code>calcurse</code> simply quits and you are - driven back to the shell prompt.<br> + driven back to the shell prompt.</p> +<p> That way, one can add a line such as <code>'calcurse --todo --appointment'</code> in its init config file to display at logon the list of tasks - and appointments scheduled for the current day. + and appointments scheduled for the current day. </p> -<a name="basics_interface_interactive"></a><h3>Interactive mode</h3> +<h3>4.2.2 Interactive mode<a name="basics_interface_interactive"></a></h3> <p> When called without any argument or only with the <code>-c</code> option, <code>calcurse</code> is started in interactive mode. In this mode, you are shown an interface containing three different panels which you can browse using the 'TAB' key, plus a notification bar and a status bar - (see figure below). + (see figure below).</p> <pre> appointment panel---. .---calendar panel @@ -387,78 +416,103 @@ All of the commands are documented within an online help system. status bar </pre> +<p> The first panel represents a calendar which allows to highlight a particular day, the second one contains the list of the events and appointments on that day, and the last one contains a list - of tasks to do but which are not assigned to any specific day.<br> - In the appointment panel, one can notice the <em>'(|)'</em> sign - just in front of the date. This indicates the current phase of the moon. + of tasks to do but which are not assigned to any specific day.</p> +<p> + In the appointment panel, one can notice the <span + class="emp">'(|)'</span> sign just in front of the date. + This indicates the current phase of the moon. Depending on which is the current phase, the following signs can be seen: - <ul> - <li>'<b> |) </b>': first quarter</li> - <li>'<b> (|) </b>': full moon</li> - <li>'<b> (| </b>': last quarter</li> - <li>'<b> | </b>': new moon</li> - <li>no sign: phase of the moon does not correspond to any of - the above ones</li> - </ul> + <dl class="compact"> + <dt>'<code> |) </code>':</dt> + <dd>first quarter</dd> + <dt>'<code> (|) </code>':</dt> + <dd>full moon</dd> + <dt>'<code> (| </code>':</dt> + <dd>last quarter</dd> + <dt>'<code> | </code>':</dt> + <dd>new moon</dd> + <dt>no sign:</dt> + <dd>phase of the moon does not correspond to any of + the above ones</dd> + </dl> + </p> <p> At the very bottom of the screen there is a status bar, which - indicates the possible actions and the corresponding keystrokes.<br> + indicates the possible actions and the corresponding keystrokes.</p> + <p> Just above this status bar is the notify-bar, which indicates from left to right : the current date, the current time, the calendar file currently in use (apts on the above example, which is the default calendar file, see the following section), and the next appointment within the upcoming 24 hours. Here it says - that it will be lunch time in one hour and twenty minutes. - <p> - <u>Note:</u> Some actions, such as editing or adding an item, + that it will be lunch time in one hour and twenty minutes.</p> + <p class="rq"><span class="valorise">Note:</span> + Some actions, such as editing or adding an item, require to type in some text. This is done with the help of - the built-in input line editor.<br> + the built-in input line editor.</p> + <p> Within this editor, if a line is longer than the screen width, a '>', '*', or '<' character is displayed in the last column indicating that there are more character after, before and after, or before the current position, respectively. The line is - scrolled horizontally as necessary.<br> + scrolled horizontally as necessary.</p> + <p> Moreover, some editing commands are bound to particular control characters. Hereafter are indicated the available editing commands - ('^' stands for the control key):<br> - <ul> - <li><b>^a</b>: moves the cursor to the beginning of the input line - <li><b>^b</b>: moves the cursor backward - <li><b>^d</b>: deletes one character forward - <li><b>^e</b>: moves the cursor to the end of the input line - <li><b>^f</b>: moves the cursor forward - <li><b>^h</b>: deletes one character backward - <li><b>^k</b>: deletes the input from the cursor to the end of the line - <li><b>ESCAPE</b>: cancels the editing - </ul> - -<a name="basics_files"></a><h2><code>calcurse</code> files</h2> -<p> - The following structure is created in your <code>$HOME</code> - directory the first time <code>calcurse</code> is run : + ('^' stands for the control key): + <dl class="compact"> + <dt><code>^a</code>:</dt> + <dd>moves the cursor to the beginning of the input line</dd> + <dt><code>^b</code>:</dt> + <dd>moves the cursor backward</dd> + <dt><code>^d</code>:</dt> + <dd>deletes one character forward</dd> + <dt><code>^e</code>:</dt> + <dd>moves the cursor to the end of the input line</dd> + <dt><code>^f</code>:</dt> + <dd>moves the cursor forward</dd> + <dt><code>^h</code>:</dt> + <dd>deletes one character backward</dd> + <dt><code>^k</code>:</dt> + <dd>deletes the input from the cursor to the end of the line</dd> + <dt><code>ESCAPE</code>:</dt> + <dd>cancels the editing</dd> + </dl> +</p> + +<h2>4.3 <code>calcurse</code> files<a name="basics_files"></a></h2> +<p> + The following structure is created in your <code>$HOME</code> + directory the first time <code>calcurse</code> is run :</p> <pre> - $HOME/.calcurse/ - |___conf - |___apts - |___todo +$HOME/.calcurse/ + |___conf + |___apts + |___todo </pre> - The <em>conf</em> file contains the user configuration.<br> - The <em>apts</em> file contains all of the events and - user's appointments.<br> - The <em>todo</em> file contains the todo list. - - -<a name="basics_help"></a><h2>Online help</h2> + <dl class="compact"> + <dt><code>conf</code>:</dt> + <dd>this file contains the user configuration</dd> + <dt><code>apts</code>:</dt> + <dd>this file contains all of the events and user's appointments</dd> + <dt><code>todo</code>:</dt> + <dd>this file contains the todo list</dd> + </dl> + +<h2>4.4 Online help<a name="basics_help"></a></h2> <p> At any time, the built-in help system can be invoked by pressing the '?' key. Once viewing the help screens, informations on a specific command can be accessed by pressing the keystroke corresponding to that command. + </p> -<a name="options"></a><h1>Options</h1> +<h1>5. Options<a name="options"></a></h1> <p> All of the <code>calcurse</code> parameters are configurable from the Configuration menu available when pressing 'C'. You are then @@ -468,56 +522,63 @@ All of the commands are documented within an online help system. <code>calcurse</code> screen (in other words, where to put the three different panels on screen), pressing 'G' permits you to choose between different general options, and last you can modify the notify-bar - settings by pressing 'N'. + settings by pressing 'N'.</p> -<a name="options_general"></a><h2>General options</h2> +<h2>5.1 General options<a name="options_general"></a></h2> <p> These options control <code>calcurse</code> general behavior, - as described below: - <ul> - <li><code>auto_save</code> (default: <em>yes</em>)<br> - This option allows to automatically save the user's data - (if set to <em>yes</em>) when quitting.<br> - <em>warning:</em> No data will be automatically saved if - <code>auto_save</code> is set to <em>no</em>. This means - the user must press 'S' (for saving) in order to retrieve its - modifications.<br> - <br> - <li><code>confirm_quit</code> (default: <em>yes</em>)<br> - If set to <em>yes</em>, confirmation is required before - quitting, otherwise pressing 'Q' will cause <code>calcurse</code> - to quit without prompting for user confirmation.<br> - <br> - <li><code>confirm_delete</code> (default: <em>yes</em>)<br> - If this option is set to <em>yes</em>, pressing 'D' for - deleting an item (either a <em>todo</em>, <em>appointment</em>, - or <em>event</em>), will lead to a prompt asking for user - confirmation before removing the selected item from the list. - Otherwise, no confirmation will be needed before deleting the - item.<br> - <br> - <li><code>skip_system_dialogs</code> (default: <em>no</em>)<br> - Setting this option to <em>yes</em> will result in skipping the - system dialogs related to the saving and loading of data. - This can be useful to speed up the input/output processes.<br> - <br> - <li><code>skip_progress_bar</code> (default: <em>no</em>)<br> - If set to <em>yes</em>, this will cause the disappearing of the - progress bar which is usually shown when saving data to file. - If set to <em>no</em>, this bar will be displayed, together with - the name of the file being saved - (see section <a href="#basics_files"><code>calcurse</code> files</a>).<br> - <br> - <li><code>week_begins_on_monday</code> (default: <em>yes</em>)<br> - One can choose between Monday and Sunday as the first day of the - week. If the option <em>week_begins_on_monday</em> is set to - <em>yes</em>, Monday will be first in the calendar view. Else if - the option is set to <em>no</em>, then Sunday will be the first - day of the week. - </ul> - - -<a name="options_colors"></a><h2>Color themes</h2> + as described below:</p> + <dl> + <dt><code>auto_save</code> + (default: <span class="emp">yes</span>)</dt> + <dd>This option allows to automatically save the user's data + (if set to <span class="emp">yes</span>) when quitting. + <p class="rq"><span class="valorise">warning:</span> + No data will be automatically saved if + <code>auto_save</code> is set to <span class="emp">no</span>. + This means the user must press 'S' (for saving) in order to + retrieve its modifications.</p> + </dd> + <dt><code>confirm_quit</code> + (default: <span class="emp">yes</span>)</dt> + <dd>If set to <span class="emp">yes</span>, confirmation is required before + quitting, otherwise pressing 'Q' will cause <code>calcurse</code> + to quit without prompting for user confirmation. + </dd> + <dt><code>confirm_delete</code> (default: <span class="emp">yes</span>)</dt> + <dd>If this option is set to <span class="emp">yes</span>, pressing 'D' for + deleting an item (either a <span class="emp">todo</span>, + <span class="emp">appointment</span>, + or <span class="emp">event</span>), will lead to a prompt asking for user + confirmation before removing the selected item from the list. + Otherwise, no confirmation will be needed before deleting the item. + </dd> + <dt><code>skip_system_dialogs</code> + (default: <span class="emp">no</span>)</dt> + <dd>Setting this option to <span class="emp">yes</span> will result in + skipping the + system dialogs related to the saving and loading of data. + This can be useful to speed up the input/output processes. + </dd> + <dt><code>skip_progress_bar</code> + (default: <span class="emp">no</span>)</dt> + <dd>If set to <span class="emp">yes</span>, this will cause the disappearing of the + progress bar which is usually shown when saving data to file. + If set to <span class="emp">no</span>, this bar will be displayed, together with + the name of the file being saved + (see section <a href="#basics_files"><code>calcurse</code> files</a>). + </dd> + <dt><code>week_begins_on_monday</code> + (default: <span class="emp">yes</span>)</dt> + <dd>One can choose between Monday and Sunday as the first day of the + week. If the option <code>week_begins_on_monday</code> is set to + <span class="emp">yes</span>, Monday will be first in the calendar view. Else if + the option is set to <span class="emp">no</span>, then Sunday will be the first + day of the week.</dd> + </dl> + + +<h2>5.2 Color themes<a name="options_colors"></a></h2> <p> <code>calcurse</code> color theme can be customized to suit user's needs. To change the default theme, the configuration page @@ -525,28 +586,26 @@ All of the commands are documented within an online help system. Using arrows or calcurse displacement keys to move, and 'X' or space to select a color, user can preview the theme which will be applied. It is possible to keep the terminal's default colors by selecting the - corresponding choice in the list. - <p> + corresponding choice in the list.</p> +<p> The chosen color theme will then be applied to the panel borders, to the titles, to the keystrokes, and to general informations displayed inside status bar. A black and white theme is also - available, in order to support non-color terminals.<br> - <u>Notes:</u> - <ul> - <li> Depending on your terminal type and on the value of the + available, in order to support non-color terminals.</p> + <p class="rq"><span class="valorise">Notes:</span> + Depending on your terminal type and on the value of the <code>$TERM</code> environnement variable, color could or could not be supported. An error message will appear if you try to change colors whereas your terminal does not support - this feature.<br> - <br> - <li> If you do know your terminal supports colors but could + this feature. + If you do know your terminal supports colors but could not get <code>calcurse</code> to display them, try to set your <code>$TERM</code> variable to another value (such as - <em>xterm-xfree86</em> for instance). - </ul> + <span class="emp">xterm-xfree86</span> for instance). + </p> -<a name="options_layout"></a><h2>Layout configuration</h2> +<h2>5.3 Layout configuration<a name="options_layout"></a></h2> <p> The layout corresponds to the position of the panels inside <code>calcurse</code> screen. The default layout makes the @@ -555,117 +614,116 @@ All of the commands are documented within an online help system. appointment panel is displayed on the left hand-side of the screen (see the figure in section <a href="#basics_interface_interactive">Interactive mode</a> - for an exemple of the default layout).<br> + for an exemple of the default layout). By choosing another layout in the configuration screen, user can customize <code>calcurse</code> appearence to best suit - his needs by placing the different panels where needed. + his needs by placing the different panels where needed.</p> -<a name="options_notify"></a><h2>Notify-bar settings</h2> +<h2>5.4 Notify-bar settings<a name="options_notify"></a></h2> <p> - The following options are used to modify the notify-bar behavior: - <ul> - <li><code>notify-bar_show</code> (default: <em>yes</em>)<br> - This option indicates if you want the notify-bar to be displayed - or not.<br> - <br> - <li><code>notify-bar_date</code> (default: <em>%a %F</em>)<br> - With this option, you can specify the format to be used to + The following options are used to modify the notify-bar behavior:</p> + <dl> + <dt><code>notify-bar_show</code> + (default: <span class="emp">yes</span>)</dt> + <dd>This option indicates if you want the notify-bar to be displayed + or not.</dd> + <dt><code>notify-bar_date</code> + (default: <span class="emp">%a %F</span>)</dt> + <dd>With this option, you can specify the format to be used to display the current date inside the notification bar. You can - see all of the possible formats by typing <tt>man 3 strftime</tt> - inside a terminal.<br> - <br> - <li><code>notify-bar_time</code> (default: <em>%T</em>)<br> - With this option, you can specify the format to be used to + see all of the possible formats by typing <code>man 3 strftime</code> + inside a terminal.</dd> + <dt><code>notify-bar_time</code> + (default: <span class="emp">%T</span>)</dt> + <dd>With this option, you can specify the format to be used to display the current time inside the notification bar. You can - see all of the possible formats by typing <tt>man 3 strftime</tt> - inside a terminal.<br> - <br> - <li><code>notify-bar_warning</code> (default: <em>300</em>)<br> - When there is an appointment which is flagged as 'important' + see all of the possible formats by typing <code>man 3 strftime</code> + inside a terminal.</dd> + <dt><code>notify-bar_warning</code> + (default: <span class="emp">300</span>)</dt> + <dd>When there is an appointment which is flagged as 'important' within the next 'notify-bar_warning' seconds, the display of that appointment inside the notify-bar starts to blink. - Moreover, the command defined by the <em>notify-bar_command</em> + Moreover, the command defined by the <code>notify-bar_command</code> option will be launched. That way, the user is warned and knows there will be soon an upcoming appointment. - <br> - <br> - <li> - <code>notify-bar_command</code> (default: <em>printf '\a'</em>)<br> - This option indicates which command is to be launched when there is an + </dd> + <dt><code>notify-bar_command</code> + (default: <span class="emp">printf '\a'</span>)</dt> + <dd>This option indicates which command is to be launched when there is an upcoming appointment flagged as 'important'. This command will be passed to the user's shell which will interpret it. To know what shell must be used, the content of the <code>$SHELL</code> environment variable is used. If this variable is not set, <code>/bin/sh</code> is used - instead.<br> - <u>Example:</u> Say the <code>mail</code> command is available on + instead. + <p class="rq"><span class="valorise">Example:</span> + Say the <code>mail</code> command is available on the user's system, one can use the following command to get notified by mail of an upcoming appointment (the appointment description will also - be mentioned in the mail body): - <pre> - calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com - </pre> - </ul> - - -<a name="known_bugs"></a><h1>Known bugs</h1> + be mentioned in the mail body):</p> + <code> +calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com + </code> + </dd> + </dl> + +<h1>6. Known bugs<a name="known_bugs"></a></h1> <p> Incorrect highlighting of items appear when using calcurse black and white theme together with a <code>$TERM</code> - variable set to <em>xterm-color</em>. + variable set to <span class="emp">xterm-color</span>. To fix this bug, and as advised by Thomas E. Dickey - (<code>xterm</code> maintainer), <em>xterm-xfree86</em> - should be used instead of <em>xterm-color</em> to set - the <code>$TERM</code> variable:<br> - <blockquote> + (<code>xterm</code> maintainer), <span class="emp">xterm-xfree86</span> + should be used instead of <span class="emp">xterm-color</span> to set + the <code>$TERM</code> variable:</p> + <blockquote class="rq"> "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>Reporting bugs and feedback</h1> +<h1>7. Reporting bugs and feedback<a name="bugs"></a></h1> <p> - Please send bug reports and feedback to: - <pre> - calcurse@culot.org - </pre> - or to the author: - <pre> - frederic@culot.org - </pre> + Please send bug reports and feedback to:</p> + <pre>calcurse .at. culot .dot. org</pre> +<p> + or to the author:</p> + <pre>frederic .at. culot .dot. org</pre> -<a name="contribute"></a><h1>How to contribute?</h1> +<h1>8. How to contribute?<a name="contribute"></a></h1> <p> If you would like to contribute to the project, you can first send your feedback on what you like or dislike, and if there are features you miss in <code>calcurse</code>. For now on, possible contributions concern the translation - of <code>calcurse</code> messages and documentation. <br> - <br> - <u>Note:</u> Any help in getting <code>calcurse</code> + of <code>calcurse</code> messages and documentation. </p> + <p class="rq"><span class="valorise">Note:</span> + any help in getting <code>calcurse</code> internationalized would be very welcomed, but before contributing, send a mail to - <code>calcurse-i18n@culot.org</code> to know if someone - already started the translation process into your language. + <code>calcurse-i18n .at. culot .dot. org</code> to know if someone + already started the translation process into your language.</p> -<a name="contribute_documentation"></a><h2>Translating documentation</h2> +<h2>8.1 Translating documentation<a name="contribute_documentation"></a></h2> <p> - The <em>doc/</em> directory of the source package already + The <span class="emp">doc/</span> directory of the source package already contains translated version of <code>calcurse</code> manual. However, if the manual is not yet available into your native language, it would be appreciated if you could help - translating it.<br> + translating it.</p> +<p> To do so, just copy one of the existing manual - file to <code>manual_XX.html</code>, where <em>XX</em> + file to <code>manual_XX.html</code>, where <span class="emp">XX</span> identifies your language. Then translate this newly created file and send it to the author (see <a href="#bugs">Reporting bugs and feeback</a>), so that it can be included in the - next <code>calcurse</code> release. + next <code>calcurse</code> release.</p> -<a name="contribute_i18n"></a><h2><code>calcurse</code> i18n</h2> +<h2>8.2 <code>calcurse</code> i18n<a name="contribute_i18n"></a></h2> <p> As already mentioned, <code>gettext</code> utilities are used by <code>calcurse</code> to produce multi-lingual @@ -675,94 +733,97 @@ All of the commands are documented within an online help system. with <code>gettext</code> for <code>calcurse</code> specifically. For more comprehensive informations or to grasp the Big Picture of Native Language Support, you should refer - to the <code>GNU gettext</code> manual at: - <pre> - http://www.gnu.org/software/gettext/manual/ - </pre> + to the <code>GNU gettext</code> manual at:</p> + <pre>http://www.gnu.org/software/gettext/manual/ </pre> +<p> Basically, three different people get involved in the translation chain: coders, language coordinator, and translators. After a quick overview of how things work, the - translator tasks will be described hereafter. + translator tasks will be described hereafter.</p> -<a name="contribute_i18n_overview"></a><h3>Overview</h3> +<h3>8.2.1 Overview<a name="contribute_i18n_overview"></a></h3> <p> To be able to display texts in the native language of the - user, two steps are required: <em>internationalization</em> - (i18n) and <em>localization</em> (l10n). i18n is about making + user, two steps are required: <span class="emp">internationalization</span> + (i18n) and <span class="emp">localization</span> (l10n).</p> +<p> + i18n is about making <code>calcurse</code> support multiple languages. It is performed by coders, who will mark translatable texts and - provide a way to display them translated at runtime. l10n is + provide a way to display them translated at runtime.</p> +<p> + l10n is about making the i18n'ed <code>calcurse</code> adapt to the specific language of the user, ie translating the strings previously marked by the developers, and setting the environment correctly for <code>calcurse</code> to use the - result of this translation.<br> <br> - + result of this translation.</p> +<p> So, translatable strings are first marked by the coders within the <code>C</code> source files, then gathered in a template - file (<em>calcurse.pot</em> - the <em>pot</em> extension - meaning <em>portable object template</em>). The content of + file (<span class="emp">calcurse.pot</span> - the <span class="emp">pot</span> extension + meaning <span class="emp">portable object template</span>). The content of this template file is then merged with the translation files - for each language (<em>fr.po</em> for french, for instance - - with <em>po</em> standing for <em>portable object</em>, ie + for each language (<span class="emp">fr.po</span> for french, for instance - + with <span class="emp">po</span> standing for <span class="emp">portable object</span>, ie meant to be read and edited by humans). A given translation team will take this file, translate its strings, and send it back to the developers. At compilation time, a binary version of this file (for efficiency reasons) will be produced - (<em>fr.mo</em> - <em>mo</em> stands for <em>machine - object</em>, ie meant to be read by programs), and then + (<span class="emp">fr.mo</span> - <span class="emp">mo</span> stands for + <span class="emp">machine + object</span>, ie meant to be read by programs), and then installed. Then <code>calcurse</code> will use this file at runtime, translating the strings according to the locale - settings of the user. + settings of the user.</p> -<a name="contribute_i18n_translator"></a><h3>Translator tasks</h3> +<h3>8.2.2 Translator tasks<a name="contribute_i18n_translator"></a></h3> <p> Suppose someone wants to initiate the translation of a new - language. Here are the steps to follow: + language. Here are the steps to follow:</p> <ul> <li>First, find out what the locale name is. For instance, for french, it is 'fr_FR', or simply 'fr'. This is the value the user will have to put in his <code>LC_ALL</code> environment variable for software to be translated (see <a href="#basics_invocation_variable">Environment variable for - i18n</a>).<br> - <br> - <li>Then, go into the <em>po/</em> directory, and create a new po-file + i18n</a>).</li> + <li>Then, go into the <span class="emp">po/</span> directory, and create a new po-file from the template file using the following command: - <pre> - 'msginit -i calcurse.pot -o fr.po -l fr --no-translator' - </pre> + <code>'msginit -i calcurse.pot -o fr.po -l fr --no-translator'</code> If you do not have <code>msginit</code> installed on your - system, simply copy the <em>calcurse.pot</em> file to - <em>fr.po</em> and edit the header by hand.<br> - Now, having this <em>fr.po</em> file, the translator is ready - to begin. - </ul> + system, simply copy the <span class="emp">calcurse.pot</span> file to + <span class="emp">fr.po</span> and edit the header by hand.</li> + </ul> +<p> + Now, having this <span class="emp">fr.po</span> file, the translator is ready + to begin.</p> -<a name="contribute_i18n_po-files"></a><h3>po-files</h3> +<h3>8.2.3 po-files<a name="contribute_i18n_po-files"></a></h3> <p> The format of the po-files is quite simple. Indeed, po-files - are made of four things: + are made of four things:</p> <ol> - <li><em>location lines:</em> tells you where the strings can + <li><span class="emp">location lines:</span> tells you where the strings can be seen (name of file and line number), in case you need to - see a bit of context. - <li><em>msgid lines:</em> the strings to translate. - <li><em>msgstr lines:</em> the translated strings. - <li><em>lines prefixed with '#':</em> comments (some with a - special meaning, as we will see below). + see a bit of context.</li> + <li><span class="emp">msgid lines:</span> the strings to translate.</li> + <li><span class="emp">msgstr lines:</span> the translated strings.</li> + <li><span class="emp">lines prefixed with '#':</span> comments (some with a + special meaning, as we will see below).</li> </ol> - Basically, all you have to do is fill the <em>msgstr</em> - lines with the translation of the above <em>msgid</em> - line. - <p> - <u>A few notes:</u> - <ul> - <li><em>Fuzzy strings</em><br> - You will meet strings marked with a <code>"#, fuzzy"</code> +<p> + Basically, all you have to do is fill the <span class="emp">msgstr</span> + lines with the translation of the above <span class="emp">msgid</span> + line.</p> +<p> + <span class="valorise">A few notes:</span> + <dl> + <dt><span class="emp">Fuzzy strings</span></dt> + <dd>You will meet strings marked with a <code>"#, fuzzy"</code> comment. <code>calcurse</code> won't use the translations of such strings until you do something about them. A string being fuzzy means either that the string has already been @@ -776,10 +837,9 @@ All of the commands are documented within an online help system. will no longer be accurate and needs to be changed. Once you are done and happy with the translation, just remove the <code>"#, fuzzy"</code> line, and the translation will be used - again in <code>calcurse</code>.<br> - <br> - <li><em>c-format strings and special sequences</em><br> - Some strings have the following comment: <code>"#, + again in <code>calcurse</code>.</dd> + <dt><span class="emp">c-format strings and special sequences</span></dt> + <dd>Some strings have the following comment: <code>"#, c-format"</code>. This tells that parts of the string to translate have a special meaning for the program, and that you should leave them alone. For instance, %-sequences, like @@ -787,21 +847,20 @@ All of the commands are documented within an online help system. replace them with another string. So it is important it remains. There are also \-sequences, like <code>\n</code> or <code>\t</code>. Leave them, too. The former represents an end - of line, the latter a tabulation.<br> - <br> - <li><em>Translations can be wrapped</em><br> - If lines are too long, you can just break them like this: + of line, the latter a tabulation.</dd> + <dt><span class="emp">Translations can be wrapped</span></dt> + <dd>If lines are too long, you can just break them like this: <pre> - msgid "" - "some very long line" - "another line" - </pre> - <li><em>po-file header</em><br> - At the very beginning of the po-file, the first string form a +msgid "" +"some very long line" +"another line" + </pre></dd> + <dt><span class="emp">po-file header</span></dt> + <dd>At the very beginning of the po-file, the first string form a header, where various kind of information has to be filled in. Most important one is the charset. It should resemble <pre> - "Content-Type: text/plain; charset=utf-8\n" +"Content-Type: text/plain; charset=utf-8\n" </pre> You should also fill in the Last-Translator field, so that potential contributors can contact you if they want to join @@ -809,127 +868,123 @@ All of the commands are documented within an online help system. give about the translations. You can either just give your name/nick, or add an email address, for exemple: <pre> - "Last-Translator: Frederic Culot <frederic@culot.org>\n" - </pre> - <li><em>Comments</em><br> - Adding comments (lines begining with the '#' character) can be +"Last-Translator: Frederic Culot <frederic@culot.org>\n" + </pre></dd> + <dt><span class="emp">Comments</span></dt> + <dd>Adding comments (lines begining with the '#' character) can be a good way to point out problems or translation difficulties - to proofreaders or other members of your team.<br> - <br> - <li><em>Strings size</em><br> - <code>calcurse</code> is a curses/console program, thus it can + to proofreaders or other members of your team.</dd> + <dt><span class="emp">Strings size</span></dt> + <dd><code>calcurse</code> is a curses/console program, thus it can be heavily dependant on the terminal size (number of columns). You should think about this when translating. Often, a string must fit into a single line (standard length is 80 characters). Don't translate blindly, try to look where your - string will be displayed to adapt your translation.<br> - <br> - <li><em>A few useful tools</em><br> - The po-file format is very simple, and the file can be edited + string will be displayed to adapt your translation.</dd> + <dt><span class="emp">A few useful tools</span></dt> + <dd>The po-file format is very simple, and the file can be edited with a standard text editor. But if you prefer, there are few specialized tools you may find convenient for translating: <ul> <li><code>poEdit</code> (<a href="http://www.poedit.org/" target="_blank"> - http://www.poedit.org/</a>) + http://www.poedit.org/</a>)</li> <li><code>KBabel</code> (<a href="http://i18n.kde.org/tools/kbabel/" target="_blank"> - http://i18n.kde.org/tools/kbabel/</a>) + http://i18n.kde.org/tools/kbabel/</a>)</li> <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 + http://gtranslator.sourceforge.net/</a>)</li> + <li><code>Emacs</code> po mode</li> + <li><code>Vim</code> po mode</li> </ul> - <br> - <li><em>And finally</em><br> - I hope you'll have fun contributing to a more + </dd> + <dt><span class="emp">And finally</span></dt> + <dd>I hope you'll have fun contributing to a more internationalized world. :) If you have any more questions, - don't hesitate to contact me at <em>frederic@culot.org</em>. - </ul> + don't hesitate to contact me at + <span class="emp">frederic .at. culot .dot. org</span>.</dd> + </dl> -<a name="links"></a><h1>Links</h1> +<h1>9. Links<a name="links"></a></h1> <p> This section contains links and references that may be of - interest to you. + interest to you.</p> - -<a name="links_homepage"></a><h2><code>calcurse</code> homepage</h2> +<h2>9.1 <code>calcurse</code> homepage<a name="links_homepage"></a></h2> <p> - The <code>calcurse</code> homepage can be found at - <pre> - http://culot.org/calcurse - </pre> + The <code>calcurse</code> homepage can be found at </p> + <pre>http://culot.org/calcurse</pre> -<a name="links_list"></a><h2><code>calcurse</code> announce list</h2> +<h2>9.2 <code>calcurse</code> announce list<a name="links_list"></a></h2> <p> If you are interested in the project and want to be warned when a new release comes out, you can subscribe to the <code>calcurse</code> announce list. In doing so, you will receive an email as soon as a new feature appears in - <code>calcurse</code>.<br> + <code>calcurse</code>.</p> +<p> To subscribe to this list, send a message to - <code>calcurse-announce@culot.org</code> with "subscribe" - in the subject field. + <span class="emp">calcurse-announce .at. culot .dot. org</span> + with "subscribe" in the subject field.</p> -<a name="links_rss"></a><h2><code>calcurse</code> RSS feed</h2> +<h2>9.3 <code>calcurse</code> RSS feed<a name="links_rss"></a></h2> <p> Another possibility to get warned when new releases come out - is to follow the RSS feed at: - <pre> - http://culot.org/calcurse/news_rss.xml - </pre> + is to follow the RSS feed at:</p> + <pre>http://culot.org/calcurse/news_rss.xml</pre> +<p> This RSS feed is updated each time a new version of calcurse is - available, describing newly added features. + available, describing newly added features.</p> -<a name="thanks"></a><h1>Thanks</a></h1> +<h1>10. Thanks<a name="thanks"></a></h1> <p> Its time now to thank other people without whom this program would not exist! So here is a list of contributing persons I would like to thank : <ul> - <li>Alex for its patches, help and advices with <code>C</code> programming + <li>Alex for its patches, help and advices with <code>C</code> programming</li> <li>Gwen for testing and general discussions about how to - improve <code>calcurse</code> - <li>Herbert for packaging <code>calcurse</code> for FreeBSD - <li>Zul for packaging <code>calcurse</code> for NetBSD - <li>Wain for packaging <code>calcurse</code> for Archlinux + improve <code>calcurse</code></li> + <li>Herbert for packaging <code>calcurse</code> for FreeBSD</li> + <li>Zul for packaging <code>calcurse</code> for NetBSD</li> + <li>Wain, Steffen and Ronald for packaging <code>calcurse</code> for Archlinux</li> <li>Kevin, Ryan, and fEnIo for packaging <code>calcurse</code> for Debian - and Ubuntu - <li>Steffen for packaging <code>calcurse</code> for Archlinux - <li>Pascal for packaging <code>calcurse</code> for Slackware + and Ubuntu</li> + <li>Pascal for packaging <code>calcurse</code> for Slackware</li> <li>Alexandre and Markus for packaging <code>calcurse</code> for Mac OsX - and Darwin - <li>Igor for packaging <code>calcurse</code> for ALT Linux + and Darwin</li> + <li>Igor for packaging <code>calcurse</code> for ALT Linux</li> <li>Joel for its calendar script which inspired <code>calcurse</code> - calendar view + calendar view</li> <li>Michael Schulz and Chris M. for the german translation of - <code>calcurse</code> and its manual + <code>calcurse</code> and its manual</li> <li>Jose Lopez for the spanish translation of - <code>calcurse</code> and its manual - <li>Neil Williams for the english translation + <code>calcurse</code> and its manual</li> + <li>Neil Williams for the english translation</li> <li>Tony for its patch which helped improving the - recur_item_inday() function - <li>Jeremy Roon for the dutch translation + recur_item_inday() function</li> + <li>Jeremy Roon for the dutch translation</li> <li>people who write softwares I like and which inspired me, especially : <ul> - <li><code>vim</code> for the displacement keys - <li><code>orpheus</code> and <code>abook</code> for documentation + <li><code>vim</code> for the displacement keys</li> + <li><code>orpheus</code> and <code>abook</code> for documentation</li> <li><code>pine</code> and <code>aptitude</code> - for the text user interface - </ul> + for the text user interface</li> + </ul></li> </ul> - <br> +</p> +<p> And last, many many thanks to all of the <code>calcurse</code> - users who sent me their feedback. + users who sent me their feedback.</p> -<hr> -<small><em> -Copyright (c) 2004-2007 Frédéric Culot<br> -Calcurse version 1.9 - Last change: August 18, 2007 -</em></small> +<div class="footer"> + Copyright (c) 2004-2008 Frédéric Culot<br> + Calcurse version 2.0 - Last change: February 06, 2008<br> +</div> +</div> </body> </html> diff --git a/doc/manual_es.html b/doc/manual_es.html index 65a3394..b38ac53 100755 --- a/doc/manual_es.html +++ b/doc/manual_es.html @@ -1,10 +1,10 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!-- /* - * $calcurse: manual_es.html,v 1.9 2007/08/19 13:19:37 culot Exp $ + * $calcurse: manual_es.html,v 1.10 2008/02/10 11:33:24 culot Exp $ * * Calcurse - text-based organizer - * Copyright (c) 2004-2007 Frederic Culot + * Copyright (c) 2004-2008 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 @@ -31,90 +31,108 @@ <head> <title>CALCURSE documentación</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<style type="text/css" media="all"> + @import url(manual.css); +</style> </head> -<body bgcolor="white" text="black" link="blue" vlink="navy"> +<body> -<h1><code>CALCURSE - organizador basado en modo texto</code></h1> -<p> -<p><hr><p> +<div id="mainContent"> + +<h1 id="title"> +<span class="main">CALCURSE - organizador basado en modo texto</span></h1> + +<div class="warn"> +<div class="todo"> +<h1>Abstract</h1> This manual describes <code>calcurse</code> functionnalities, +and how to use them. The installation from source is first described, together +with the available command line arguments. The user interface +is then presented, with all of the customizable options that change +<code>calcurse</code> behavior. Last, bug reporting procedure is explained, as +well as the way one can contribute to <code>calcurse</code> development. +</div> +</div> +<div id="toc"> <h1>Tabla de Contenidos</h1> <ul> -<li><a href="#intro">Introducción</a> -<li><a href="#overview">Descripción</a> -<ul> -<li><a href="#overview_history">Historia</a> -<li><a href="#overview_features">Características importantes</a> -</ul> -<li><a href="#install">Instalación</a> -<ul> -<li><a href="#install_requirements">Requerimientos</a> -<ul><li><a href="#install_requirements_ncurses">librería <code>ncurses</code></a> -<li><a href="#install_requirements_gettext">librería <code>gettext</code></a> -</ul> -<li><a href="#install_process">Proceso de instalación</a> -</ul> -<li><a href="#basics"><code>calcurse</code> básicos</a> -<ul> -<li><a href="#basics_invocation">Invocación</a> -<ul> -<li><a href="#basics_invocation_commandline">Argumentos de la linea de comandos</a> -<li><a href="#basics_invocation_variable">Variable de entorno para i18n</a> -</ul> -<li><a href="#basics_interface">Interfaz de usuario</a> -<ul> -<li><a href="#basics_interface_noninteractive">Modo no-interactivo</a> -<li><a href="#basics_interface_interactive">Modo interactivo</a> -</ul> -<li><a href="#basics_files">Archivos de <code>calcurse</code></a> -<li><a href="#basics_help">Ayuda en linea</a> -</ul> -<li><a href="#options">Opciones</a> -<ul> -<li><a href="#options_general">Opciones generales</a> -<li><a href="#options_colors">Color (temas)</a> -<li><a href="#options_layout">Configuración de la disposición</a> -<li><a href="#options_notify">Ajustes de la barra de notificaciones</a> -</ul> -<li><a href="#known_bugs">Bugs conocidos</a> -<li><a href="#bugs">Informar de bugs y comentarios</a> -<li><a href="#contribute">¿Como contribuir?</a> -<ul> -<li><a href="#contribute_documentation">Traduciendo la documentación</a> -<li><a href="#contribute_i18n"><code>calcurse</code> i18n</a> -<ul> -<li><a href="#contribute_i18n_overview">Descripción</a> -<li><a href="#contribute_i18n_translator">Tareas del traductor</a> -<li><a href="#contribute_i18n_po-files">Archivos-po</a> -</ul> -</ul> -<li><a href="#links">Enlaces</a> -<ul> -<li><a href="#links_homepage">Pagina web de <code>calcurse</code></a> -<li><a href="#links_list">Lista de anuncios de <code>calcurse</code></a> -<li><a href="#links_rss"><code>calcurse</code> RSS feed</a> -</ul> -<li><a href="#thanks">Gracias a ...</a> + <li><a href="#intro">1. Introducción</a></li> + <li><a href="#overview">2. Descripción</a> + <ul> + <li><a href="#overview_history">2.1 Historia</a></li> + <li><a href="#overview_features">2.2 Características importantes</a></li> + </ul></li> + <li><a href="#install">3. Instalación</a> + <ul> + <li><a href="#install_requirements">3.1 Requerimientos</a> + <ul> + <li><a href="#install_requirements_ncurses">3.1.1 librería <code>ncurses</code></a></li> + <li><a href="#install_requirements_gettext">3.1.2 librería <code>gettext</code></a></li> + </ul></li> + <li><a href="#install_process">3.2 Proceso de instalación</a></li> + </ul></li> + <li><a href="#basics">4. <code>calcurse</code> básicos</a> + <ul> + <li><a href="#basics_invocation">4.1 Invocación</a> + <ul> + <li><a href="#basics_invocation_commandline">4.1.1 Argumentos de la linea de comandos</a></li> + <li><a href="#basics_invocation_variable">4.1.2 Variable de entorno para i18n</a></li> + </ul></li> + <li><a href="#basics_interface">4.2 Interfaz de usuario</a> + <ul> + <li><a href="#basics_interface_noninteractive">4.2.1 Modo no-interactivo</a></li> + <li><a href="#basics_interface_interactive">4.2.2 Modo interactivo</a></li> + </ul></li> + <li><a href="#basics_files">4.3 Archivos de <code>calcurse</code></a></li> + <li><a href="#basics_help">4.4 Ayuda en linea</a></li> + </ul></li> + <li><a href="#options">5. Opciones</a> + <ul> + <li><a href="#options_general">5.1 Opciones generales</a></li> + <li><a href="#options_colors">5.2 Color (temas)</a></li> + <li><a href="#options_layout">5.3 Configuración de la disposición</a></li> + <li><a href="#options_notify">5.4 Ajustes de la barra de notificaciones</a></li> + </ul></li> + <li><a href="#known_bugs">6. Bugs conocidos</a></li> + <li><a href="#bugs">7. Informar de bugs y comentarios</a></li> + <li><a href="#contribute">8. ¿Como contribuir?</a> + <ul> + <li><a href="#contribute_documentation">8.1 Traduciendo la documentación</a></li> + <li><a href="#contribute_i18n">8.2 <code>calcurse</code> i18n</a> + <ul> + <li><a href="#contribute_i18n_overview">8.2.1 Descripción</a></li> + <li><a href="#contribute_i18n_translator">8.2.2 Tareas del traductor</a></li> + <li><a href="#contribute_i18n_po-files">8.2.3 Archivos-po</a></li> + </ul></li> + </ul></li> + <li><a href="#links">9. Enlaces</a> + <ul> + <li><a href="#links_homepage">9.1 Pagina web de <code>calcurse</code></a></li> + <li><a href="#links_list">9.2 Lista de anuncios de <code>calcurse</code></a></li> + <li><a href="#links_rss">9.3 <code>calcurse</code> RSS feed</a></li> + </ul></li> + <li><a href="#thanks">10. Gracias a ...</a></li> </ul> -<p><hr><p> - +</div> -<a name="intro"></a><h1>Introducción</a></h1> +<h1>1. Introducción<a name="intro"></a></h1> <p> <code>calcurse</code> es un calendario y organizador de tareas personal basado en modo texto. Te ayuda a mantener un seguimiento de tus eventos, citas y tareas diarias. Un sistema de notificacion recuerda al usuario sus proximas citas y la interfaz de usuario basanda en ncurses puede ser personalizada para cubrir las necesidades del usuario. Todos los comandos están documentados a través de un sistema de ayuda en linea. +</p> - -<a name="overview"></a><h1>Descripción</h1> -<a name="overview_history"></a><h2>Historia</h2> +<h1>2. Descripción<a name="overview"></a></h1> +<h2>2.1 Historia<a name="overview_history"></a></h2> <p> Comencé a pensar en este proyecto cuando estaba acabando mi doctorado en Astrofísica... Empezaba a ser un poco complicado el organizarme y realmente necesitaba una buena herramienta que me ayudase - en esa difícil tarea ;-)<br> + en esa difícil tarea ;-) +</p> +<p> Me gustan los programas que utilizan las interfaces de usuario en modo texto porque son simples, rápidos y eficientes, por eso pensé en programar un calendario simple en @@ -122,30 +140,37 @@ lenguaje <code>C</code> que había utilizado solo a ratos durante mi época de estudiante. Por eso pensé que podía ser un buen proyecto para empezar a estar organizado y ¡ aprender algunas - cosas sobre <code>C</code> ! Por desgracia acabe mi doctorado antes de + cosas sobre <code>C</code> ! +</p> +<p> + Por desgracia acabe mi doctorado antes de acabar <code>calcurse</code>, pero de todas formas aun quería trabajar en el y esperaba que pudiese ser de ayuda a otra gente. - Y aquí esta...<br><br> + Y aquí esta... +</p> +<p> Pero ¿por que 'calcurse'? Bien, es simplemente una concatenación de CALendar y nCURSEs, el nombre de la librería utilizada para construir la interfaz de usuario. - - +</p> - -<a name="overview_features"></a><h2>Características importantes</h2> +<h2>2.2 Características importantes<a name="overview_features"></a></h2> <p> <code>Calcurse</code> es multi-plataforma e intenta ser ligero, rápido y fiable. Esta hecho para ser usado en consola o terminal, tanto en local como en una maquina remota a través de ssh o una - conexión similar.<br> + conexión similar. +</p> +<p> <code>Calcurse</code> puede funcionar de dos modos diferentes : modo interactivo o no-interactivo. El primero permite a un usuario ver su organizador en casi cualquier maquina gracias a la interfaz basada en modo texto. El segundo modo permite crear recordatorios de una forma muy fácil, únicamente añadiendo <code>calcurse</code>, con los argumentos apropiados en la linea de comando, en el crontab - o mediante un sell init script.<br> + o mediante un sell init script. +</p> +<p> Por otra parte, <code>calcurse</code> fue creado pensando en el usuario final y trata de ser lo mas amigable posible. Esto significa un completo sistema de ayuda en linea, conjuntamente con tener todas @@ -153,192 +178,198 @@ estado. La interfaz de usuario también es configurable y uno puede elegir entre combinaciones de colores y disposiciones. Finalmente, un sistema de notificacion recuerda al usuario sus proximas citas. - +</p> -<a name="install"></a><h1>Instalación</h1> -<a name="install_requirements"></a><h2>Requerimientos</h2> -<a name="install_requirements_ncurses"></a><h3>librería <code>ncurses</code></h3> +<h1>3. Instalación<a name="install"></a></h1> +<h2>3.1 Requerimientos<a name="install_requirements"></a></h2> +<h3>3.1.1 librería <code>ncurses</code><a name="install_requirements_ncurses"></a></h3> <p> <code>Calcurse</code> requiere solo un compilador <code>C</code>, como <code>cc</code> o <code>gcc</code>, y la librería <code>ncurses</code>. Sería muy sorprendente no tener una librería <code>ncurses</code> valida ya instalada en tu ordenador, pero si no la tienes, puedes - encontrarla en la siguiente dirección :<br> - <pre> - http://ftp.gnu.org/pub/gnu/ncurses/ - </pre> + encontrarla en la siguiente dirección :</p> + <pre>http://ftp.gnu.org/pub/gnu/ncurses/</pre> -<a name="install_requirements_gettext"></a><h3>librería <code>gettext</code></h3> +<h3>3.1.2 librería <code>gettext</code><a name="install_requirements_gettext"></a></h3> <p> <code>calcurse</code> soporta internacionalización - ( de aquí en adelante <em>i18n</em>) con las + (de aquí en adelante <span class="emp">i18n</span>) con las utilidades <code>gettext</code>. Esto significa que <code>calcurse</code> puede producir mensajes en diferentes lenguas si esta compilado con el soporte - para lengua nativa (p.e. <em>NLS</em>). Por otra parte, - <em>NLS</em> es opcional, si tu no quieres tener soporte + para lengua nativa (p.e. <span class="emp">NLS</span>). +</p> +<p> + Por otra parte, + <span class="emp">NLS</span> es opcional, si tu no quieres tener soporte para esta característica, basta con que utilices la opción <code>--disable-nls</code> en el comando <code>configure</code> (ver la sección <a - href="#install_process">Proceso de instalación</a>). <br> + href="#install_process">Proceso de instalación</a>). Para comprobar si las utilidades <code>gettext</code> están instaladas en tu sistema, puedes buscar el archivo cabecera - <code>libintl.h</code>, por ejemplo : - <pre> - locate libintl.h - </pre> + <code>libintl.h</code>, por ejemplo :</p> + <pre>locate libintl.h</pre> +<p> Si este archivo cabecera no se encuentra, entonces puedes obtener - las fuentes de <code>gettext</code> en la siguiente dirección :<br> - <pre> - http://ftp.gnu.org/pub/gnu/gettext/ - </pre> - <u>Nota:</u> Incluso si <code>libintl.h</code> se encuentra en tu + las fuentes de <code>gettext</code> en la siguiente dirección :</p> + <pre>http://ftp.gnu.org/pub/gnu/gettext/</pre> +<p> + <p class="rq"><span class="valorize">Nota:</span> + Incluso si <code>libintl.h</code> se encuentra en tu sistema, puede ser necesario especificar su localización durante el <a href="#install_process">proceso de instalación</a>, utilizando la opción <code>--with-libintl-prefix</code> en el comando <code>configure</code>. De hecho, el comando <code>configure</code> puede fallar al tratar de localizar esta librería si esta instalada en un lugar infrecuente. - +</p> -<a name="install_process"></a><h2>Proceso de instalación</h2> +<h2>3.2 Proceso de instalación<a name="install_process"></a></h2> +<p> + Primero necesitas descomprimir ( gunzip y untar) el archivo fuente:</p> + <pre>tar zxvf calcurse-2.0.tar.gz</pre> <p> - Primero necesitas descomprimir ( gunzip y untar) el archivo fuente: - <pre> - tar zxvf calcurse-1.9.tar.gz - </pre> Una vez has resuelto los requisitos y has extraído el archivo, el proceso de instalación es muy simple y sigue los tres pasos habituales: - <OL> - <li><code>./configure</code> - <li><code>make</code> - <li><code>make install</code> (puede requerir privilegios de administrador) - </OL> + <ol> + <li><code>./configure</code></li> + <li><code>make</code></li> + <li><code>make install</code> (puede requerir privilegios de administrador)</li> + </ol> +</p> +<p> Utiliza <code>./configure --help</code> para obtener una lista de posibles opciones. +</p> - -<a name="basics"></a><h1><code>calcurse</code> básicos</h1> -<a name="basics_invocation"></a><h2>Invocación (arranque del programa)</h2> -<a name="basics_invocation_commandline"></a><h3>Argumentos de la linea de comando</h3> +<h1>4. <code>calcurse</code> básicos<a name="basics"></a></h1> +<h2>4.1 Invocación (arranque del programa)<a name="basics_invocation"></a></h2> +<h3>4.1.1 Argumentos de la linea de comando<a name="basics_invocation_commandline"></a></h3> <p> <code>calcurse</code> acepta las siguientes opciones en la - linea de comando (ambas opciones, cortas y largas estan soportadas): - - <dl compact> - <dt><code>-a, --appointment</code> - <dd> - Imprime las citas y eventos para el día actual y sale.<br> - <u>Nota:</u> el calendario desde donde leerán - puede ser especificado usando la opción '-c' .<br> - <br> - <dt><code>-c <file>, --calendar <file></code> - <dd> - Especifica el archivo de calendario a usar.<br> - El calendario por defecto es <code>~/.calcurse/apts</code> - (ver la sección <a href="#basics_files">Archivos de <code>calcurse</code></a>).<br> - <br> - <dt><code>-d <date|num>, --day <date|num></code> - <dd> - Imprime las citas y eventos para la fecha dada o para el numero dado de días - próximos, dependiendo del formato del argumento. - Soporta dos posible formatos : - <ul> - <li>una fecha en la siguiente forma 'mm/dd/aaaa' (día/mes/año). - <li>un numero 'n'. - </ul> - En el primer caso, devolverá la lista de citas y eventos para la fecha especificada - mientras que en el segundo caso devolverá la lista de citas y eventos - para los 'n' próximos días.<br> - Por ejemplo, tecleando <code>calcurse -d 3</code> - mostrara tus citas y eventos para hoy, mañana y pasado mañana.<br> - <u>Nota:</u>al igual que para la opción '-a' , el calendario desde donde se - leerán puede ser especificado usando la opción '-c' .<br> - <br> - <dt><code>-h, --help</code> - <dd> - Imprime un breve texto de ayuda describiendo las opciones soportadas en la - linea de comando y sale.<br> - <br> - <dt><code>-n, --next</code> - <dd> - Imprime las citas para las próximas 24 horas y sale.<br> - El tiempo indicado es el numero de horas y minutos que faltan hasta la proxima cita.<br> - <u>Nota:</u> el calendario desde donde se leeran las citas puede ser especificado usando la opcion '-c'.<br> - <br> - <dt><code>-t[num], --todo[=num]</code> - <dd> - Imprime la lista de tareas pendientes ('ToDo') y sale.<br> - Si se especifica la opcion <code>numero</code>, se mostraran todas las tareas pendientes que tengan la prioridad - igual a <code>numero</code>.<br> - <u>Nota:</u> la prioridad debe ser desde 1 (la mas alta) hasta 9 (la mas baja).<br> - <br> - <dt><code>-v, --version</code> - <dd> - Muestra la versión de <code>calcurse</code> y sale.<br> - <br> - <dt><code>-x, --export</code> - <dd> - Exporta los datos del usuario a un formato iCalendar. Citas, eventos y tareas pendientes son convertidos y - mostrados en patalla.<br> - <u>Nota:</u> redirecciona la salida standard para exportar los datos a un archivo usando - un comando como este: - <pre> - $ calcurse --export > my_data.ics - </pre> + linea de comando (ambas opciones, cortas y largas estan soportadas):</p> + <p> -<a name="basics_invocation_variable"></a><h3>Variable de entorno para i18n</h3> + <dl> + <dt><code>-a, --appointment</code></dt> + <dd> + Imprime las citas y eventos para el día actual y sale. + <p class="rq"><span class="valorise">Nota:</span> + el calendario desde donde leerán + puede ser especificado usando la opción '-c'.</p> + </dd> + <dt><code>-c <file>, --calendar <file></code></dt> + <dd> + Especifica el archivo de calendario a usar. + El calendario por defecto es <code>~/.calcurse/apts</code> + (ver la sección <a href="#basics_files">Archivos de <code>calcurse</code></a>). + </dd> + <dt><code>-d <date|num>, --day <date|num></code></dt> + <dd> + Imprime las citas y eventos para la fecha dada o para el numero dado de días + próximos, dependiendo del formato del argumento. + Soporta dos posible formatos : + <ul> + <li>una fecha en la siguiente forma 'mm/dd/aaaa' (día/mes/año).</li> + <li>un numero 'n'.</li> + </ul> + En el primer caso, devolverá la lista de citas y eventos para la fecha especificada + mientras que en el segundo caso devolverá la lista de citas y eventos + para los 'n' próximos días. + Por ejemplo, tecleando <code>calcurse -d 3</code> + mostrara tus citas y eventos para hoy, mañana y pasado mañana. + <p class="rq"><span class="valorise">Nota:</span> + al igual que para la opción '-a' , el calendario desde donde se + leerán puede ser especificado usando la opción '-c' .</p> + </dd> + <dt><code>-h, --help</code></dt> + <dd> + Imprime un breve texto de ayuda describiendo las opciones soportadas en la + linea de comando y sale. + </dd> + <dt><code>-n, --next</code></dt> + <dd> + Imprime las citas para las próximas 24 horas y sale. + El tiempo indicado es el numero de horas y minutos que faltan hasta + la proxima cita. + <p class="rq"><span class="valorise">Nota:</span> + el calendario desde donde se leeran las citas puede ser especificado usando la opcion '-c'.</p> + </dd> + <dt><code>-t[num], --todo[=num]</code></dt> + <dd> + Imprime la lista de tareas pendientes ('ToDo') y sale. + Si se especifica la opcion <code>numero</code>, se mostraran todas las tareas pendientes que tengan la prioridad + igual a <code>numero</code>. + <p class="rq"><span class="valorise">Nota:</span> + la prioridad debe ser desde 1 (la mas alta) hasta 9 (la mas baja).</p> + </dd> + <dt><code>-v, --version</code></dt> + <dd> + Muestra la versión de <code>calcurse</code> y sale. + </dd> + <dt><code>-x, --export</code></dt> + <dd> + Exporta los datos del usuario a un formato iCalendar. Citas, eventos y tareas pendientes son convertidos y + mostrados en patalla. + <p class="rq"><span class="valorise">Nota:</span> + redirecciona la salida standard para exportar los datos a un archivo usando + un comando como este: + <code>$ calcurse --export > my_data.ics</code></p> + </dd> + </dl> + +<h3>4.1.2 Variable de entorno para i18n<a name="basics_invocation_variable"></a></h3> <p> <code>calcurse</code> puede ser compilado son soporte para lenguaje nativo (ver <a href="#install_requirements_gettext">librería <code>gettext</code> </a>). Así, si quieres ver los mensajes en tu lengua nativa, primero comprueba que esta disponible mirando en el fichero <code>po/LINGUAS</code>. Este fichero indica la lista de lenguas disponibles mostrando el código de dos - letras correspondiente (por ejemplo, <em>es</em> sería para español). + letras correspondiente (por ejemplo, <span class="emp">es</span> sería para español). Si no encuentras tu lengua, tu ayuda seria muy apreciada si pudieses traducir - <code>calcurse</code> (ver la sección <a href="#contribute">¿Como puedo ayudar?</a>.<br> - Si tu lengua esta disponible, arranca <code>calcurse</code> con el siguiente comando: - <pre> - LC_ALL=es_ES calcurse - </pre> - donde <em>es_ES</em> es el nombre locale en este ejemplo, pero puede ser remplazado - por el locale correspondiente a la lengua deseada.<br> + <code>calcurse</code> (ver la sección <a href="#contribute">¿Como puedo + ayudar?</a>.</p> +<p> + Si tu lengua esta disponible, arranca <code>calcurse</code> con el siguiente comando:</p> + <pre>LC_ALL=es_ES calcurse</pre> +<p> + donde <span class="emp">es_ES</span> es el nombre locale en este ejemplo, pero puede ser remplazado + por el locale correspondiente a la lengua deseada.</p> +<p> Debes especificar también tipo de caracteres 'charset' que se usara porque en algunos casos los acentos podrían no mostrarse correctamente. Este tipo de caracteres o 'charset' esta indicado al principio del archivo po correspondiente al lenguaje deseado. Como puedes ver en el archivo es.po se usa el tipo de caracteres iso-8859-1, entonces puedes iniciar <code>calcurse</code> - utilizando el siguiente comando: - <pre> - LC_ALL=es_ES.ISO8859-1 calcurse - </pre> - - + utilizando el siguiente comando:</p> + <pre>LC_ALL=es_ES.ISO8859-1 calcurse</pre> -<a name="basics_interface"></a><h2>Interfaz de usuario</h2> -<a name="basics_interface_noninteractive"></a><h3>Modo no-interactivo</h3> +<h2>4.2 Interfaz de usuario<a name="basics_interface"></a></h2> +<h3>4.2.1 Modo no-interactivo<a name="basics_interface_noninteractive"></a></h3> <p> - Cuando es llamado por lo menos con uno de los siguientes argumentos:<br> + Cuando es llamado por lo menos con uno de los siguientes argumentos: <code>-a</code>, <code>-d</code>, <code>-h</code>, - <code>-n</code>, <code>-t</code>, <code>-v</code>, <code>-x</code><br> + <code>-n</code>, <code>-t</code>, <code>-v</code>, <code>-x</code>, <code>calcurse</code> arranca en modo no-interactivo. Esto significa que se mostrara la información deseada, y después de esto, <code>calcurse</code> simplemente se cierra y eres - de nuevo devuelto al prompt del shell.<br> + de nuevo devuelto al prompt del shell.</p> +<p> De esta forma, uno puede añadir una linea como <code>'calcurse --todo --appointment'</code> en el archivo de inicialización de su entorno gráfico (X o consola) para ver, - cuando entras en el sistema; la lista de tareas, citas y eventos programadas para el día actual. - - + cuando entras en el sistema; la lista de tareas, citas y eventos + programadas para el día actual.</p> -<a name="basics_interface_interactive"></a><h3>Modo interactivo</h3> +<h3>4.2.2 Modo interactivo<a name="basics_interface_interactive"></a></h3> <p> Cuando es llamado sin ningún argumento o solo con la opción <code>-c</code>, <code>calcurse</code> arranca en modo interactivo. En este modo, se muestra una interfaz conteniendo tres paneles diferentes por los cuales puedes navegar usando la tecla 'TAB' (tabulador), mas una barra de notificaciones, mas una barra - de estado (ver la figura de abajo). + de estado (ver la figura de abajo).</p> <pre> panel de citas y eventos ---. .--- panel de calendario @@ -373,79 +404,105 @@ barra de estado </pre> +<p> El primer panel representa un calendario que permite iluminar un día en particular, el segundo contiene la lista de citas y eventos pertenecientes a ese día, y el ultimo contiene una lista de tareas pendientes (ToDo) pero que no están asignadas a ningún día - especifico.<br> - <font color="green"> - In the appointment panel, one can notice the <em>'(|)'</em> sign + especifico.</p> +<div class="todo"> +<p> + In the appointment panel, one can notice the <span class="emp">'(|)'</span> sign just in front of the date. This indicates the current phase of the moon. Depending on which is the current phase, the following signs can be - seen: - <ul> - <li>'<b> |) </b>': first quarter</li> - <li>'<b> (|) </b>': full moon</li> - <li>'<b> (| </b>': last quarter</li> - <li>'<b> | </b>': new moon</li> - <li>no sign: phase of the moon does not correspond to any of - the above ones</li> - </ul> - </font> - <p> + seen:</p> + <dl class="compact"> + <dt>'<code> |) </code>':</dt> + <dd>first quarter</dd> + <dt>'<code> (|) </code>':</dt> + <dd>full moon</dd> + <dt>'<code> (| </code>':</dt> + <dd>last quarter</dd> + <dt>'<code> | </code>':</dt> + <dd>new moon</dd> + <dt>no sign:</dt> + <dd>phase of the moon does not correspond to any of + the above ones</dd> + </dl> +</p> +</div> +<p> En la parte inferior de la pantalla hay una barra de estado, que indica las posibles acciones y sus correspondientes atajos de - teclado.<br> + teclado.</p> +<p> Justo encima de esta barra de estado esta la barra de notificaciones, que indica de izquierda a derecha : la fecha actual, la hora actual, el archivo de calendario actualmente en uso (en el ejemplo de arriba, el de citas, que es el fichero de calendario por defecto, ver la sección siguiente), y la cita mas cercana para las proximas 24 horas. En el ejemplo seria una comida - dentro de una hora y 20 minutos. - <p> - <u>Nota:</u> Algunas acciones, como editar o añadir un elemento, - requieren teclear algo de texto. Esto se hace con la ayuda del editor incorporado.<br> + dentro de una hora y 20 minutos.</p> + <p class="rq"><span class="valorise">Nota:</span> + Algunas acciones, como editar o añadir un elemento, + requieren teclear algo de texto. Esto se hace con la ayuda del editor + incorporado.</p> +<p> Dentro de este editor, si una linea es mas larga que el ancho de la pantalla, se mostrara un caracter como '>', '*', o '<' al final de la columna indicando que hay mas caracteres despues, antes y despues, o antes de la posicion actual, respectivamente. - La linea se movera horizontalmente si es necesario.<br> + La linea se movera horizontalmente si es necesario.</p> +<p> Por otra parte, hay algunos caracteres que se utilizan para editar. Aqui se indican los comandos de edicion disponibles - ('^' significa la tecla "control"):<br> - <ul> - <li><b>^a</b>: mueve el cursor al principio de la linea - <li><b>^b</b>: mueve el cursor para atras - <li><b>^d</b>: borra un caracter por delante - <li><b>^e</b>: mueve el cursor al final de la linea - <li><b>^f</b>: mueve el cursor para alante - <li><b>^h</b>: borra un caracter hacia atras - <li><b>^k</b>: borra desde el cursor hasta el final de la linea - <li><b>ESCAPE</b>: cancela la edicion - </ul> - -<a name="basics_files"></a><h2>Archivos de <code>calcurse</code></h2> + ('^' significa la tecla "control"): + <dl class="compact"> + <dt><code>^a</code>:</dt> + <dd>mueve el cursor al principio de la linea</dd> + <dt><code>^b</code>:</dt> + <dd>mueve el cursor para atras</dd> + <dt><code>^d</code>:</dt> + <dd>borra un caracter por delante</dd> + <dt><code>^e</code>:</dt> + <dd>mueve el cursor al final de la linea</dd> + <dt><code>^f</code>:</dt> + <dd>mueve el cursor para alante</dd> + <dt><code>^h</code>:</dt> + <dd>borra un caracter hacia atras</dd> + <dt><code>^k</code>:</dt> + <dd>borra desde el cursor hasta el final de la linea</dd> + <dt><code>ESCAPE</code></dt> + <dd>b>: cancela la edicion</dd> + </dl> +</p> + +<h2>4.3 Archivos de <code>calcurse</code><a name="basics_files"></a></h2> <p> La siguiente estructura se crea en tu directorio <code>$HOME</code> - la primera vez que se ejecuta <code>calcurse</code> : + la primera vez que se ejecuta <code>calcurse</code> :</p> <pre> - $HOME/.calcurse/ - |___conf - |___apts - |___todo - </pre> - El archivo <em>conf</em> contiene la configuración del usuario.<br> - El archivo <em>apts</em> contiene todos los eventos y citas del usuario.<br> - El archivo <em>todo</em> contiene la lista de tareas pendientes. - - -<a name="basics_help"></a><h2>Ayuda en linea</h2> +$HOME/.calcurse/ + |___conf + |___apts + |___todo + </pre> + <dl class="compact"> + <dt><code>conf</code>:</dt> + <dd>contiene la configuración del usuario.</dd> + <dt><code>apts</code>:</dt> + <dd>contiene todos los eventos y citas del usuario.</dd> + <dt><code>todo</code>:</dt> + <dd>contiene la lista de tareas pendientes.</dd> + </dl> + +<h2>4.4 Ayuda en linea<a name="basics_help"></a></h2> <p> En cualquier momento, puedes consultar el sistema de ayuda integrado presionando la tecla '?'. Una vez en la pantalla de ayuda, puedes acceder a la información acerca de un comando especifico presionando la tecla correspondiente a ese comando. +</p> -<a name="options"></a><h1>Opciones</h1> +<h1>5. Opciones<a name="options"></a></h1> <p> Todos los parámetros de <code>calcurse</code> se peden configurar desde el menú de Configuración disponible pulsando 'C'. Entonces aparecerá un @@ -455,55 +512,64 @@ de <code>calcurse</code> (en otras palabras, donde colocar los tres diferentes paneles en pantalla), y finalmente puedes elegir entre diferentes opciones generales pulsando 'G'. +</p> -<a name="options_general"></a><h2>Opciones generales</h2> +<h2>5.1 Opciones generales<a name="options_general"></a></h2> <p> Estas opciones controlan el comportamiento general en la forma - que se describe a continuación: - <ul> - <li><code>auto_guardar</code> (por defecto: <em>si</em>)<br> - Esta opción permite salvar automáticamente los datos del usuario - (si esta fijada en <em>si</em>) cuando se sale del programa.<br> - <em>Aviso:</em> Los datos no serán guardados automáticamente si - <code>auto_guardar</code> esta fijada en <em>no</em>. Esto significa que - el usuario debe pulsar 'S' (guardar) para guardar sus modificaciones - antes de salir.<br> - <br> - <li><code>confirmar_salir</code> (por defecto: <em>si</em>)<br> - Si se fija en <em>si</em>, se requerirá confirmación antes de salir, - de otra forma cuando se pulse 'Q' causara que <code>calcurse</code> - se cierre sin esperar confirmación del usuario.<br> - <br> - <li><code>confirmar_borrar</code> (por defecto: <em>si</em>)<br> - Si se fija esta opción en <em>si</em>, cuando se pulse 'D' para - borrar una anotación (bien sea un <em>ToDo - (tarea pendiente)</em>, <em>cita</em>, - o <em>evento</em>), se requerirá confirmación del usuario antes de borrar - de la lista la anotación seleccionada. - De otra forma, no será necesaria confirmación antes de borrar la anotación.<br> - <br> - <li><code>saltar_dialogos_sistema</code> (por defecto: <em>no</em>)<br> - Fijando esta opción en <em>si</em> causará la omisión de los diálogos - del sistema relativos al guardado y carga de los datos. - Esto puede ser útil para acelerar los procesos de entrada y salida al programa.<br> - <br> - <li><code>saltar_barra_progreso</code> (por defecto: <em>no</em>)<br> - Si se fija en <em>si</em>, ocasionara la desaparición de la barra de progreso - que normalmente se muestra cuando se salvan datos a un archivo. - Si esta fijada en <em>no</em>, se mostrará esta barra, conjuntamente con - el nombre del archivo que se esta guardando - (ver sección <a href="#basics_files">Archivos de <code>calcurse</code></a>).<br> - <br> - <li><code>empezar_semana_en_lunes</code> (por defecto: <em>si</em>)<br> - Uno puede elegir entre el Lunes o el Domingo como primer día de la semana. - Si la opción <em>empezar_semana_en_lunes</em> esta fijada en - <em>si</em>, el Lunes será el primer día de la semana en la vista del calendario. - Por el contrario, si esta opción esta fijada en <em>no</em>, entonces el Domingo - será el primer día de la semana. - </ul> - - -<a name="options_colors"></a><h2>Color (temas)</h2> + que se describe a continuación:</p> + <dl> + <dt><code>auto_guardar</code> + (por defecto: <span class="emp">si</span>)</dt> + <dd>Esta opción permite salvar automáticamente los datos del usuario + (si esta fijada en <span class="emp">si</span>) cuando se sale + del programa. + <p class="rq"><span class="valorise">aviso:</span> + Los datos no serán guardados automáticamente si + <code>auto_guardar</code> esta fijada en <span class="emp">no</span>. + Esto significa que el usuario debe pulsar 'S' (guardar) para guardar + sus modificaciones antes de salir.</p> + </dd> + <dt><code>confirmar_salir</code> + (por defecto: <span class="emp">si</span>)</dt> + <dd>Si se fija en <span class="emp">si</span>, se requerirá confirmación antes de salir, + de otra forma cuando se pulse 'Q' causara que <code>calcurse</code> + se cierre sin esperar confirmación del usuario. + </dd> + <dt><code>confirmar_borrar</code> + (por defecto: <span class="emp">si</span>)</dt> + <dd>Si se fija esta opción en <span class="emp">si</span>, cuando se pulse 'D' para + borrar una anotación (bien sea un <span class="emp">ToDo + (tarea pendiente)</span>, <span class="emp">cita</span>, + o <span class="emp">evento</span>), se requerirá confirmación del usuario antes de borrar + de la lista la anotación seleccionada. + De otra forma, no será necesaria confirmación antes de borrar la anotación. + </dd> + <dt><code>saltar_dialogos_sistema</code> + (por defecto: <span class="emp">no</span>)</dt> + <dd>Fijando esta opción en <span class="emp">si</span> causará la omisión de los diálogos + del sistema relativos al guardado y carga de los datos. + Esto puede ser útil para acelerar los procesos de entrada y salida al programa. + </dd> + <dt><code>saltar_barra_progreso</code> + (por defecto: <span class="emp">no</span>)</dt> + <dd>Si se fija en <span class="emp">si</span>, ocasionara la desaparición de la barra de progreso + que normalmente se muestra cuando se salvan datos a un archivo. + Si esta fijada en <span class="emp">no</span>, se mostrará esta barra, conjuntamente con + el nombre del archivo que se esta guardando + (ver sección <a href="#basics_files">Archivos de <code>calcurse</code></a>). + </dd> + <dt><code>empezar_semana_en_lunes</code> + (por defecto: <span class="emp">si</span>)</dt> + <dd>Uno puede elegir entre el Lunes o el Domingo como primer día de la semana. + Si la opción <span class="emp">empezar_semana_en_lunes</span> esta fijada en + <span class="emp">si</span>, el Lunes será el primer día de la semana en la vista del calendario. + Por el contrario, si esta opción esta fijada en <span class="emp">no</span>, entonces el Domingo + será el primer día de la semana. + </dd> + </dl> + +<h2>5.2 Color (temas)<a name="options_colors"></a></h2> <p> El tema de color de <code>calcurse</code> puede se configurado para cubrir las necesidades del usuario. Para cambiar el tema por defecto, la @@ -513,21 +579,25 @@ para moverse y 'X'o la barra espaciadora para seleccionar el color, el usuario puede previsualizar el tema que se aplicara. Tambien es posible mantener los colores por defecto del terminal seleccionando - la opcion correspondiente en la lista. - <u>Notas:</u> - <ul> - <li> Dependiendo de tu tipo de terminal y del valor de la variable de + la opcion correspondiente en la lista.</p> +<div class="todo"> +<p> + The chosen color theme will then be applied to the panel borders, + to the titles, to the keystrokes, and to general informations + displayed inside status bar. A black and white theme is also + available, in order to support non-color terminals.</p> +</div> + <p class="rq"><span class="valorise">Notas:</span> + Dependiendo de tu tipo de terminal y del valor de la variable de entorno <code>$TERM</code>, color puede no estar soportado. En ese caso, si intentas cambiar los colores aparecerá un mensaje de error - puesto que tu terminal no soporta esta característica.<br> - <br> - <li> Si sabes que tu terminal soporta colores pero no puedes conseguir + puesto que tu terminal no soporta esta característica. + Si sabes que tu terminal soporta colores pero no puedes conseguir que <code>calcurse</code> los muestre, intenta fijar tu variable <code>$TERM</code> - a otro valor. (como por ejemplo <em>xterm-xfree86</em>). - </ul> - + a otro valor. (como por ejemplo <span class="emp">xterm-xfree86</span>). + </p> -<a name="options_layout"></a><h2>Configuración de la disposición</h2> +<h2>5.3 Configuración de la disposición<a name="options_layout"></a></h2> <p> La disposición corresponde a la posición de los paneles dentro de la pantalla de <code>calcurse</code>. La disposición por defecto @@ -535,187 +605,196 @@ del terminal, el panel de 'ToDo' (tareas pendientes) en la esquina inferior derecha, mientras que el panel de citas se muestra en la parte izquierda de la pantalla (ver la figura de la sección <a href="#basics_interface_interactive">Modo interactivo</a> - como ejemplo de la disposición por defecto).<br> + como ejemplo de la disposición por defecto). Eligiendo otra disposición en la pantalla de configuración, el usuario puede modificar la apariencia de <code>calcurse</code> que mejor se adapte a sus - necesidades colocando los diferentes paneles donde los necesite. + necesidades colocando los diferentes paneles donde los necesite.</p> -<a name="options_notify"></a><h2>Ajustes de la barra de notificaciones</h2> +<h2>5.4 Ajustes de la barra de notificaciones<a name="options_notify"></a></h2> <p> - Las siguientes opciones se usan para modificar el comportamiento de la barra de notificaciones: - <ul> - <li><code>mostrar-barra-notificaciones</code> (por defecto: <em>si</em>)<br> - Esta opción indica si quieres que se muestre la barra de notificaciones o no.<br> - <br> - <li><code>fecha_barra-notificaciones</code> (por defecto: <em>%a %F</em>)<br> - Con esta opcion puedes especificar el formato que se usara para mostrar la fecha + Las siguientes opciones se usan para modificar el comportamiento de la barra de notificaciones:</p> + <dl> + <dt><code>mostrar-barra-notificaciones</code> + (por defecto: <span class="emp">si</span>)</dt> + <dd>Esta opción indica si quieres que se muestre la barra de notificaciones o no. + </dd> + <dt><code>fecha_barra-notificaciones</code> + (por defecto: <span class="emp">%a %F</span>)</dt> + <dd>Con esta opcion puedes especificar el formato que se usara para mostrar la fecha actual dentro de la barra de notificaciones. Puedes ver todos los formatos posibles - tecleando <tt>man 3 strftime</tt> en un terminal.<br> - <br> - <li><code>hora_barra-notificaciones</code> (por defecto: <em>%T</em>)<br> - Con esta opcion puedes especificar el formato que se usara para mostrar la + tecleando <code>man 3 strftime</code> en un terminal. + </dd> + <dt><code>hora_barra-notificaciones</code> + (por defecto: <span class="emp">%T</span>)</dt> + <dd>Con esta opcion puedes especificar el formato que se usara para mostrar la hora actual dentro de la barra de notificaciones. Puedes ver todos los formatos - posibles tecleando <tt>man 3 strftime</tt> dentro de un terminal.<br> - <br> - <li><code>alarma_barra-notificaciones</code> (por defecto: <em>300</em>)<br> - Cuando tienes una cita dentro de los siguientes 'alarma_barra-notificaciones' + posibles tecleando <code>man 3 strftime</code> dentro de un terminal. + </dd> + <dt><code>alarma_barra-notificaciones</code> + (por defecto: <span class="emp">300</span>)</dt> + <dd>Cuando tienes una cita dentro de los siguientes 'alarma_barra-notificaciones' segundos, la referencia a esa cita dentro de la barra de notificaciones comienza a parpadear. - Además, se lanzara el comando definido por la opcion <em>comando_barra-notificaciones</em>. + Además, se lanzara el comando definido por la opcion <span class="emp">comando_barra-notificaciones</span>. De esta forma, se alerta al usuario y este sabe que - detro de poco tiene una cita.<br><br> - <li><code>comando_barra-notificaciones</code> (por defecto: <em>printf '\a'</em>)<br> - Esta opcion indica que comando se lanzara cuando haya una cita proxima marcada como + detro de poco tiene una cita. + </dd> + <dt><code>comando_barra-notificaciones</code> + (por defecto: <span class="emp">printf '\a'</span>)</dt> + <dd>Esta opcion indica que comando se lanzara cuando haya una cita proxima marcada como "inportante". Este comando sera pasado al shell del usuario que lo interpretara. Para saber que tipo de shell debe usarse, se utilizara el contenido dela variable de - entorno <code>$SHELL</code>. Si esta variable no esta seleccionada, se usara <code>/bin/sh</code>.<br> - <u>Ejemplo:</u> Digamos que el comando <code>mail</code> esta disponible en el sistema del usuario, uno + entorno <code>$SHELL</code>. Si esta variable no esta seleccionada, se usara <code>/bin/sh</code>. + <p class="rq"><span class="valorise">Ejemplo:</span> + Digamos que el comando <code>mail</code> esta disponible en el sistema del usuario, uno puede usar este comando para ser notificado por correo electronico cuando se acerque la cita - (la descripcion de la cita se mencionara en el cuerpo del mensaje): - <pre> - calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com - </pre> - </ul> - - -<a name="known_bugs"></a><h1>Bugs conocidos</h1> + (la descripcion de la cita se mencionara en el cuerpo del mensaje):</p> + <code> +calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com + </code> + </dd> + </dl> + +<h1>6. Bugs conocidos<a name="known_bugs"></a></h1> <p> Aparece una incorrecta iluminación de las anotaciones cuando se usa el tema calcurse blanco y negro conjuntamente con la variable <code>$TERM</code> - fijada a <em>xterm-color</em>. + fijada a <span class="emp">xterm-color</span>. Para solucionar este bug, y tal como fue anunciado por Thomas E. Dickey - (que mantiene <code>xterm</code>), <em>xterm-xfree86</em> - puede ser usado en vez de <em>xterm-color</em> para fijar la variable <code>$TERM</code><br> - <blockquote> + (que mantiene <code>xterm</code>), <span class="emp">xterm-xfree86</span> + puede ser usado en vez de <span class="emp">xterm-color</span> para + fijar la variable <code>$TERM</code>:</p> + <blockquote class="rq"> "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>Informar de bugs y comentarios</h1> +<h1>7. Informar de bugs y comentarios<a name="bugs"></a></h1> <p> - Por favor envía los informes de bugs y tus comentarios a : - <pre> - calcurse@culot.org - </pre> - o al autor: - <pre> - frederic@culot.org - </pre> + Por favor envía los informes de bugs y tus comentarios a :</p> + <pre>calcurse @ culot . org</pre> +<p> + o al autor:</p> + <pre>frederic @ culot . org</pre> -<a name="contribute"></a><h1>¿Como contribuir?</h1> +<h1>8. ¿Como contribuir?<a name="contribute"></a></h1> <p> Si te gustaría contribuir al proyecto, puedes enviar tus comentarios acerca de lo que te gusta o no te gusta, y si hay alguna funcionalidad que echas de menos en <code>calcurse</code>. Por ahora, las posibles contribuciones están limitadas a la traducción - de la documentación y mensajes de error de <code>calcurse</code>. <br> - <br> - <u>Nota:</u> Cualquier ayuda para la internacionalización de <code>calcurse</code> + de la documentación y mensajes de error de <code>calcurse</code>. </p> + <p class="rq"><span class="valorise">Nota:</span> + Cualquier ayuda para la internacionalización de <code>calcurse</code> será muy bienvenida, pero antes de contribuir envía en email a : - <code>calcurse-i18n@culot.org</code> para saber si alguien ha empezado ya - el proceso de traducción a tu lengua. + <code>calcurse-i18n @ culot . org</code> para saber si alguien ha empezado ya + el proceso de traducción a tu lengua.</p> -<a name="contribute_documentation"></a><h2>Traduciendo la documentación</h2> +<h2>8.1 Traduciendo la documentación<a name="contribute_documentation"></a></h2> <p> - El directorio <em>doc/</em> del paquete fuente ya contiene versiones traducidas + El directorio <span class="emp">doc/</span> del paquete fuente ya contiene versiones traducidas del manual de <code>calcurse</code>. Aunque si el manual no esta aun disponible - en tu lengua nativa, sería de gran ayuda si tu pudieses traducirlo.<br> + en tu lengua nativa, sería de gran ayuda si tu pudieses traducirlo.</p> +<p> Para hacerlo, únicamente copia uno de los archivos de los manuales existentes - de <code>manual_XX.html</code>, donde <em>XX</em> identifica tu lengua. Entonces + de <code>manual_XX.html</code>, donde <span class="emp">XX</span> identifica tu lengua. Entonces traduce este nuevo archivo creado y envía un email al autor (ver <a href="#bugs">Informar - de bugs y comentarios</a>), para que pueda ser incluido en la nueva edición de <code>calcurse</code>. + de bugs y comentarios</a>), para que pueda ser incluido en la nueva + edición de <code>calcurse</code>.</p> -<a name="contribute_i18n"></a><h2><code>calcurse</code> i18n</h2> +<h2>8.2 <code>calcurse</code> i18n<a name="contribute_i18n"></a></h2> <p> Como ya se ha mencionado, las utilidades de <code>gettext</code> son usadas por <code>calcurse</code> para producir mensajes en diferentes lenguas. Esta sección proporciona información acerca de como traducir estos mensajes a tu lengua nativa. Por otra parte este 'como' es deliberadamente incompleto, centrado específicamente en trabajar con <code>gettext</code> para <code>calcurse</code>. - Para una información mas completa deberás dirigirte al manual de <code>GNU gettext</code> en: - <pre> - http://www.gnu.org/software/gettext/manual/ - </pre> + Para una información mas completa deberás dirigirte al manual de <code>GNU gettext</code> en:</p> + <pre>http://www.gnu.org/software/gettext/manual/</pre> +<p> Básicamente, hay tres tipos de personas diferentes que están involucradas en la cadena de traducción: programadores, coordinadores de lenguaje y traductores. Después de una rápida descripción de como funcionan las cosas, las tareas del - traductor se describen a continuación. + traductor se describen a continuación.</p> - -<a name="contribute_i18n_overview"></a><h3>Descripción</h3> +<h3>8.2.1 Descripción<a name="contribute_i18n_overview"></a></h3> <p> Para que se muestren mensajes en la lengua nativa del usuario, se requieren - dos pasos: <em>internacionalización</em> - (i18n) y <em>localización</em> (l10n). i18n se refiere a como hacer que + dos pasos: <span class="emp">internacionalización</span> + (i18n) y <span class="emp">localización</span> (l10n).</p> +<p> + i18n se refiere a como hacer que <code>calcurse</code> soporte múltiples lenguas. Esto es realizado por programadores, quienes seleccionan los textos traducibles y - proporcionan una manera de que se muestren traducidos en el arranque. l10n se + proporcionan una manera de que se muestren traducidos en el + arranque.</p> +<p> + l10n se refiere a como hacer que el <code>calcurse</code> internacionalizado se adapte a la lengua especifica del usuario, p.e. traduciendo las sentencias previamente marcadas por los desarrolladores y seleccionando el entorno correcto - para que <code>calcurse</code> utilice el resultado de esta traducción.<br> <br> - + para que <code>calcurse</code> utilice el resultado de esta traducción.</p> +<p> Entonces, las sentencias traducibles son primero marcadas por los programadores dentro de el código fuente de los archivos en código <code>C</code>, y después recogidas en un archivo - plantilla (<em>calcurse.pot</em> - la extensión <em>pot</em> significa - <em>portable object template</em>). El contenido de + plantilla (<span class="emp">calcurse.pot</span> - la extensión <span class="emp">pot</span> significa + <span class="emp">portable object template</span>). El contenido de esta plantilla es entonces combinado con los ficheros de traducción - para cada lengua (<em>fr.po</em> para francés por ejemplo - - donde <em>po</em> significa <em>portable object</em>, lo cual quiere decir + para cada lengua (<span class="emp">fr.po</span> para francés por ejemplo - + donde <span class="emp">po</span> significa <span class="emp">portable object</span>, lo cual quiere decir que puede ser leído y editado por humanos). Un equipo de traducción dado, cogería este archivo, traduciría estas sentencias y se las mandaría de nuevo a los desarrolladores. En el momento de la compilación, una versión binaria de esta archivo (por razones de eficacia) producirá - (<em>fr.mo</em> - donde <em>mo</em> significa <em>machine - object</em>, lo que quiere decir que puede ser leído por programas), y entonces + (<span class="emp">fr.mo</span> - donde <span class="emp">mo</span> significa <span class="emp">machine + object</span>, lo que quiere decir que puede ser leído por programas), y entonces instalado. Ahora <code>calcurse</code> utilizara este archivo en el arranque, traduciendo las sentencias acorde con la configuración del locale del usuario. +</p> - -<a name="contribute_i18n_translator"></a><h3>Tareas del traductor</h3> +<h3>8.2.2 Tareas del traductor<a name="contribute_i18n_translator"></a></h3> <p> Supongamos que alguien quiere iniciar la traducción de una nueva lengua. - Estos son los pasos a seguir: + Estos son los pasos a seguir:</p> <ul> <li>Primero, localiza cual es el nombre del locale. Por ejemplo, para francés es 'fr_FR', o simplemente 'fr'. Este es el valor que el usuario deberá poner es su variable de entorno <code>LC_ALL</code> para que el software sea traducido - (ver <a href="#basics_invocation_variable">Variable de entorno para i18n</a>).<br> - <br> - <li>Entonces, entra en el directorio <em>po/</em> y crea un nuevo archivo-po - desde el archivo plantilla usando el siguiente comando: - <pre> - 'msginit -i calcurse.pot -o fr.po -l fr --no-translator' - </pre> + (ver <a href="#basics_invocation_variable">Variable de entorno para i18n</a>).</li> + <li>Entonces, entra en el directorio <span class="emp">po/</span> y crea un nuevo archivo-po + desde el archivo plantilla usando el siguiente comando: + <code>'msginit -i calcurse.pot -o fr.po -l fr --no-translator'</code> Si no tienes instalado <code>msginit</code> en tu sistema, - simplemente copia el archivo <em>calcurse.pot</em> a - <em>fr.po</em> y edita la cabecera a mano.<br> - Ahora, teniendo el archivo <em>fr.po</em>, estas preparado para empezar. - </ul> - + simplemente copia el archivo <span class="emp">calcurse.pot</span> a + <span class="emp">fr.po</span> y edita la cabecera a mano.</li> + </ul> +<p> + Ahora, teniendo el archivo <span class="emp">fr.po</span>, estas preparado para empezar. +</p> -<a name="contribute_i18n_po-files"></a><h3>Archivos-po</h3> +<h3>8.2.3 Archivos-po<a name="contribute_i18n_po-files"></a></h3> <p> El formato de los archivos-po es muy simple. De hecho, los archivos-po - están formados de cuatro cosas: + están formados de cuatro cosas:</p> <ol> - <li><em>lineas de localización:</em> te dicen donde están las sentencias + <li><span class="emp">lineas de localización:</span> te dicen donde están las sentencias (nombre del archivo y numero de linea), en caso de que necesites un poco - mas de contexto. - <li><em>lineas msgid:</em> las sentencias a traducir. - <li><em>lineas msgstr:</em> las sentencias traducidas. - <li><em>lineas con prefijo '#':</em> comentarios (algunos con un significado - especial, como veremos más abajo). + mas de contexto.</li> + <li><span class="emp">lineas msgid:</span> las sentencias a traducir.</li> + <li><span class="emp">lineas msgstr:</span> las sentencias traducidas.</li> + <li><span class="emp">lineas con prefijo '#':</span> comentarios (algunos con un significado + especial, como veremos más abajo).</li> </ol> - Básicamente, todo lo que tienes que hacer es llenar las lineas <em>msgstr</em> - con la traducción de la linea <em>msgid</em> de encima. - <p> - <u>Algunas notas:</u> - <ul> - <li><em>Sentencias Fuzzy</em><br> - Encontraras sentencias marcadas con un comentario <code>"#, fuzzy"</code>. +<p> + Básicamente, todo lo que tienes que hacer es llenar las lineas <span class="emp">msgstr</span> + con la traducción de la linea <span class="emp">msgid</span> de encima.</p> +<p> + <span class="valorise">Algunas notas:</span> + <dl> + <li><span class="emp">Sentencias Fuzzy</span></dt> + <dd>Encontraras sentencias marcadas con un comentario <code>"#, fuzzy"</code>. <code>calcurse</code> no utilizara las traducciones de ese tipo de sentencias hasta que tu elimines este comentario. Si una sentencia es fuzzy significa que ya ha sido traducida pero que desde entonces ha sido @@ -727,10 +806,9 @@ traducción puede no ser muy precisa y necesitara ser modificada. Una vez que has acabado y estas satisfecho con la traducción, tan solo elimina el comentario <code>"#, fuzzy"</code> y la traducción podrá ser usada de nuevo - en <code>calcurse</code>.<br> - <br> - <li><em>Sentencias c-format y sentencias especiales</em><br> - Algunas sentencias tienen el siguiente comentario: <code>"#, + en <code>calcurse</code>.</dd> + <dt><span class="emp">Sentencias c-format y sentencias especiales</span></dt> + <dd>Algunas sentencias tienen el siguiente comentario: <code>"#, c-format"</code>. Esto te esta diciendo que partes de la sentencia a traducir tienen un significado especial para el programa, puede ser que la sentencia contenga alguna variable, como por ejemplo % , si ves algo como esto <code>"%s"</code>, @@ -739,142 +817,135 @@ variables que pueda contener. También hay sentencias que contienen \ , como por ejemplo <code>\n</code> o <code>\t</code>, lo primero significa un final de linea y lo otro una tabulación, así pues, puedes traducir la sentencia pero con cuidado de no - modificar estos símbolos.<br> - <br> - <li><em>Las traducciones pueden ser excesivamente largas</em><br> - Si las lineas son demasiado largas, pueden ser partidas de la siguiente forma: + modificar estos símbolos.</dd> + <dt><span class="emp">Las traducciones pueden ser excesivamente largas</span></dt> + <dd>Si las lineas son demasiado largas, pueden ser partidas de la siguiente forma: <pre> - msgid "" - "alguna linea muy larga" - "otra linea" - </pre> - <li><em>Cabecera del archivo-po</em><br> - Al principio del archivo-po, la primera sentencia forma una cabecera, +msgid "" +"alguna linea muy larga" +"otra linea" + </pre></dd> + <dt><span class="emp">Cabecera del archivo-po</span></dt> + <dd>Al principio del archivo-po, la primera sentencia forma una cabecera, donde hay varios tipos de información. Lo mas importante es el 'charset'. Suele parecerse a esto: <pre> - "Content-Type: text/plain; charset=utf-8\n" +"Content-Type: text/plain; charset=utf-8\n" </pre> Debes cumplimentar también el campo 'Last-Translator' (último traductor), para que los potenciales contribuidores puedan contactar contigo si ellos quieren colaborar en el equipo de traducción, o hacer algún tipo de corrección sobre las traducciones. Puedes poner solo tu nombre/nick o añadir tu dirección de email, por ejemplo: <pre> - "Last-Translator: Frederic Culot <frederic@culot.org>\n" - </pre> - <li><em>Comentarios</em><br> - Añadir comentarios (lineas que comiencen con el carácter '#') puede ser una buena manera - de evitar problemas o dificultades a los correctores u otros miembros de tu equipo.<br> - <br> - <li><em>Tamaño de las sentencias</em><br> - <code>calcurse</code> es un programa basado en curses/consola, así que puede ser muy dependiente +"Last-Translator: Frederic Culot <frederic@culot.org>\n" + </pre></dd> + <dt><span class="emp">Comentarios</span></dt> + <dd>Añadir comentarios (lineas que comiencen con el carácter '#') puede ser una buena manera + de evitar problemas o dificultades a los correctores u otros miembros de tu equipo.</dd> + <dt><span class="emp">Tamaño de las sentencias</span></dt> + <dd><code>calcurse</code> es un programa basado en curses/consola, así que puede ser muy dependiente del tamaño del terminal donde se ejecute (numero de columnas). Piensa en ello cuando lo traduzcas. A menudo una sentencia puede colocarse en una sola linea (la longitud standard es de 80 caracteres). - No traduzcas a lo loco, intenta ver donde se mostrara la sentencia y adapta a ello tu traducción.<br> - <br> - <li><em>Algunas herramientas útiles</em><br> + No traduzcas a lo loco, intenta ver donde se mostrara la sentencia y adapta a ello tu traducción. + </dd> + <dt><span class="emp">Algunas herramientas útiles</span></dt> El formato de los archivos-po es muy simple, y puede ser editado con casi cualquier editor, pero si lo prefieres, hay unas pocas herramientas especializadas que pueden resultarte interesantes para traducir: <ul> <li><code>poEdit</code> (<a href="http://www.poedit.org/" target="_blank"> - http://www.poedit.org/</a>) + http://www.poedit.org/</a>)</li> <li><code>KBabel</code> (<a href="http://i18n.kde.org/tools/kbabel/" target="_blank"> - http://i18n.kde.org/tools/kbabel/</a>) + http://i18n.kde.org/tools/kbabel/</a>)</li> <li><code>GTranslator</code> (<a href="http://gtranslator.sourceforge.net/" target="_blank"> - http://gtranslator.sourceforge.net/</a>) - <li><code>Emacs</code> en modo po - <li><code>Vim</code> en modo po + http://gtranslator.sourceforge.net/</a>)</li> + <li><code>Emacs</code> en modo po</li> + <li><code>Vim</code> en modo po</li> </ul> - <br> - <li><em>Y finalmente</em><br> - Espero que te hayas divertido contribuyendo a un mundo mas internacionalizado :) Si tienes alguna - pregunta no dudes en contactar conmigo en <em>frederic@culot.org</em>. - </ul> - - -<a name="links"></a><h1>Enlaces</h1> - + </dd>> + <dt><span class="emp">Y finalmente</span></dt> + <dd>Espero que te hayas divertido contribuyendo a un mundo mas internacionalizado :) Si tienes alguna + pregunta no dudes en contactar conmigo en + <span class="emp">frederic @ culot . org</span>.</dd> + </dl> + +<h1>9.Enlaces<a name="links"></a></h1> <p> Esta sección contiene enlaces y referencias que pueden ser de tu interés. +</p> - -<a name="links_homepage"></a><h2>Pagina web de <code>calcurse</code></h2> +<h2>9.1 Pagina web de <code>calcurse</code><a name="links_homepage"></a></h2> <p> - La pagina web de <code>calcurse</code> es: - <pre> - http://culot.org/calcurse - </pre> + La pagina web de <code>calcurse</code> es: </p> + <pre>http://culot.org/calcurse</pre> -<a name="links_list"></a><h2>Lista de anuncios de <code>calcurse</code></h2> +<h2>9.2 Lista de anuncios de <code>calcurse</code><a name="links_list"></a></h2> <p> Si estas interesado en el proyecto y quieres ser avisado cuando salga una nueva versión, puedes suscribirte a la lista de anuncios de <code>calcurse</code>. Si lo haces, recibirás un email tan pronto como una nueva funcionalidad se añada a - <code>calcurse</code>.<br> + <code>calcurse</code>.</p> +<p> Para suscribirte a la lista, envía un email a : - <code>calcurse-announce@culot.org</code> poniendo "subscribe" - en el asunto. + <span class="emp">calcurse-announce @ culot . org</span> poniendo "subscribe" + en el asunto.</p> -<a name="links_rss"></a><h2><code>calcurse</code> RSS feed</h2> +<h2>9.3 <code>calcurse</code> RSS feed<a name="links_rss"></a></h2> <p> Otra posibilidad para enterarte de cuando aparecen nuevas versiones de Calcurse - es seguir el RSS feed en: - <pre> - http://culot.org/calcurse/news_rss.xml - </pre> + es seguir el RSS feed en:</p> + <pre>http://culot.org/calcurse/news_rss.xml</pre> +<p> Este RSS feed es actualizado cada vez que hay una nueva version de Calcurse disponible - describiendo las nuevas caracteristicas. + describiendo las nuevas caracteristicas.</p> - -<a name="thanks"></a><h1>Gracias a ...</a></h1> +<h1>10. Gracias a ...<a name="thanks"></a></h1> <p> Es la hora de dar las gracias a personas sin las que este programa ¡ no existiría ! Por eso esta es una lista de las personas que contribuyeron y a las que me gustaría dar las gracias : <ul> - <li>Alex por sus patches, ayuda y notas con la programación <code>C</code> - <li>Gwen por probarlo y las discusiones sobre como mejorar <code>calcurse</code> - <li>Herbert por hacer el paquete <code>calcurse</code> para FreeBSD - <li>Zul por hacer el paquete <code>calcurse</code> para NetBSD - <li>Wain por hacer el paquete <code>calcurse</code> para Archlinux + <li>Alex por sus patches, ayuda y notas con la programación <code>C</code></li> + <li>Gwen por probarlo y las discusiones sobre como mejorar <code>calcurse</code></li> + <li>Herbert por hacer el paquete <code>calcurse</code> para FreeBSD</li> + <li>Zul por hacer el paquete <code>calcurse</code> para NetBSD</li> + <li>Wain, Steffen y Ronald por hacer el paquete <code>calcurse</code> para Archlinux</li> <li>Kevin, Ryan, y fEnIo por hacer el paquete para <code>calcurse</code> - para Debian y Ubuntu - <li>Steffen por hacer el paquete <code>calcurse</code> para Archlinux - <li>Pascal por hacer el paquete <code>calcurse</code> para Slackware + para Debian y Ubuntu</li> + <li>Pascal por hacer el paquete <code>calcurse</code> para Slackware</li> <li>Alexandre por hacer el paquete <code>calcurse</code> para Mac OsX y - Darwin - <li>Igor por hacer el paquete <code>calcurse</code> para ALT Linux - <li>Joel por su script del calendario que inspiro la vista de calendario de <code>calcurse</code> - <li>Michael Schulz y Chris M. por la traducción al alemán de <code>calcurse</code> y su manual - <li>Neil Williams por la traducción al ingles - <li>Tony por el patch que me ha ayudado a implementar la funcion recur_item_inday() - <li>José López por la traducción al Español de <code>calcurse</code> y su manual - <li>Jeremy Roon por la traducción al holandes + Darwin</li> + <li>Igor por hacer el paquete <code>calcurse</code> para ALT Linux</li> + <li>Joel por su script del calendario que inspiro la vista de calendario de <code>calcurse</code> </li> + <li>Michael Schulz y Chris M. por la traducción al alemán de <code>calcurse</code> y su manual</li> + <li>Neil Williams por la traducción al ingles</li> + <li>Tony por el patch que me ha ayudado a implementar la funcion recur_item_inday()</li> + <li>José López por la traducción al Español de <code>calcurse</code> y su manual</li> + <li>Jeremy Roon por la traducción al holandes</li> <li>a la gente que ha escrito softwares que me gustan y que me inspiraron, especialmente : <ul> - <li><code>vim</code> por las teclas de desplazamiento - <li><code>orpheus</code> y <code>abook</code> por la documentación - <li><code>pine</code> and <code>aptitude</code> - por la interfaz de usuario - </ul> + <li><code>vim</code> por las teclas de desplazamiento</li> + <li><code>orpheus</code> y <code>abook</code> por la documentación</li> + <li><code>pine</code> and <code>aptitude</code> + por la interfaz de usuario</li> + </ul></li> </ul> - <br> +</p> +<p> Y por último, muchas muchas gracias a todos los usuarios de <code>calcurse</code> - que me han enviado sus comentarios. - -<hr> -<small><em> -Copyright (c) 2004-2007 Frédéric Culot<br> -Traducido al Español por José López -<code><testinground.at.gmail.dot.com></code><br> -Calcurse version 1.9 - Last change: Aug 18, 2007 -</em></small> - + que me han enviado sus comentarios.</p> + +<div class="footer"> + Copyright (c) 2004-2008 Frédéric Culot<br> + Traducido al Español por José López + <code><testinground .at. gmail .dot. com></code><br> + Calcurse version 2.0 - Last change: February 09, 2008<br> +</div> +</div> </body> </html> diff --git a/doc/manual_fr.html b/doc/manual_fr.html index f62ffdd..33c4f69 100755 --- a/doc/manual_fr.html +++ b/doc/manual_fr.html @@ -1,10 +1,10 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!-- /* - * $calcurse: manual_fr.html,v 1.13 2008/02/03 11:13:21 culot Exp $ + * $calcurse: manual_fr.html,v 1.14 2008/02/10 11:33:24 culot Exp $ * * Calcurse - text-based organizer - * Copyright (c) 2004-2007 Frederic Culot + * Copyright (c) 2004-2008 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 @@ -57,62 +57,62 @@ pour faire remonter les bogues et pour contribuer au développement de <div id="toc"> <h1>Table des matières</h1> <ul> - <li><a href="#intro">1. Introduction</a> + <li><a href="#intro">1. Introduction</a></li> <li><a href="#overview">2. Aperçu du logiciel</a> <ul> - <li><a href="#overview_history">2.1 Origine de Calcurse</a> - <li><a href="#overview_features">2.2 Caractéristiques importantes</a> - </ul> + <li><a href="#overview_history">2.1 Origine de Calcurse</a></li> + <li><a href="#overview_features">2.2 Caractéristiques importantes</a></li> + </ul></li> <li><a href="#install">3. Installation</a> <ul> <li><a href="#install_requirements">3.1 Pré-requis</a> <ul> - <li><a href="#install_requirements_ncurses">3.1.1 Librairie <code>ncurses</code></a> - <li><a href="#install_requirements_gettext">3.2.2 Librairie <code>gettext</code></a> - </ul> - <li><a href="#install_process">3.2 Processus d'installation</a> - </ul> + <li><a href="#install_requirements_ncurses">3.1.1 Librairie <code>ncurses</code></a></li> + <li><a href="#install_requirements_gettext">3.2.2 Librairie <code>gettext</code></a></li> + </ul></li> + <li><a href="#install_process">3.2 Processus d'installation</a></li> + </ul></li> <li><a href="#basics">4. Présentation générale</a> <ul> <li><a href="#basics_invocation">4.1 Invocation</a> <ul> - <li><a href="#basics_invocation_commandline">4.1.1 Arguments en ligne de commande</a> - <li><a href="#basics_invocation_variable">4.1.2 Variable d'environnement pour l'i18n</a> - </ul> + <li><a href="#basics_invocation_commandline">4.1.1 Arguments en ligne de commande</a></li> + <li><a href="#basics_invocation_variable">4.1.2 Variable d'environnement pour l'i18n</a></li> + </ul></li> <li><a href="#basics_interface">4.2 Interface utilisateur</a> <ul> - <li><a href="#basics_interface_noninteractive">4.2.1 Mode non-interactif</a> - <li><a href="#basics_interface_interactive">4.2.2 Mode Interactif</a> - </ul> - <li><a href="#basics_files">4.3 Fichiers</a> - <li><a href="#basics_help">4.4 Aide en ligne</a> - </ul> + <li><a href="#basics_interface_noninteractive">4.2.1 Mode non-interactif</a></li> + <li><a href="#basics_interface_interactive">4.2.2 Mode Interactif</a></li> + </ul></li> + <li><a href="#basics_files">4.3 Fichiers</a></li> + <li><a href="#basics_help">4.4 Aide en ligne</a></li> + </ul></li> <li><a href="#options">5. Options</a> <ul> - <li><a href="#options_general">5.1 Options générales</a> - <li><a href="#options_colors">5.2 Thèmes graphiques</a> - <li><a href="#options_layout">5.3 Disposition des panneaux</a> - <li><a href="#options_notify">5.4 Réglages de la barre de notification</a> - </ul> - <li><a href="#known_bugs">6. Bogues connus</a> - <li><a href="#bugs">7. Rapporter les bogues et commentaires</a> + <li><a href="#options_general">5.1 Options générales</a></li> + <li><a href="#options_colors">5.2 Thèmes graphiques</a></li> + <li><a href="#options_layout">5.3 Disposition des panneaux</a></li> + <li><a href="#options_notify">5.4 Réglages de la barre de notification</a></li> + </ul></li> + <li><a href="#known_bugs">6. Bogues connus</a></li> + <li><a href="#bugs">7. Rapporter les bogues et commentaires</a></li> <li><a href="#contribute">8. Comment contribuer?</a> <ul> - <li><a href="#contribute_documentation">8.1 Traduction de la documentation</a> + <li><a href="#contribute_documentation">8.1 Traduction de la documentation</a></li> <li><a href="#contribute_i18n">8.2 Traduction de <code>calcurse</code></a> <ul> - <li><a href="#contribute_i18n_overview">8.2.1 Aperçu</a> - <li><a href="#contribute_i18n_translator">8.2.2 Etapes de la traducion</a> - <li><a href="#contribute_i18n_po-files">8.2.3 Fichiers <code>po</code></a> - </ul> - </ul> + <li><a href="#contribute_i18n_overview">8.2.1 Aperçu</a></li> + <li><a href="#contribute_i18n_translator">8.2.2 Etapes de la traducion</a></li> + <li><a href="#contribute_i18n_po-files">8.2.3 Fichiers <code>po</code></a></li> + </ul></li> + </ul></li> <li><a href="#links">9. Liens</a> <ul> - <li><a href="#links_homepage">9.1 Site internet de <code>calcurse</code></a> - <li><a href="#links_list">9.2 Liste de diffusion de <code>calcurse</code></a> - <li><a href="#links_rss">9.3 Flux RSS</a> - </ul> - <li><a href="#thanks">10. Remerciements</a> + <li><a href="#links_homepage">9.1 Site internet de <code>calcurse</code></a></li> + <li><a href="#links_list">9.2 Liste de diffusion de <code>calcurse</code></a></li> + <li><a href="#links_rss">9.3 Flux RSS</a></li> + </ul></li> + <li><a href="#thanks">10. Remerciements</a></li> </ul> </div> @@ -215,7 +215,7 @@ disponibles. <p> <code>calcurse</code> s'aide de la librairie <code>gettext</code> pour le support de l'internationalisation - (noté <em>i18n</em> ci-après). Cela signifie que + (noté <span class="emp">i18n</span> ci-après). Cela signifie que <code>calcurse</code> peut fournir des messages multilingues s'il est compilé avec le support NLS (<span class="emp">Native Language Support</span> - <span class="emp">Support de Langage @@ -257,17 +257,18 @@ disponibles. <p> Vous devez tout d'abord décompresser l'archive source de la manière suivante :</p> - <pre>tar zxvf calcurse-1.9.tar.gz</pre> + <pre>tar zxvf calcurse-2.0.tar.gz</pre> <p> Une fois que vous remplissez tous les pré-requis nécessaires à l'installation, le processus de compilation est simple et suit - les trois étapes usuelles :</p> + les trois étapes usuelles : <ol> - <li><code>./configure</code> - <li><code>make</code> - <li><code>make install</code> (peut nécessiter les privilèges - super-utilisateur) + <li><code>./configure</code></li> + <li><code>make</code></li> + <li><code>make install</code> (peut nécessiter les privilèges + super-utilisateur)</li> </ol> +</p> <p> Vous pouvez obtenir la liste des options possibles en tapant <code>./configure --help</code>. @@ -276,7 +277,7 @@ disponibles. <h1>4. Présentation générale<a name="basics"></a></h1> <h2>4.1 Invocation<a name="basics_invocation"></a></h2> -<h3>4.2 Arguments en ligne de commande<a name="basics_invocation_commandline"></a></h3> +<h3>4.1.1 Arguments en ligne de commande<a name="basics_invocation_commandline"></a></h3> <p> Lors de son appel en ligne de commande, <code>calcurse</code> accepte les arguments suivants (les arguments courts ou longs @@ -285,7 +286,8 @@ disponibles. <dl> <dt><code>-a, --appointment</code></dt> - <dd> Affiche les rendez-vous pour la date du jour, puis quitte. + <dd> + Affiche les rendez-vous pour la date du jour, puis quitte. <p class="rq"><span class="valorise">Remarque:</span> le calendrier à utiliser peut être spécifié en utilisant l'option '-c'.</p> </dd> @@ -308,7 +310,7 @@ disponibles. Dans le premier cas, la liste des rendez-vous pour la date spécifiée sera affichée, alors que dans le deuxième cas, la liste des rendez-vous pour les 'n' - jours à venir sera retournée.<br> + jours à venir sera retournée. Par exemple, taper <code>calcurse -d 3</code> fera s'afficher les rendez-vous pour aujourd'hui, demain et après-demain. @@ -359,7 +361,7 @@ disponibles. </dl> -<h3>4.2.1 Variable d'environnement pour l'i18n<a name="basics_invocation_variable"></a></h3> +<h3>4.1.2 Variable d'environnement pour l'i18n<a name="basics_invocation_variable"></a></h3> <p> <code>calcurse</code> peut être compilé avec le support <span class="emp">NLS</span> (voir <a @@ -377,7 +379,7 @@ disponibles. <p> Si votre langue est disponible, lancez <code>calcurse</code> en utilisant la commande suivante : </p> - <pre> LC_ALL=fr_FR calcurse</pre> + <pre>LC_ALL=fr_FR calcurse</pre> <p>où <span class="emp">fr_FR</span> doit être remplacé par la <span class="emp">locale</span> (code de la langue suivi du code pays) correspondant à la traduction voulue.</p> @@ -417,7 +419,7 @@ disponibles. contient trois panneaux différents, qu'il est possible de sélectionner cycliquement en utilisant la touche 'TAB', ainsi que d'une barre de notification et une autre de status - (voir la figure ci-dessous).<p> + (voir la figure ci-dessous).</p> <pre> panneau rendez-vous---. .---panneau calendrier @@ -463,7 +465,7 @@ disponibles. <span class="emp">'(|)'</span> placé juste devant la date. Ce signe représente la phase de la lune. En fonction de la phase actuelle de celle-ci, un des signes suivants - peut-être indiqué :</p> + peut-être indiqué : <dl class="compact"> <dt>'<code> |) </code>':</dt> <dd>premier quartier</dd> @@ -477,6 +479,7 @@ disponibles. <dd>la phase actuelle de la lune ne correspond à aucune des phases ci-dessus</dd> </dl> + </p> <p> Tout en bas de l'écran on retrouve une barre de status, qui indique les actions possibles en fonction du contexte, ainsi que la @@ -504,7 +507,7 @@ disponibles. <p> De plus, il existe des combinaisons de touches pour effectuer certaines actions courantes utiles lors de l'édition - de textes. Voici ces raccourcis:</p> + de textes. Voici ces raccourcis: <dl class="compact"> <dt><code>^a</code>:</dt> <dd>déplacer le curseur au début de la ligne</dd> @@ -524,6 +527,7 @@ disponibles. <dt><code>ESC</code>:</dt> <dd>annuler l'édition du texte courant</dd> </dl> +</p> <h2>4.3 Fichiers<a name="basics_files"></a></h2> <p> @@ -543,7 +547,7 @@ $HOME/.calcurse/ <dd>ce fichier contient tous les événements ainsi que les rendez-vous de l'utilisateur</dd> <dt><code>todo</code>:</dt> - <dd>ce fichier contient la liste des tâches à effectuer. </dd> + <dd>ce fichier contient la liste des tâches à effectuer</dd> </dl> <h2>4.4 Aide en ligne<a name="basics_help"></a></h2> @@ -575,57 +579,59 @@ $HOME/.calcurse/ <code>calcurse</code>, comme décrit ci-dessous :</p> <dl> <dt><code>sauvegarde_automatique</code> - (valeur par défaut: <code>oui</code>)</dt> + (valeur par défaut: <span class="emp">oui</span>)</dt> <dd>Cette option permet de sauvegarder automatiquement les données de l'utilisateur avant de quitter, si elle est - fixée à <code>oui</code>. + fixée à <span class="emp">oui</span>. <p class="rq"><span class="valorise">attention:</span> Aucune donnée ne sera automatiquement sauvegardée si cette variable est fixée à <code>non</code>. Cela signifie que l'utilisateur doit appuyer sur 'S' (pour sauvegarder) pour retrouver ses modifications au prochain - lancement de <code>calcurse</code>. + lancement de <code>calcurse</code>.</p> </dd> <dt><code>confirmer_pour_quitter</code> - (valeur par défaut: <code>oui</code>)</dt> - <dd>Si cette option est fixée à <code>oui</code>, la confirmation + (valeur par défaut: <span class="emp">oui</span>)</dt> + <dd>Si cette option est fixée à <span class="emp">oui</span>, + la confirmation de l'utilisateur est nécessaire avant de pouvoir quitter. Autrement, appuyer sur 'Q' provoquera l'arrêt de <code>calcurse</code> sans demander confirmation. </dd> <dt><code>confirmer_pour_effacer</code> - (valeur par défaut: <code>oui</code>)</dt> - <dd>Si cette option est fixée à <code>oui</code>, appuyer sur 'D' + (valeur par défaut: <span class="emp">oui</span>)</dt> + <dd>Si cette option est fixée à <span class="emp">oui</span>, appuyer sur 'D' pour effacer un élement (soit une tâche, un rendez-vous ou bien un évenement) provoquera l'apparition d'un message demandant la confirmation de l'utilisateur avant d'effacer cet élement. - Si cette option est fixée à <code>non</code>, aucune confirmation + Si cette option est fixée à <span class="emp">non</span>, aucune confirmation ne sera demandée avant l'effacement d'un élement. </dd> <dt><code>masquer_messages_système</code> - (valeur par défaut: <code>non</code>)</dt> - <dd>Fixer cette option à <code>oui</code> provoque la disparition des + (valeur par défaut: <span class="emp">non</span>)</dt> + <dd>Fixer cette option à <span>oui</span> provoque la disparition des messages relatifs aux enregistrements ou lectures des fichiers de données. Ceci peut être utile pour accélerer les processus d'entrées/sorties. </dd> <dt><code>masquer_barre_progression</code> - (valeur par défaut: <code>non</code>)</dt> - <dd>Si elle est fixée à <code>oui</code>, cette option provoque la + (valeur par défaut: <span class="emp">non</span>)</dt> + <dd>Si elle est fixée à <span class="emp">oui</span>, cette option provoque la disparition de la barre de progression qui est normalement chargée d'indiquer l'état d'avancement de l'enregistrement des fichiers - de données. Si cette option est fixée à <code>non</code>, cette barre + de données. Si cette option est fixée à <span class="emp">non</span>, + cette barre sera affichée, en même temps que le nom du fichier de données actuellement en cours d'écriture (voir la section <a href="#basics_files">Fichiers</a>). </dd> <dt><code>semaine_commence_lundi</code> - (valeur par défaut: <code>oui</code>)</dt> - <dd>Il est possible dans <code>calcurse</code> d'indiquer quel est le + (valeur par défaut: <span class="emp">oui</span>)</dt> + <dd>Il est possible dans <span class="emp">calcurse</span> d'indiquer quel est le premier jour de la semaine, à savoir soit le lundi, soit le dimanche. Si l'option <code>semaine_commence_lundi</code> est fixée à - <code>oui</code>, les semaines du calendrier commenceront le lundi. - Par contre si cette option est fixée à <code>non</code>, + <span class="emp">oui</span>, les semaines du calendrier commenceront le lundi. + Par contre si cette option est fixée à <span class="emp">non</span>, les semaines débuteront le dimanche.</dd> </dl> @@ -646,7 +652,7 @@ $HOME/.calcurse/ informations générales affichées dans la barre de status. Un thème en noir et blanc est également disponible, afin de supporter les terminaux - monochromes. + monochromes.</p> <p class="rq"><span class="valorise">Remarque:</span> Suivant le type de terminal que vous utilisez, et suivant la valeur de la variable d'environnement <code>$TERM</code>, @@ -657,7 +663,7 @@ $HOME/.calcurse/ mais que <code>calcurse</code> ne veut pas les afficher, essayez de changer la valeur de la variable d'environnement <code>$TERM</code> (appliquez par exemple la valeur - <em>xterm-xfree86</em>). + <span class="emp">xterm-xfree86</span>). </p> <h2>5.3 Disposition des panneaux<a name="options_layout"></a></h2> @@ -680,25 +686,25 @@ $HOME/.calcurse/ barre de notification:</p> <dl> <dt><code>barre-notification_afficher</code> - (valeur par défaut: <code>oui</code>)</dt> + (valeur par défaut: <span class="emp"oui</span>)</dt> <dd>Cette option indique si la barre de notification doit être affichée ou pas.</dd> <dt><code>barre-notification_date</code> - (valeur par défaut: <code>%a %F</code>)</dt> + (valeur par défaut: <span class="emp">%a %F</span>)</dt> <dd>Avec cette option, il vous est possible de spécifier le format qui doit être utilisé pour afficher la date du jour dans la barre de notification. Les différents formats possibles sont visibles en tapant la commande suivante dans un terminal: <code>man 3 strftime</code>. </dd> <dt><code>barre-notification_heure</code> - (valeur par défaut: <code>%T</code>)</dt> + (valeur par défaut: <span class="emp">%T</span>)</dt> <dd>Avec cette option, il vous est possible de spécifier le format qui doit être utilisé pour afficher l'heure courante dans la barre de notification. Les différents formats possibles sont visibles en tapant la commande suivante dans un terminal: <code>man 3 strftime</code>. </dd> <dt><code>barre-notification_alerte</code> - (valeur par défaut: <code>300</code>)</dt> + (valeur par défaut: <span class="emp">300</span>)</dt> <dd>Si l'utilisateur a programmé un rendez-vous dans les prochaines 'barre-notification_alerte' secondes, et qu'il a marqué celui-ci comme étant important, l'affichage de ce rendez-vous clignotera dans @@ -708,7 +714,7 @@ $HOME/.calcurse/ De cette manière, l'utilisateur sera alerté et saura que l'heure du rendez-vous approche.</dd> <dt><code>barre-notification_commande</code> - (valeur par défaut: <code>printf '\a'</code>)</dt> + (valeur par défaut: <span class="emp">printf '\a'</span>)</dt> <dd>Cette option indique la commande qui sera lancée lorsque l'heure d'un rendez-vous approchera, et que ce rendez-vous a été marqué comme 'important'. La commande spécifiée par cette option sera passée au shell @@ -733,12 +739,12 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com Une coloration incorrecte des objets peut résulter d'une utilisation conjointe d'un thème graphique en noir et blanc et d'une variable <code>$TERM</code> - fixée à <code>xterm-color</code>. Pour supprimer ce + fixée à <span class="emp">xterm-color</span>. Pour supprimer ce bogue, et comme le conseille Thomas E. Dickey (le résponsable du projet <code>xterm</code>), - <code>xterm-xfree86</code> devrait être assigné + <span class="emp">xterm-xfree86</span> devrait être assigné à la variable <code>$TERM</code> en lieu et place de - <code>xterm-color</code> :</p> + <span class="emp">xterm-color</span> :</p> <blockquote class="rq"> "La valeur xterm-color pour la variable $TERM est un mauvais choix pour les terminaux XFree86 parce qu'elle est couramment @@ -753,10 +759,10 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com <p> Merci de renvoyer vos rapports de bogues et vos commentaires à l'adresse suivante :</p> - <pre>calcurse@culot.org </pre> + <pre>calcurse .à. culot .point. org </pre> <p> ou directement à l'auteur :</p> - <pre>frederic@culot.org </pre> + <pre>frederic .à. culot .point. org </pre> <h1>8. Comment contribuer?<a name="contribute"></a></h1> <p> @@ -770,14 +776,14 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com toute contribution à la traduction de <code>calcurse</code> serait très appréciée, mais avant tout, envoyez un mail - à <code>calcurse-i18n@culot.org</code> pour savoir si + à <code>calcurse-i18n .à. culot .point. org</code> pour savoir si quelqu'un a déjà commencé le processus de traduction dans votre langue.</p> <h2>8.1 Traduction de la documentation<a name="contribute_documentation"></a></h2> <p> - Le répertoire <code>doc/</code> du paquet source contient + Le répertoire <span class="emp">doc/</span> du paquet source contient déjà des versions traduites de la documentation. Cependant, si celle-ci n'est pas encore disponible dans votre langue, votre aide pour sa traduction serait très @@ -785,7 +791,7 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com <p> Pour cela, il suffit de copier un des fichiers existant et de renommer cette copie en <code>manual_XX.html</code>, où - <code>XX</code> représente votre langue. Il faut ensuite + <span class="emp">XX</span> représente votre langue. Il faut ensuite traduire ce fichier nouvellement créé et de l'envoyer à l'auteur (voir <a href="#bugs">Rapporter les bogues et commentaires</a>), pour qu'il soit inclus dans @@ -821,8 +827,8 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com <p> Afin de pouvoir afficher du texte dans la langue natale de l'utilisateur, deux étapes sont nécessaires : - l'<code>internationalisation</code> (i18n), et la - <code>localisation</code> (l10n).</p> + l'<span class="emp">internationalisation</span> (i18n), et la + <span class="emp">localisation</span> (l10n).</p> <p> L'i18n permet à <code>calcurse</code> d'être multilingue. C'est un processus qui est mis en place par les @@ -842,23 +848,25 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com Ainsi, les phrases traduisibles sont tout d'abord marquées par les programmeurs dans le code source, puis rassemblées dans un fichier référence - (<code>calcurse.pot</code> - l'extension <code>pot</code> signifiant - <code>portable object template</code>, objet portable de + (<span class="emp">calcurse.pot</span> - l'extension + <span class="emp">pot</span> signifiant + <span class="emp">portable object template</span>, objet portable de référence). Le contenu de ce fichier est alors associé aux fichiers contenant la traduction pour - chacune des différentes langues (fichier <code>fr.po</code> - pour le français par exemple - <code>po</code> siginifiant - <code>portable object</code>, objet portable - qui peut être + chacune des différentes langues (fichier <span class="emp">fr.po</span> + pour le français par exemple - <span class="emp">po</span> siginifiant + <span class="emp">portable object</span>, objet portable - qui peut être lu par les humains). Le traducteur devra se servir de ce fichier, et traduira les phrases qu'il contient, puis l'enverra aux développeurs. Ensuite, au niveau de la compilation du programme, une version binaire de ce fichier sera produite (pour des raisons d'efficacité), puis installée. Cette version binaire a pour extension - <code>.mo</code>, où <code>mo</code> signifie <code>machine - object</code> - objet machine, c'est-à-dire qui peut + <span class="emp">.mo</span>, où <span class="emp">mo</span> + signifie <span class="emp">machine + object</span> - objet machine, c'est-à-dire qui peut être lu par le programme. Pour finir, - <code>calcurse</code> se servira de ce fichier <code>mo</code> + <code>calcurse</code> se servira de ce fichier <span class="emp">mo</span> lors de son exécution pour traduire les phrases dans la langue de l'utilisateur.</p> @@ -878,20 +886,18 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com href="#basics_invocation_variable">Variable d'environnement pour l'i18n</a>).</li> <li>Ensuite, il faut se rendre dans le répertoire - <code>po/</code>, et créer un nouveau fichier <code>.po</code> + <span class="emp">po/</span>, et créer un nouveau fichier <span class="emp">.po</span> à partir du fichier de référence en utilisant la commande suivante : - <code> - 'msginit -i calcurse.pot -o fr.po -l fr --no-translator' - </code> + <code>'msginit -i calcurse.pot -o fr.po -l fr --no-translator'</code> Si vous n'avez pas <code>msginit</code> installé sur votre système, vous pouvez plus simplement copier - <code>calcurse.pot</code> en <code>fr.po</code> par exemple, et éditer - l'en-tête du fichier nouvellement créé + <span class="emp">calcurse.pot</span> en <span class="emp">fr.po</span> + par exemple, et éditer l'en-tête du fichier nouvellement créé manuellement.</li> </ul> <p> Maintenant, ayant à disposition ce fichier - <code>fr.po</code>, la traduction peut commencer.</p> + <span class="emp">fr.po</span>, la traduction peut commencer.</p> <h3>8.2.3 Fichiers <code>po</code><a name="contribute_i18n_po-files"></a></h3> @@ -900,25 +906,25 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com ils ne contiennent que quatre éléments différents :</p> <ol> - <li><code>ligne d'emplacement:</code> renseigne sur l'emplacement + <li><span class="emp">ligne d'emplacement:</span> renseigne sur l'emplacement de la phrase dans le fichier source (donne le nom du fichier ainsi que le numéro de ligne), afin de retrouver simplement le contexte d'où est issu la phrase à traduire.</li> - <li><code>ligne msgid:</code> indique la phrase à traduire.</li> - <li><code>ligne msgstr:</code> ligne indiquant la phrase traduite.</li> - <li><code>lignes commençant par '#'</code>: indiquent des + <li><span class="emp">ligne msgid:</span> indique la phrase à traduire.</li> + <li><span class="emp">ligne msgstr:</span> ligne indiquant la phrase traduite.</li> + <li><span class="emp">lignes commençant par '#'</span>: indiquent des commentaires (certains ont une signification spéciale, comme nous le verrons plus tard).</li> </ol> <p> Pour résumer, un traducteur doit simplement remplir les - champs <code>msgstr</code> avec la traduction des lignes - trouvées juste au-dessus dans la partie <code>msgid</code>.</p> + champs <span class="emp">msgstr</span> avec la traduction des lignes + trouvées juste au-dessus dans la partie <span class="emp">msgid</span>.</p> <p> <span class="valorise">Remarques:</span> <dl> - <dt><code>Phrases marquées Fuzzy</code></dt> + <dt><span class="emp">Phrases marquées Fuzzy</span></dt> <dd>Vous pourrez rencontrer des phrases commençant par le commentaire <code>"#, fuzzy"</code>. <code>calcurse</code> n'utilisera pas les traductions @@ -938,11 +944,12 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com cette mise à jour effectuée, vous pouvez supprimer le commentaire <code>"#, fuzzy"</code>, et la traduction sera - alors à nouveau prise en compte par <code>calcurse</code>.</dd> - <dt><code>Lignes au format C et séquences spéciales</code></dt> + alors à nouveau prise en compte par <code>calcurse</code>. + </dd> + <dt><span class="emp">Lignes au format C et séquences spéciales</span></dt> <dd>Certaines phrases ont le commentaire suivant: <code>"#, c-format"</code>. Cela signifie que des parties du texte - à traduire ont une signification particulière + à traduire ont une signification particulière pour le programme, et qu'il ne faut pas les modifier. Par exemple, les séquences contenant des <code>%</code>, comme <code>"%s"</code>. Cela signifie que <code>calcurse</code> @@ -953,7 +960,7 @@ calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com faut pas les modifier non plus. En effet, la première séquence représente une fin de ligne, et la deuxième une tabulation.</dd> - <dt><code>Découpage des traductions</code></dt> + <dt><span class="emp">Découpage des traductions</span></dt> <dd>Si certaines lignes sont trop longues, il est possible de découper les phrases comme dans l'exemple ci-après: <pre> @@ -961,8 +968,8 @@ msgid "" "une ligne très longue" "une autre ligne" </pre></dd> - <dt><code>En-tête des fichiers po</code></dt> - <dd>Au tout début du fichier <code>po</code>, la + <dt><span class="emp">En-tête des fichiers po</span></dt> + <dd>Au tout début du fichier <span class="emp">po</span>, la première phrase forme un en-tête où différentes informations doivent être renseignées. La plus importante est le jeu de @@ -972,7 +979,8 @@ msgid "" "Content-Type: text/plain; charset=utf-8\n" </pre> Il est également nécessaire de remplir le champ - <code>Last-Translator</code> - <code>Dernier Traducteur</code>, afin + <span class="emp">Last-Translator</span> - + <span class="emp">Dernier Traducteur</span>, afin que d'autres traducteurs potentiels puissent se mettre en relation avec la dernière personne ayant retouché le fichier. De cette manière, il est @@ -982,11 +990,11 @@ msgid "" <pre> "Last-Translator: Frederic Culot <frederic@culot.org>\n" </pre></dd> - <dt><code>Commentaires</code></dt> + <dt><span class="emp">Commentaires</span></dt> <dd>Ajouter des commentaires (lignes commençant par '#') peut être un bon moyen de signaler des problèmes ou difficultés de traduction aux autres traducteurs.</dd> - <dt><code>Taille des phrases</code></dt> + <dt><span class="emp">Taille des phrases</span></dt> <dd><code>calcurse</code> est un programme comportant une interface console/curses, il dépend donc de la taille du terminal utilisé (plus particulièrement du @@ -996,7 +1004,7 @@ msgid "" général 80 caractères). Il faut en tenir compte, et essayer de voir où la phrase sera placée pour adapter sa traduction.</dd> - <dt><code>Quelques outils utiles</code></dt> + <dt><span class="emp">Quelques outils utiles</span></dt> <dd>Le format des fichiers <code>po</code> est relativement simple, et ils peuvent être modifiés avec un éditeur de texte standard. Mais il est également possible @@ -1016,12 +1024,13 @@ msgid "" <li><code>Vim</code> et son mode <code>po</code></li> </ul> </dd> - <dt><code>Finalement...</code></dt> + <dt><span class="emp">Finalement...</span></dt> <dd>J'espère que vous prendrez plaisir à contribuer à l'internationalisation du monde des logiciels libres. :) Si vous avez d'autres questions concernant ce processus, n'hésitez pas à me - contacter à l'adresse <code>frederic .à. culot .point. org</code>.</dd> + contacter à l'adresse + <span class="emp">frederic .à. culot .point. org</span>.</dd> </dl> @@ -1045,8 +1054,8 @@ msgid "" version est disponible.</p> <p> Pour souscrire à cette liste, envoyez un message à l'adresse - <code>calcurse-announce .à. culot .point. org</code> avec "subscribe" dans - le sujet du mél.</p> + <span class="emp">calcurse-announce .à. culot .point. org</span> + avec "subscribe" dans le sujet du mél.</p> <h2>9.3 Flux RSS<a name="links_rss"></a></h2> <p> @@ -1059,7 +1068,7 @@ msgid "" <code>calcurse</code> est diffusée, et indique quelles sont les modifications qui ont été apportées.</p> -<h1>10. Remerciements</a><a name="thanks"></a></h1> +<h1>10. Remerciements<a name="thanks"></a></h1> <p> Je voudrais remercier ici toutes les personnes sans qui ce projet n'aurait jamais pu voir le jour! En particulier : @@ -1074,7 +1083,7 @@ msgid "" NetBSD</li> <li>Kevin, Ryan, et fEnIo pour la maintenance du paquet <code>calcurse</code> pour Debian et Ubuntu</li> - <li>Steffen pour la maintenance du paquet <code>calcurse</code> pour + <li>Wain, Steffen and Ronald pour la maintenance du paquet <code>calcurse</code> pour Archlinux</li> <li>Pascal pour la maintenance du paquet <code>calcurse</code> pour Slackware</li> @@ -1108,7 +1117,7 @@ msgid "" <div class="footer"> Copyright (c) 2004-2008 Frédéric Culot<br> - Calcurse version 2.0 - Dernière modification: 31 Janvier 2008<br> + Calcurse version 2.0 - Dernière modification: 06 Février 2008<br> </div> </div> diff --git a/doc/manual_nl.html b/doc/manual_nl.html index 2f812ff..7da8894 100755 --- a/doc/manual_nl.html +++ b/doc/manual_nl.html @@ -1,10 +1,10 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//NL"> <!-- /* - * $calcurse: manual_nl.html,v 1.3 2007/10/08 20:41:31 culot Exp $ + * $calcurse: manual_nl.html,v 1.4 2008/02/10 11:33:24 culot Exp $ * * Calcurse - text-based organizer - * Copyright (c) 2004-2007 Frederic Culot + * Copyright (c) 2004-2008 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 @@ -31,76 +31,91 @@ <head> <title>CALCURSE documentatie</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<style type="text/css" media="all"> + @import url(manual.css); +</style> </head> -<body bgcolor="white" text="black" link="blue" vlink="navy"> +<body> -<h1><code>CALCURSE - tekst-gebaseerde organizer</code></h1> -<p> -<p><hr><p> +<div id="mainContent"> + +<h1 id="title"> +<span class="main">CALCURSE - tekst-gebaseerde organizer</span></h1> +<div class="warn"> +<div class="todo"> +<h1>Abstract</h1> This manual describes <code>calcurse</code> functionnalities, +and how to use them. The installation from source is first described, together +with the available command line arguments. The user interface +is then presented, with all of the customizable options that change +<code>calcurse</code> behavior. Last, bug reporting procedure is explained, as +well as the way one can contribute to <code>calcurse</code> development. +</div> +</div> + +<div id="toc"> <h1>Inhoudsopgave</h1> <ul> -<li><a href="#intro">Introductie</a> -<li><a href="#overview">Overzicht</a> -<ul> -<li><a href="#overview_history">Inleiding</a> -<li><a href="#overview_features">Belangrijke kenmerken</a> -</ul> -<li><a href="#install">Installatie</a> -<ul> -<li><a href="#install_requirements">Afhankelijkheden</a> -<ul> -<li><a href="#install_requirements_ncurses"><code>ncurses</code> bibliotheek</a> -<li><a href="#install_requirements_gettext"><code>gettext</code> bibliotheek</a> -</ul> -<li><a href="#install_process">Installatieprocedure</a> -</ul> -<li><a href="#basics"><code>calcurse</code> basis</a> -<ul> -<li><a href="#basics_invocation">Calcurse starten</a> -<ul> -<li><a href="#basics_invocation_commandline">Commandoregel-opties</a> -<li><a href="#basics_invocation_variable">Omgevingsvariabele voor i18n</a> -</ul> -<li><a href="#basics_interface">Gebruikers-interface</a> -<ul> -<li><a href="#basics_interface_noninteractive">Niet-interactieve modus</a> -<li><a href="#basics_interface_interactive">Interactieve modus</a> -</ul> -<li><a href="#basics_files"><code>calcurse</code> bestanden</a> -<li><a href="#basics_help">Online hulp</a> -</ul> -<li><a href="#options">Opties</a> -<ul> -<li><a href="#options_general">Algemene opties</a> -<li><a href="#options_colors">Kleurenschema's</a> -<li><a href="#options_layout">Layout configuratie</a> -<li><a href="#options_notify">Informatiebalk instellingen</a> -</ul> -<li><a href="#known_bugs">Bekende bugs</a> -<li><a href="#bugs">Rapporteren bugs en aanmerkingen</a> -<li><a href="#contribute">Hoe kan ik mee helpen?</a> -<ul> -<li><a href="#contribute_documentation">Vertalen van documentatie</a> -<li><a href="#contribute_i18n"><code>calcurse</code> i18n</a> -<ul> -<li><a href="#contribute_i18n_overview">Overzicht</a> -<li><a href="#contribute_i18n_translator">Vertaal stappen</a> -<li><a href="#contribute_i18n_po-files">Po-bestanden</a> -</ul> -</ul> -<li><a href="#links">Links</a> -<ul> -<li><a href="#links_homepage"><code>Calcurse</code> homepage</a> -<li><a href="#links_list"><code>Calcurse</code> nieuws lijst</a> -<li><a href="#links_rss"><code>Calcurse</code> RSS feed</a> -</ul> -<li><a href="#thanks">Dankwoord</a> + <li><a href="#intro">1. Introductie</a></li> + <li><a href="#overview">2. Overzicht</a> + <ul> + <li><a href="#overview_history">2.1 Inleiding</a></li> + <li><a href="#overview_features">2.2 Belangrijke kenmerken</a></li> + </ul></li> + <li><a href="#install">3. Installatie</a> + <ul> + <li><a href="#install_requirements">3.1 Afhankelijkheden</a> + <ul> + <li><a href="#install_requirements_ncurses">3.1.1 <code>ncurses</code> bibliotheek</a></li> + <li><a href="#install_requirements_gettext">3.1.2 <code>gettext</code> bibliotheek</a></li> + </ul></li> + <li><a href="#install_process">3.2 Installatieprocedure</a></li> + </ul></li> + <li><a href="#basics">4. <code>calcurse</code> basis</a> + <ul> + <li><a href="#basics_invocation">4.1 Calcurse starten</a> + <ul> + <li><a href="#basics_invocation_commandline">4.1.1 Commandoregel-opties</a></li> + <li><a href="#basics_invocation_variable">4.1.2 Omgevingsvariabele voor i18n</a></li> + </ul></li> + <li><a href="#basics_interface">4.2 Gebruikers-interface</a> + <ul> + <li><a href="#basics_interface_noninteractive">4.2.1 Niet-interactieve modus</a></li> + <li><a href="#basics_interface_interactive">4.2.2 Interactieve modus</a></li> + </ul></li> + <li><a href="#basics_files">4.3 <code>calcurse</code> bestanden</a></li> + <li><a href="#basics_help">4.4 Online hulp</a></li> + </ul></li> + <li><a href="#options">5. Opties</a> + <ul> + <li><a href="#options_general">5.1 Algemene opties</a></li> + <li><a href="#options_colors">5.2 Kleurenschema's</a></li> + <li><a href="#options_layout">5.3 Layout configuratie</a></li> + <li><a href="#options_notify">5.4 Informatiebalk instellingen</a></li> + </ul></li> + <li><a href="#known_bugs">6. Bekende bugs</a></li> + <li><a href="#bugs">7. Rapporteren bugs en aanmerkingen</a></li> + <li><a href="#contribute">8. Hoe kan ik mee helpen?</a> + <ul> + <li><a href="#contribute_documentation">8.1 Vertalen van documentatie</a></li> + <li><a href="#contribute_i18n">8.2 <code>calcurse</code> i18n</a> + <ul> + <li><a href="#contribute_i18n_overview">8.2.1 Overzicht</a></li> + <li><a href="#contribute_i18n_translator">8.2.2 Vertaal stappen</a></li> + <li><a href="#contribute_i18n_po-files">8.2.3 Po-bestanden</a></li> + </ul></li> + </ul></li> + <li><a href="#links">9. Links</a> + <ul> + <li><a href="#links_homepage">9.1 <code>Calcurse</code> homepage</a></li> + <li><a href="#links_list">9.2 <code>Calcurse</code> nieuws lijst</a></li> + <li><a href="#links_rss">9.3 <code>Calcurse</code> RSS feed</a></li> + </ul></li> + <li><a href="#thanks">10. Dankwoord</a></li> </ul> -<p><hr><p> - +</div> -<a name="intro"></a><h1>Introductie</a></h1> +<h1>1. Introductie<a name="intro"></a></h1> <p> <code>calcurse</code> is een tekstgebaseerde kalender en planner. Het helpt om overzicht te houden over afspraken en alledaagse taken. Een @@ -108,15 +123,17 @@ deadlines, en de curses-gebaseerde interface kan aangepast worden aan de wensen van de gebruiker. Alle commando's zijn gedocumenteerd in een online hulpsysteem. +</p> -<a name="overview"></a><h1>Overzicht</h1> -<a name="overview_history"></a><h2>Inleiding</h2> +<h1>2. Overzicht<a name="overview"></a></h1> +<h2>2.1 Inleiding<a name="overview_history"></a></h2> <p> Ik begon te denken aan dit project toen ik bijna afgestudeerd was in de astrofysica... Het werd moeilijk om alles georganiseerd te houden en ik had behoefte aan een goed hulpmiddel om me daar bij te helpen. - :)<br> - + ;) +</p> +<p> Ik hou van programma's die gebruik maken van de tekst-interface, omdat ze simpel, snel, overdraagbaar en efficient zijn, dus ik dacht eraan om een simpele tekst-interface kalender te programmeren. Ook wilde ik @@ -124,29 +141,37 @@ welke ik alleen in mijn vooropleiding had gebruikt. Zodoende zou ik dus leren programmeren in <code>C</code>, en mijn zaakjes voor elkaar krijgen. +</p> +<p> Helaas studeerde ik af voordat ik klaar was met <code>calcurse</code>, maar ik was nog steeds geboeid door het project, in de hoop dat het ook voor anderen een handig programma zou zijn. En hier is dan het - resultaat...<br> - <br> + resultaat... +</p> +<p> Waarom de naam 'calcurse', vraagt u zich af? Het is simpelweg een samentrekking van 'CALendar' en 'nCURSEs', de naam van de bibliotheek die gebruikt wordt om de gebruikers-interface aan te sturen. +</p> -<a name="overview_features"></a><h2>Belangrijke kenmerken</h2> +<h2>2?2 Belangrijke kenmerken<a name="overview_features"></a></h2> <p> <code>Calcurse</code> is multi-platform, neemt weinig systeembronnen in beslag, en is snel en betrouwbaar. Het moet gebruikt worden binnen een console of terminal, lokaal of op een aparte computer door middel - van een connectie met een programma zoals ssh.<br> - + van een connectie met een programma zoals ssh. +</p> +<p> <code>Calcurse</code> kan op twee verschillende manieren gebruikt worden: interactieve of niet-interactieve modus. De eerste modus zorgt er voor dat men zijn eigen agenda bijna overal kan bekijken, dankzij de tekst-gebaseerde interface. Met de tweede modus, kan men makkelijk met geheugensteuntjes werken door <code>calcurse</code> met de juiste commandoregel-opties in een cron tab of shell init script te - zetten.<br> Bovendien, is <code>calcurse</code> geschreven met de + zetten. +</p> +<p> + Bovendien, is <code>calcurse</code> geschreven met de eindgebruiker in gedachten, en is dus zo gebruikersvriendelijk mogelijk. Dit betekent dat er een volledige hulp-functie is, en de beschikbare acties altijd op het scherm staan in de statusbalk. De @@ -154,146 +179,152 @@ verschillende kleurenschema's en layout-combinaties kiezen. En als laatste, is er het configurabele meldingssysteem, dat gebruikers verwittigt van op handen zijnde afspraken. +</p> - -<a name="install"></a><h1>Installatie</h1> -<a name="install_requirements"></a><h2>Benodigheden</h2> -<a name="install_requirements_ncurses"></a><h3><code>ncurses</code> bibliotheek</h3> +<h1>3. Installatie<a name="install"></a></h1> +<h2>3.1 Benodigheden<a name="install_requirements"></a></h2> +<h3>3.1.1 <code>ncurses</code> bibliotheek<a name="install_requirements_ncurses"></a></h3> <p> <code>Calcurse</code> maakt alleen gebruik van een <code>C</code> compiler, zoals <code>cc</code> of <code>gcc</code>, en de <code>ncurses</code> bibliotheek. Het is onwaarschijnlijk dat er nog geen juiste versie van <code>ncurses</code> op uw computer staat, maar - indien het niet zo is, is het via de volgende url te vinden:<br> - <pre> - http://ftp.gnu.org/pub/gnu/ncurses/ - </pre> + indien het niet zo is, is het via de volgende url te vinden:</p> + <pre>http://ftp.gnu.org/pub/gnu/ncurses/</pre> -<a name="install_requirements_gettext"></a><h3><code>gettext</code> bibliotheek</h3> +<h3>3.1.2 <code>gettext</code> bibliotheek<a name="install_requirements_gettext"></a></h3> <p> - <code>calcurse</code> ondersteunt internationalisatie (<em>i18n</em> + <code>calcurse</code> ondersteunt internationalisatie + (<span class="emp">i18n</span> genoemd hierna) door middel van <code>gettext</code>. Dit betekent dat <code>calcurse</code> berichten in verschillende talen kan weergeven, indien gecompileerd met native language support - (<em>NLS</em>). <em>NLS</em> is optioneel en als het niet nodig is, + (<span class="emp">NLS</span>). +</p> +<p> + <span class="emp">NLS</span> is optioneel en als het niet nodig is, kan het uitgeschakeld worden. Dit wordt gedaan door <code>--disable-nls</code> als optie mee te geven aan <code>configure</code> (zie sectie <a - href="#install_process">Installatieprocedure</a>). <br> Om te zien of + href="#install_process">Installatieprocedure</a>). Om te zien of gettext op het systeem aanwezig is, kan er gezocht worden naar het - <code>libintl.h</code> header bestand b.v.: - <pre> - locate libintl.h - </pre> + <code>libintl.h</code> header bestand b.v.:</p> + <pre>locate libintl.h</pre> +<p> Indien het header bestand niet gevonden wordt, kan het via de volgende - url verkregen worden:<br> - <pre> - http://ftp.gnu.org/pub/gnu/gettext/ - </pre> - <u>Noot:</u> Zelfs als <code>libintl.h</code> gevonden wordt, is het + url verkregen worden:</p> + <pre>http://ftp.gnu.org/pub/gnu/gettext/</pre> +<p> + <p class="rq"><span class="valorize">Noot:</span> + Zelfs als <code>libintl.h</code> gevonden wordt, is het misschien beter om de lokatie van het bestand tijdens de <a href="#install_process">Installatieprocedure</a>) mee te geven aan <code>configure</code> door middel van <code>--with-libintl-prefix</code>. Het zou kunnen, dat <code>configure</code> de bibliotheek niet kan vinden, als het op een niet-gangbare plaats geïnstalleerd is. - +</p> -<a name="install_process"></a><h2>Installatieprocedure</h2> +<h2>3.2 Installatieprocedure<a name="install_process"></a></h2> <p> Als eerste moet het volgende archief uitgepakt worden met gunzip en - untar: - <pre> - tar zxvf calcurse-1.9.tar.gz - </pre> + untar:</p> + <pre>tar zxvf calcurse-1.9.tar.gz</pre> +<p> Zodra de benodigde pakketten geïnstalleerd zijn en het archief uitgepakt is, is de installatieprocedure vrij simpel, via de standaard drie stappen: - <OL> - <li><code>./configure</code> - <li><code>make</code> - <li><code>make install</code> (mogelijk root privileges nodig) - </OL> + <ol> + <li><code>./configure</code></li> + <li><code>make</code></li> + <li><code>make install</code> (mogelijk root privileges nodig)</li> + </ol> +</p> +<p> Typ <code>./configure --help</code> om een lijst te zien van mogelijke opties. +</p> - -<a name="basics"></a><h1><code>calcurse</code> basis</h1> -<a name="basics_invocation"></a><h2>Het aanroepen van calcurse</h2> -<a name="basics_invocation_commandline"></a><h3>Commandoregel-opties</h3> +<h1>4. <code>calcurse</code> basis<a name="basics"></a></h1> +<h2>4.1 Het aanroepen van calcurse<a name="basics_invocation"></a></h2> +<h3>4.1.1 Commandoregel-opties<a name="basics_invocation_commandline"></a></h3> <p> <code>calcurse</code> accepteert de volgende opties op de - commandoregel (zowel korte en lange opties worden ondersteund): + commandoregel (zowel korte en lange opties worden ondersteund):</p> <p> - <dl compact> - <dt><code>-a, --appointment</code> - <dd> - Geeft de afspraken van vandaag weer en verlaat het programma.<br> - <u>Noot:</u> de te gebruiken kalender waaruit de afspraken gelezen - moeten worden, kan gekozen worden met de '-c' vlag.<br> - <br> - <dt><code>-c <file>, --calendar <file></code> - <dd> - Kies het te gebruiken kalenderbestand.<br> De standaardkalender is - <code>~/.calcurse/apts</code> (zie sectie <a - href="#basics_files"><code>calcurse</code> bestanden</a>).<br> - <br> - <dt><code>-d <date|num>, --day <date|num></code> - <dd> - Geef de afspraken weer van de gegeven datum of van het gegeven aantal - komende dagen, afhankelijk van de opties. Er zijn twee mogelijkheden: - <ul> - <li>een datum zoals volgt 'mm/dd/yyyy'. - <li>een nummer 'n'. - </ul> - In het eerste geval, wordt een lijst met afspraken voor de gegeven - datum weergegeven, terwijl in het tweede geval, een lijst met - afspraken voor de komende 'n' aantal dagen wordt weergegeven.<br> - Als je bijvoorbeeld <code>calcurse -d 3</code> intypt, zullen de - afpraken voor vandaag, morgen en overmorgen worden weergegeven.<br> - <u>Noot:</u> Net zoals bij de '-a' vlag, kan de te gebruiken kalender - worden gekozen met de '-c' vlag.<br> - <br> - <dt><code>-h, --help</code> - <dd> - Geeft een korte hulptekst weer, met de ondersteunde - commandoregel-opties en verlaat het programma.<br> - <br> - <dt><code>-n, --next</code> - <dd> - Geeft de eerstvolgende afspraak weer die binnen 24 uur valt en verlaat - het programma.<br> - De weergegeven tijd is het aantal uren en minuten tot de afspraak.<br> - <u>Noot:</u> de te gebruiken kalender met de afspraken, kan gekozen - worden met de '-c' vlag.<br> - <br> - <dt><code>-t[num], --todo[=num]</code> - <dd> - Geef de 'todo' lijst weer en verlaat het programma. Als het optionele - nummer <code>num</code> wordt meegegeven, zullen alleen de todo's met - de prioriteit gelijk aan <code>num</code> worden weergegeven.<br> - <u>Noot:</u> het nummer van de prioriteit moet liggen tussen 1 - (hoogste) en 9 (laagste).<br> - <br> - <dt><code>-v, --version</code> - <dd> - Geeft het versienummer van <code>calcurse</code> weer en verlaat het - programma.<br> - <br> - <dt><code>-x, --export</code> - <dd> - Exporteert de data van de gebruiker naar het iCalender-formaat. - Gebeurtenissen, afspraken en taken worden geconverteerd en naar stdout - gezonden.<br> - <u>Noot:</u> Om de data te exporteren naar een bestand, kan men de - standaard output omleiden met een commando zoals: - <pre> - $ calcurse --export > my_data.ics - </pre> - </DL> - -<a name="basics_invocation_variable"></a><h3>Omgevingsvariabele voor i18n</h3> + <dl> + <dt><code>-a, --appointment</code></dt> + <dd> + Geeft de afspraken van vandaag weer en verlaat het programma. + <p class="rq"><span class="valorise">Noot:</span> + de te gebruiken kalender waaruit de afspraken gelezen + moeten worden, kan gekozen worden met de '-c' vlag.</p> + </dd> + <dt><code>-c <file>, --calendar <file></code></dt> + <dd> + Kies het te gebruiken kalenderbestand. De standaardkalender is + <code>~/.calcurse/apts</code> (zie sectie <a + href="#basics_files"><code>calcurse</code> bestanden</a>). + </dd> + <dt><code>-d <date|num>, --day <date|num></code></dt> + <dd> + Geef de afspraken weer van de gegeven datum of van het gegeven aantal + komende dagen, afhankelijk van de opties. Er zijn twee mogelijkheden: + <ul> + <li>een datum zoals volgt 'mm/dd/yyyy'.</li> + <li>een nummer 'n'.</li> + </ul> + In het eerste geval, wordt een lijst met afspraken voor de gegeven + datum weergegeven, terwijl in het tweede geval, een lijst met + afspraken voor de komende 'n' aantal dagen wordt weergegeven. + Als je bijvoorbeeld <code>calcurse -d 3</code> intypt, zullen de + afpraken voor vandaag, morgen en overmorgen worden weergegeven. + <p class="rq"><span class="valorise">Noot:</span> + Net zoals bij de '-a' vlag, kan de te gebruiken kalender + worden gekozen met de '-c' vlag.</p> + </dd> + <dt><code>-h, --help</code></dt> + <dd> + Geeft een korte hulptekst weer, met de ondersteunde + commandoregel-opties en verlaat het programma. + </dd> + <dt><code>-n, --next</code></dt> + <dd> + Geeft de eerstvolgende afspraak weer die binnen 24 uur valt en verlaat + het programma. + De weergegeven tijd is het aantal uren en minuten tot de afspraak. + <p class="rq"><span class="valorise">Noot:</span> + de te gebruiken kalender met de afspraken, kan gekozen + worden met de '-c' vlag.</p> + </dd> + <dt><code>-t[num], --todo[=num]</code></dt> + <dd> + Geef de 'todo' lijst weer en verlaat het programma. Als het optionele + nummer <code>num</code> wordt meegegeven, zullen alleen de todo's met + de prioriteit gelijk aan <code>num</code> worden weergegeven. + <p class="rq"><span class="valorise">Noot:</span> + het nummer van de prioriteit moet liggen tussen 1 + (hoogste) en 9 (laagste).</p> + </dd> + <dt><code>-v, --version</code></dt> + <dd> + Geeft het versienummer van <code>calcurse</code> weer en verlaat het + programma. + </dd> + <dt><code>-x, --export</code></dt> + <dd> + Exporteert de data van de gebruiker naar het iCalender-formaat. + Gebeurtenissen, afspraken en taken worden geconverteerd en naar stdout + gezonden. + <p class="rq"><span class="valorise">Noot:</span> + Om de data te exporteren naar een bestand, kan men de + standaard output omleiden met een commando zoals: + <code>$ calcurse --export > my_data.ics</code></p> + </dd> + </dl> + +<h3>4.1.2 Omgevingsvariabele voor i18n<a name="basics_invocation_variable"></a></h3> <p> <code>calcurse</code> kan gecompileerd worden met native language support (zie <a @@ -302,44 +333,44 @@ dan eerst na of het beschikbaar is door naar het <code>po/LINGUAS</code> bestand te kijken. Dit bestand geeft de beschikbare talen weer door middel van twee letters. (Voorbeeld, - <em>fr</em> duidt frans aan). Indien je je taal niet vindt, zouden we + <span class="emp">fr</span> duidt frans aan). Indien je je taal niet vindt, zouden we het op prijs stellen, als je meehelpt met het vertalen van <code>calcurse</code> (zie <a href="#contribute">Hoe kan ik - helpen?</a>).<br> + helpen?</a>).</p> +<p> Als je taal beschikbaar is, start <code>calcurse</code> met het - volgende commando: - <pre> - LC_ALL=fr_FR calcurse - </pre> - waar <em>fr_FR</em> de locale naam van dit voorbeeld is, maar - veranderd moet worden naar de locale van de gewenste taal.<br> + volgende commando:</p> + <pre>LC_ALL=fr_FR calcurse</pre> +<p> + waar <span class="emp">fr_FR</span> de locale naam van dit voorbeeld is, maar + veranderd moet worden naar de locale van de gewenste taal.</p> +<p> De te gebruiken karakterset zou ook gespecificeerd moeten worden, omdat anders in bepaalde gevallen de accenten en dergelijke niet correct weergegeven worden. De karakterset wordt gekozen in het begin van het po bestand, dat overeenkomt met de gewenste taal. Je kan bijvoorbeeld in het fr.po bestand zien dat het gebruik maakt van de iso-8859-1 karakterset, dus om <code>calcurse</code> te starten, kan - het volgende commando worden gebruikt: - <pre> - LC_ALL=fr_FR.ISO8859-1 calcurse - </pre> + het volgende commando worden gebruikt:</p> + <pre>LC_ALL=fr_FR.ISO8859-1 calcurse</pre> -<a name="basics_interface"></a><h2>Gebruikers-interface</h2> -<a name="basics_interface_noninteractive"></a><h3>Niet-interactieve modus</h3> +<h2>4.2 Gebruikers-interface<a name="basics_interface"></a></h2> +<h3>4.2.1 Niet-interactieve modus<a name="basics_interface_noninteractive"></a></h3> <p> <code>calcurse</code> wordt in niet-interactieve modus gestart, als - ten minste een van de volgende opties wordt gebruikt:<br> + ten minste een van de volgende opties wordt gebruikt: <code>-a</code>, <code>-d</code>, <code>-h</code>, <code>-n</code>, - <code>-t</code>, <code>-v</code>, <code>-x</code><br> + <code>-t</code>, <code>-v</code>, <code>-x</code>, Dit betekent dat de gewenste informatie wordt getoond, en dat daarna <code>calcurse</code> simpelweg wordt verlaten en men weer terug is - bij de shell prompt.<br> + bij de shell prompt.</p> +<p> Op deze manier, kan men een regel zoals <code>'calcurse --todo --appointment'</code> in zijn init config bestand zetten, zodat bij het inloggen de takenlijst en afspraken van vandaag worden - weergegeven. + weergegeven.</p> -<a name="basics_interface_interactive"></a><h3>Interactieve modus</h3> +<h3>4.2.2 Interactieve modus<a name="basics_interface_interactive"></a></h3> <p> Als <code>calcurse</code> zonder opties of alleen met de <code>-c</code> optie wordt aangeroepen, wordt <code>calcurse</code> @@ -347,7 +378,7 @@ getoond, dat drie verschillende panels (panelen) bevat, waartussen je kan schakelen door middel van de 'TAB' toets, een notify-bar (informatiebalk), en een statusbar (statusbalk) (zie onderstaand - figuur). + figuur).</p> <pre> afspraken panel---. .---kalender panel @@ -382,81 +413,105 @@ statusbalk </pre> +<p> Het eerste panel geeft een kalender weer, die het mogelijk maakt om een bepaalde datum te kiezen. Het tweede panel bevat de afspraken en gebeurtenissen van die dag. Het laatste panel bevat een lijst met taken (todo's) die nog moeten gebeuren, maar niet aan een bepaalde dag - zijn toegewezen.<br> - - In het afspraken panel, staat vlak voor de datum het <em>'(|)'</em> + zijn toegewezen.</p> +<p> + In het afspraken panel, staat vlak voor de datum het <span class="emp">'(|)'</span> teken. Dit geeft de huidige fase van de maan aan. Afhankelijk van de fase, kunnen de volgende tekens worden gezien: - <ul> - <li>'<b> |) </b>': eerste kwartier</li> - <li>'<b> (|) </b>': volle maan</li> - <li>'<b> (| </b>': laatste kwartier</li> - <li>'<b> | </b>': nieuwe maan</li> - <li>geen teken: huidige fase van de maan correspondeert met geen - van bovenstaande fases</li> - </ul> + <dl class="compact"> + <dt>'<code> |) </code>':</dt> + <dd>eerste kwartier</dd> + <dt>'<code> (|) </code>':</dt> + <dd>volle maan</dd> + <dt>'<code> (| </code>':</dt> + <dd>laatste kwartier</dd> + <dt>'<code> | </code>':</dt> + <dd>nieuwe maan</dd> + <dt>geen teken:</dt> + <dd>huidige fase van de maan correspondeert met geen + van bovenstaande fases</dd> + </dl> + </p> <p> Aan de onderkant van het scherm is de statusbalk, die de mogelijke - acties en de daarbij horende toetscombinaties weergeeft.<br> + acties en de daarbij horende toetscombinaties weergeeft.</p> + <p> Net boven de statusbalk is de informatiebalk, die van links naar rechts het volgende toont: de huidige datum, de huidige tijd, het kalenderbestand dat in gebruik is (apts in het bovenstaand voorbeeld, dat het standaardkalender bestand is, zie de volgende sectie), en de volgende afspraak binnen 24 uur. In het voorbeeld staat dat het over - een uur en twintig minuten tijd is voor de lunch. + een uur en twintig minuten tijd is voor de lunch.</p> <p> - <u>Noot:</u> Voor sommige acties, zoals het bewerken of toevoegen van + <p class="rq"><span class="valorise">Noot:</span> + Voor sommige acties, zoals het bewerken of toevoegen van een item, is het nodig dat er tekst wordt ingevoerd. Dit wordt gedaan - met de hulp van de ingebouwde editor.<br> + met de hulp van de ingebouwde editor.</p> + <p> Als een regel met tekst langer is dan de breedte van het scherm, wordt er in de editor een '>', '*', or '<' karakter getoond in de laatste kolom, wat aanduid dat er respectievelijk meer karakters achter, voor en achter, of voor de huidige positie staan. De - tekstregel schuift horizontaal mee als het nodig is.<br> + tekstregel schuift horizontaal mee als het nodig is.</p> + <p> Sommige bewerkingscommando's zijn gebonden aan speciale controle karakters. Hierna zijn de beschikbare bewerkingscommando's weergegeven - ('^' staat voor de control-toets):<br> - <ul> - <li><b>^a</b>: verplaats de cursor naar het begin van de invoerregel - <li><b>^b</b>: verplaats de cursor terug - <li><b>^d</b>: verwijder een karakter voorwaarts - <li><b>^e</b>: verplaats de cursor naar het einde van de invoerregel - <li><b>^f</b>: verplaats de cursor voorwaarts - <li><b>^h</b>: verwijder een karakter terug - <li><b>^k</b>: verwijder de invoer vanaf de cursor naar het einde van - de regel - <li><b>ESCAPE</b>: annuleert het bewerken - </ul> - -<a name="basics_files"></a><h2><code>calcurse</code> bestanden</h2> + ('^' staat voor de control-toets): + <dl class="compact"> + <dt><code>^a</code>:</dt> + <dd>verplaats de cursor naar het begin van de invoerregel</dd> + <dt><code>^b</code>:</dt> + <dd>verplaats de cursor terug</dd> + <dt><code>^d</code>:</dt> + <dd>verwijder een karakter voorwaarts</dd> + <dt><code>^e</code>:</dt> + <dd>verplaats de cursor naar het einde van de invoerregel</dd> + <dt><code>^f</code>:</dt> + <dd>verplaats de cursor voorwaarts</dd> + <dt><code>^h</code>:</dt> + <dd>verwijder een karakter terug</dd> + <dt><code>^k</code>:</dt> + <dd>verwijder de invoer vanaf de cursor naar het einde van + de regel</dd> + <dt><code>ESCAPE</code>:</dt> + <dd>annuleert het bewerken</dd> + </dl> +</p> + +<h2>4.3 <code>calcurse</code> bestanden<a name="basics_files"></a></h2> <p> De volgende structuur wordt in je <code>$HOME</code> directory aangemaakt, als <code>calcurse</code> voor de eerste keer wordt - gestart: + gestart:</p> <pre> - $HOME/.calcurse/ - |___conf - |___apts - |___todo +$HOME/.calcurse/ + |___conf + |___apts + |___todo </pre> - Het <em>conf</em> bestand bevat de configuratie van de gebruiker.<br> - Het <em>apts</em> bestand bevat alle gebeurtenissen en afspraken van - de gebruiker.<br> - Het <em>todo</em> bestand bevat de todo lijst. - - -<a name="basics_help"></a><h2>Online hulp</h2> + <dl class="compact"> + <dt><code>conf</code>:</dt> + <dd>bevat de configuratie van de gebruiker.</dd> + <dt><code>apts</code>:</dt + <dd>bevat alle gebeurtenissen en afspraken van de gebruiker.</dd> + <dt><code>todo</code>:</dt> + <dd>bevat de todo lijst.</dd> + </dl> + +<h2>4.4 Online hulp<a name="basics_help"></a></h2> <p> De ingebouwde hulp kan waar nodig aangeroepen worden door middel van de '?' toets. Tijdens het gebruik van de hulpschermen kan een specifiek commando opgevraagd worden door op de toetscombinatie te drukken van dat commando. +</p> -<a name="options"></a><h1>Opties</h1> +<h1>5. Opties<a name="options"></a></h1> <p> Alle opties van <code>calcurse</code> zijn aan te passen vanuit het Configuratie menu. Als je op 'C' drukt, kom je in een submenu met 4 @@ -466,57 +521,63 @@ het scherm komen), druk op 'G' om een aantal algemene opties in te stellen, en als laatste kan de informatiebalk worden aangepast worden met de toets 'N'. +</p> -<a name="options_general"></a><h2>Algemene opties</h2> +<h2>5.1 Algemene opties<a name="options_general"></a></h2> <p> Met de volgende opties kan <code>calcurse</code> naar wens ingesteld - worden: - <ul> - <li><code>automatisch_opslaan</code> (standaard: <em>ja</em>)<br> Door - deze optie wordt de data van de gebruiker automatisch opgeslagen - (indien ingesteld op <em>ja</em>) bij het afsluiten.<br> - <em>Let op:</em>De data wordt niet automatisch opgeslagen als - <code>automatisch_opslaan</code> ingesteld is op <em>nee</em>. Dit - betekent dat de gebruiker op 'S' moet drukken om de gewijzigde data te - bewaren.<br> - <br> - <li><code>einde_bevestigen</code> (standaard: <em>ja</em>)<br> - Bij het beëindigen van <code>calcurse</code>, zal er om een - bevestiging worden gevraagd, als de optie op <em>ja</em> is ingesteld. - Zoniet, dan zal <code>calcurse</code> zonder bevestigingsvraag - eindigen, als er op 'Q' wordt gedrukt.<br> - <br> - <li><code>bevestig_verwijderen</code> (standaard: <em>ja</em>)<br> - - Als deze optie op <em>ja</em> is ingesteld, zal er om een bevestiging - gevraagd worden voor het wissen van een item door middel van een - toetsdruk op 'D' (dit kan een <em>todo</em>, <em>afspraak</em>, of - <em>gebeurtenis</em> zijn. Anders zal er geen bevestiging nodig zijn - voor het wissen van een item.<br> - <br> - <li><code>overslaan_systeem_dialoog</code> (standaard: - <em>nee</em>)<br> - Als deze optie ingesteld is op <em>ja</em> zullen de systeem dialogen - gerelateerd aan het opslaan en laden van data worden overgeslagen. Dit - zorgt ervoor dat <code>calcurse</code> sneller opstart en afsluit.<br> - <br> - <li><code>overslaan_progressie_balk</code> (standaard: - <em>nee</em>)<br> - Indien ingesteld op <em>ja</em>, zal deze optie er voor zorgen dat de - progressie balk, die normaal gesproken getoond wordt bij het opslaan - van data naar bestand, verdwijnt. Ingesteld op <em>ja></em>, wordt de - progressie balk getoond samen met de bestandsnaam. (zie sectie <a - href="#basics_files"><code>calcurse</code> bestanden</a>).<br> - <br> - <li><code>week_begint_op_maandag</code> (standaard: <em>ja</em>)<br> - Er kan gekozen worden tussen maandag en zondag als de eerste dag van - de week. Als <em>week_begint_op_maandag</em> ingesteld is op - <em>ja</em>, dan zal maandag als eerste staan in het kalender - overzicht. Anders staat zondag als eerste dag van de week. - </ul> - - -<a name="options_colors"></a><h2>Kleurenschema's</h2> + worden:</p> + <dl> + <dt><code>automatisch_opslaan</code> + (standaard: <span class="emp">ja</span>)</dt> + <dd>Door deze optie wordt de data van de gebruiker automatisch opgeslagen + (indien ingesteld op <span class="emp">ja</span>) bij het + afsluiten. + <p class="rq"><span class="valorise">Let op:</span> + De data wordt niet automatisch opgeslagen als + <code>automatisch_opslaan</code> ingesteld is op <span class="emp">nee</span>. Dit + betekent dat de gebruiker op 'S' moet drukken om de gewijzigde data te + bewaren.</p> + </dd> + <dt><code>einde_bevestigen</code> + (standaard: <span class="emp">ja</span>)</dt> + <dd>Bij het beëindigen van <code>calcurse</code>, zal er om een + bevestiging worden gevraagd, als de optie op <span class="emp">ja</span> is ingesteld. + Zoniet, dan zal <code>calcurse</code> zonder bevestigingsvraag + eindigen, als er op 'Q' wordt gedrukt. + </dd> + <dt><code>bevestig_verwijderen</code> + (standaard: <span class="emp">ja</span>)</dt> + <dd>Als deze optie op <span class="emp">ja</span> is ingesteld, zal er om een bevestiging + gevraagd worden voor het wissen van een item door middel van een + toetsdruk op 'D' (dit kan een <span class="emp">todo</span>, <span class="emp">afspraak</span>, of + <span class="emp">gebeurtenis</span> zijn. Anders zal er geen bevestiging nodig zijn + voor het wissen van een item. + </dd> + <dt><code>overslaan_systeem_dialoog</code> + (standaard: <span class="emp">nee</span>)</dt> + <dd>Als deze optie ingesteld is op <span class="emp">ja</span> zullen de systeem dialogen + gerelateerd aan het opslaan en laden van data worden overgeslagen. Dit + zorgt ervoor dat <code>calcurse</code> sneller opstart en afsluit. + </dd> + <dt><code>overslaan_progressie_balk</code> + (standaard: <span class="emp">nee</span>)</dt> + <dd>Indien ingesteld op <span class="emp">ja</span>, zal deze optie er voor zorgen dat de + progressie balk, die normaal gesproken getoond wordt bij het opslaan + van data naar bestand, verdwijnt. Ingesteld op <span class="emp">ja></span>, wordt de + progressie balk getoond samen met de bestandsnaam. (zie sectie <a + href="#basics_files"><code>calcurse</code> bestanden</a>). + </dd> + <dt><code>week_begint_op_maandag</code> + (standaard: <span class="emp">ja</span>)</dt> + <dd>Er kan gekozen worden tussen maandag en zondag als de eerste dag van + de week. Als <span class="emp">week_begint_op_maandag</span> ingesteld is op + <span class="emp">ja</span>, dan zal maandag als eerste staan in het kalender + overzicht. Anders staat zondag als eerste dag van de week. + </dd> + </dl> + +<h2>5.2 Kleurenschema's<a name="options_colors"></a></h2> <p> De kleurenschema's van <code>calcurse</code> zijn aan te passen aan de wensen van de gebruiker. Om het standaard schema te wijzigen, zijn er @@ -526,92 +587,91 @@ spatie een kleur te selecteren, kan de gebruiker de kleur toegepast zien. Het is ook mogelijk om de standaard kleuren van de terminal te gebruiken. Selecteer hiervoor de corresponderende optie. - <p> +</p> +<p> De kleuren van de randen, titels, toetshulp, en algemene informatie binnen de statusbalk zullen worden aangepast. Er is ook een zwart-wit - schema, voor terminals die geen kleuren ondersteunen.<br> - <u>Noot:</u> - <ul> - <li> Afhankelijk van het type terminal en van de <code>$TERM</code> + schema, voor terminals die geen kleuren ondersteunen.</p> + <p class="rq"><span class="valorise">Noot:</span> + Afhankelijk van het type terminal en van de <code>$TERM</code> omgevingsvariabele, is het mogelijk dat kleur wel of niet wordt ondersteund. Indien gepoogd wordt de kleuren te veranderen, terwijl de terminal geen kleuren ondersteund, zal er een foutbericht - verschijnen.<br> - <br> - <li> Als bekend is dat de terminal kleuren ondersteund, maar niet + verschijnen. + Als bekend is dat de terminal kleuren ondersteund, maar niet getoond worden door <code>calcurse</code>, probeerd dan om de waarde van de <code>$TERM</code> variabele te veranderen in iets anders - (zoals bijvoorbeeld <em>xterm-xfree86</em>) - </ul> - + (zoals bijvoorbeeld <span class="emp">xterm-xfree86</span>) + </p> -<a name="options_layout"></a><h2>Layout configuratie</h2> +<h2>5.3 Layout configuratie<a name="options_layout"></a></h2> <p> De layout stelt de positie van de panels van <code>calcurse</code> in. Bij de standaard layout is de positie van het kalender panel in de terminal rechtsboven, het todo-panel rechtsonder, en het afspraken panel wordt aan de linkerkant van het scherm getoond (zie het figuur in sectie <a href="#basics_interface_interactive">Interactieve - modus</a> voor een voorbeeld van de standaard layout).<br> + modus</a> voor een voorbeeld van de standaard layout). Door een andere layout te kiezen in het configuratie scherm, kan de gebruiker <code>calcurse</code> zo het beste aan zijn behoeftes - aanpassen. + aanpassen.</p> -<a name="options_notify"></a><h2>Informatiebalk instellingen</h2> +<h2>5.4 Informatiebalk instellingen<a name="options_notify"></a></h2> <p> - De volgende opties stelt het gedrag van de informatiebalk in: - <ul> - <li><code>informatiebalk_toon</code> (standaard: <em>ja</em>)<br> - Deze optie stelt in of de informatiebalk getoond wordt op het scherm - of niet.<br> - <br> - <li><code>informatiebalk_datum</code> (standaard: <em>%a %F</em>)<br> - Door middel van deze optie, kan ingesteld worden hoe de datum wordt + De volgende opties stelt het gedrag van de informatiebalk in:</p> + <dl> + <dt><code>informatiebalk_toon</code> + (standaard: <span class="emp">ja</span>)</dt> + <dd>Deze optie stelt in of de informatiebalk getoond wordt op het scherm + of niet.</dd> + <dt><code>informatiebalk_datum</code> + (standaard: <span class="emp">%a %F</span>)</dt> + <dd>Door middel van deze optie, kan ingesteld worden hoe de datum wordt weergegeven in de informatiebalk. Alle mogelijkheden kunnen gezien - worden door <tt>man 3 strftime</tt> in de terminal te typen.<br> - <br> - <li><code>informatiebalk_tijd</code> (standaard: <em>%T</em>)<br> - Door middel van deze optie, kan insteld worden hoe de huidige tijd + worden door <code>man 3 strftime</code> in de terminal te typen.</dd> + <dt><code>informatiebalk_tijd</code> + (standaard: <span class="emp">%T</span>)</dt> + <dd>Door middel van deze optie, kan insteld worden hoe de huidige tijd wordt weergegeven in de informatiebalk. weergegeven in de - informatiebalk. Alle mogelijkheden kunnen gezien worden door <tt>man 3 - strftime</tt> in de terminal te typen.<br> - <br> - <li><code>informatiebalk_waarschuwing</code> (standaard: - <em>300</em>)<br> - Indien een afspraak binnen de tijd valt die is ingesteld in + informatiebalk. Alle mogelijkheden kunnen gezien worden door + <code>man 3 strftime</code> in de terminal te typen.</dd> + <dt><code>informatiebalk_waarschuwing</code> + (standaard: <span class="emp">300</span>)</dt> + <dd>Indien een afspraak binnen de tijd valt die is ingesteld in 'informatiebalk_waarschuwing', begint de weergave van die boodschap te knipperen. Zo wordt de gebruiker gewaarschuwd, dat er een op handen zijnde afspraak is. Bovendien zal het commando uitgevoerd worden dat - is gedefinieerd door informatiebalk_commando.<br> - <br> - <li><code>informatiebalk_commando</code> (standaard: - <em>printf '\a'</em>)<br> - Deze optie geeft het commando weer dat wordt uitgevoerd wanneer er een + is gedefinieerd door informatiebalk_commando.</dd> + <dt><code>informatiebalk_commando</code> + (standaard: <span class="emp">printf '\a'</span>)</dt> + <dd>Deze optie geeft het commando weer dat wordt uitgevoerd wanneer er een op handen zijnde afspraak is, die gemarkeerd is als 'belangrijk'. Het commando zal naar de shell van de gebruiker gestuurd worden, waar het door de shell uitgevoerd wordt. Om van de gewenste shell gebruik te maken, wordt gebruik gemaakt van de <code>$SHELL</code> omgevingsvariabele. Er wordt gebruik gemaakt van <code>/bin/sh</code>, - indien de variabele leeg is.<br> - <u>Voorbeeld:</u> Stel dat het commando <code>mail</code> uit te + indien de variabele leeg is. + <p class="rq"><span class="valorise">Voorbeeld:</span> + Stel dat het commando <code>mail</code> uit te voeren is op het systeem van de gebruiker. Men kan dan het volgende commando gebruiken om op de hoogte gesteld te worden van een op handen zijnde afspraak (de beschrijving van de afspraak zal ook te zien zijn - in de body van de mail): - <pre> - calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com - </pre> - </ul> - -<a name="bekende_bugs"></a><h1>bekende bugs</h1> + in de body van de mail):</p> + <code> +calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com + </code> + </dd> + </dl> + +<h1>6. bekende bugs<a name="bekende_bugs"></a></h1> <p> Wanneer <code>calcurse</code> gebruikt maakt van een zwart-wit schema terwijl de <code>$TERM</code> variabele is ingesteld op - <em>xterm-color</em>, zullen er verkeerde items gemarkeerd worden. - Gebruik om deze bug op te lossen, <em>xterm-xfree86</em> in plaats van - <em>xterm-color</em> in de variabele <code>$TERM</code>, - adviseert Thomas E. Dickey (<code>xterm</code> maintainer): - <blockquote> + <span class="emp">xterm-color</span>, zullen er verkeerde items gemarkeerd worden. + Gebruik om deze bug op te lossen, <span class="emp">xterm-xfree86</span> in plaats van + <span class="emp">xterm-color</span> in de variabele <code>$TERM</code>, + adviseert Thomas E. Dickey (<code>xterm</code> maintainer):</p> + <blockquote class="rq"> "De waarde van xterm-color voor $TERM is geen goede keuze voor XFree86 xterm, omdat het vaak gebruikt wordt voor een optie in terminfo, dat bce niet ondersteunt. Maak gebruik van de xterm-xfree86 optie die met @@ -619,45 +679,43 @@ gedistribueerd met ncurses)." </blockquote> -<a name="bugs"></a><h1>Het melden van bugs en aanmerkingen</h1> +<h1>7. Het melden van bugs en aanmerkingen<a name="bugs"></a></h1> <p> - Meldt bugs en aanmerkingen alstublieft aan: - <pre> - calcurse@culot.org - </pre> - Of aan de auteur: - <pre> - frederic@culot.org - </pre> + Meldt bugs en aanmerkingen alstublieft aan:</p> + <pre>calcurse @ culot . org</pre> +<p> + Of aan de auteur:</p> + <pre>frederic @ culot . org</pre> -<a name="contribute"></a><h1>Hoe kan ik helpen?</h1> +<h1>8. Hoe kan ik helpen?<a name="contribute"></a></h1> <p> Mocht je mee willen helpen aan het project, dan kan je ten eerste laten weten wat je wel en niet goed vindt, en of er nog dingen zijn die je mist in <code>calcurse</code>. Ook wordt het vertalen van <code>calcurse</code> berichten en - documentatie zeer gewaardeerd.<br> - <br> - <u>Noot:</u> Alle hulp bij het 'internationaliseren' van + documentatie zeer gewaardeerd.</p> + <p class="rq"><span class="valorise">Noot:</span> + Alle hulp bij het 'internationaliseren' van <code>calcurse</code> wordt zeer op prijs gesteld, maar voordat je - begint, mail dan eerst naar <code>calcurse-i18n@culot.org</code>, om + begint, mail dan eerst naar <code>calcurse-i18n @ culot . org</code>, om te weten te komen of iemand anders al met een vertaling naar jouw taal - bezig is. + bezig is.</p> -<a name="contribute_documentation"></a><h2>Vertalen van de documentatie</h2> +<h2>8.1 Vertalen van de documentatie<a name="contribute_documentation"></a></h2> <p> - De <em>doc/</em> directory van het bronpakket bevat alle vertalingen + De <span class="emp">doc/</span> directory van het bronpakket bevat alle vertalingen van de handleidingen van <code>calcurse</code>. Als de handleiding van je moedertaal echter nog niet aanwezig is, wordt het zeer op prijs - gesteld als je kunt helpen met de vertaling.<br> + gesteld als je kunt helpen met de vertaling.</p> +<p> Kopieer eenvoudig de bestaande handleiding naar - <code>manual_XX.html</code>, waar <em>XX</em> de code is van je taal. + <code>manual_XX.html</code>, waar <span class="emp">XX</span> de code is van je taal. Vertaal dan het zojuist aangemaakte bestand en zend het naar de auteur (zie <a href="#bugs">Het melden van bugs en aanmerkingen</a>), zodat het bij de volgende versie van <code>calcurse</code> gevoegd can - worden. + worden.</p> -<a name="contribute_i18n"></a><h2><code>calcurse</code> i18n</h2> +<h2>8.2 <code>calcurse</code> i18n<a name="contribute_i18n"></a></h2> <p> Zoals eerder gezegd, maakt <code>calcurse</code> gebruikt van <code>gettext</code> om berichten weer te geven in meerdere talen. @@ -665,90 +723,89 @@ Deze howto is echter met opzet incompleet, en verlegt de focus op het werken met <code>gettext</code> voor <code>calcurse</code>. Voor meer gespecificeerde informatie of om het grotere geheel te begrijpen, is - er de <code>GNU gettext</code> handleiding: - <pre> - http://www.gnu.org/software/gettext/manual/ - </pre> + er de <code>GNU gettext</code> handleiding:</p> + <pre>http://www.gnu.org/software/gettext/manual/</pre> +<p> In principe, zijn er drie verschillende mensen bezig in de vertaalketen: programmeurs, de vertaal coördinator, en de vertalers. Na in vogelvlucht uit te leggen hoe dingen werken, zal de taak van de - vertaler beschreven worden. + vertaler beschreven worden.</p> -<a name="contribute_i18n_overview"></a><h3>Overzicht</h3> +<h3>8.2.1 Overzicht<a name="contribute_i18n_overview"></a></h3> <p> Om het mogelijk te maken om teksten weer te geven in de taal van de - gebruiker, zijn er twee stappen vereist: <em>internationalisatie</em> - (i18n) en <em>localisatie</em> (l10n). i18n zorgt ervoor dat + gebruiker, zijn er twee stappen vereist: <span class="emp">internationalisatie</span> + (i18n) en <span class="emp">localisatie</span> (l10n).</p> +<p> + i18n zorgt ervoor dat <code>calcurse</code> meerdere talen ondersteund. De programmeurs markeren de te vertalen tekst (strings genaamd) en bieden een manier - aan om deze direct te vertalen als <code>calcurse</code> gestart is. + aan om deze direct te vertalen als <code>calcurse</code> gestart is.</p> +<p> l10n zorgt ervoor dat de i18n-de <code>calcurse</code> zich instelt op de taal van de gebruiker, dus worden de door de programmeurs gemarkeerde strings vertaald, en wordt de omgeving correct ingesteld, - zodat <code>calcurse</code> gebruik kan maken van de vertaling.<br> - <br> - + zodat <code>calcurse</code> gebruik kan maken van de vertaling.</p> +<p> Dus, de te vertalen strings worden eerst gemarkeerd door de programmeurs binnen in de <code>C</code> broncode, dan worden ze - verzameld in een sjabloon bestand (<em>calcurse.pot</em> - de - <em>pot</em> extensie staat voor <em>portable object template</em>, + verzameld in een sjabloon bestand (<span class="emp">calcurse.pot</span> - de + <span class="emp">pot</span> extensie staat voor <span class="emp">portable object template</span>, wat zoiets als overdraagbaar object sjabloon betekent). De inhoud van deze sjabloonbestanden worden dan samengevoegd met de vertaalbestanden - van elke taal (<em>fr.po</em> voor frans, bijvoorbeeld - waar - <em>po</em> voor <em>portable object</em> staat, dus bedoeld om + van elke taal (<span class="emp">fr.po</span> voor frans, bijvoorbeeld - waar + <span class="emp">po</span> voor <span class="emp">portable object</span> staat, dus bedoeld om gelezen en gewijzigd te worden door mensen). Dit bestand wordt door een vertaalteam vertaald, en verzonden naar de ontwikkelaars. Bij het compileren wordt voor efficientie een binaire versie van dit bestand - gemaakt (<em>fr.mo</em> - <em>mo</em> staat voor <em>machine - object</em>, dus met als doel gelezen te worden door programma's), en + gemaakt (<span class="emp">fr.mo</span> - <span class="emp">mo</span> staat voor <span class="emp">machine + object</span>, dus met als doel gelezen te worden door programma's), en geïnstalleerd. <code>calcurse</code> gebruikt dit bestand dan, om de strings te vertalen volgende de instellingen van de locale van de - gebruiker. + gebruiker.</p> - -<a name="contribute_i18n_translator"></a><h3>Taken van de vertaler</h3> +<h3>8.2.2 Taken van de vertaler<a name="contribute_i18n_translator"></a></h3> <p> Stel dat iemand met het vertalen naar een nieuwe taal wil beginnen. - Dan zijn dit de stappen die gevolgd moeten worden: + Dan zijn dit de stappen die gevolgd moeten worden:</p> <ul> <li>Vindt eerst uit wat de naam van de locale is. Voor frans bijvoorbeeld is het 'fr_FR', of simpelweg 'fr'. Dit is de waarde die in de omgevingsvariabele <code>LC_ALL</code> moet staan om software te vertalen (zie <a href="#basics_invocation_variable">De i18n - omgevingsvariabele</a>).<br> - <br> - <li>Ga dan naar de <em>po/</em> directory, en maak nieuwe + omgevingsvariabele</a>).</li> + <li>Ga dan naar de <span class="emp">po/</span> directory, en maak nieuwe po-bestanden aan met het volgende commando: - <pre> - 'msginit -i calcurse.pot -o fr.po -l fr --no-translator' - </pre> + <code>'msginit -i calcurse.pot -o fr.po -l fr --no-translator'</code> Indien <code>msginit</code> niet aanwezig is op het systeem, kopieer - dan simpelweg het <em>calcurse.pot</em> bestand en hernoem het naar - bijvoorbeeld <em>fr.po</em> en wijzig de header handmatig.<br> - Nu <em>fr.po</em> aangemaakt is, kan de vertaler beginnen. - </ul> - + dan simpelweg het <span class="emp">calcurse.pot</span> bestand en hernoem het naar + bijvoorbeeld <span class="emp">fr.po</span> en wijzig de header + handmatig.</li> + </ul> +<p> + Nu <span class="emp">fr.po</span> aangemaakt is, kan de vertaler beginnen.</p> -<a name="contribute_i18n_po-files"></a><h3>po-bestanden</h3> +<h3>8.2.3 po-bestanden<a name="contribute_i18n_po-files"></a></h3> <p> De indeling van de po-bestanden is vrij simpel. Po-bestanden bestaan - uit vier onderdelen: + uit vier onderdelen:</p> <ol> - <li><em>locatie regels:</em> informeert waar de strings gevonden + <li><span class="emp">locatie regels:</span> informeert waar de strings gevonden kunnen worden (bestandsnaam en regelnummer), in het geval dat je het - een beetje in context wilt zien. - <li><em>msgid regels:</em> de te vertalen strings. - <li><em>msgstr regels:</em> de vertaalde strings. - <li><em>regels met een '#' ervoor:</em> commentaar (sommige met een - speciale betekenis, zoals we verderop zullen zien). + een beetje in context wilt zien.</li> + <li><span class="emp">msgid regels:</span> de te vertalen strings.</li> + <li><span class="emp">msgstr regels:</span> de vertaalde strings.</li> + <li><span class="emp">regels met een '#' ervoor:</span> commentaar (sommige met een + speciale betekenis, zoals we verderop zullen zien).</li> </ol> - Eigenlijk, hoef je alleen de <em>msgstr</em> regels te vullen met de - vertaling van bovenstaande <em>msgid</em> regels. - <p> - <u>Een paar aanmerkingen:</u> - <ul> - <li><em>Fuzzy strings</em><br> - Wanneer je een string tegenkomt die gemarkeerd is met <code>"#, +<p> + Eigenlijk, hoef je alleen de <span class="emp">msgstr</span> regels te vullen met de + vertaling van bovenstaande <span class="emp">msgid</span> regels.</p> +<p> + <span class="valorise">Een paar aanmerkingen:</span> + <dl> + <dt><span class="emp">Fuzzy strings</span></dt> + <dd>Wanneer je een string tegenkomt die gemarkeerd is met <code>"#, fuzzy"</code>, zal <code>calcurse</code> de vertaling niet gebruiken totdat je iets verandert. 'Fuzzy' betekent dat de string al vertaald is, maar sindsdien is veranderd in de broncode van het programma, of @@ -760,10 +817,9 @@ ook zo zijn dat de vertaling niet juist meer is, en een verandering noodzakelijk is. Als de vertaling weer in orde is, wis dan de regel met <code>"#, fuzzy"</code>, en dan zal de vertaling weer gebruikt - worden in <code>calcurse</code>.<br> - <br> - <li><em>c-format strings en speciale tekens</em><br> - Sommige string hebben het volgende commentaar: <code>"#, + worden in <code>calcurse</code>.</dd> + <dt><span class="emp">c-format strings en speciale tekens</span></dt> + <dd>Sommige string hebben het volgende commentaar: <code>"#, c-format"</code>. Dit betekent dat een deel van de te vertalen string een speciale betekenis heeft voor het programma, en niet veranderd mag worden. Bijvoorbeeld, het teken %, gebruikt als <code>"%s"</code>. Dit @@ -771,21 +827,20 @@ andere string. Het is dus belangrijk dat het niet verwijderd wordt. Er zijn ook andere tekens zoals \, gebruikt als <code>\n</code> of <code>\t</code>. Verander ook deze niet. Het zijn respectievelijk - tekens voor einde-van-de-regel, en een tab.<br> - <br> - <li><em>Vertalingen mogen afgebroken worden</em><br> - Zodra een regel te lang wordt, kan je hem splitsen als volgt: + tekens voor einde-van-de-regel, en een tab.</dd> + <dt><span class="emp">Vertalingen mogen afgebroken worden</span></dt> + <dd>Zodra een regel te lang wordt, kan je hem splitsen als volgt: <pre> - msgid "" - "een hele lange regel" - "de volgende regel" - </pre> - <li><em>het begin van het po-bestand</em><br> - Aan het begin van het po-bestand, vormt de eerste string de 'header', +msgid "" +"een hele lange regel" +"de volgende regel" + </pre></dd> + <dt><span class="emp">het begin van het po-bestand</span></dt> + <dd>Aan het begin van het po-bestand, vormt de eerste string de 'header', waar verschillende soorten informatie kan worden ingevuld. Het belangrijkste is de karakterset. Het zou er als volgt uit moeten zien: <pre> - "Content-Type: text/plain; charset=utf-8\n" +"Content-Type: text/plain; charset=utf-8\n" </pre> Het is ook belangrijk dat het Last-Translator veld wordt ingevuld, zodat nieuwe vertalers zich bij je kunnen aanmelden, of dat mensen @@ -793,137 +848,129 @@ gevonden hebben. Je kan zowel een naam/bijnaam, of email adres invulllen, zoals bijvoorbeeld: <pre> - "Last-Translator: Frederic Culot <frederic@culot.org>\n" - </pre> - <li><em>Commentaar</em><br> - Het toevoegen van commentaar (regels die beginnen met het karakter +"Last-Translator: Frederic Culot <frederic@culot.org>\n" + </pre></dd> + <dt><span class="emp">Commentaar</span></dt> + <dd>Het toevoegen van commentaar (regels die beginnen met het karakter '#', is een juiste manier om problemen met vertalingen te markeren - voor proeflezers of andere vertalers.<br> - <br> - <li><em>De lengte van strings</em><br> - <code>calcurse</code> is een curses/console programma, dus het is nauw + voor proeflezers of andere vertalers.</dd> + <dt><span class="emp">De lengte van strings</span></dt> + <dd><code>calcurse</code> is een curses/console programma, dus het is nauw verbonden met het aantal kolommen dat de terminal gebruikt. Dit is iets om in gedachten te houden bij het vertalen. Vaak moet een string op een enkele regel passen. Het beste is dus om niet zomaar de strings te vertalen, maar om eerst te kijken waar ze weergegeven worden in het - programma, en pas dan te vertalen.<br> - <br> - <li><em>Een paar nuttige hulpmiddelen</em><br> - Het po-bestandsformaat is vrij simpel, en het bestand kan gewijzigd + programma, en pas dan te vertalen.</dd> + <dt><span class="emp">Een paar nuttige hulpmiddelen</span></dt> + <dd>Het po-bestandsformaat is vrij simpel, en het bestand kan gewijzigd worden met een standaard tekst-editor. Maar er zijn een paar gespecialiseerde hulpmiddelen, die je misschien handig vindt bij het vertalen: <ul> <li><code>poEdit</code> (<a href="http://www.poedit.org/" target="_blank"> - http://www.poedit.org/</a>) + http://www.poedit.org/</a>)</li> <li><code>KBabel</code> (<a href="http://i18n.kde.org/tools/kbabel/" target="_blank"> - http://i18n.kde.org/tools/kbabel/</a>) + http://i18n.kde.org/tools/kbabel/</a>)</li> <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 + http://gtranslator.sourceforge.net/</a>)</li> + <li><code>Emacs</code> po mode</li> + <li><code>Vim</code> po mode</li> </ul> - <br> - <li><em>En als laatste</em><br> - Ik hoop dat je het leuk vindt om bij te dragen aan een + </dd> + <dt><span class="emp">En als laatste</span></dt> + <dd>Ik hoop dat je het leuk vindt om bij te dragen aan een 'geïnternationaliseerde' wereld. :) Mocht je nog vragen hebben, schroom dat niet om contact met me op te nemen via - <em>frederic@culot.org</em>. </ul> - + <span class="emp">frederic @ culot . org</span>. </dd> + </dl> -<a name="links"></a><h1>Links</h1> +<h1>9. Links<a name="links"></a></h1> <p> - - Deze sectie bevat links en referenties welke je misschien interesseren. + Deze sectie bevat links en referenties welke je misschien interesseren.</p> - -<a name="links_homepage"></a><h2><code>calcurse</code> homepage</h2> +<h2>9.1 <code>calcurse</code> homepage<a name="links_homepage"></a></h2> <p> - De <code>calcurse</code> homepage is hier te vinden: - <pre> - http://culot.org/calcurse - </pre> + De <code>calcurse</code> homepage is hier te vinden:</p> + <pre>http://culot.org/calcurse</pre> -<a name="links_list"></a><h2><code>calcurse</code> mededelingenlijst</h2> +<h2>9.2 <code>calcurse</code> mededelingenlijst<a name="links_list"></a></h2> <p> Mocht je interesse hebben in het project, en op de hoogte wilt worden gehouden als er een nieuwe versie uitkomt, kan je jezelf inschrijven op de <code>calcurse</code> mededelingenlijst. Je ontvangt dan een - email zodra er iets nieuws is in <code>calcurse</code>.<br> + email zodra er iets nieuws is in <code>calcurse</code>.</p> +<p> Om je in te schrijven, zend dan een email naar - <code>calcurse-announce@culot.org</code> met "subscribe" - ingevuld bij 'onderwerp'. + <code>calcurse-announce @ culot . org</code> met "subscribe" + ingevuld bij 'onderwerp'.</p> -<a name="links_rss"></a><h2><code>calcurse</code> RSS feed</h2> +<h2><code>9.3 calcurse</code> RSS feed<a name="links_rss"></a></h2> <p> Nog een mogelijkheid om op de hoogte te blijven over nieuwe versies - is om de RSS feed te volgen: - <pre> - http://culot.org/calcurse/news_rss.xml - </pre> + is om de RSS feed te volgen:</p> + <pre>http://culot.org/calcurse/news_rss.xml</pre> +<p> Deze RSS feed wordt iedere keer vernieuwd als er een nieuwe versie van calcurse beschikbaar is, waarbij ook de nieuwe opties beschreven - worden. + worden. </p> -<a name="thanks"></a><h1>Dankwoord</a></h1> +<h1>10. Dankwoord<a name="thanks"></a></h1> <p> Het is tijd om de mensen te bedanken, zonder wie dit programma niet zou bestaan! Hier is een lijst met mensen die ik graag wil bedanken: <ul> <li>Alex voor zijn patches, hulp en advies met het programmeren in - <code>C</code> + <code>C</code> </li> <li>Gwen voor het testen en voor de discussies om - <code>calcurse</code> te verbeteren + <code>calcurse</code> te verbeteren</li> <li>Herbert voor het maken van een pakket voor <code>calcurse</code> - voor FreeBSD + voor FreeBSD </li> <li>Zul voor het maken van een pakket voor <code>calcurse</code> voor - NetBSD - <li>Wain voor het maken van een pakket voor <code>calcurse</code> voor - Archlinux + NetBSD</li> + <li>Wain, Steffen and Ronald voor het maken van een pakket voor <code>calcurse</code> voor + Archlinux</li> <li>Kevin, Ryan, en fEnIo voor het maken van een pakket voor - <code>calcurse</code> voor Debian en Ubuntu - <li>Steffen voor het maken van een pakket voor <code>calcurse</code> - voor Archlinux + <code>calcurse</code> voor Debian en Ubuntu</li> <li>Pascal voor het maken van een pakket voor <code>calcurse</code> - voor Slackware + voor Slackware</li> <li>Alexandre en Markus voor het maken van een pakket voor - <code>calcurse</code> voor Mac OsX en Darwin + <code>calcurse</code> voor Mac OsX en Darwin</li> <li>Igor voor het maken van een pakket voor <code>calcurse</code> for - ALT Linux + ALT Linux</li> <li>Joel voor zijn kalender script waarop de kalenderview van - <code>calcurse</code> geïnspireerd is + <code>calcurse</code> geïnspireerd is</li> <li>Michael Schulz en Chris M. voor de duitse vertaling van - <code>calcurse</code> en handleiding + <code>calcurse</code> en handleiding</li> <li>Jose Lopez voor de spaanse vertaling van <code>calcurse</code> en - handleiding - <li>Neil Williams voor de engelse vertaling - <li>Tony voor zijn patch die de recur_item_inday functie verbeterde. + handleiding</li> + <li>Neil Williams voor de engelse vertaling</li> + <li>Tony voor zijn patch die de recur_item_inday functie verbeterde.</li> <li>Jeremy Roon voor de nederlandse vertaling van - <code>calcurse</code> en handleiding + <code>calcurse</code> en handleiding</li> <li>en de mensen die de software geschreven hebben die ik goed vind en mij geïnspireerd hebben zoals: <ul> - <li><code>vim</code> voor de toetsen die de cursor verplaatsen + <li><code>vim</code> voor de toetsen die de cursor verplaatsen</li> <li><code>orpheus</code> en <code>abook</code> voor de - documentatie + documentatie</li> <li><code>pine</code> en <code>aptitude</code> - voor de tekstinterface - </ul> + voor de tekstinterface</li> + </ul></li> </ul> - <br> +</p> +<p> En als laatste wil ik graag de mensen bedanken die <code>calcurse</code> gebruiken, en mij aanvullingen en opbouwende - kritiek stuurden. - -<hr> -<small><em> -Copyright (c) 2004-2007 Frédéric Culot<br> -Calcurse version 1.9 - Last change: October 8, 2007 -<em></small> + kritiek stuurden.</p> +<div class="footer"> + Copyright (c) 2004-2008 Frédéric Culot<br> + Calcurse version 2.0 - Last change: February 09, 2008<br> +</div> +</div> </body> </html> |