From 3b4b5a1fad7ffa13a3c41162eadb51b01915014d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Thu, 22 Jul 2021 11:21:34 +0200 Subject: Use common rules for build and install documentation and translations. Simplify the structure of the documentation directories. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Slávek Banko --- doc/CMakeLists.txt | 14 - doc/de/CMakeLists.txt | 1 - doc/de/index.docbook | 644 +++++++++++++++++++++++++++++++++++ doc/de/kbiff/CMakeLists.txt | 1 - doc/de/kbiff/index.docbook | 644 ----------------------------------- doc/en/CMakeLists.txt | 1 - doc/en/index.docbook | 651 +++++++++++++++++++++++++++++++++++ doc/en/kbiff.png | Bin 0 -> 319 bytes doc/en/kbiff/CMakeLists.txt | 1 - doc/en/kbiff/index.docbook | 651 ----------------------------------- doc/en/kbiff/kbiff.png | Bin 319 -> 0 bytes doc/es/CMakeLists.txt | 1 - doc/es/index.docbook | 669 ++++++++++++++++++++++++++++++++++++ doc/es/kbiff/CMakeLists.txt | 1 - doc/es/kbiff/index.docbook | 669 ------------------------------------ doc/fr/CMakeLists.txt | 1 - doc/fr/index.docbook | 800 ++++++++++++++++++++++++++++++++++++++++++++ doc/fr/kbiff/CMakeLists.txt | 1 - doc/fr/kbiff/index.docbook | 800 -------------------------------------------- doc/man/CMakeLists.txt | 5 - 20 files changed, 2764 insertions(+), 2791 deletions(-) delete mode 100644 doc/CMakeLists.txt delete mode 100644 doc/de/CMakeLists.txt create mode 100644 doc/de/index.docbook delete mode 100644 doc/de/kbiff/CMakeLists.txt delete mode 100644 doc/de/kbiff/index.docbook delete mode 100644 doc/en/CMakeLists.txt create mode 100644 doc/en/index.docbook create mode 100644 doc/en/kbiff.png delete mode 100644 doc/en/kbiff/CMakeLists.txt delete mode 100644 doc/en/kbiff/index.docbook delete mode 100644 doc/en/kbiff/kbiff.png delete mode 100644 doc/es/CMakeLists.txt create mode 100644 doc/es/index.docbook delete mode 100644 doc/es/kbiff/CMakeLists.txt delete mode 100644 doc/es/kbiff/index.docbook delete mode 100644 doc/fr/CMakeLists.txt create mode 100644 doc/fr/index.docbook delete mode 100644 doc/fr/kbiff/CMakeLists.txt delete mode 100644 doc/fr/kbiff/index.docbook delete mode 100644 doc/man/CMakeLists.txt (limited to 'doc') diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt deleted file mode 100644 index 70d6348..0000000 --- a/doc/CMakeLists.txt +++ /dev/null @@ -1,14 +0,0 @@ -file( GLOB _dirs RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} * ) -string( REGEX REPLACE "[ \r\n\t]+" ";" _linguas "$ENV{LINGUAS}" ) - -foreach( _dir ${_dirs} ) - if( IS_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/${_dir} AND - EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${_dir}/CMakeLists.txt ) - if( "${_dir}" STREQUAL "en" OR - "${_dir}" STREQUAL "man" OR - "${_linguas}" MATCHES "^;*$" OR - ";${_linguas};" MATCHES ";${_dir};" ) - add_subdirectory( ${_dir} ) - endif( ) - endif() -endforeach() diff --git a/doc/de/CMakeLists.txt b/doc/de/CMakeLists.txt deleted file mode 100644 index 51feb67..0000000 --- a/doc/de/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -add_subdirectory( ${PROJECT_NAME} ) diff --git a/doc/de/index.docbook b/doc/de/index.docbook new file mode 100644 index 0000000..881f88e --- /dev/null +++ b/doc/de/index.docbook @@ -0,0 +1,644 @@ + +kbiff"> + +]> + + +Das Handbuch zu KBiff + + +Kurt Granroth + +
<granroth@kde.org>
+ + + + + + +KBiff ist ein Email-Melder, er unterstützt MBOX (Unix Stil), Maildir (wie bei Qmail), MH, POP3, IMAP4 und NNTP Protokolle. +Handbuch zu KBiff + +KBiff +Email +E-Mail +Mailbox + + + + +Einführung + + +Funktionen + +KBiff ist ein Email-Melder fürs KDE-Projekt, er zeigt mittels akustischer oder optischer Signale +eingehende Email an. Er hat einige Vorteile gegenüber konkurrierenden Programmen: + + + +Konfiguration über die graphische Benutzeroberfläche. Kommandozeilenparameter und +Konfigurations-Dateien werden nicht mehr benötigt. Alle Einstellungen können über das Menü "Einrichten" +vorgenommen werden. (Es ist aber möglich einige Funktionen über +Kommandozeilenparameter zu aktivieren.) + + + +Sitzungsorientiert. KBiff started automatisch mit der Konfiguration der letzten +Sitzung. + + +Andocken. KBiff kann einfach an die Kontrolleiste angedockt werden. Das ist besonders +nützlich wenn mehrere Postfächer überwacht werden sollen und spart Platz auf der Arbeitsfläche. + + +Bewegte GIFs. Es möglich bewegte (=animierte) GIFs als Icons zu verwenden. + + +Musik. KBiff kann .wav Dateien abspielen wenn neue Post eintrifft. + + +POP3, IMAP4, NNTP, Maildir, MBOX, MH. KBiff unterstützt alle verbreiteten Protokolle. + + +Mehrere Postfächer. KBiff kann gleichzeitig mehrere Postfächer verwalten. + + +Sonstiges. KBiff bietet noch viele zusätzliche Funktionen. + + + + +Bitte wenden Sie sich, mit Kommentaren und Vorschlägen für weitere Funktionen, direkt an mich. + +Kurt Granroth + +<granroth@kde.org> + + + + +Installation + + +Wie man KBiff erhält + +Die neueste Version (als Quellcode und als Binärformat) findet sich immer auf der KBiff Webseite: +http://www.granroth.org/kbiff +KBiff ist auch Teil des KDE Network Pakets, die neueste Version kann daher auch im CVS-Archiv gefunden +werden. + + + +Voraussetzungen + +Um KBiff zu kompilieren wird KDE Version 1.0 oder höher benötigt. Alle notwendigen Bibliotheken +finden sich hier: ftp://ftp.kde.org/pub/kde. + + + +Kompilieren und Installieren + +KBiff läßt sich sehr einfach kompilieren: +% ./configure +% make +% make install + + +Sollten Probleme auftreten, bitte informieren sie den Autor: +Autor. + + + + +Benutzung von KBiff + +Nahezu alle Funktionen lassen sich über den Dialog "Einstellungen" konfigurieren. +Einige Kommandozeilenparameter sind vorhanden - das dient der Bequemlichkeit, +denn für manches macht die Kontrolle über Kommandozeile mehr Sinn. + + +"Profil" + +KBiff arbeitet mit sogenannten Profilen. Das sind Konfigurationen die einem +oder mehreren Postfächern zugeordnet sind. Per Voreinstellung ist ein Profil "Inbox" +vorhanden (der Name läßt sich ändern). Dieses Profil enthält ein Postfach, üblicherweise +in der Form "/var/mail/benutzername", es könnte aber auch mehrere Postfächer enthalten. +Es ist möglich KBiff mehrmals (mit unterschiedlichen Profilen aufzurufen). Jedem KBiff-Icon +ist dann genau ein Profil zugeordnet. + + + +Kommandozeilenparameter + +KBiff versteht drei Kommandozeilenparameter: profile (=Profil), +debug (=Fehlersuche), und secure (=sicher). + +-profile <Profil_Name> Der Dialog "Einstellungen wird übersprungen und +KBiff started direkt mit dem angegebenen Profil. (Bsp: 'kbiff -profile Inbox') + +-debug Aktiviert ausführliche Status- und Fehlermeldungen. Nur sinnvoll + wenn Probleme mit KBiff auftreten. + +-secure Deaktiviert das Einstellungsmenü. Das kann nützlich sein wenn Sie + KBiff anzeigen wollen, anderen Benutzern aber nicht die Möglichkeit + geben wollen die Einstellungen zu ändern. + + + + + +Einstellungsmenü + +Alle Einstellungen können über das Einstellungsmenü vorgenommen werden. +Kommandozeilenparameter werden deshalb in der Regel nicht benötigt. + + +Profilname + +Der obere Teil des Einstellungsmenüs besteht aus einer + Auswahlliste und drei Knöpfen. +Ein Profil ist ein Satz von Einstellungen für ein Postfach +die unter einem Namen zusammengefaßt sind. Die drei Knöpfe "Neu", "Umbenennen" +und "Löschen" beziehen sich auf lediglich auf Profile, die eigentlichen +Postfächer bleiben unbehelligt. Beim ersten Start von KBiff wird automatisch +das Profil "Inbox" erzeugt. Dieses überwacht das System-Postfach. + + + +Einstellungsmenü + +Das Einstellungsmenü hat vier Ordner. Die Einstellung beziehen sich auf das gerade +ausgewählte Profil, es gibt keine Einstellungen die für alle Profile gültig sind. + + +Allgemein + +Dieser Ordner enthält die allgemeinen Einstellungen für das ausgewählte Profil. +Fünf Felder sind vorhanden: + + +Prüfintervall + +Dieses Feld legt fest, wie häufig KBiff das Postfach überprüft. Die Zeit +zwischen Abfragen wird in Sekunden angegeben, die Voreinstellung ist 60 Sekunden. + +Das geeignetste Prüfintervall hängt davon ab, in häufig neue Mail eintrifft. Wird etwa +fetchmail eingesetzt um alle 5 Minuten Email abzuholen, dann braucht das +Prüfintervall nicht kürzer zu sein. +Wird aber POP3 oder IMAP4 verwendet, dann ist sinnvoll ein längeres Intervall zu wählen. +Ein Intervall unterhalb von 60 Sekunden kann problematisch sein falls Ihre Netzwerkanbindung nicht +schnell genug ist. + + + +EMail-Programm + +Dieses Feld bestimmt welches Programm ausgeführt wird wenn KBiff angeklickt wird. +Normalerweise ist das ein Email-Programm, im Prinzip kann es aber ein beliebiges X-Window +Programm sein. Es ist nicht möglich einfach nur elm einzutragen (da kein X-Window +Programm) aber konsole -e elm funktioniert. Die Voreinstellung ist kmail -check. + + + +An Kontrolleiste andocken + +Wird diese Option ausgewählt (Voreinstellung) so startet KBiff angedockt an der Kontrolleiste. +Es ist aber möglich KBiff später wieder aus der Kontrolleiste auszuklinken. + + + +Benutze Sitzungs-Management + +Diese Option bestimmt ob Sitzungs-Management verwendet wird. Normalerweise sollte das +eingeschaltet bleiben. Nützlich ist diese Option wenn KDE mit dem gleichen Benutzerkonto +auf mehreren Rechnern verwendet wird. Dann ist es wahrscheinlich sinnvoll das Sitzungs-Management +abzuschalten und statt dessen den -profile Kommandozeilenparameter zu verwenden. + + + +Symbole + +KBiff benutzt drei Symbole um die Zustände "Keine Mail", "Alte Mail" und "Neue Mail" +anzuzeigen. Im Einrichtungsdialog werden die großformatigen Versionen dieser Symbole +angezeigt. Diese Symbole lassen sich einfach ändern: durch Anklicken des Symbols wird ein +Popup-Menü erzeugt, mit dem sich andere Symbole auswählen lassen. +KBiff unterstützt bewegte GIFs, im Einrichtungsdialog werden diese aber nur unbewegt dargestellt. + + + + +Neue Mail + +In diesem Ordner läßt sich festlegen was geschieht +wenn neue Nachrichten eintreffen. + + +Startbefehl + +Dieser Eintrag wird von einer Shell ausgeführt. Ein typisches Beispiel wäre +der Eintrag "play newmail.au". Beim Eintreffen einer neuen Email würde dieses +Kommando ausgeführt d.h. das Programm "play" würde die Audio-Datei "newmail.au" +abspielen. In der Voreinstellung ist diese Option abgeschaltet. + + + +Klang abspielen + +Hier läßt sich eine Audio-Datei angeben, die abgespielt wird wenn neue Email eintrifft. +In der aktuellen Version werden nur .wav-Dateien unterstützt. Die Audio-Datei muß mit dem +vollen Pfadnamen angegeben werden. In der Voreinstellung ist diese Option abgeschaltet. + + + +System-Ton + +Wenn diese Option eingeschaltet ist erzeugt KBiff einen Piepston wenn neue Mail eintrifft. +Diese Option ist wahrscheinlich die unaufdringlichste Methode auf neue Mail +hinzuweisen. In der Voreinstellung ist diese Option eingeschaltet. + + + +Benachrichtigen + +Wenn diese Option eingeschaltet ist erzeugt KBiff ein Popup-Fenster wenn neue Mail eintrifft +und zeigt an wieviele Nachrichten in welchen Postfächern eingegangen sind. +Diese Option ist wahrscheinlich ungeeignet für Postfächer in denen sehr viele Emails eintreffen. + + + +Floating Status + +Ist diese Option eingeschaltet so zeigt KBiff eine Liste aller Postfächer +zusammen mit der Anzahl der neuen Nachrichten in diesen Fächern an. +Das sieht dann aus wie ein Tooltip. + + + + +Postfach + +In diesem Ordner sind die Einstellungen der eigentlichen Postfächer untergebracht. + +Jedes Postfach hat einen eigenen Satz von Einstellungen in diesem Ordner. +Falls z.B. drei Postfächer zu diesem Profil gehören, dann müssen die Einstellungen +in diesem Ordner dreimal (einmal für jedes Postfach) vorgenommen werden. +Die Einstellungen in allen anderen Ordnern ist profilweit gültig, d.h. wenn die +Option "Benachrichtigen" im Ordner "Neue Mail" eingeschaltet ist, so gilt sie +für alle Postfächer dieses Profils. + + +Liste der Postfächer + +Auf der linken Seite ist die Liste der Postfächer des aktuellen Profils +untergebracht. Normalerweise ist nur ein Postfach (mit dem Namen "Default") aufgeführt, +es ist aber möglich mehrere Postfächer im gleichen Profil zu verwalten. + +Unterhalb der Liste sind zwei Knöpfe untergebracht. Der Knopf mit dem (amerikanischen) +Briefkastensymbol erzeugt ein neues Postfach, der Knopf mit Kreuz löscht das gerade +ausgewählte Postfach. Ein Postfach läßt sich nur umbennen indem ein neuer Eintrag (mit +den gleichen Einstellungen) hinzugefügt, und der alte Eintrag gelöscht wird. + + + +Protokoll + +Hier läßt sich das Protokoll für das ausgewählte Postfach einstellen. Es stehen +vier Protokolle zur Verfügung: mbox (Unix Stil), maildir (Qmail), POP3, und IMAP4. +Außerdem gibt es das Quasi-Protokoll "file" (=Datei) mit dem sich eine beliebige +lokale Datei überwachen läßt. (Dabei werden die Dateiinformationen über den +letzten Lesezugriff bzw. die letzte Änderung der Datei ausgewertet). + + + +Postfach + +Für das POP3-Protokoll steht dieses Feld nicht zur Verfügung, für anderen Protokolle +wird hier der Pfadname zum Postfach eingetragen. Für "mbox" zeigt der Pfad auf eine +Datei, für "maildir" und "IMAP4" zeigt er auf ein Verzeichnis. + + + +Server + +Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. + + + +Benutzer + +Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. + + + +Paßwort + +Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. + + + +Speichere Paßwort + +Paßwort für die nächste Sitzung speichern. + +KBiff speichert das Paßwort unverschlüsselt! Zwar wird es nicht im Klartext +gespeichert, es ist aber trivial mit Hilfe des KBiff-Quelltexts oder auch nur +mit etwas Geduld das Paßwort zu dekodieren. In einem ungeschützten Netzwork sollte +diese Option besser ausgeschaltet werden. + + + +Erweiterte Optionen + +Dieser Knopf erzeugt ein Menü mit erweiterten Einstellungen. + + +Postfach URL (=Uniform Resource Locator = Universelle Dokument-Adresse) + +KBiff verwaltet Postfächer als URL. Wenn Sie sich gut mit KBiff auskennen, so +können Sie dir URL hier ändern. Allgemein wird das aber nicht empfohlen. + + + +Port + +Hier läßt sich der Netzwerk-Port des Mailservers einstellen. Normalerweise +ist das 110 für das POP3-Format und 143 für das IMAP-Format. + + + +PREAUTH + +Normalerweise wird diese Option nicht benötigt. Ist Sie Ihnen nicht verständlich benötigen +Sie sie wahrscheinlich nicht. + + + +Verbindung halten + +Für POP3 und IMAP4 Formate. Wenn diese Option eingeschaltet ist, dann +wird die Verbindung von KBiff zum Mailserver aufrechterhalten. KBiff loggt sich +einmal ein und bleibt dann eingeloggt. Das Beschleunigt den Zugriff, ist aber +nicht zu empfehlen wenn der Mailserver nur einem Programm zur gleichen Zeit den +Zugriff ermöglicht. Das bedeutet dann nämlich, daß ihr Mailprogramm nicht +mehr an das Postfach herankommt. + + + + + +Über + +Informationen über KBiff. + + +Über KBiff + +Informationen über die verwendete Version von KBiff und Kontaktinformation des +Programmautors. + +Die Email-Adresse läßt sich anklicken wenn die Variable MAILER korrekt +eingestellt ist, KBiff ruft dann ein Email-Programm auf mit dem man dann eine +Email an den KBiff-Autor senden kann. + +Wird die Variable MAILER so gesetzt (in csh): + % setenv MAILER "konsole -e mutt" +dann verwendet KBiff konsole -e mutt um das Email-Programm aufzurufen. + + + + + + +Das Popup-Menü + +Das Popup-Menü wird angezeigt wenn das KBiff-Icon mit der rechten Maustaste +angeklickt wird. + + +(An)docken + +Hier läßt sich einstellen ob KBiff ans Panel angedockt werden soll. +Dies funktioniert nur mit Fenster-Managern die +KDE kompatibel sind, wie etwa KWM. + +Die Voreinstellung läßt sich über das Einstellungsmenü wählen. + + + +Einstellungen + +Ruft das Einstellungsmenü auf. Siehe Abschnitt "Einstellungen". + + + +Hilfe + +Zeigt den Hilfetext an (dieses Dokument). + + + +Nach Mail sehen + +Diese Option veranlaßt KBiff sofort festzustellen ob neue Nachrichten vorhanden sind +anstatt auf das nächste Abfrageintervall zu warten. Dabei werden alle Postfächer des +Profils überprüft. + + + +Jetzt Mail lesen + +Wird diese Aktion ausgewählt, so markiert KBiff alle Nachrichten auf dem +POP3- oder IMAP4-Server als "gelesen". Das kann nützlich sein, wenn +Sie die auf dem Server vorhandene Mail nicht sofort laden möchten, aber +dennoch bei weiterer Mail benachrichtigt werden wollen. + + + +Stop/Start + +Hält KBiff an, oder startet es wieder. Ist KBiff angehalten so überprüft +es nicht mehr ob neue Nachrichten verfügbar sind. + + + + +Fragen, Antworten, und Tips + + +Gibt es auch andere Mail-Wächter für KDE? + +Ja, dem Autor sind zwei weitere Mail-Wächter bekannt. Der Erste war +KOrn, er eignet sich besonders um mehrere Postfächer gleichzeitig zu +überwachen. Es zeigt dabei auch die Anzahl der neuen Mails in jedem Postfach +an. Eine weitere Alternative ist KNewMail. Er ist dem +Windows-Programm NewMail nachgebildet. Er arbeitet mit dem POP3-Protokoll und +zeigt die "Betreff"-Zeile der neuen Mails an. + + + +Was genau ist der Unterschied zwischen einem Profil und einem Postfach? + +Ein Profil umfaßt die Einstellungen für eine Gruppe von Postfächern, es +ist aber möglich das diese Gruppe aus nur einem einzigen Postfach besteht. + +Ein typisches Beispiel für ein Postfach ist "/usr/var/username". + + + +Wie lassen sich die Icons für KBiff auswählen? + +Sie können über das Einstellungsmenü ausgewählt werden. + +KBiff sucht nach den Icons im normalen KDE Icon-Pfad. Derzeit ist dies: + +tdedir()/share/apps/kbiff/toolbar +tdedir()/share/toolbar +tdedir()/share/icons +tdedir()/share/apps/kbiff/pics +$HOME/.kde/share/apps/kbiff/toolbar +$HOME/.kde/share/toolbar +$HOME/.kde/share/icons +$HOME/.kde/share/apps/kbiff/pics + + +Üblicherweise steht "tdedir()" für "/opt/kde" und $HOME ist ihr "home +directory" (= Heimatverzeichnis). Wenn Sie eigene Icons verwenden möchten, +können Sie diese einfach in eines der genannten Verzeichnisse einfügen. Am +besten geeignet ist $HOME/.kde/share/apps/kbiff/pics + +Wenn Sie KBiff andocken möchten, so sollten sie eine 22x22 (oder kleinere) +Version Ihres Icons haben. Der Name dieses verkleinerten Icons sollte aus dem +Icon-Namen und dem Prefix "mini-" bestehen. + +Möglicherweise möchten Sie das Icon "oldmail.xpm" verwenden um das Vorhandensein +alter Mail anzuzeigen (das ist die Voreinstellung). Andererseits möchten sie vielleicht +für den gleichen Zweck das kleinere Icon "nettesbild.xpm" verwenden wenn KBiff +angedockt ist. Das ließe sich nur realisieren wenn sie "nettesbild.xpm" in +"mini-oldmail.xpm" umbennen. + +KBiff verwendet das Icon, das für alte Mail verwendet wird, als Größenreferenz. +Es stellt seine Größe entsprechend ein. Daher sollten die Icons ungefähr die gleiche +Größe besitzen. + + + +Wie läßt sich elm (oder mutt oder PINE) mit KBiff verwenden? + +Es ist leider nicht möglich einfach "elm" in das Eingabefeld für das +Email-Programm einzugeben. Programme wie "elm", "mutt" und "PINE" +müssen in einem Terminalfenster gestartet werden. Der Autor verwendet diesen +Eintrag um "mutt" als Email-Programm zu starten: +konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt & + +Für graphische Email-Programme wie KMail wird kein Terminalfenster benötigt und der Name des Programms kann direkt ins +Eingabefeld eingetragen werden. + + + +Warum werden manche Audiodateien nicht abgespielt? + +KBiff verwendet die Klasse "KAudio" um Musikdateien abzuspielen. Diese Klasse +unterstützt derzeit aber ausschliesslich das ".wav"-Format. Man kann aber +z.B. das SOX-Paket installieren und dann 'play newmail.au' (oder +'cat newmail.au > /dev/audio') in das Feld "Startbefehl" eintragen. + + + +Ist es möglich KBiff ohne Sitzungs-Management zu verwenden? + +Die Voreinstellung aktiviert das Sitzungs-Management, es ist aber möglich +das abzustellen. KBiff kann weiterhin automatisch gestartet werden wenn Sie es +in Ihr Autostart-Verzeichnis aufnehmen und die Option '-profile' angeben. + + + +Die Email-Adresse des Autors (im Eintrag "Über") läßt sich nicht +anklicken. + +Leider ist diese Funktion noch nicht vollständig implementiert. Wenn die +Umgebungsvariable "MAILER" korrekt gesetzt ist, sollte es funktionieren. + +z.B.: +% setenv MAILER konsole -e mutt + + +Wird diese Variable so gesetzt, so verwendet kfm für 'mailto:'-Links +gleichfalls das entsprechende Mail-Programm. + + + +Andere Email-Wächter funktionieren nicht mehr wenn KBiff verwendet +wird. + +KBiff öffnet das Postfach um festzustellen wieviele neue Nachrichten +vorhanden sind. Die meisten Email-Wächter werden dies als Lesezugriff +interpretieren, und die Mails im Postfach als "gelesen" klassifizieren. + +Es gibt drei Lösungsmöglichkeiten: + +KBiff nicht verwenden. + + +Anstatt des 'mbox'-Protokolls das 'file'-Protokoll verwenden (leider läßt sich +dann nicht mehr ersehen wieviele neue Nachrichten eingegangen sind). + + +Alle Postfächer von 'mbox' auf 'maildir' umstellen. + + + + + + +Kann KBiff mit Netscape-Mail zusammenarbeiten? + +'netscape -mail' einzutragen reicht leider nicht aus. Hier ist die Lösung +(vorgeschlagen bei Steven Boger (sboger@marcus-online.net) ). + +Zunächst wird dieses Shellscript benötigt: + +#!/bin/sh +if [ -L "$HOME/.netscape/lock" ]; +then +netscape -remote 'xfeDoCommand(openInbox)' +else +netscape -mail & +fi + + + + +KBiff schneidet den ersten "/" im IMAP Mode ab. Ist das ein Bug? + +Nein, daß ist kein Problem. Normalerweise wird mit IMAP kein absoluter Pfad +verwendet, praktisch alle Postfächer können (und werden) über relative Pfadnamen +oder symbolische Links wie 'inbox angesprochen. + +Wenn Sie beispielsweise auf /var/spool/mail/username zugreifen wollen +geht das in der Regel in dem Sie inbox als Postfachnamen benutzen. + + + +Vorschläge für neue Funktionen + +Wenn Sie einen Vorschlag für eine neue Funktion haben, bitte konsultieren Sie +zunächst die TODO-Datei der Quelltext-Distribution oder die KBiff Webseite. +Sollte Ihre Idee bereits eingetragen sein, bitte haben Sie Geduld, sie könnte +schon bald implementiert werden. Ist sie noch nicht aufgeführt so senden Sie +sie bitte per Email an den Autor. Der Autor kann aber nicht garantieren daß +Ihre Idee in KBiff integriert wird. + + + + +Autoren und Übersetzer + +KBiff wurde geschrieben von: +Kurt Granroth + +Deutsche Übersetzung von Stefan Doll: +<stefan@i-2000.com> + + diff --git a/doc/de/kbiff/CMakeLists.txt b/doc/de/kbiff/CMakeLists.txt deleted file mode 100644 index eca4bd4..0000000 --- a/doc/de/kbiff/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -tde_create_handbook( DESTINATION ${PROJECT_NAME} LANG de ) diff --git a/doc/de/kbiff/index.docbook b/doc/de/kbiff/index.docbook deleted file mode 100644 index 881f88e..0000000 --- a/doc/de/kbiff/index.docbook +++ /dev/null @@ -1,644 +0,0 @@ - -kbiff"> - -]> - - -Das Handbuch zu KBiff - - -Kurt Granroth - -
<granroth@kde.org>
- - - - - - -KBiff ist ein Email-Melder, er unterstützt MBOX (Unix Stil), Maildir (wie bei Qmail), MH, POP3, IMAP4 und NNTP Protokolle. -Handbuch zu KBiff - -KBiff -Email -E-Mail -Mailbox - - - - -Einführung - - -Funktionen - -KBiff ist ein Email-Melder fürs KDE-Projekt, er zeigt mittels akustischer oder optischer Signale -eingehende Email an. Er hat einige Vorteile gegenüber konkurrierenden Programmen: - - - -Konfiguration über die graphische Benutzeroberfläche. Kommandozeilenparameter und -Konfigurations-Dateien werden nicht mehr benötigt. Alle Einstellungen können über das Menü "Einrichten" -vorgenommen werden. (Es ist aber möglich einige Funktionen über -Kommandozeilenparameter zu aktivieren.) - - - -Sitzungsorientiert. KBiff started automatisch mit der Konfiguration der letzten -Sitzung. - - -Andocken. KBiff kann einfach an die Kontrolleiste angedockt werden. Das ist besonders -nützlich wenn mehrere Postfächer überwacht werden sollen und spart Platz auf der Arbeitsfläche. - - -Bewegte GIFs. Es möglich bewegte (=animierte) GIFs als Icons zu verwenden. - - -Musik. KBiff kann .wav Dateien abspielen wenn neue Post eintrifft. - - -POP3, IMAP4, NNTP, Maildir, MBOX, MH. KBiff unterstützt alle verbreiteten Protokolle. - - -Mehrere Postfächer. KBiff kann gleichzeitig mehrere Postfächer verwalten. - - -Sonstiges. KBiff bietet noch viele zusätzliche Funktionen. - - - - -Bitte wenden Sie sich, mit Kommentaren und Vorschlägen für weitere Funktionen, direkt an mich. - -Kurt Granroth - -<granroth@kde.org> - - - - -Installation - - -Wie man KBiff erhält - -Die neueste Version (als Quellcode und als Binärformat) findet sich immer auf der KBiff Webseite: -http://www.granroth.org/kbiff -KBiff ist auch Teil des KDE Network Pakets, die neueste Version kann daher auch im CVS-Archiv gefunden -werden. - - - -Voraussetzungen - -Um KBiff zu kompilieren wird KDE Version 1.0 oder höher benötigt. Alle notwendigen Bibliotheken -finden sich hier: ftp://ftp.kde.org/pub/kde. - - - -Kompilieren und Installieren - -KBiff läßt sich sehr einfach kompilieren: -% ./configure -% make -% make install - - -Sollten Probleme auftreten, bitte informieren sie den Autor: -Autor. - - - - -Benutzung von KBiff - -Nahezu alle Funktionen lassen sich über den Dialog "Einstellungen" konfigurieren. -Einige Kommandozeilenparameter sind vorhanden - das dient der Bequemlichkeit, -denn für manches macht die Kontrolle über Kommandozeile mehr Sinn. - - -"Profil" - -KBiff arbeitet mit sogenannten Profilen. Das sind Konfigurationen die einem -oder mehreren Postfächern zugeordnet sind. Per Voreinstellung ist ein Profil "Inbox" -vorhanden (der Name läßt sich ändern). Dieses Profil enthält ein Postfach, üblicherweise -in der Form "/var/mail/benutzername", es könnte aber auch mehrere Postfächer enthalten. -Es ist möglich KBiff mehrmals (mit unterschiedlichen Profilen aufzurufen). Jedem KBiff-Icon -ist dann genau ein Profil zugeordnet. - - - -Kommandozeilenparameter - -KBiff versteht drei Kommandozeilenparameter: profile (=Profil), -debug (=Fehlersuche), und secure (=sicher). - --profile <Profil_Name> Der Dialog "Einstellungen wird übersprungen und -KBiff started direkt mit dem angegebenen Profil. (Bsp: 'kbiff -profile Inbox') - --debug Aktiviert ausführliche Status- und Fehlermeldungen. Nur sinnvoll - wenn Probleme mit KBiff auftreten. - --secure Deaktiviert das Einstellungsmenü. Das kann nützlich sein wenn Sie - KBiff anzeigen wollen, anderen Benutzern aber nicht die Möglichkeit - geben wollen die Einstellungen zu ändern. - - - - - -Einstellungsmenü - -Alle Einstellungen können über das Einstellungsmenü vorgenommen werden. -Kommandozeilenparameter werden deshalb in der Regel nicht benötigt. - - -Profilname - -Der obere Teil des Einstellungsmenüs besteht aus einer - Auswahlliste und drei Knöpfen. -Ein Profil ist ein Satz von Einstellungen für ein Postfach -die unter einem Namen zusammengefaßt sind. Die drei Knöpfe "Neu", "Umbenennen" -und "Löschen" beziehen sich auf lediglich auf Profile, die eigentlichen -Postfächer bleiben unbehelligt. Beim ersten Start von KBiff wird automatisch -das Profil "Inbox" erzeugt. Dieses überwacht das System-Postfach. - - - -Einstellungsmenü - -Das Einstellungsmenü hat vier Ordner. Die Einstellung beziehen sich auf das gerade -ausgewählte Profil, es gibt keine Einstellungen die für alle Profile gültig sind. - - -Allgemein - -Dieser Ordner enthält die allgemeinen Einstellungen für das ausgewählte Profil. -Fünf Felder sind vorhanden: - - -Prüfintervall - -Dieses Feld legt fest, wie häufig KBiff das Postfach überprüft. Die Zeit -zwischen Abfragen wird in Sekunden angegeben, die Voreinstellung ist 60 Sekunden. - -Das geeignetste Prüfintervall hängt davon ab, in häufig neue Mail eintrifft. Wird etwa -fetchmail eingesetzt um alle 5 Minuten Email abzuholen, dann braucht das -Prüfintervall nicht kürzer zu sein. -Wird aber POP3 oder IMAP4 verwendet, dann ist sinnvoll ein längeres Intervall zu wählen. -Ein Intervall unterhalb von 60 Sekunden kann problematisch sein falls Ihre Netzwerkanbindung nicht -schnell genug ist. - - - -EMail-Programm - -Dieses Feld bestimmt welches Programm ausgeführt wird wenn KBiff angeklickt wird. -Normalerweise ist das ein Email-Programm, im Prinzip kann es aber ein beliebiges X-Window -Programm sein. Es ist nicht möglich einfach nur elm einzutragen (da kein X-Window -Programm) aber konsole -e elm funktioniert. Die Voreinstellung ist kmail -check. - - - -An Kontrolleiste andocken - -Wird diese Option ausgewählt (Voreinstellung) so startet KBiff angedockt an der Kontrolleiste. -Es ist aber möglich KBiff später wieder aus der Kontrolleiste auszuklinken. - - - -Benutze Sitzungs-Management - -Diese Option bestimmt ob Sitzungs-Management verwendet wird. Normalerweise sollte das -eingeschaltet bleiben. Nützlich ist diese Option wenn KDE mit dem gleichen Benutzerkonto -auf mehreren Rechnern verwendet wird. Dann ist es wahrscheinlich sinnvoll das Sitzungs-Management -abzuschalten und statt dessen den -profile Kommandozeilenparameter zu verwenden. - - - -Symbole - -KBiff benutzt drei Symbole um die Zustände "Keine Mail", "Alte Mail" und "Neue Mail" -anzuzeigen. Im Einrichtungsdialog werden die großformatigen Versionen dieser Symbole -angezeigt. Diese Symbole lassen sich einfach ändern: durch Anklicken des Symbols wird ein -Popup-Menü erzeugt, mit dem sich andere Symbole auswählen lassen. -KBiff unterstützt bewegte GIFs, im Einrichtungsdialog werden diese aber nur unbewegt dargestellt. - - - - -Neue Mail - -In diesem Ordner läßt sich festlegen was geschieht -wenn neue Nachrichten eintreffen. - - -Startbefehl - -Dieser Eintrag wird von einer Shell ausgeführt. Ein typisches Beispiel wäre -der Eintrag "play newmail.au". Beim Eintreffen einer neuen Email würde dieses -Kommando ausgeführt d.h. das Programm "play" würde die Audio-Datei "newmail.au" -abspielen. In der Voreinstellung ist diese Option abgeschaltet. - - - -Klang abspielen - -Hier läßt sich eine Audio-Datei angeben, die abgespielt wird wenn neue Email eintrifft. -In der aktuellen Version werden nur .wav-Dateien unterstützt. Die Audio-Datei muß mit dem -vollen Pfadnamen angegeben werden. In der Voreinstellung ist diese Option abgeschaltet. - - - -System-Ton - -Wenn diese Option eingeschaltet ist erzeugt KBiff einen Piepston wenn neue Mail eintrifft. -Diese Option ist wahrscheinlich die unaufdringlichste Methode auf neue Mail -hinzuweisen. In der Voreinstellung ist diese Option eingeschaltet. - - - -Benachrichtigen - -Wenn diese Option eingeschaltet ist erzeugt KBiff ein Popup-Fenster wenn neue Mail eintrifft -und zeigt an wieviele Nachrichten in welchen Postfächern eingegangen sind. -Diese Option ist wahrscheinlich ungeeignet für Postfächer in denen sehr viele Emails eintreffen. - - - -Floating Status - -Ist diese Option eingeschaltet so zeigt KBiff eine Liste aller Postfächer -zusammen mit der Anzahl der neuen Nachrichten in diesen Fächern an. -Das sieht dann aus wie ein Tooltip. - - - - -Postfach - -In diesem Ordner sind die Einstellungen der eigentlichen Postfächer untergebracht. - -Jedes Postfach hat einen eigenen Satz von Einstellungen in diesem Ordner. -Falls z.B. drei Postfächer zu diesem Profil gehören, dann müssen die Einstellungen -in diesem Ordner dreimal (einmal für jedes Postfach) vorgenommen werden. -Die Einstellungen in allen anderen Ordnern ist profilweit gültig, d.h. wenn die -Option "Benachrichtigen" im Ordner "Neue Mail" eingeschaltet ist, so gilt sie -für alle Postfächer dieses Profils. - - -Liste der Postfächer - -Auf der linken Seite ist die Liste der Postfächer des aktuellen Profils -untergebracht. Normalerweise ist nur ein Postfach (mit dem Namen "Default") aufgeführt, -es ist aber möglich mehrere Postfächer im gleichen Profil zu verwalten. - -Unterhalb der Liste sind zwei Knöpfe untergebracht. Der Knopf mit dem (amerikanischen) -Briefkastensymbol erzeugt ein neues Postfach, der Knopf mit Kreuz löscht das gerade -ausgewählte Postfach. Ein Postfach läßt sich nur umbennen indem ein neuer Eintrag (mit -den gleichen Einstellungen) hinzugefügt, und der alte Eintrag gelöscht wird. - - - -Protokoll - -Hier läßt sich das Protokoll für das ausgewählte Postfach einstellen. Es stehen -vier Protokolle zur Verfügung: mbox (Unix Stil), maildir (Qmail), POP3, und IMAP4. -Außerdem gibt es das Quasi-Protokoll "file" (=Datei) mit dem sich eine beliebige -lokale Datei überwachen läßt. (Dabei werden die Dateiinformationen über den -letzten Lesezugriff bzw. die letzte Änderung der Datei ausgewertet). - - - -Postfach - -Für das POP3-Protokoll steht dieses Feld nicht zur Verfügung, für anderen Protokolle -wird hier der Pfadname zum Postfach eingetragen. Für "mbox" zeigt der Pfad auf eine -Datei, für "maildir" und "IMAP4" zeigt er auf ein Verzeichnis. - - - -Server - -Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. - - - -Benutzer - -Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. - - - -Paßwort - -Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. - - - -Speichere Paßwort - -Paßwort für die nächste Sitzung speichern. - -KBiff speichert das Paßwort unverschlüsselt! Zwar wird es nicht im Klartext -gespeichert, es ist aber trivial mit Hilfe des KBiff-Quelltexts oder auch nur -mit etwas Geduld das Paßwort zu dekodieren. In einem ungeschützten Netzwork sollte -diese Option besser ausgeschaltet werden. - - - -Erweiterte Optionen - -Dieser Knopf erzeugt ein Menü mit erweiterten Einstellungen. - - -Postfach URL (=Uniform Resource Locator = Universelle Dokument-Adresse) - -KBiff verwaltet Postfächer als URL. Wenn Sie sich gut mit KBiff auskennen, so -können Sie dir URL hier ändern. Allgemein wird das aber nicht empfohlen. - - - -Port - -Hier läßt sich der Netzwerk-Port des Mailservers einstellen. Normalerweise -ist das 110 für das POP3-Format und 143 für das IMAP-Format. - - - -PREAUTH - -Normalerweise wird diese Option nicht benötigt. Ist Sie Ihnen nicht verständlich benötigen -Sie sie wahrscheinlich nicht. - - - -Verbindung halten - -Für POP3 und IMAP4 Formate. Wenn diese Option eingeschaltet ist, dann -wird die Verbindung von KBiff zum Mailserver aufrechterhalten. KBiff loggt sich -einmal ein und bleibt dann eingeloggt. Das Beschleunigt den Zugriff, ist aber -nicht zu empfehlen wenn der Mailserver nur einem Programm zur gleichen Zeit den -Zugriff ermöglicht. Das bedeutet dann nämlich, daß ihr Mailprogramm nicht -mehr an das Postfach herankommt. - - - - - -Über - -Informationen über KBiff. - - -Über KBiff - -Informationen über die verwendete Version von KBiff und Kontaktinformation des -Programmautors. - -Die Email-Adresse läßt sich anklicken wenn die Variable MAILER korrekt -eingestellt ist, KBiff ruft dann ein Email-Programm auf mit dem man dann eine -Email an den KBiff-Autor senden kann. - -Wird die Variable MAILER so gesetzt (in csh): - % setenv MAILER "konsole -e mutt" -dann verwendet KBiff konsole -e mutt um das Email-Programm aufzurufen. - - - - - - -Das Popup-Menü - -Das Popup-Menü wird angezeigt wenn das KBiff-Icon mit der rechten Maustaste -angeklickt wird. - - -(An)docken - -Hier läßt sich einstellen ob KBiff ans Panel angedockt werden soll. -Dies funktioniert nur mit Fenster-Managern die -KDE kompatibel sind, wie etwa KWM. - -Die Voreinstellung läßt sich über das Einstellungsmenü wählen. - - - -Einstellungen - -Ruft das Einstellungsmenü auf. Siehe Abschnitt "Einstellungen". - - - -Hilfe - -Zeigt den Hilfetext an (dieses Dokument). - - - -Nach Mail sehen - -Diese Option veranlaßt KBiff sofort festzustellen ob neue Nachrichten vorhanden sind -anstatt auf das nächste Abfrageintervall zu warten. Dabei werden alle Postfächer des -Profils überprüft. - - - -Jetzt Mail lesen - -Wird diese Aktion ausgewählt, so markiert KBiff alle Nachrichten auf dem -POP3- oder IMAP4-Server als "gelesen". Das kann nützlich sein, wenn -Sie die auf dem Server vorhandene Mail nicht sofort laden möchten, aber -dennoch bei weiterer Mail benachrichtigt werden wollen. - - - -Stop/Start - -Hält KBiff an, oder startet es wieder. Ist KBiff angehalten so überprüft -es nicht mehr ob neue Nachrichten verfügbar sind. - - - - -Fragen, Antworten, und Tips - - -Gibt es auch andere Mail-Wächter für KDE? - -Ja, dem Autor sind zwei weitere Mail-Wächter bekannt. Der Erste war -KOrn, er eignet sich besonders um mehrere Postfächer gleichzeitig zu -überwachen. Es zeigt dabei auch die Anzahl der neuen Mails in jedem Postfach -an. Eine weitere Alternative ist KNewMail. Er ist dem -Windows-Programm NewMail nachgebildet. Er arbeitet mit dem POP3-Protokoll und -zeigt die "Betreff"-Zeile der neuen Mails an. - - - -Was genau ist der Unterschied zwischen einem Profil und einem Postfach? - -Ein Profil umfaßt die Einstellungen für eine Gruppe von Postfächern, es -ist aber möglich das diese Gruppe aus nur einem einzigen Postfach besteht. - -Ein typisches Beispiel für ein Postfach ist "/usr/var/username". - - - -Wie lassen sich die Icons für KBiff auswählen? - -Sie können über das Einstellungsmenü ausgewählt werden. - -KBiff sucht nach den Icons im normalen KDE Icon-Pfad. Derzeit ist dies: - -tdedir()/share/apps/kbiff/toolbar -tdedir()/share/toolbar -tdedir()/share/icons -tdedir()/share/apps/kbiff/pics -$HOME/.kde/share/apps/kbiff/toolbar -$HOME/.kde/share/toolbar -$HOME/.kde/share/icons -$HOME/.kde/share/apps/kbiff/pics - - -Üblicherweise steht "tdedir()" für "/opt/kde" und $HOME ist ihr "home -directory" (= Heimatverzeichnis). Wenn Sie eigene Icons verwenden möchten, -können Sie diese einfach in eines der genannten Verzeichnisse einfügen. Am -besten geeignet ist $HOME/.kde/share/apps/kbiff/pics - -Wenn Sie KBiff andocken möchten, so sollten sie eine 22x22 (oder kleinere) -Version Ihres Icons haben. Der Name dieses verkleinerten Icons sollte aus dem -Icon-Namen und dem Prefix "mini-" bestehen. - -Möglicherweise möchten Sie das Icon "oldmail.xpm" verwenden um das Vorhandensein -alter Mail anzuzeigen (das ist die Voreinstellung). Andererseits möchten sie vielleicht -für den gleichen Zweck das kleinere Icon "nettesbild.xpm" verwenden wenn KBiff -angedockt ist. Das ließe sich nur realisieren wenn sie "nettesbild.xpm" in -"mini-oldmail.xpm" umbennen. - -KBiff verwendet das Icon, das für alte Mail verwendet wird, als Größenreferenz. -Es stellt seine Größe entsprechend ein. Daher sollten die Icons ungefähr die gleiche -Größe besitzen. - - - -Wie läßt sich elm (oder mutt oder PINE) mit KBiff verwenden? - -Es ist leider nicht möglich einfach "elm" in das Eingabefeld für das -Email-Programm einzugeben. Programme wie "elm", "mutt" und "PINE" -müssen in einem Terminalfenster gestartet werden. Der Autor verwendet diesen -Eintrag um "mutt" als Email-Programm zu starten: -konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt & - -Für graphische Email-Programme wie KMail wird kein Terminalfenster benötigt und der Name des Programms kann direkt ins -Eingabefeld eingetragen werden. - - - -Warum werden manche Audiodateien nicht abgespielt? - -KBiff verwendet die Klasse "KAudio" um Musikdateien abzuspielen. Diese Klasse -unterstützt derzeit aber ausschliesslich das ".wav"-Format. Man kann aber -z.B. das SOX-Paket installieren und dann 'play newmail.au' (oder -'cat newmail.au > /dev/audio') in das Feld "Startbefehl" eintragen. - - - -Ist es möglich KBiff ohne Sitzungs-Management zu verwenden? - -Die Voreinstellung aktiviert das Sitzungs-Management, es ist aber möglich -das abzustellen. KBiff kann weiterhin automatisch gestartet werden wenn Sie es -in Ihr Autostart-Verzeichnis aufnehmen und die Option '-profile' angeben. - - - -Die Email-Adresse des Autors (im Eintrag "Über") läßt sich nicht -anklicken. - -Leider ist diese Funktion noch nicht vollständig implementiert. Wenn die -Umgebungsvariable "MAILER" korrekt gesetzt ist, sollte es funktionieren. - -z.B.: -% setenv MAILER konsole -e mutt - - -Wird diese Variable so gesetzt, so verwendet kfm für 'mailto:'-Links -gleichfalls das entsprechende Mail-Programm. - - - -Andere Email-Wächter funktionieren nicht mehr wenn KBiff verwendet -wird. - -KBiff öffnet das Postfach um festzustellen wieviele neue Nachrichten -vorhanden sind. Die meisten Email-Wächter werden dies als Lesezugriff -interpretieren, und die Mails im Postfach als "gelesen" klassifizieren. - -Es gibt drei Lösungsmöglichkeiten: - -KBiff nicht verwenden. - - -Anstatt des 'mbox'-Protokolls das 'file'-Protokoll verwenden (leider läßt sich -dann nicht mehr ersehen wieviele neue Nachrichten eingegangen sind). - - -Alle Postfächer von 'mbox' auf 'maildir' umstellen. - - - - - - -Kann KBiff mit Netscape-Mail zusammenarbeiten? - -'netscape -mail' einzutragen reicht leider nicht aus. Hier ist die Lösung -(vorgeschlagen bei Steven Boger (sboger@marcus-online.net) ). - -Zunächst wird dieses Shellscript benötigt: - -#!/bin/sh -if [ -L "$HOME/.netscape/lock" ]; -then -netscape -remote 'xfeDoCommand(openInbox)' -else -netscape -mail & -fi - - - - -KBiff schneidet den ersten "/" im IMAP Mode ab. Ist das ein Bug? - -Nein, daß ist kein Problem. Normalerweise wird mit IMAP kein absoluter Pfad -verwendet, praktisch alle Postfächer können (und werden) über relative Pfadnamen -oder symbolische Links wie 'inbox angesprochen. - -Wenn Sie beispielsweise auf /var/spool/mail/username zugreifen wollen -geht das in der Regel in dem Sie inbox als Postfachnamen benutzen. - - - -Vorschläge für neue Funktionen - -Wenn Sie einen Vorschlag für eine neue Funktion haben, bitte konsultieren Sie -zunächst die TODO-Datei der Quelltext-Distribution oder die KBiff Webseite. -Sollte Ihre Idee bereits eingetragen sein, bitte haben Sie Geduld, sie könnte -schon bald implementiert werden. Ist sie noch nicht aufgeführt so senden Sie -sie bitte per Email an den Autor. Der Autor kann aber nicht garantieren daß -Ihre Idee in KBiff integriert wird. - - - - -Autoren und Übersetzer - -KBiff wurde geschrieben von: -Kurt Granroth - -Deutsche Übersetzung von Stefan Doll: -<stefan@i-2000.com> - - diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt deleted file mode 100644 index 51feb67..0000000 --- a/doc/en/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -add_subdirectory( ${PROJECT_NAME} ) diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..c6ac889 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,651 @@ + +kbiff"> +]> + + + +The KBiff Handbook + + +Kurt +Granroth + +
granroth@kde.org
+ + + + + + +KBiff is a KDE aware mail notification utility. It supports MBOX (Unix + style), Maildir (Qmail), MH, POP3(S), IMAP4(S), and NNTP mailboxes. + + +KDE +KBiff +mailboxes +incoming mail + + + + +Introduction + + +Features + +KBiff is a mail notification utility for the KDE project. It has several +advantages over much of its competition: + + +Pure GUI configuration. No more command line parameters to remember (well, +one optional one to make things easier for some people) or strange config files. +All settings for KBiff can be done from one setup dialog. + + +Session Management. KBiff starts up with the same configuration you left +it with. + + +Panel Docking. KBiff can be docked into the panel very easily. Handy when +you are monitoring several mailboxes and don't have room anywhere else. + + +Animated GIFs. You can use animated GIFs as your icons. + + +Sounds. KBiff has an option to play .wav files when new mail arrives. + + +POP3(+SSL), IMAP4(+SSL), NNTP, Maildir, MBOX, MH. KBiff supports all major mailbox formats! + + +Multiple Mailbox. KBiff can monitor several mailboxes with one instance. + + +Secure Authentication. KBiff can authenticate using APOP or CRAM-MD5 if the POP3 or IMAP4 server supports it. + + + +Others. KBiff has scads of other options. + + + + +Kurt Granroth + +<granroth@kde.org> + + + + +Installation + + +How to obtain KBiff + +The most current release version in both source and binary formats can +always be found at the KBiff homepage. This is at +http://kbiff.granroth.org + + + +Requirements + +In order to successfully compile KBiff, you need at least the 2.0 version +of KDE. All required libraries can be found starting at the +KDE website. + +A note on the minimum KDE version: while KBiff should compile +with KDE2, this hasn't been verified or tested in years. The +effective minimum version is KDE3. + + + +Compilation and Installation + +Compiling KBiff is very easy. The following should do it: +% ./configure +% make +% make install + + +That should do it! Should you run into any problems, please report them +to the author + + + + +Using KBiff + +Almost every feature of KBiff can be configured from the Setup dialog. +What few command line parameters KBiff has are mostly for convenience -- some +options just make more sense on the command line. + + +The "profile" + +KBiff revolves around something called a "profile" A profile is simply +a container for one or mailboxes that KBiff will monitor. For instance, there +will always be one default profile called "Inbox" (or something else if you +rename it). This profile will contain one mailbox, usually something like "/var/mail/username". +It could just as well hold several mailboxes, though. Each instance of KBiff +(that is, each visible icon) corresponds to one profile. + + + +Command Line Parameters + +KBiff supports three command line parameters. They are: profile, debug, +and secure. +-profile <profile_name> Bypass the Setup dialog and start KBiff directly in the + given profile. e.g., 'kbiff -profile Inbox' +-debug Turns on verbose debugging. Use this only if you are + having problems with KBiff +-secure Disables the setup dialog. Useful when you want KBiff + displayed but don't want others to modify it. + + + + + +The Setup Dialog + +The setup dialog handles all configuration items for KBiff. As a result, +there is no need for command line parameters in nearly all cases. + + +Profile Name + +The top part of the dialog consists of a drop down list and three buttons. +The drop down list contains the names of all the "profiles." A profile is a +set of configuration settings for one mailbox under one name. The three +buttons are New, Rename, and Delete. The buttons work on the profiles, +only. They do not touch the actual mailbox files. When KBiff is started for +the first time, there will be one profile automatically created. This is +the Inbox profile which monitors the system mailbox. + + + +Preference Tabs + +There are four preference tabs. These are full of options that apply to the +current profile. The current profile is the one that is currently displayed +in the drop down list. There are no global settings. + + +General Preferences + +The general preferences for each profile are contained in this tab. There +are five fields here: + + +Poll + +This setting controls how much time KBiff will wait until it checks the +mailbox again. The time is in seconds. The default is 60 seconds (one +minute). + +To choose a time other than the default, here, it is a good idea to analyze +the frequency in which your mail arrives. If, for instance, you have +fetchmail downloading new mail every 5 minutes, then it doesn't make sense +to set the time for less than that. On the other hand, if you are using the +POP3 or IMAP4 feature of KBiff, you should probably use a higher interval. Setting +it less than 60 might give you unexpected results if your network +connection isn't very fast. + + + +Mail client + +This field specifies what command will run when KBiff is left-clicked. +While this is typically a mail client, it does not have to be. It can be +any command that can be run with its own X window. In other words, putting +elm in this field will not work. Putting konsole -e elm would. +The default is kmail -check + + + +Dock in panel + +This controls whether or not KBiff will start docked into the panel or not +when the user exits the setup dialog. Note that it is still possible to +switch between docked and undocked regardless of this option. This only +controls the initial state. This is checked by default. + + + +Enable session management + +This controls whether or not KDE session management is enabled. This should +be turned off only in rare cases. The most common case where session +management is disabled is when a user is running KDE under the same account +on several different computers at the same time. In this case, it would +probably be desirable to turn off session management and use the -profile +command line option instead. + +In all other cases, session management should probably be left on. + + + +Icons + +KBiff uses three icons to represent the three states: No Mail, Old Mail, +and New Mail. The icons shown are the "large" icons. To select new ones, +click on the buttons and a icon loader dialog will pop up. Note that even +though KBiff supports animated GIFs, they will not appear animated here. + + + + +New Mail Preferences + +This tab groups together the options that control what happen when new mail +arrives. + + +Run Command + +This is a shell command that will be executed when new mail arrives. A +typical example of this would be play newmail.au. This would cause the file +newmail.au to be played whenever new mail arrives. By default, this is +turned off. + + + +Play Sound + +This specifies a sound to play when new mail arrives. As of this version, +it will only play .wav files. Simply specify the path to the file to have +it played. By default, this is turned off. + + + +System Beep + +Enabling this will cause KBiff to beep whenever new mail arrives. This is +probably the least intrusive, yet still active, method of alerting the user +that new mail as arrived. By default, this is on. + + + +Notify + +Enabling this will cause KBiff to popup a window when new mail arrives. The +"notify" message box will list both the mailbox in question and the number of +new mails. This option is not recommended on mailboxes that receive lots of +mail. + + + +Floating Status + +If this is enabled, KBiff will popup a small box listing all mailboxes +with their newmail count whenever you the mouse is over the icon (after +a one second delay). The effect is similar to that of a tooltip... only +better. This isn't technically a new mail feature... but it doesn't fit +easily anywhere else! + + + + +Mailbox Preferences + +This groups together the options controlling the physical mailboxs themself. + +All options on this tab are PER mailbox. So if you have three mailboxes in +this profile, each mailbox will have its own settings on this tab. However, +all settings in the other tabs apply profile-wide. This means that if you +have the Notify option checking the the New Mail tab, then KBiff will notify +you that new mail has arrived in all of the mailboxes in this profile. + + +Mailbox list + +The listbox on the left of the tab contains the list of mailboxes that the +current profile will monitor. In most cases, there will be only one (the +"Default" mailbox). However, you may have as many mailboxes per profile as +you wish. + +There are two buttons below the mailbox list. The button with the mailbox on +it will create a new mailbox. The button with the cross will delete a +mailbox. If you wish to rename a mailbox, you must delete the old one and +create a new one with identical properties. + + + +Protocol + +This determines the protocol for the currently selected mailbox. There are 4 +(and a half) protocols - mbox (Unix style), maildir (Qmail), POP3, and IMAP4. +The 'file' protocol can be used to monitor any local file as it uses only +the last read and last modified times to determine the state. + + + +Mailbox + +This field will not be active with the POP3 protocol. In all other cases, put +the path to your mailbox here. In the case of mbox, this will be a file. With +maildir, this will be a directory. It is a folder with IMAP4 (almost +always called 'INBOX' or 'inbox' for your main mail folder). + + + +Server + +This is active only for the IMAP4 and POP3 protocols. + + + +User + +This is active only for the IMAP4 and POP3 protocols. + + + + +Password + +This is active only for the IMAP4 and POP3 protocols. + + + + +Store Password + +This will save the password between sessions. + +KBiff does not encrypt the password when it is saved! It will scramble it a +little, but anybody with the source code (or a little patience) could +unscramble it in an instant. If you are on an insecure network, it is +strongly recommended that the store password option be turned off + + + +Advanced + +This will popup a dialog containing advanced features. + + +Mailbox URL + +KBiff handles mailboxes internally as a URL. If you know what you are doing, +you can directly modify the URL here. Modifying this is discouraged unless +you are familiar with the code, + + + +Port + +Set this to whatever port your server is at. By default, it will be 110 for +POP3 and 143 for IMAP4 + + + +PREAUTH + +If you don't know what this means, you probably don't need to use it. +Basically, it will start checking for new mail in IMAP4 without logging in. + + + +Keep Alive + +When checked in POP3 or IMAP4 mode, this will keep the connection "alive". +That is, KBiff will login once and stay logged in. This is not recommended if +your POP3 or IMAP4 server uses locks. If locks are in place and KBiff does +not log out then your mail client will not be able to access your account. + + + + + +About + +This tab has information about KBiff. + + +About KBiff + +This contains information about which version of KBiff is being used. It +also has contact information about the author. + +Note that the email address is a hyperlink. Clicking on it is supposed to +pop up your mail client in order to send mail to the author. Unfortunately, +there is no automated way of doing this in KBiff at the present time. There +is some code here, though. To send email using this hyperlink, KBiff looks +for the environment variable MAILER. If it finds it, it will use the +contents of this variable as the email program to use. + +For example, if MAILER is set like so: + % setenv MAILER "konsole -e mutt" +then KBiff will use konsole -e mutt as the default mail client, here. + + + + + + +The Popup Menu + +The popup menu is activated whenever the right mouse button is clicked +in the KBiff icon area. + + +(Un)Dock + +This docks or undocks KBiff from the panel. This option will only work +in KDE complient window managers like KWin. The default state is determined +by the setup dialog. + + + +Setup + +This will activate the setup dialog. See the Setup Dialog section for more details. + + + +Help + +This activates the online help (this). + + + +Check Mail Now + +This forces KBiff to check for new mail right now, regardless of the poll +time. This will check all mailboxes in a profile. + + + +Read Mail Now + +This will force KBiff to act like all mailboxes in the current profile +are "old." This makes most sense when you have new mail on a remote server +(pop3 or imap4) and don't feel like downloading it right then. + + + +Stop/Start + +This will either stop or start KBiff. + + + + +Questions, Answers, and Tips + + +Are there other KDE-aware "biff" utilities? + +Yes. There are at least three that I know of. Each "biff" has its own strengths. +KOrn was the original. It's main strength is the ability to monitor multiple +mailboxes with one instance and effectively show the number of messages in +each. If you have many mailboxes and don't care for the cutesy icons, then +KOrn is probably a better choice than KBiff. Another "biff" is KNewMail. +KNewMail attempts to emulate the Windows utility NewMail. It checks for POP3 +mail and displays the subject line for each message. I don't know if +this is still an viable project, though, since it doesn't look like +it's been updated since 2003. + +The final (and most common) mail monitor is the one that ships with +KMail. Its major advantages are all related to the fact that it's +integrated with KMail itself. KBiff is more flexible, though, and +works with mailers other than KMail. + + + +What is the difference between a "profile" and a "mailbox" again? + +A "profile" is a group of one or more mailboxes that one instance of +KBiff will monitor. And example of a profile is "Inbox". A "mailbox" is +a physical entity that can be monitored by KBiff. An example of a mailbox is +"/var/mail/username". + + + +How do I use my own pixmaps? + +Short answer: select them using the setup dialog. +Longer answer: KBiff +searches for its icons in the standard KDE icon path. Currently, this is +tdedir()/share/apps/kbiff/toolbar +tdedir()/share/toolbar +tdedir()/share/icons +tdedir()/share/apps/kbiff/pics +$HOME/.kde/share/apps/kbiff/toolbar +$HOME/.kde/share/toolbar +$HOME/.kde/share/icons +$HOME/.kde/share/apps/kbiff/pics + + +Where "tdedir()" is usally "/opt/kde" and $HOME is your home +directory. If you put your pixmaps in any of these directories (the last one +listed is recommended), then KBiff should have no problems finding and using +them. + +If you plan on docking KBiff, you should have a 22x22 (or smaller) version +of your pixmap. The name of the small pixmap should be the name of the larger +pixmap preceded by "mini-". So if you want to use the default "oldmail.xpm" +pixmap for old mail but want to use your own "mycoolpixmap.xpm" smaller pixmap +when it's docked, you should rename your pixmap to "mini-oldmail.xpm" If +you do not do this, KBiff will use the large version even in the panel. + +Note that KBiff determines its size by the old mail pixmap. So if your +pixmap for old mail is 100x100, but all the other ones are 32x32... well, KBiff +will look very strange every time new mail arrives. + + + +How do I use elm (or mutt or PINE) with KBiff? + +You tried putting "elm" into the Mail Client edit box, didn't you? Whoops! +'elm', 'mutt', and 'PINE' all need a terminal to run in and KBiff does not +supply one. The author used to use the following as his Mail Client: +konsole -caption Mail -e mutt & + +If you use a graphical email client such as KMail or Thunderbird, then you +simply need to put the name of the client in the edit box. No terminal is necessary. + + + +Why won't KBiff play my newmail.au file? + +KBiff uses the KAudio class to play sounds when new mail arrives. Currently, +this class only supports .wav files. If you wish to play an .au file when new +mail arrives, try getting the SOX package and put 'play newmail.au' (or just +'cat newmail.au > /dev/audio') in the Run Command option. + + + +Does KBiff work without session management? + +Yes. Session management is on by default, but you can turn it off in the +setup dialog. You can still have KBiff start up when KDE starts up by putting +KBiff into your Autostart folder with the '-profile' option. + + + +Clicking on your email address in About does nothing! + +It would be nice to pass the 'mailto:granroth@kde.org' URL to kfm to process +it.. unfortunately, this is not implemented yet. I did code in some support, +though. Just set an environment variable MAILER to whatever your mailer is +and the link should work. +e.g. +% setenv MAILER konsole -e mutt + + +Note that this has the pleasant side effect that 'mailto:' links in the +regular kfm will also use your mailer. + + + +When I use KBiff to monitor my mailbox, all other 'biff' utilities stop + working. What's up? + +This is a result of the new message counting code in KBiff. In order for +KBiff to know how many new messages are in an mbox mailbox, it must open it +up to read it. When this happens, most other 'biff' utilities (including your +shell's built-in one) will assume that you read your mailbox and announce it +as old (or "read") mail. + +There are three ways around this: + +Don't use KBiff. + + +Use the 'file' protocol instead of the 'mbox' protocol (note that you'll +no longer know how many new mails have arrived) + + +Convert all of your 'mbox' mailboxes to 'maildir' + + + + + + +How do I use Netscape Mail with KBiff? + +You tried 'netscape -mail', didn't you? You then discovered that this caused +Netscape to complain about a lockfile if it was already running, right? Well, +here's a workaround from KBiff user Steven Boger +(sboger@marcus-online.net) +Create a shell script like so: +#!/bin/sh +if [ -L "$HOME/.netscape/lock" ]; +then +netscape -remote 'xfeDoCommand(openInbox)' +else +netscape -mail & +fi + + + + +KBiff truncates the initial slash in IMAP mode. Is this a bug? + +No, it's a feature! It is very very rare that one uses an absolute path +with IMAP. Nearly all mailbox can (and are) accessed either relative to +the user's home directory or use symbolic names like 'inbox. + +If you are trying to read /var/spool/mail/username try entering +inbox as the mailbox name. + + + +I have this great feature I want implemented. What should I do? + +Unfortunately, the answer is likely "write it yourself". KBiff +is maintained in only a minimal sense. Patches are applied and it's +updated enough to compile with the latest KDE, but I will be adding +very few features in the future and likely none that are just +suggestions. Nearly all patches are accepted, though. + + + + diff --git a/doc/en/kbiff.png b/doc/en/kbiff.png new file mode 100644 index 0000000..d4cbe40 Binary files /dev/null and b/doc/en/kbiff.png differ diff --git a/doc/en/kbiff/CMakeLists.txt b/doc/en/kbiff/CMakeLists.txt deleted file mode 100644 index ba3ef3e..0000000 --- a/doc/en/kbiff/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -tde_create_handbook( DESTINATION ${PROJECT_NAME} ) diff --git a/doc/en/kbiff/index.docbook b/doc/en/kbiff/index.docbook deleted file mode 100644 index c6ac889..0000000 --- a/doc/en/kbiff/index.docbook +++ /dev/null @@ -1,651 +0,0 @@ - -kbiff"> -]> - - - -The KBiff Handbook - - -Kurt -Granroth - -
granroth@kde.org
- - - - - - -KBiff is a KDE aware mail notification utility. It supports MBOX (Unix - style), Maildir (Qmail), MH, POP3(S), IMAP4(S), and NNTP mailboxes. - - -KDE -KBiff -mailboxes -incoming mail - - - - -Introduction - - -Features - -KBiff is a mail notification utility for the KDE project. It has several -advantages over much of its competition: - - -Pure GUI configuration. No more command line parameters to remember (well, -one optional one to make things easier for some people) or strange config files. -All settings for KBiff can be done from one setup dialog. - - -Session Management. KBiff starts up with the same configuration you left -it with. - - -Panel Docking. KBiff can be docked into the panel very easily. Handy when -you are monitoring several mailboxes and don't have room anywhere else. - - -Animated GIFs. You can use animated GIFs as your icons. - - -Sounds. KBiff has an option to play .wav files when new mail arrives. - - -POP3(+SSL), IMAP4(+SSL), NNTP, Maildir, MBOX, MH. KBiff supports all major mailbox formats! - - -Multiple Mailbox. KBiff can monitor several mailboxes with one instance. - - -Secure Authentication. KBiff can authenticate using APOP or CRAM-MD5 if the POP3 or IMAP4 server supports it. - - - -Others. KBiff has scads of other options. - - - - -Kurt Granroth - -<granroth@kde.org> - - - - -Installation - - -How to obtain KBiff - -The most current release version in both source and binary formats can -always be found at the KBiff homepage. This is at -http://kbiff.granroth.org - - - -Requirements - -In order to successfully compile KBiff, you need at least the 2.0 version -of KDE. All required libraries can be found starting at the -KDE website. - -A note on the minimum KDE version: while KBiff should compile -with KDE2, this hasn't been verified or tested in years. The -effective minimum version is KDE3. - - - -Compilation and Installation - -Compiling KBiff is very easy. The following should do it: -% ./configure -% make -% make install - - -That should do it! Should you run into any problems, please report them -to the author - - - - -Using KBiff - -Almost every feature of KBiff can be configured from the Setup dialog. -What few command line parameters KBiff has are mostly for convenience -- some -options just make more sense on the command line. - - -The "profile" - -KBiff revolves around something called a "profile" A profile is simply -a container for one or mailboxes that KBiff will monitor. For instance, there -will always be one default profile called "Inbox" (or something else if you -rename it). This profile will contain one mailbox, usually something like "/var/mail/username". -It could just as well hold several mailboxes, though. Each instance of KBiff -(that is, each visible icon) corresponds to one profile. - - - -Command Line Parameters - -KBiff supports three command line parameters. They are: profile, debug, -and secure. --profile <profile_name> Bypass the Setup dialog and start KBiff directly in the - given profile. e.g., 'kbiff -profile Inbox' --debug Turns on verbose debugging. Use this only if you are - having problems with KBiff --secure Disables the setup dialog. Useful when you want KBiff - displayed but don't want others to modify it. - - - - - -The Setup Dialog - -The setup dialog handles all configuration items for KBiff. As a result, -there is no need for command line parameters in nearly all cases. - - -Profile Name - -The top part of the dialog consists of a drop down list and three buttons. -The drop down list contains the names of all the "profiles." A profile is a -set of configuration settings for one mailbox under one name. The three -buttons are New, Rename, and Delete. The buttons work on the profiles, -only. They do not touch the actual mailbox files. When KBiff is started for -the first time, there will be one profile automatically created. This is -the Inbox profile which monitors the system mailbox. - - - -Preference Tabs - -There are four preference tabs. These are full of options that apply to the -current profile. The current profile is the one that is currently displayed -in the drop down list. There are no global settings. - - -General Preferences - -The general preferences for each profile are contained in this tab. There -are five fields here: - - -Poll - -This setting controls how much time KBiff will wait until it checks the -mailbox again. The time is in seconds. The default is 60 seconds (one -minute). - -To choose a time other than the default, here, it is a good idea to analyze -the frequency in which your mail arrives. If, for instance, you have -fetchmail downloading new mail every 5 minutes, then it doesn't make sense -to set the time for less than that. On the other hand, if you are using the -POP3 or IMAP4 feature of KBiff, you should probably use a higher interval. Setting -it less than 60 might give you unexpected results if your network -connection isn't very fast. - - - -Mail client - -This field specifies what command will run when KBiff is left-clicked. -While this is typically a mail client, it does not have to be. It can be -any command that can be run with its own X window. In other words, putting -elm in this field will not work. Putting konsole -e elm would. -The default is kmail -check - - - -Dock in panel - -This controls whether or not KBiff will start docked into the panel or not -when the user exits the setup dialog. Note that it is still possible to -switch between docked and undocked regardless of this option. This only -controls the initial state. This is checked by default. - - - -Enable session management - -This controls whether or not KDE session management is enabled. This should -be turned off only in rare cases. The most common case where session -management is disabled is when a user is running KDE under the same account -on several different computers at the same time. In this case, it would -probably be desirable to turn off session management and use the -profile -command line option instead. - -In all other cases, session management should probably be left on. - - - -Icons - -KBiff uses three icons to represent the three states: No Mail, Old Mail, -and New Mail. The icons shown are the "large" icons. To select new ones, -click on the buttons and a icon loader dialog will pop up. Note that even -though KBiff supports animated GIFs, they will not appear animated here. - - - - -New Mail Preferences - -This tab groups together the options that control what happen when new mail -arrives. - - -Run Command - -This is a shell command that will be executed when new mail arrives. A -typical example of this would be play newmail.au. This would cause the file -newmail.au to be played whenever new mail arrives. By default, this is -turned off. - - - -Play Sound - -This specifies a sound to play when new mail arrives. As of this version, -it will only play .wav files. Simply specify the path to the file to have -it played. By default, this is turned off. - - - -System Beep - -Enabling this will cause KBiff to beep whenever new mail arrives. This is -probably the least intrusive, yet still active, method of alerting the user -that new mail as arrived. By default, this is on. - - - -Notify - -Enabling this will cause KBiff to popup a window when new mail arrives. The -"notify" message box will list both the mailbox in question and the number of -new mails. This option is not recommended on mailboxes that receive lots of -mail. - - - -Floating Status - -If this is enabled, KBiff will popup a small box listing all mailboxes -with their newmail count whenever you the mouse is over the icon (after -a one second delay). The effect is similar to that of a tooltip... only -better. This isn't technically a new mail feature... but it doesn't fit -easily anywhere else! - - - - -Mailbox Preferences - -This groups together the options controlling the physical mailboxs themself. - -All options on this tab are PER mailbox. So if you have three mailboxes in -this profile, each mailbox will have its own settings on this tab. However, -all settings in the other tabs apply profile-wide. This means that if you -have the Notify option checking the the New Mail tab, then KBiff will notify -you that new mail has arrived in all of the mailboxes in this profile. - - -Mailbox list - -The listbox on the left of the tab contains the list of mailboxes that the -current profile will monitor. In most cases, there will be only one (the -"Default" mailbox). However, you may have as many mailboxes per profile as -you wish. - -There are two buttons below the mailbox list. The button with the mailbox on -it will create a new mailbox. The button with the cross will delete a -mailbox. If you wish to rename a mailbox, you must delete the old one and -create a new one with identical properties. - - - -Protocol - -This determines the protocol for the currently selected mailbox. There are 4 -(and a half) protocols - mbox (Unix style), maildir (Qmail), POP3, and IMAP4. -The 'file' protocol can be used to monitor any local file as it uses only -the last read and last modified times to determine the state. - - - -Mailbox - -This field will not be active with the POP3 protocol. In all other cases, put -the path to your mailbox here. In the case of mbox, this will be a file. With -maildir, this will be a directory. It is a folder with IMAP4 (almost -always called 'INBOX' or 'inbox' for your main mail folder). - - - -Server - -This is active only for the IMAP4 and POP3 protocols. - - - -User - -This is active only for the IMAP4 and POP3 protocols. - - - - -Password - -This is active only for the IMAP4 and POP3 protocols. - - - - -Store Password - -This will save the password between sessions. - -KBiff does not encrypt the password when it is saved! It will scramble it a -little, but anybody with the source code (or a little patience) could -unscramble it in an instant. If you are on an insecure network, it is -strongly recommended that the store password option be turned off - - - -Advanced - -This will popup a dialog containing advanced features. - - -Mailbox URL - -KBiff handles mailboxes internally as a URL. If you know what you are doing, -you can directly modify the URL here. Modifying this is discouraged unless -you are familiar with the code, - - - -Port - -Set this to whatever port your server is at. By default, it will be 110 for -POP3 and 143 for IMAP4 - - - -PREAUTH - -If you don't know what this means, you probably don't need to use it. -Basically, it will start checking for new mail in IMAP4 without logging in. - - - -Keep Alive - -When checked in POP3 or IMAP4 mode, this will keep the connection "alive". -That is, KBiff will login once and stay logged in. This is not recommended if -your POP3 or IMAP4 server uses locks. If locks are in place and KBiff does -not log out then your mail client will not be able to access your account. - - - - - -About - -This tab has information about KBiff. - - -About KBiff - -This contains information about which version of KBiff is being used. It -also has contact information about the author. - -Note that the email address is a hyperlink. Clicking on it is supposed to -pop up your mail client in order to send mail to the author. Unfortunately, -there is no automated way of doing this in KBiff at the present time. There -is some code here, though. To send email using this hyperlink, KBiff looks -for the environment variable MAILER. If it finds it, it will use the -contents of this variable as the email program to use. - -For example, if MAILER is set like so: - % setenv MAILER "konsole -e mutt" -then KBiff will use konsole -e mutt as the default mail client, here. - - - - - - -The Popup Menu - -The popup menu is activated whenever the right mouse button is clicked -in the KBiff icon area. - - -(Un)Dock - -This docks or undocks KBiff from the panel. This option will only work -in KDE complient window managers like KWin. The default state is determined -by the setup dialog. - - - -Setup - -This will activate the setup dialog. See the Setup Dialog section for more details. - - - -Help - -This activates the online help (this). - - - -Check Mail Now - -This forces KBiff to check for new mail right now, regardless of the poll -time. This will check all mailboxes in a profile. - - - -Read Mail Now - -This will force KBiff to act like all mailboxes in the current profile -are "old." This makes most sense when you have new mail on a remote server -(pop3 or imap4) and don't feel like downloading it right then. - - - -Stop/Start - -This will either stop or start KBiff. - - - - -Questions, Answers, and Tips - - -Are there other KDE-aware "biff" utilities? - -Yes. There are at least three that I know of. Each "biff" has its own strengths. -KOrn was the original. It's main strength is the ability to monitor multiple -mailboxes with one instance and effectively show the number of messages in -each. If you have many mailboxes and don't care for the cutesy icons, then -KOrn is probably a better choice than KBiff. Another "biff" is KNewMail. -KNewMail attempts to emulate the Windows utility NewMail. It checks for POP3 -mail and displays the subject line for each message. I don't know if -this is still an viable project, though, since it doesn't look like -it's been updated since 2003. - -The final (and most common) mail monitor is the one that ships with -KMail. Its major advantages are all related to the fact that it's -integrated with KMail itself. KBiff is more flexible, though, and -works with mailers other than KMail. - - - -What is the difference between a "profile" and a "mailbox" again? - -A "profile" is a group of one or more mailboxes that one instance of -KBiff will monitor. And example of a profile is "Inbox". A "mailbox" is -a physical entity that can be monitored by KBiff. An example of a mailbox is -"/var/mail/username". - - - -How do I use my own pixmaps? - -Short answer: select them using the setup dialog. -Longer answer: KBiff -searches for its icons in the standard KDE icon path. Currently, this is -tdedir()/share/apps/kbiff/toolbar -tdedir()/share/toolbar -tdedir()/share/icons -tdedir()/share/apps/kbiff/pics -$HOME/.kde/share/apps/kbiff/toolbar -$HOME/.kde/share/toolbar -$HOME/.kde/share/icons -$HOME/.kde/share/apps/kbiff/pics - - -Where "tdedir()" is usally "/opt/kde" and $HOME is your home -directory. If you put your pixmaps in any of these directories (the last one -listed is recommended), then KBiff should have no problems finding and using -them. - -If you plan on docking KBiff, you should have a 22x22 (or smaller) version -of your pixmap. The name of the small pixmap should be the name of the larger -pixmap preceded by "mini-". So if you want to use the default "oldmail.xpm" -pixmap for old mail but want to use your own "mycoolpixmap.xpm" smaller pixmap -when it's docked, you should rename your pixmap to "mini-oldmail.xpm" If -you do not do this, KBiff will use the large version even in the panel. - -Note that KBiff determines its size by the old mail pixmap. So if your -pixmap for old mail is 100x100, but all the other ones are 32x32... well, KBiff -will look very strange every time new mail arrives. - - - -How do I use elm (or mutt or PINE) with KBiff? - -You tried putting "elm" into the Mail Client edit box, didn't you? Whoops! -'elm', 'mutt', and 'PINE' all need a terminal to run in and KBiff does not -supply one. The author used to use the following as his Mail Client: -konsole -caption Mail -e mutt & - -If you use a graphical email client such as KMail or Thunderbird, then you -simply need to put the name of the client in the edit box. No terminal is necessary. - - - -Why won't KBiff play my newmail.au file? - -KBiff uses the KAudio class to play sounds when new mail arrives. Currently, -this class only supports .wav files. If you wish to play an .au file when new -mail arrives, try getting the SOX package and put 'play newmail.au' (or just -'cat newmail.au > /dev/audio') in the Run Command option. - - - -Does KBiff work without session management? - -Yes. Session management is on by default, but you can turn it off in the -setup dialog. You can still have KBiff start up when KDE starts up by putting -KBiff into your Autostart folder with the '-profile' option. - - - -Clicking on your email address in About does nothing! - -It would be nice to pass the 'mailto:granroth@kde.org' URL to kfm to process -it.. unfortunately, this is not implemented yet. I did code in some support, -though. Just set an environment variable MAILER to whatever your mailer is -and the link should work. -e.g. -% setenv MAILER konsole -e mutt - - -Note that this has the pleasant side effect that 'mailto:' links in the -regular kfm will also use your mailer. - - - -When I use KBiff to monitor my mailbox, all other 'biff' utilities stop - working. What's up? - -This is a result of the new message counting code in KBiff. In order for -KBiff to know how many new messages are in an mbox mailbox, it must open it -up to read it. When this happens, most other 'biff' utilities (including your -shell's built-in one) will assume that you read your mailbox and announce it -as old (or "read") mail. - -There are three ways around this: - -Don't use KBiff. - - -Use the 'file' protocol instead of the 'mbox' protocol (note that you'll -no longer know how many new mails have arrived) - - -Convert all of your 'mbox' mailboxes to 'maildir' - - - - - - -How do I use Netscape Mail with KBiff? - -You tried 'netscape -mail', didn't you? You then discovered that this caused -Netscape to complain about a lockfile if it was already running, right? Well, -here's a workaround from KBiff user Steven Boger -(sboger@marcus-online.net) -Create a shell script like so: -#!/bin/sh -if [ -L "$HOME/.netscape/lock" ]; -then -netscape -remote 'xfeDoCommand(openInbox)' -else -netscape -mail & -fi - - - - -KBiff truncates the initial slash in IMAP mode. Is this a bug? - -No, it's a feature! It is very very rare that one uses an absolute path -with IMAP. Nearly all mailbox can (and are) accessed either relative to -the user's home directory or use symbolic names like 'inbox. - -If you are trying to read /var/spool/mail/username try entering -inbox as the mailbox name. - - - -I have this great feature I want implemented. What should I do? - -Unfortunately, the answer is likely "write it yourself". KBiff -is maintained in only a minimal sense. Patches are applied and it's -updated enough to compile with the latest KDE, but I will be adding -very few features in the future and likely none that are just -suggestions. Nearly all patches are accepted, though. - - - - diff --git a/doc/en/kbiff/kbiff.png b/doc/en/kbiff/kbiff.png deleted file mode 100644 index d4cbe40..0000000 Binary files a/doc/en/kbiff/kbiff.png and /dev/null differ diff --git a/doc/es/CMakeLists.txt b/doc/es/CMakeLists.txt deleted file mode 100644 index 51feb67..0000000 --- a/doc/es/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -add_subdirectory( ${PROJECT_NAME} ) diff --git a/doc/es/index.docbook b/doc/es/index.docbook new file mode 100644 index 0000000..b6fca38 --- /dev/null +++ b/doc/es/index.docbook @@ -0,0 +1,669 @@ + +kbiff"> + + +]> + + +Manual de KBiff + + +Kurt +Granroth + +
granroth@kde.org
+ + + +Jaime +Robles + +Traductor +
ea4abw@amsat.org
+ + + + + + +KBiff es una utilidad que avisa de que hay correo. Soporta MBOX (estilo +Unix), Maildir (Qmail), POP3, y buzones IMAP. + + +KDE +KBiff +mailboxes +incoming mail + + + + +Introducción. + + +Características. + +KBiff es una utilidad que avisa de que hay correo para el proyecto KDE. +Tiene varias ventajas sobre muchos de sus competidores: + + +Configuración GUI pura. No más parámetros en la línea de +comandos que recordar (bien, una opción para hacer las cosas más sencillas +para algunas personas) o extraños ficheros de configuración. +Toda la configuración de KBiff se puede hacer desde cuadros de diálogos. + + +Mantenimiento de la sesión. KBiff comienza con la misma +configuración con la que lo dejaste. + + +Se fija en el Panel. Puedes fijar KBiff en el panel de forma +muy sencilla. Práctico cuando controlas varios buzones y no tienes sitio en +ninguna otra parte. + + +GIFs Animados. Puedes usar GIFs animados como tus iconos. + + +Sonidos. KBiff tiene la opción de hacer sonar un fichero .wav +cuando llega correo. + + +POP3, IMAP4, Maildir, MBOX. KBiff soporta todos los formatos +de buzón más importantes. + + +Buzones Múltiples. KBiff puede monitorizar varios buzones de +una sola vez. + + +Otros. KBiff tiene un gran número de otras opciones. + + + + +Si tienes cualquier comentario o quieres pedir alguna otra característica, +siéntete libre de enviarme un correo electrónico. + +Kurt Granroth + +<granroth@kde.org> + + + +Características planeadas. + +Esas son algunas de las características que estoy planeando añadir o +considerando si añadirlas. Sin ningún orden en particular: + + + +Ponerlo en algún "lazo" CORBA. Posiblemente implemente un modelo +cliente/servidor también. + + +¿Monitorizar grupos de noticias NNTP? Estoy esperando hasta que +alguien lo pida. + + + + + + + +Instalación. + + +Cómo obtener KBiff. + +La versión más reciente puede siempre encontrarse, tanto en formato binario +como las fuentes en la página de KBiff. Está en +http://www.granroth.org/kbiff +KBiff es ahora parte del paquete de Redes de KDE. Como tal la última versión +está siempre disponible en el CVS de KDE. + + + +Requisitos. + +Para compilar KBiff de forma satisfactoria tú necesitas al menos la versión +1.0 de KDE. Todas las librerías requeridas pueden encontrarse en +ftp://ftp.kde.org/pub/kde. + + + +Compilación e Instalación. + +Compilar KBiff es muy sencillo. Se tiene que hacer lo siguiente: +% ./configure +% make +% make install + + +¡Eso debería hacerlo! Si tienes algún problema, por favor coméntaselos al +autor + + + + +Usando KBiff + +Casi todas las características de KBiff pueden configurarse desde el cuadro +de configuración. +El que existan algunos parámetros para la línea de comandos es más por +conveniencia -- algunas opciones tienen más sentido en la línea de comandos. + + +El "perfil". + +KBiff gira en torno a algo llamado "perfil". Un "perfil" es +simplemente un contenedor para uno o varios buzones de correo que KBiff +monitorizará. Por ejemplo, siempre habrá un buzón por defecto llamado +"Inbox" (o alguna otra cosa si lo renombras). Este perfil contendrá un +buzón, a menudo como "/var/mail/nombredeusuario". +Puede sin embargo, simplemente tener varios buzones. Cada caso de KBiff (que +es, cada icono visible) corresponde a un perfil. + + + +Parámetros de la línea de comandos. + +KBiff soporta tres parámetros en la línea de comandos. Son: +profile, debug, y secure. +-profile <nombre_del_perfil> Se salta el cuadro de configuración y + comienza KBiff directamente con el perfil dado. + Ej. 'kbiff -profile Inbox' +-debug Pone el programa en modo de depurado. Sólo usar si + tienes problemas con KBiff +-secure Deshabilita el cuadro de configuración. Útil cuando + quieras que se muestre KBiff pero no que otros lo modifiquen. + + + + + +El cuadro de configuración. + +El cuadro de configuración maneja todos los puntos de configuración de +KBiff. Como resultado no hay necesidad de usar parámetros en la línea de +comandos en casi todos los casos. + + +Nombre del perfil. + +La parte de arriba del cuadro consiste en una lista desplegable y tres +opciones. +La lista desplegable consiste en los nombres de todos los "perfiles". Un +perfil es un conjunto de configuraciones para un buzon bajo el mismo nombre. +Los tres botones son Nuevo, Renombrar, y Borrar. Los botones funcionan sobre +los perfiles, nada más. No tocan los ficheros del buzón. Cuando se arranca +KBiff la primera vez, habrá un perfil creado de forma automática. Es el +perfil Inbox que monitoriza el buzón del sistema. + + + +Etiquetas de preferencia. + +Hay cuatro etiquetas de preferencia. Son opciones completas que se aplican +al perfil actual. El perfil actual es el cual se está mostrando en ese +momento en la lista desplegable. No hay configuraciones globales. + + +Preferencias Generales. + +Las preferencias generales para cada perfil están contenidas en este +apartado. Aquí hay cinco campos: + + +Revisar. + +Esta opción controla cuanto tiempo tiene que esperar KBiff hasta que +comprueba el buzón otra vez. El tiempo está en segundos. El valor por +defecto es 60 segundos (un minuto). + +Para elegir un tiempo distinto al valor por defecto, aquí, es una buena idea +el analizar la frecuencia con que llega el correo. Por ejemplo, si tienes +fetchmail corriendo cada cinco minutos, no tiene sentido fijar un +tiempo menor que ese. Por otra parte si estas usando la opción POP3 y IMAP4 +de KBiff, posiblemente debas usar un intervalo más grande. Fijar el valor +por debajo de 60 dará resultados inesperados si tu conexión de red no es muy +rápida. + + + +Cliente de correo. + +Este campo especifica el comando que deberá ejecutar KBiff cuando se pulse +el botón izquierdo. +Aunque típicamente es un cliente de correo, no tiene por qué. Puede se +cualquier comando que pueda ser ejecutado en su propia ventana X. En otras +palabras, poner elm en este campo no funcionará. Poner konsole -e +elm sí lo hará. Por defecto pone kmail -check + + + +Fijar en el panel. + +Esto controla si KBiff comenzará fijo en el panel o no cuando el usuario +salga del cuadro de configuración. Date cuenta de que aun es posible cambiar +entre fijo y no fijo a parte de esta opción. Esto solo controla el estado +inicial. Puede ser comprobado por defecto. + + + +Habilitar mantenimiento de la sesión. + +Esto controla el que el mantenimiento de sesión de KDE esté o no habilitado. +Deberá deshabilitarse solo en raras ocasiones. El caso más común donde la +sesión está deshabilitada es cuando el usuario ejecuta KDE desde la misma +cuenta en máquinas diferentes al mismo tiempo. En este caso, posiblemente +sea deseable el deshabilitar el mantenimiento de sesión y usar la opción de +la línea de comandos -profile en su lugar. + +En todos los otros casos, el mantenimiento de la sesión, probablemente se +dejará habilitado. + + + +Iconos. + +KBiff usa tres iconos para representar los tres estados: No hay correo, +Correo antiguo y Correo nuevo. Los iconos mistrados son iconos "grandes". +Para selecionar iconos nuevos pulsar el los botones y aparecerá un cuadro de +iconos. Date cuenta de que aunque KBiff soporta GIFs animados, no aparecerán +animados aquí. + + + + +Preferencias en el correo nuevo. + +Esta opción agrupa las opciones que controlan qué ocurre cuando llega correo +nuevo. + + +Ejecutar comando. + +Es una shell de comandos que será ejecutada cuando llegue correo nuevo. Un +ejemplo típico de esto es hacer sonar newmail.au. Esto causará que suene el +fichero newmail.au cada vez que llegue correo nuevo. Por defecto esto está +deshabilitado. + + + +Tocar sonido. + +Especifica un sonido a tocar cuando llega nuevo correo. Esta versión solo +tocará ficheros .wav. Simplemente especifica el trayecto hasta el fichero +que quieres que suene. Por defecto, está deshabilitado. + + + +Pitido del sistema. + +Habilitando esto, se hará que KBiff pite cada vez que llegue correo nuevo. +Esto es posiblemente el método menos intrusivo, aunque este activo, de +avisar al usuario de que ha llegado nuevo correo. Por defecto está +habilitado. + + + +Avisar. + +Habilitando esto se hará que KBiff abra una ventana cuando llegue nuevo +correo. El mensaje de "aviso" mostrará ambas cosas el buzón y el número de +mensajes nuevos. Esta opción no se recomienda en buzones que reciban mucho +correo. + + + + +Preferencias del Buzón. + +Esto agrupa las opciones que controlan el buzón físico. + +Todas las opciones en este cuadro son POR buzón. Así que si tienes tres +buzones en este perfil, cada buzón tendrá sus propias configuraciones en +este cuadro. De todas formas todas las configuraciónes en los otros cuadros +afectan a todos los perfiles. Esto significa que si tú tienes la opción de +Avisar en el cuadro de Correo Nuevo, entonces KBiff avisará cuando haya +llegado correo nuevo a todos los buzones de este perfil. + + +Lista de buzones. + +La lista de la izquierda del cuadro contiene la lista de buzones de correo +que el perfil actual monitorizará. En la mayoría d los casos solo habrá uno +(el buzón "por defecto"). Así que puedes tener tantos buzones por perfil +como quieras. + +Hay dos botones debajo de la lista de buzones. El botón con el buzón creará +un nuevo buzón. Si quieres renombrar el buzón, deberás borrar el viejo y +crear uno nuevo con idénticas propiedades. + + + +Protocolo. + +Determina el protocolo del buzón seleccionado. Hay cuatro (y medio) +protocolos - mbox (estilo Unix), maildir (Qmail), POP3, e IMAP4. +El protocolo 'fichero' puede usarse para monitorizar cualquier fichero local +porque utiliza solo la última leída - última modificación para determinar el +estado. + + + +Buzón. + +Este campo no estará activo con el protocolo POP3. En todos los otros casos, +pon el trayecto hasta el buzón aquí. En el caso de mbox, esto será un +fichero, con maildir, será un directorio. Es una carpeta con IMAP4. + + + +Servidor. + +Solo está activo con los protocolos IMAP4 y POP3. + + + +Usuario. + +Solo está activo con los protocolos IMAP4 y POP3. + + + +Contraseña. + +Solo está activo con los protocolos IMAP4 y POP3. + + + +Guardar contraseña. + +Guardará la contraseña entre sesiones. + +¡KBiff no encripta la contraseña cuando se guarda! La revolverá un poco, +pero cualquiera con el código fuente (o un poco de paciencia) podria +decodificarlo en un instante. Si estás en una red insegura, es del todo +recomendable que la opción de guardar contraseña este deshabilitada. + + + +Avanzado. + +Esto abrirá un menú que contiene características avanzadas. + + +URL del Buzón + +KBiff maneja los buzones internamente como una URL. Si sabes que estás +haciendo puedes modificar directamente la URL aquí. Modificar esto se +desaconseja a no ser que te sea familiar el código. + + + +Puerto. + +Configura esto al número del puerto donde tengas tu servidor. Por defecto, +estará 110 para POP3 y 143 para IMAP4. + + + +PREAUTENTIFICACIÓN. + +Si no sabesq ue significa esto, posiblemente no lo necesites. +Básicamente, comprobará el correo IMAP sin entrar. + + + +Mantener vivo. + +Cuando se habilita en POP3 o IMAP4, esto mantendrá "viva" la conexión. Esto +es, KBiff entrará una vez y se mantendrá conectado. Esto no se recomienda si +tu servidor POP3 o IMAP4 usa bloqueos. Si hay bloqueos (cerrojos) y KBiff no +sale entonces tu cliente de correo no será capaz de acceder a tu cuenta. + + + + + +Acerca de. + +Esta etiqueta tiene información acerca de KBiff. + + +Acerca de KBiff. + +Esto contiene información sobre qué versión de KBiff se está usando. +También tiene información para contactar con el autor. + +Date cuenta de que la dirección de correo es un hiperenlace. Pulsando sobre él +se supone que se abrirá el cliente de correo para enviar un mensaje al +autor. Desafortunadamente, no hay forma de hacer esto de forma automática si +KBiff estña presente. Hay aquí algún código para ello. Para enviar un +mensaje usando este hiperenlace, KBiff busca la variable de entorno +MAILER. Si la encuentra, usará el contenido de la variable como el +programa de correo a usar. + +Por ejemplo, si MAILER está fijada como: + % setenv MAILER "konsole -e mutt" +Entonces KBiff usará konsole -e mutt como programa de correo por defecto. + + + + + + +Menú desplegable. + +El menu desplegable se activa cuando se pulsa el botón derecho del ratón +sobre el area del icono del KBiff. + + +(No)Fijar. + +Esto fija y libera KBiff del panel. Esta opción solo funcionará en gestores +de ventana compatibles con KDE como KWM. El valor por defecto se determina +en el menu de configuración. + + + +Configuración. + +Esto activará el menú de configuración. Mira la sección del Menú de +configuración para más detalles. + + + +Ayuda. + +Esto activa la ayuda en línea (esto). + + + +Comprobar si hay correo. + +Esto fuerza a KBiff a comprobar si hay correo justo ahora, sin tener en +cuenta el tiempo de espera. Esto comprobará todos los buzones de un perfil. + + + +Leer correo. + +Esto forzará a KBiff a actuar como si todos los buzones del perfil actual +fueran "viejos". Esto tiene más sentido cuando tienes correo nuevo en un +servidor remoto (pop3 o imap4) y no te apetece bajarlos en ese momento. + + + +Parar/Empezar. + +Esto hará parar o empezar KBiff. + + + + +Preguntas, Respuestas, y Pistas. + + +¿Hay otras utilidades "biff" para KDE". + +Si. Hay por lo menos dos que yo conozco. Cada "biff" tiene sus puntos +fuertes. +KOrn fue el original. Su mayor fortaleza es la habilidad de +monitorizar múltiples buzones de una sola vez y mostrar de forma efectiva el +nimero de mensajes de cada uno. Si tienes muchos buzones y no te importan +los iconos, KOrn es posiblemente una mejor elección que KBiff. El otro "biff" +KNewMail. KNewMail intenta emular la utilidad de Windows NewMail. +Comprueba correo POP3 y muestra la línea del título de cada mensaje. + + + +¿Qué diferencia hay entre "perfil" y "buzón" otra vez? + +Un "perfil" es un conjunto de uno o más buzones que KBiff monitorizará de +una sola vez. Y un ejemplo de perfil es "Inbox". Un "buzón" es una entidad +física que puede ser monitorizada por KBiff. Un ejemplo de buzón es +"/usr/var/nombre_de_usuario". + + + +¿Cómo uso mis propios <emphasis>pixmaps</emphasis>? + +Respuesta corta: seleccionalos usando el cuadro de configuración. +Respuesta más larga: KBiff +busca los iconos en el trayecto estandar de KDE para los iconos. +Actualmente es +tdedir()/share/apps/kbiff/toolbar +tdedir()/share/toolbar +tdedir()/share/icons +tdedir()/share/apps/kbiff/pics +$HOME/.kde/share/apps/kbiff/toolbar +$HOME/.kde/share/toolbar +$HOME/.kde/share/icons +$HOME/.kde/share/apps/kbiff/pics + + +Donde "tdedir()" es a menudo "/opt/kde" y $HOME es tu directorio +habitual. Si pones tus propios iconos en cualquiera de esos directorios (se +recomienda el último de los listados), entonces KBiff no deberá tener +problemas para encontrarlos y usarlos. + +Si planeas fijar KBiff en el panel, deberás tener una versión de 22x22 (o +menor) de tu icono. El nombre del icono pequeño deberá ser el mismo que el +del más grande precedido de "mini-". Asi que si quieres usar el icono +"oldmail.zpm" por defecto para el correo antiguo pero usar tu propio +"mycoolpixmap.xpm" icono más pequeño para cuando esté fijo, debes renombrar +tu icono a ""mini-oldmail.xpm". Si no haces esto, KBiff usará la versión +grande incluso en el panel. + +Date cuenta de que KBiff determina su tamaño por el icono antiguo. Asi que si +tu antiguo icono es 100x100, pero todos los demás son 32x32... vamos, que +KBiff parecerá muy raro cada vez que llegue correo nuevo. + + + +¿Cómo uso elm (o mutt o PINE) con KBiff? + +Has probado a poner "elm" en la opción de Cliente de correo ¿verdad? +¡Ups! 'elm', 'mutt' y 'PINE' todos necesitan un terminal para ejecutar y +KBiff no proporciona uno. El autor usa lo siguiente como Cliente de correo: +konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt & + +Si usas un cliente de correo gráfico como KMail o Netscape, entonces +simplemente necesitas poner el nombre en la opción. No se necesita terminal. + + + +¿Por qué KBiff no puede tocar mi fichero newmail.au? + +KBiff usa la clase KAudio para tocar sonidos cuando llega correo nuevo. +Actualmente esa clase solo soporta ficheros .wav. Si quieres tocar un +fichero .au cuando llegue correo, prueba a obtener el paquete SOX y poner "'play +newmail.au' (o solo cat newmail.au > /dev/audio') en la opción de +comandos a ejecutar. + + + +¿Por qué KBiff funciona sin mantenimiento de sesión? + +Si. El mantenimiento de sesión está habilitado por defecto, pero se puede +deshabilitar en el menú de configuración. Todavia puedes tener KBiff en el +arranque de KDE poniendo KBiff en la carpeta de Inicio con la opción +'-profile'. + + + +¡Pulsando en tu dirección de correo en Sobre no pasa nada! + +Sería bueno pasar la URL 'mailto:granroth@kde.org' a kfm para procesar +esto... desafortunadamente, esto no está implementado aun. Codifiqué algo de +soporte de todas formas. Simplemente fija como variable de entorno MAILER al +mailer que uses y el enlace debe funcionar. +e.g. +% setenv MAILER konsole -e mutt + + +Date cuenta de que esto tiene el lado agradable de que 'mailto' enlaza en +kfm y usará también tu cliente de correo. + + + +Cuando uso KBiff para monitorizar mi buzón, las otras utilidades 'biff' dejan de funcionar ¿qué pasa? + +Esto es resultado del código para contar nuevos mensajes en KBiff. Para que +KBiff sepa cuantos mensajes nuevos hay en un buzón mbox, debe de abrirlo +para leerlo. Cuando eso ocurre, la mayoría de las otras utiliaddes 'biff' +(incluyendo la que lleva la shell) asumirán que tú has leído el buzón y lo +clasificarán como correo antiguo (o "leído") + +Hay tres soluciones para esto: + +No usar KBiff. + + +Usar el protocolo 'fichero' en vez del protocolo 'mbox' (date cuenta +de que no sabrás cuantos mensajes nuevos te han llegado) + + +Convertir todos tus buzones 'mbox' a 'maildir'. + + + + + + +¿Cómo usar el correo de Netscape con KBiff? + +Has probado 'netscape -mail' ¿verdad? Entonces has descubierto que eso hace que +Netscape se queje debido al fichero cerradura si ya está corriendo ¿cierto? +Bien, aquí hay mucho del usuario de KBiff Steven Boger +(sboger@marcus-online.net) +Crea un script como este: +#!/bin/sh +if [ -L "$HOME/.netscape/lock" ]; +then +netscape -remote + 'xfeDoCommand(openInbox)' +else +netscape -mail & +fi + + + + + +Licencia + + +Sobre la traducción. + +Esta traducción se distribuye bajo los términos de la Licencia Pública +General - GPL - GNU. + +Jaime Robles - ea4abw@amsat.org + + + diff --git a/doc/es/kbiff/CMakeLists.txt b/doc/es/kbiff/CMakeLists.txt deleted file mode 100644 index 7995d65..0000000 --- a/doc/es/kbiff/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -tde_create_handbook( DESTINATION ${PROJECT_NAME} LANG es ) diff --git a/doc/es/kbiff/index.docbook b/doc/es/kbiff/index.docbook deleted file mode 100644 index b6fca38..0000000 --- a/doc/es/kbiff/index.docbook +++ /dev/null @@ -1,669 +0,0 @@ - -kbiff"> - - -]> - - -Manual de KBiff - - -Kurt -Granroth - -
granroth@kde.org
- - - -Jaime -Robles - -Traductor -
ea4abw@amsat.org
- - - - - - -KBiff es una utilidad que avisa de que hay correo. Soporta MBOX (estilo -Unix), Maildir (Qmail), POP3, y buzones IMAP. - - -KDE -KBiff -mailboxes -incoming mail - - - - -Introducción. - - -Características. - -KBiff es una utilidad que avisa de que hay correo para el proyecto KDE. -Tiene varias ventajas sobre muchos de sus competidores: - - -Configuración GUI pura. No más parámetros en la línea de -comandos que recordar (bien, una opción para hacer las cosas más sencillas -para algunas personas) o extraños ficheros de configuración. -Toda la configuración de KBiff se puede hacer desde cuadros de diálogos. - - -Mantenimiento de la sesión. KBiff comienza con la misma -configuración con la que lo dejaste. - - -Se fija en el Panel. Puedes fijar KBiff en el panel de forma -muy sencilla. Práctico cuando controlas varios buzones y no tienes sitio en -ninguna otra parte. - - -GIFs Animados. Puedes usar GIFs animados como tus iconos. - - -Sonidos. KBiff tiene la opción de hacer sonar un fichero .wav -cuando llega correo. - - -POP3, IMAP4, Maildir, MBOX. KBiff soporta todos los formatos -de buzón más importantes. - - -Buzones Múltiples. KBiff puede monitorizar varios buzones de -una sola vez. - - -Otros. KBiff tiene un gran número de otras opciones. - - - - -Si tienes cualquier comentario o quieres pedir alguna otra característica, -siéntete libre de enviarme un correo electrónico. - -Kurt Granroth - -<granroth@kde.org> - - - -Características planeadas. - -Esas son algunas de las características que estoy planeando añadir o -considerando si añadirlas. Sin ningún orden en particular: - - - -Ponerlo en algún "lazo" CORBA. Posiblemente implemente un modelo -cliente/servidor también. - - -¿Monitorizar grupos de noticias NNTP? Estoy esperando hasta que -alguien lo pida. - - - - - - - -Instalación. - - -Cómo obtener KBiff. - -La versión más reciente puede siempre encontrarse, tanto en formato binario -como las fuentes en la página de KBiff. Está en -http://www.granroth.org/kbiff -KBiff es ahora parte del paquete de Redes de KDE. Como tal la última versión -está siempre disponible en el CVS de KDE. - - - -Requisitos. - -Para compilar KBiff de forma satisfactoria tú necesitas al menos la versión -1.0 de KDE. Todas las librerías requeridas pueden encontrarse en -ftp://ftp.kde.org/pub/kde. - - - -Compilación e Instalación. - -Compilar KBiff es muy sencillo. Se tiene que hacer lo siguiente: -% ./configure -% make -% make install - - -¡Eso debería hacerlo! Si tienes algún problema, por favor coméntaselos al -autor - - - - -Usando KBiff - -Casi todas las características de KBiff pueden configurarse desde el cuadro -de configuración. -El que existan algunos parámetros para la línea de comandos es más por -conveniencia -- algunas opciones tienen más sentido en la línea de comandos. - - -El "perfil". - -KBiff gira en torno a algo llamado "perfil". Un "perfil" es -simplemente un contenedor para uno o varios buzones de correo que KBiff -monitorizará. Por ejemplo, siempre habrá un buzón por defecto llamado -"Inbox" (o alguna otra cosa si lo renombras). Este perfil contendrá un -buzón, a menudo como "/var/mail/nombredeusuario". -Puede sin embargo, simplemente tener varios buzones. Cada caso de KBiff (que -es, cada icono visible) corresponde a un perfil. - - - -Parámetros de la línea de comandos. - -KBiff soporta tres parámetros en la línea de comandos. Son: -profile, debug, y secure. --profile <nombre_del_perfil> Se salta el cuadro de configuración y - comienza KBiff directamente con el perfil dado. - Ej. 'kbiff -profile Inbox' --debug Pone el programa en modo de depurado. Sólo usar si - tienes problemas con KBiff --secure Deshabilita el cuadro de configuración. Útil cuando - quieras que se muestre KBiff pero no que otros lo modifiquen. - - - - - -El cuadro de configuración. - -El cuadro de configuración maneja todos los puntos de configuración de -KBiff. Como resultado no hay necesidad de usar parámetros en la línea de -comandos en casi todos los casos. - - -Nombre del perfil. - -La parte de arriba del cuadro consiste en una lista desplegable y tres -opciones. -La lista desplegable consiste en los nombres de todos los "perfiles". Un -perfil es un conjunto de configuraciones para un buzon bajo el mismo nombre. -Los tres botones son Nuevo, Renombrar, y Borrar. Los botones funcionan sobre -los perfiles, nada más. No tocan los ficheros del buzón. Cuando se arranca -KBiff la primera vez, habrá un perfil creado de forma automática. Es el -perfil Inbox que monitoriza el buzón del sistema. - - - -Etiquetas de preferencia. - -Hay cuatro etiquetas de preferencia. Son opciones completas que se aplican -al perfil actual. El perfil actual es el cual se está mostrando en ese -momento en la lista desplegable. No hay configuraciones globales. - - -Preferencias Generales. - -Las preferencias generales para cada perfil están contenidas en este -apartado. Aquí hay cinco campos: - - -Revisar. - -Esta opción controla cuanto tiempo tiene que esperar KBiff hasta que -comprueba el buzón otra vez. El tiempo está en segundos. El valor por -defecto es 60 segundos (un minuto). - -Para elegir un tiempo distinto al valor por defecto, aquí, es una buena idea -el analizar la frecuencia con que llega el correo. Por ejemplo, si tienes -fetchmail corriendo cada cinco minutos, no tiene sentido fijar un -tiempo menor que ese. Por otra parte si estas usando la opción POP3 y IMAP4 -de KBiff, posiblemente debas usar un intervalo más grande. Fijar el valor -por debajo de 60 dará resultados inesperados si tu conexión de red no es muy -rápida. - - - -Cliente de correo. - -Este campo especifica el comando que deberá ejecutar KBiff cuando se pulse -el botón izquierdo. -Aunque típicamente es un cliente de correo, no tiene por qué. Puede se -cualquier comando que pueda ser ejecutado en su propia ventana X. En otras -palabras, poner elm en este campo no funcionará. Poner konsole -e -elm sí lo hará. Por defecto pone kmail -check - - - -Fijar en el panel. - -Esto controla si KBiff comenzará fijo en el panel o no cuando el usuario -salga del cuadro de configuración. Date cuenta de que aun es posible cambiar -entre fijo y no fijo a parte de esta opción. Esto solo controla el estado -inicial. Puede ser comprobado por defecto. - - - -Habilitar mantenimiento de la sesión. - -Esto controla el que el mantenimiento de sesión de KDE esté o no habilitado. -Deberá deshabilitarse solo en raras ocasiones. El caso más común donde la -sesión está deshabilitada es cuando el usuario ejecuta KDE desde la misma -cuenta en máquinas diferentes al mismo tiempo. En este caso, posiblemente -sea deseable el deshabilitar el mantenimiento de sesión y usar la opción de -la línea de comandos -profile en su lugar. - -En todos los otros casos, el mantenimiento de la sesión, probablemente se -dejará habilitado. - - - -Iconos. - -KBiff usa tres iconos para representar los tres estados: No hay correo, -Correo antiguo y Correo nuevo. Los iconos mistrados son iconos "grandes". -Para selecionar iconos nuevos pulsar el los botones y aparecerá un cuadro de -iconos. Date cuenta de que aunque KBiff soporta GIFs animados, no aparecerán -animados aquí. - - - - -Preferencias en el correo nuevo. - -Esta opción agrupa las opciones que controlan qué ocurre cuando llega correo -nuevo. - - -Ejecutar comando. - -Es una shell de comandos que será ejecutada cuando llegue correo nuevo. Un -ejemplo típico de esto es hacer sonar newmail.au. Esto causará que suene el -fichero newmail.au cada vez que llegue correo nuevo. Por defecto esto está -deshabilitado. - - - -Tocar sonido. - -Especifica un sonido a tocar cuando llega nuevo correo. Esta versión solo -tocará ficheros .wav. Simplemente especifica el trayecto hasta el fichero -que quieres que suene. Por defecto, está deshabilitado. - - - -Pitido del sistema. - -Habilitando esto, se hará que KBiff pite cada vez que llegue correo nuevo. -Esto es posiblemente el método menos intrusivo, aunque este activo, de -avisar al usuario de que ha llegado nuevo correo. Por defecto está -habilitado. - - - -Avisar. - -Habilitando esto se hará que KBiff abra una ventana cuando llegue nuevo -correo. El mensaje de "aviso" mostrará ambas cosas el buzón y el número de -mensajes nuevos. Esta opción no se recomienda en buzones que reciban mucho -correo. - - - - -Preferencias del Buzón. - -Esto agrupa las opciones que controlan el buzón físico. - -Todas las opciones en este cuadro son POR buzón. Así que si tienes tres -buzones en este perfil, cada buzón tendrá sus propias configuraciones en -este cuadro. De todas formas todas las configuraciónes en los otros cuadros -afectan a todos los perfiles. Esto significa que si tú tienes la opción de -Avisar en el cuadro de Correo Nuevo, entonces KBiff avisará cuando haya -llegado correo nuevo a todos los buzones de este perfil. - - -Lista de buzones. - -La lista de la izquierda del cuadro contiene la lista de buzones de correo -que el perfil actual monitorizará. En la mayoría d los casos solo habrá uno -(el buzón "por defecto"). Así que puedes tener tantos buzones por perfil -como quieras. - -Hay dos botones debajo de la lista de buzones. El botón con el buzón creará -un nuevo buzón. Si quieres renombrar el buzón, deberás borrar el viejo y -crear uno nuevo con idénticas propiedades. - - - -Protocolo. - -Determina el protocolo del buzón seleccionado. Hay cuatro (y medio) -protocolos - mbox (estilo Unix), maildir (Qmail), POP3, e IMAP4. -El protocolo 'fichero' puede usarse para monitorizar cualquier fichero local -porque utiliza solo la última leída - última modificación para determinar el -estado. - - - -Buzón. - -Este campo no estará activo con el protocolo POP3. En todos los otros casos, -pon el trayecto hasta el buzón aquí. En el caso de mbox, esto será un -fichero, con maildir, será un directorio. Es una carpeta con IMAP4. - - - -Servidor. - -Solo está activo con los protocolos IMAP4 y POP3. - - - -Usuario. - -Solo está activo con los protocolos IMAP4 y POP3. - - - -Contraseña. - -Solo está activo con los protocolos IMAP4 y POP3. - - - -Guardar contraseña. - -Guardará la contraseña entre sesiones. - -¡KBiff no encripta la contraseña cuando se guarda! La revolverá un poco, -pero cualquiera con el código fuente (o un poco de paciencia) podria -decodificarlo en un instante. Si estás en una red insegura, es del todo -recomendable que la opción de guardar contraseña este deshabilitada. - - - -Avanzado. - -Esto abrirá un menú que contiene características avanzadas. - - -URL del Buzón - -KBiff maneja los buzones internamente como una URL. Si sabes que estás -haciendo puedes modificar directamente la URL aquí. Modificar esto se -desaconseja a no ser que te sea familiar el código. - - - -Puerto. - -Configura esto al número del puerto donde tengas tu servidor. Por defecto, -estará 110 para POP3 y 143 para IMAP4. - - - -PREAUTENTIFICACIÓN. - -Si no sabesq ue significa esto, posiblemente no lo necesites. -Básicamente, comprobará el correo IMAP sin entrar. - - - -Mantener vivo. - -Cuando se habilita en POP3 o IMAP4, esto mantendrá "viva" la conexión. Esto -es, KBiff entrará una vez y se mantendrá conectado. Esto no se recomienda si -tu servidor POP3 o IMAP4 usa bloqueos. Si hay bloqueos (cerrojos) y KBiff no -sale entonces tu cliente de correo no será capaz de acceder a tu cuenta. - - - - - -Acerca de. - -Esta etiqueta tiene información acerca de KBiff. - - -Acerca de KBiff. - -Esto contiene información sobre qué versión de KBiff se está usando. -También tiene información para contactar con el autor. - -Date cuenta de que la dirección de correo es un hiperenlace. Pulsando sobre él -se supone que se abrirá el cliente de correo para enviar un mensaje al -autor. Desafortunadamente, no hay forma de hacer esto de forma automática si -KBiff estña presente. Hay aquí algún código para ello. Para enviar un -mensaje usando este hiperenlace, KBiff busca la variable de entorno -MAILER. Si la encuentra, usará el contenido de la variable como el -programa de correo a usar. - -Por ejemplo, si MAILER está fijada como: - % setenv MAILER "konsole -e mutt" -Entonces KBiff usará konsole -e mutt como programa de correo por defecto. - - - - - - -Menú desplegable. - -El menu desplegable se activa cuando se pulsa el botón derecho del ratón -sobre el area del icono del KBiff. - - -(No)Fijar. - -Esto fija y libera KBiff del panel. Esta opción solo funcionará en gestores -de ventana compatibles con KDE como KWM. El valor por defecto se determina -en el menu de configuración. - - - -Configuración. - -Esto activará el menú de configuración. Mira la sección del Menú de -configuración para más detalles. - - - -Ayuda. - -Esto activa la ayuda en línea (esto). - - - -Comprobar si hay correo. - -Esto fuerza a KBiff a comprobar si hay correo justo ahora, sin tener en -cuenta el tiempo de espera. Esto comprobará todos los buzones de un perfil. - - - -Leer correo. - -Esto forzará a KBiff a actuar como si todos los buzones del perfil actual -fueran "viejos". Esto tiene más sentido cuando tienes correo nuevo en un -servidor remoto (pop3 o imap4) y no te apetece bajarlos en ese momento. - - - -Parar/Empezar. - -Esto hará parar o empezar KBiff. - - - - -Preguntas, Respuestas, y Pistas. - - -¿Hay otras utilidades "biff" para KDE". - -Si. Hay por lo menos dos que yo conozco. Cada "biff" tiene sus puntos -fuertes. -KOrn fue el original. Su mayor fortaleza es la habilidad de -monitorizar múltiples buzones de una sola vez y mostrar de forma efectiva el -nimero de mensajes de cada uno. Si tienes muchos buzones y no te importan -los iconos, KOrn es posiblemente una mejor elección que KBiff. El otro "biff" -KNewMail. KNewMail intenta emular la utilidad de Windows NewMail. -Comprueba correo POP3 y muestra la línea del título de cada mensaje. - - - -¿Qué diferencia hay entre "perfil" y "buzón" otra vez? - -Un "perfil" es un conjunto de uno o más buzones que KBiff monitorizará de -una sola vez. Y un ejemplo de perfil es "Inbox". Un "buzón" es una entidad -física que puede ser monitorizada por KBiff. Un ejemplo de buzón es -"/usr/var/nombre_de_usuario". - - - -¿Cómo uso mis propios <emphasis>pixmaps</emphasis>? - -Respuesta corta: seleccionalos usando el cuadro de configuración. -Respuesta más larga: KBiff -busca los iconos en el trayecto estandar de KDE para los iconos. -Actualmente es -tdedir()/share/apps/kbiff/toolbar -tdedir()/share/toolbar -tdedir()/share/icons -tdedir()/share/apps/kbiff/pics -$HOME/.kde/share/apps/kbiff/toolbar -$HOME/.kde/share/toolbar -$HOME/.kde/share/icons -$HOME/.kde/share/apps/kbiff/pics - - -Donde "tdedir()" es a menudo "/opt/kde" y $HOME es tu directorio -habitual. Si pones tus propios iconos en cualquiera de esos directorios (se -recomienda el último de los listados), entonces KBiff no deberá tener -problemas para encontrarlos y usarlos. - -Si planeas fijar KBiff en el panel, deberás tener una versión de 22x22 (o -menor) de tu icono. El nombre del icono pequeño deberá ser el mismo que el -del más grande precedido de "mini-". Asi que si quieres usar el icono -"oldmail.zpm" por defecto para el correo antiguo pero usar tu propio -"mycoolpixmap.xpm" icono más pequeño para cuando esté fijo, debes renombrar -tu icono a ""mini-oldmail.xpm". Si no haces esto, KBiff usará la versión -grande incluso en el panel. - -Date cuenta de que KBiff determina su tamaño por el icono antiguo. Asi que si -tu antiguo icono es 100x100, pero todos los demás son 32x32... vamos, que -KBiff parecerá muy raro cada vez que llegue correo nuevo. - - - -¿Cómo uso elm (o mutt o PINE) con KBiff? - -Has probado a poner "elm" en la opción de Cliente de correo ¿verdad? -¡Ups! 'elm', 'mutt' y 'PINE' todos necesitan un terminal para ejecutar y -KBiff no proporciona uno. El autor usa lo siguiente como Cliente de correo: -konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt & - -Si usas un cliente de correo gráfico como KMail o Netscape, entonces -simplemente necesitas poner el nombre en la opción. No se necesita terminal. - - - -¿Por qué KBiff no puede tocar mi fichero newmail.au? - -KBiff usa la clase KAudio para tocar sonidos cuando llega correo nuevo. -Actualmente esa clase solo soporta ficheros .wav. Si quieres tocar un -fichero .au cuando llegue correo, prueba a obtener el paquete SOX y poner "'play -newmail.au' (o solo cat newmail.au > /dev/audio') en la opción de -comandos a ejecutar. - - - -¿Por qué KBiff funciona sin mantenimiento de sesión? - -Si. El mantenimiento de sesión está habilitado por defecto, pero se puede -deshabilitar en el menú de configuración. Todavia puedes tener KBiff en el -arranque de KDE poniendo KBiff en la carpeta de Inicio con la opción -'-profile'. - - - -¡Pulsando en tu dirección de correo en Sobre no pasa nada! - -Sería bueno pasar la URL 'mailto:granroth@kde.org' a kfm para procesar -esto... desafortunadamente, esto no está implementado aun. Codifiqué algo de -soporte de todas formas. Simplemente fija como variable de entorno MAILER al -mailer que uses y el enlace debe funcionar. -e.g. -% setenv MAILER konsole -e mutt - - -Date cuenta de que esto tiene el lado agradable de que 'mailto' enlaza en -kfm y usará también tu cliente de correo. - - - -Cuando uso KBiff para monitorizar mi buzón, las otras utilidades 'biff' dejan de funcionar ¿qué pasa? - -Esto es resultado del código para contar nuevos mensajes en KBiff. Para que -KBiff sepa cuantos mensajes nuevos hay en un buzón mbox, debe de abrirlo -para leerlo. Cuando eso ocurre, la mayoría de las otras utiliaddes 'biff' -(incluyendo la que lleva la shell) asumirán que tú has leído el buzón y lo -clasificarán como correo antiguo (o "leído") - -Hay tres soluciones para esto: - -No usar KBiff. - - -Usar el protocolo 'fichero' en vez del protocolo 'mbox' (date cuenta -de que no sabrás cuantos mensajes nuevos te han llegado) - - -Convertir todos tus buzones 'mbox' a 'maildir'. - - - - - - -¿Cómo usar el correo de Netscape con KBiff? - -Has probado 'netscape -mail' ¿verdad? Entonces has descubierto que eso hace que -Netscape se queje debido al fichero cerradura si ya está corriendo ¿cierto? -Bien, aquí hay mucho del usuario de KBiff Steven Boger -(sboger@marcus-online.net) -Crea un script como este: -#!/bin/sh -if [ -L "$HOME/.netscape/lock" ]; -then -netscape -remote - 'xfeDoCommand(openInbox)' -else -netscape -mail & -fi - - - - - -Licencia - - -Sobre la traducción. - -Esta traducción se distribuye bajo los términos de la Licencia Pública -General - GPL - GNU. - -Jaime Robles - ea4abw@amsat.org - - - diff --git a/doc/fr/CMakeLists.txt b/doc/fr/CMakeLists.txt deleted file mode 100644 index 51feb67..0000000 --- a/doc/fr/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -add_subdirectory( ${PROJECT_NAME} ) diff --git a/doc/fr/index.docbook b/doc/fr/index.docbook new file mode 100644 index 0000000..f00c3e2 --- /dev/null +++ b/doc/fr/index.docbook @@ -0,0 +1,800 @@ + +kbiff"> +]> + + +Manuel de KBiff + + +Kurt Granroth + +
granroth@kde.org
+ + + +14 avril 2002 +3.6.1 + +KBiff est un utilitaire de notification d'arrivée de courrier électronique compatible +avec KDE. +Il supporte les boîtes aux lettres de type MBOX (façon Unix), Maildir (Qmail), +POP3, et IMAP. +Manuel de KBiff + +KDE +KBiff +Courrier électronique +Mél +Notification + + + + +Introduction + + +Caractéristiques + +KBiff est un utilitaire de notification d'arrivée de courrier pour le +projet KDE. Il a plusieurs +avantages sur bon nombre de ses concurrents : + + + +Configuration entièrement par interface +graphique. Il n'y a plus de paramètres de +ligne de commande à retenir (ou plutôt, certains restent disponibles en option +pour faciliter la +vie de certains), et plus de fichiers de configuration étranges. Tous les +réglages de KBiff peuvent +être faits depuis un simple dialogue de paramétrage. + + + +Gestion de session. KBiff redémarre avec +la configuration telle qu'elle était au moment +où vous en êtes sorti. + + + +Placement dans la barre de tâches +("docking"). KBiff peut être placé dans la barre de +tâches très facilement. C'est pratique quand vous gérez plusieurs boîtes aux +lettres et que vous n'avez +plus de place nulle part ailleurs. + + + +GIFs animés. Vous pouvez utiliser des +images GIFs animées comme icônes. + + + +Sons. Kbiff a une option pour jouer des +fichiers .wav quand du courrier arrive. + + + +POP3, IMAP4, Maildir, MBOX. KBiff supporte + les principaux formats de boîtes aux +lettres! + + + +Boîtes aux lettres multiples. KBiff peut +gérer plusieurs boîtes aux lettre depuis une +même instance du programme. + + + +Autres. KBiff a des tonnes d'autres +options. + + + + +Si vous avez des commentaires ou des demandes de nouvelles +fonctionnalités, ne vous gènez pas pour me +contacter par courrier. + +Kurt Granroth + +granroth@kde.org + + + +Améliorations prévues + +Il y a certaines caractéristiques que soit je prévois d'ajouter soit au +sujet desquelles je m'interroge. +Dans le désordre : + + + +Rajouter des points d'entrée CORBA. Eventuellement implémenter un modèle +client/serveur également. + + +Gérer les forums de discussion NNTP ? J'attends que quelqu'un me le +demande. + + + + + + + +Installation + + +Comment se procurer KBiff ? + +La version la plus récente en formats source et binaire se trouve +toujours sur le site de +KBiff, à l'adresse +http://www.granroth.org/kbiff. +KBiff fait également à présent partie du paquetage réseau "tdenetwork" et donc la version +en cours de développement se trouve toujours dans le référentiel CVS de +KDE. + + + +Configuration nécessaire + +Pour compiler avec succès KBiff, vous avez besoin au moins de la version +1.0 de KDE. +Toutes les librairies nécessaires se trouvent sur +ftp://ftp.kde.org/pub/kde. + + + +Compilation et Installation + +Il est très facile de compiler KBiff avec ce qui suit : +% ./configure +% make +% make install + + +Ca devrait suffire ! En cas de problèmes, veuillez les signaler à l' +auteur + + + + +Utilisation de KBiff + +Pratiquement toutes les caractéristiques de KBiff peuvent être changées +depuis le dialogue de +configuration. Les quelques paramètres que KBiff a en ligne de commande sont là +essentiellement +par souci de commodité, parce que c'est là qu'elles sont utiles. + + +Le profil d'utilisation + +KBiff est centré autour d'un profil d'utilisation. +Un profil est simplement un regroupement d'une ou plusieurs boîtes aux lettres +que KBiff va surveiller. +Par exemple, il y a toujours un profil par défaut appelé "Inbox" (ou autrement +si vous le renommez). +Ce profil ne contient qu'une boîte aux lettres, d'ordinaire du type +"/var/mail/username". +Il pourrait tout aussi bien contenir plusieurs boîtes aux lettres. Chaque +instance de KBiff +(c'est-à-dire, chaque icône visible) correspond à un profil. + + + +Les paramètres de ligne de commande + +KBiff supporte trois paramètres en ligne de commande. Il s'agit de : +profile, debug +et secure. +-profile <nom_du_profil> Sauter le dialogue de +configuration et démarrer + KBiff directement avec le profil passé en argument, + par exemple 'kbiff -profile Inbox' +-debug Passer en mode de débogage bavard. A utiliser uniquement +dans le cas de + problèmes avec KBiff +-secure Désactiver le dialogue de configuration. Utile quand +vous voulez que KBiff tourne + mais lorsque vous ne voulez pas que d'autres le modifient. + + + + + +Le dialogue de configuration + +Le dialogue de configuration gère tous les aspects de la configuration de +KBiff. Par conséquent, +les paramètres de ligne de commande ne sont presque jamais nécessaires. + + +Nom du profil d'utilisation + +La partie supérieure du dialogue contient une liste déroulante et trois +boutons. +La liste déroulante contient les noms de tous les "profils". Un profil +d'utilisation +est un ensemble de réglages de configuration de boîte aux lettres. Les trois +boutons sont +intitulés Nouveau, Renommer et Supprimer. Ces boutons ne modifient que les +profils, ils +ne touchent pas aux boîtes aux lettres elles-mêmes. Quand KBiff est lancé pour la +première +fois, il n'y a qu'un profil, qui est créé automatiquement. Il s'agit du profil +"Inbox" qui surveille la boîte aux lettres système. + + + +Onglets de configuration + +Il y a quatre onglets d'options. Ils permettent de régler un grand nombre +d'options +relatives au profil courant. Le profil courant est celui qui est affiché dans la +liste +déroulante. Il n'y a pas de réglages globaux. + + +Général + +Les options générales pour chaque profil sont accessibles via cet onglet. +On y trouve cinq champs : + + +Intervalle + +Ce réglage contrôle combien de temps KBiff attend avant de revérifier la +boîte aux +lettre. La durée indiquée est en secondes. KBiff attend par défaut 60 secondes +(une minute). + +Pour savoir quelle durée choisir, il peut être judicieux d'analyser la +fréquence +à laquelle votre courrier arrive. Si, par exemple, +fetchmail télécharge le courrier arrivé toutes les +cinq minutes, il +est inutile de régler la durée sur une valeur inférieure. De la même façon, +si vous utilisez la fonctionnalité POP3 ou IMAP4 de KBiff, vous aurez sans +doute intérêt à utilisée un intervalle plus espacé. Si vous règlez +cette durée sur moind de 60 secondes, vous obtiendrez des résultats décevants +si votre connexion réseau est lente. + + + +Client de courrier + +Ce champ spécifie la commande à exécuter quand vous cliquez sur KBiff avec +le bouton +gauche de la souris. Bien qu'il s'agisse en général d'un client de courrier, +ce n'est pas indispensable. Cela peut être n'importe quelle commande ayant sa +propre +fenêtre X. Par exemple, si mettre elm dans ce +champ ne fonctionnera pas, +par contre mettre konsole -e elm marchera. La valeur +par défaut est +kmail -check + + + +Placer sur le tableau de bord + +Permet de déterminer si KBiff démarre placé dans le tableau de bord ou non +quand l'utilisateur sort du dialogue de configuration. Notez qu'il est possible +de basculer dans ou hors du tableau de bord indépendemment de cette option. Elle +ne contrôle que l'état initial, et est cochée par défaut. + + + +Utiliser la gestion de session + +Permet d'activer ou de désactiver la gestion de session KDE. Cette case ne +doit +être dévalidée que dans de rares cas. Le cas le plus courant où l'on +désactive la gestion de session est celui où un utilisateur utilise +simultanément +KDE sur plusieurs ordinateurs différents. Dans ce cas, il serait sans doute +souhaitable de désactiver la gestion de session et d'utiliser l'option de +ligne de commande -profile à la place. + +Dans tous les autres cas, la gestion de session devrait probablement être +laissée active. + + + + +Icônes + +KBiff utilise trois icônes pour représenter les trois états : Pas de +courrier, +Anciens message et Nouveau message. Les icônes proposées sont les "grandes" +icônes. +Pour en choisir de nouvelles, cliquez sur les boutons et un dialogue de +chargement +d'icône apparaîtra. Notez que bien que KBiff supporte les images GIF animées, +elles n'apparaîtront pas animées ici. + + + + +Nouveau message + +Cet onglet regroupe les options qui traitent de ce qui se passe lorsque du +courrier arrive. + + +Exécuter la commande + +Il s'agit d'une commande de ligne de commandes qui sera exécutée lorsque +du +courrier arrive. Un exemple typique serait play +newmail.au. +Cela aurait pour conséquence de faire jouer le son contenu dans le fichier +newmail.au chaque fois que du courrier arrive. +Par défaut, cette option est dévalidée. + + + +Lire un fichier son + +Cela indique un son à jouer lorsque du courrier arrive. Dans cette +version, +seuls des fichiers au format .wav peuvent être joués. +Indiquez simplement le chemin vers le fichier à jouer. +Par défaut, cette option est dévalidée. + + + +Bip système + +Si cette option est activée, KBiff bipera chaque fois que du courrier +arrive. +Il s'agit probablement de l'option la moins envahissante, bien que toujours +active, de prévenir l'utilisateur de l'arrivée de courrier. +Par défaut, cette option est validée. + + + +Notifier + +Si cette option est activée, KBiff affichera une fenêtre à chaque fois que +du courrier +arrive. Le message d'avertissement affichera aussi bien la boîte aux lettres +concernée que le nombre de messages arrivés. +Cette option est déconseillée pour les boîtes aux lettres qui recoivent beaucoup +de courrier. + + + + +Boîte aux lettres + +Cet onglet regroupe les options concernant les boîtes aux lettres réelles +elles-mêmes. + +Toutes les options de cet onglet concernent UNE SEULE boîte aux lettres. +Par +conséquent, si vous avez trois boîtes aux lettres dans ce profil utilisateur, +chaque boîte aux lettres aura ses propres réglages dans cet onglet. Par contre, +tous les réglages des autres onglets s'appliquent à l'ensemble du profil +utilisateur. +Par exemple, si vous avez l'option "Notifier" active dans l'onglet "Nouveau +message", +alors KBiff vous enverra un message d'avertissement quand du courrier arrive +dans +l'une quelconque des boîtes aux lettres de ce profil utilisateur. + + +Liste de boîtes aux lettres + +La liste déroulante à gauche de l'onglet contient la liste des boîtes aux +lettres +que le profil courant gère. Dans la plupart des cas, il n'y en aura qu'une +(la boîte aux lettres "par défaut"). Néanmoins, vous pouvez gérer autant de +boîtes +aux lettres par "profil" qu'il vous plaira. + +Il y a deux boutons sous la liste déroulante. Le bouton avec une boîte +aux lettres +dessinée dessus sert à créer une nouvelle boîte aux lettres. Le bouton avec une +croix sert +à en détruire une. Si vous désirez renommer une boîte aux lettres, vous devez +détruire la +vieille boîte aux lettres et en créer une nouvelle avec des propriétés +identiques. + + + +Protocole + +Ce champ détermine le protocole utilisé par la boîte aux lettres +couramment sélectionnée. +Il y a 4 (et demi) protocoles - mbox (Unix style), maildir (Qmail), POP3, et +IMAP4. +Le protocole 'fichier' peut être utilisé pour gérer tout fichier local car il +n'utilise que les dates de dernière lecture et de dernière modification pour +déterminer +l'état du fichier. + + + +Boîte aux lettres + +Ce champ n'est pas actif avec le protocole POP3. Dans tous les autres +cas, mettez +le chemin d'accès à votre boîte aux lettres ici. Dans le cas du protocole mbox, +il +s'agit d'un fichier. Dans le cas de maildiri et de IMAP4, il s'agira d'un +répertoire. + + + +Serveur + +Ce champ n'est actif que pour les protocoles IMAP4 et POP3. + + + +Utilisateur + +Ce champ n'est actif que pour les protocoles IMAP4 et POP3. + + + +Mot de passe + +Ce champ n'est actif que pour les protocoles IMAP4 et POP3. + + + +Stocker le mot de passe + +Cette case à cocher permet de conserver le mot de passe entre deux +sessions. + +KBiff ne crypte pas le mot de passe quand il est enregistré ! Il le +brouille un +petit peu, mais quiconque possède le code source (ou un peu de patience) +pourrait le +faire apparaître en clair en un instant. Si vous êtes sur un réseau non +sécurisé, +il est fortement recommandé que l'option "stocker le mot de passe" soit +dévalidée. + + + +Avancé + +Ce bouton permet d'afficher un dialogue concernant les caractéristiques +avancées. + + +URL de la boîte aux lettres + +KBiff gère en interne les boîtes aux lettres comme des URLs. Si vous savez +ce que vous +faites, vous pouvez modifier directement l'URL ici. La modification de cette +option est +déconseillée à moins que vous ne soyez familier avec le code de +l'application. + + + +Port + +Mettez ici le port servant à joindre votre serveur de courrier. Par défaut, +il s'agira du port +110 pour POP3 et 143 pour IMAP4. + + + +PREAUTH + +Si vous ne savez pas ce que ça veut dire, alors vous n'avez sans doute pas +besoin de l'utiliser. +En gros, ça permet de vérifier si du courrier est arrivé sans qu'IMAP4 ne +procède à une identification (login). + + + +Laisser actif + +Quand cette case est cochée en mode POP3 ou IMAP4, cela permettra de +laisser la connexion "active". +C'est-à-dire que KBiff se connectera une fois et restera connecté. Cette option +n'est pas recommandée si +votre serveur POP3 ou IMAP4 utilise des verrous. Si des verrous sont en place et +si KBiff ne se déconnecte pas +alors votre client de courrier ne sera pas capable d'accéder à votre compte de +courrier. + + + + + +A propos + +Cet onglet présente des informations au sujet de KBiff. + + +A propos de KBiff + +On trouve ici des informations sur la version de KBiff utilisée. Il y a +également +des informations permettant de contacter l'auteur. + +Notez que l'adresse mél est un hyperlien. En cliquant dessus, votre client +de courrier +est supposé se lancer afin d'envoyer un message à l'auteur. Malheureusement, +il n'y a actuellement aucun moyen d'effectuer cette opération automatiquement. +Néanmoins, il y a une amorce de code derrière. Pour envoyer du courrier en +utilisant cet +hyperlien, KBiff regarde la variable d'environnement MAILER. S'il la trouve, +il utilisera son contenu pour savoir quel programme de courrier utiliser. + +Par example, si MAILER est réglé ainsi : + % setenv MAILER "konsole -e mutt" +alors KBiff utilisera konsole -e mutt comme client de +courrier par défaut. + + + + + + +Le menu contextuel + +Le menu contextuel est activé à chaque fois que l'on clique sur le bouton +droit +de la souris dans la partie consacrée à l'icône de KBiff. + + +(Dés)arrimer + +Cette option place ou retire KBiff du tableau de bord. Cette option ne +fonctionne qu'avec des gestionnaires de fenêtres complètement compatibles +avec KDE comme KWM. L'état par défaut est défini via le dialogue de +configuration. + + + +Configuration + +Cette option affiche le dialogue de configuration. Voir la section +consacrée au dialogue de configuration pour plus de détails. + + + +Aide + +Cette option lance l'aide en ligne (ceci). + + + +Vérifier maintenant + +Cette option force KBiff à vérifier immédiatement si du courrier est +arrivé, +sans tenir compte du délai entre deux vérifications. +Cette option vérifie toutes les boîtes aux lettres d'un profil donné. + + + +Lire le courrier maintenant + +Cette option force KBiff à faire comme si toutes les boîtes aux lettres du +profil courant étaient "lues". +Celà présente de l'intérêt surtout lorsque vous avez du courrier sur un +serveur distant (pop3 ou imap4) et que vous n'avez pas envie de le télécharger +sur le champ. + + + +Arrêter/démarrer + +Cette option arrête ou démarre KBiff. + + + + +Questions, réponses et astuces + + +Y-a-t'il d'autres utilitaires "biff" compatibles avec KDE ? + +Oui. J'en connais au moins deux. Chaque "biff" a ses propres avantages. +KOrn était le premier. Sa qualité principale est +de pouvoir gérer +plusieurs boîtes aux lettres avec une seule instance de programme et de +montrer le nombre de messages dans chacune d'entre elles. Si vous avez +beaucoup de boîtes aux lettres et que vous ne recherchez pas de jolies +icônes, alors KOrn est probablement un meilleur choix que KBiff. +L'autre "biff" est KNewMail. KnewMail cherche à +imiter l'utilitaire +NewMail de Windows. Il vérifie la présence de courrier POP3 et affiche le +sujet de chaque message. + + + +Quelle est encore la différence entre un "profil" et une boîte aux +lettres ? + +Un "profil" est un groupe d'une ou plusieurs boîtes aux lettres qu'une +instance de KBiff gère. Un exemple de profil est "Inbox". Une "boîte aux +lettres" est une entité physique qui peut être géré par KBiff. Un exemple +de boîte aux lettres est "/usr/var/username". + + + +Puis-je utiliser mes propres images ? + +Réponse rapide: choisissez-les dans le menu de configuration. +Reponse plus approfondie: KBiff recherche ses icônes dans le chemin des icônes +de KDE. En ce moment, elles sont dans +tdedir()/share/apps/kbiff/toolbar +tdedir()/share/toolbar +tdedir()/share/icons +tdedir()/share/apps/kbiff/pics +$HOME/.kde/share/apps/kbiff/toolbar +$HOME/.kde/share/toolbar +$HOME/.kde/share/icons +$HOME/.kde/share/apps/kbiff/pics + + +Où "tdedir()" est habituellement "/opt/kde" et où $HOME est votre +répertoire personnel. Si vous placez vos images dans l'un de ces répertoires +(le dernier de la liste étant celui qu'on recommande), alors KBiff +ne devrait pas avoir de problèmes à les trouver et à les utiliser + +Si vous projetez de placer KBiff dans le table de bord, vous devriez avoir +une version de votre image de taille inférieure ou égale à 22x22. +Le nom de la petite image devrait être le nom de la grande image précédé par +"mini-". Ainsi si vous voulez utiliser l'image par défaut "oldmail.xpm" +pour le courrier lu mais si vous voulez utiliser votre propre petite image +"dessin_sympa.xpm" pour quand KBiff est placé dans le tableau de bord, +voud devrez renommer votre image en "mini-oldmail.xpm". Si vous ne procédez +pas ainsi, KBiff utilisera la grande version, même dans le tableau de +bord. + +Notez que KBiff détermine sa taille par rapport à l'image du courrier lu. +Ainsi si votre image pour le courrier lu a une taille de 100x100, mais si +toutes les autres images font 32x32... et bien, KBiff aura une drôle d'allure +à chaque fois que du courrier arrive. + + + +Comment fais-je pour utiliser elm (ou mutt ou PINE) avec KBiff ? + +Vous avez essayé de taper "elm" dans la zone de saisie du client de +courrier, +n'est-ce pas? Patatras! 'elm', 'mutt' et 'PINE' ont tous besoin d'un terminal +pour tourner et KBiff n'en fournit pas. L'auteur utilise le terminal suivant +comme client de courrier : +konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt +& + +Si vous utilisez un client de courrier graphique comme KMail ou Netscape, +alors +vous n'avez besoin que de mettre son nom dans la zone de saisie. Aucun terminal +n'est nécessaire. + + + +Pourquoi est-ce que KBiff ne joue pas mon fichier audio newmail.au +? + +KBiff utilise la classe KAudio pour jouer des sons quand du courrier +arrive. +Actuellement, cette classe ne supporte que des fichiers .wav. +Si vous désirez jouer un fichier .au quand du courrier arrive, essayez de vous +procurer le paquetage SOX et mettez 'play newmail.au' (ou simplement +'cat newmail.au > /dev/audio') dans l'option Lancer la commande. + + + +Est-ce que KBiff fonctionne sans gestion de session ? + +Oui. La gestion de session est activée par défaut, mais vous pouvez la +désactiver dans le dialogue de configuration. Vous pouvez toujours avoir +KBiff qui se lance au démarrage de KDE en mettant KDE dans le dossier +Ouverture au démarrage avec l'option '-profile". + + + +En cliquant sur votre adresse mél dans "A propos" il ne se passe rien +! + +Il serait très agréable de passer l'URL 'mailto:granroth@kde.org' à kfm +pour +la traiter... malheureusement, ce n'est pas encore implémenté. J'ai toutefois +codé un bout de gestion pour celà. Réglez simplement la variable +d'environnement MAILER en lui donnant le nom de votre lecteur de courrier +et le lien devrait fonctionner. +par exemple +% setenv MAILER konsole -e mutt + + +Notez que ceci présente l'avantage que si 'mailto:' est lié correctement +alors +kfm utilisera lui aussi votre lecteur de courrier. + + + +Quand j'utilise KBiff pour gérer ma boîte aux lettres, tous les autres +utilitaires 'biff' cessent de fonctionner. Que se passe-t'il ? + +Ceci est un résultat du code de comptage des messages dans KBiff. +Afin que KBiff sache combien de nouveaux messages sont dans une boîte aux +lettres de type mbox, il doit l'ouvrir afin de la lire. Quand il procède ainsi, +tous les autres utilitaires 'biff' (y compris celui inclus d'office dans le +shell) considéreront que vous êtes en train de lire votre courrier et +annonceront +qu'il s'agit de courrier déjà lu. + +Il y a trois façons de contourner ce problème : + +N'utilisez pas KBiff. + + +Utilisez le protocole 'fichier" plutôt que le protocole 'mbox' +(notez que vous ne saurez alors plus combien de méls sont arrivés) + + +Convertissez toutes vos boîtes aux lettres 'mbox' au format +'maildir' + + + + + + +Comment puis-je utiliser Netscape Mail avec KBiff? + +Vous avez essayé 'netscape -mail', n'est-ce pas ? Vous vous êtes alors +aperçu +que cela a eu pour effet que Netscape se plaint d'un fichier verrou s'il +est déjà lancé, n'est-ce pas ? Et bien, voici un contournement proposé +par l'utilisateur de KBiff Steven Boger +(sboger@marcus-online.net) +Créez un script pour le shell ainsi : +#!/bin/sh +if [ -L "$HOME/.netscape/lock" ]; +then +netscape -remote + 'xfeDoCommand(openInbox)' +else +netscape -mail & +fi + + + + +KBiff tronque le "/" initial en mode IMAP. Est-ce une bogue ? + +Non, c'est voulu ! Il est extrèmement rare d'utiliser un chemin absolu avec IMAP. +Pratiquement toutes les boîtes aux lettres sont accesibles soit à partir du répertoire de base de l'utilisateur, +soit à partir d'un nom symbolique comme "inbox". + + +Si vous essayez de lire /var/spool/mail/username, essayez d'entrer +inbox comme nom de boîte aux lettres. + + + +J'ai une idée pour ajouter une fonctionnalité géniale. Que dois-je faire ? + +D'abord lire le fichier TODO qui accompagne les sources et qui est sur le site internet. +Si votre fonctionalité est là, soyez patients. Si elle n'est pas là, ça ne coute rien de demander: +écrivez moi ! + + + diff --git a/doc/fr/kbiff/CMakeLists.txt b/doc/fr/kbiff/CMakeLists.txt deleted file mode 100644 index 495f168..0000000 --- a/doc/fr/kbiff/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -tde_create_handbook( DESTINATION ${PROJECT_NAME} LANG fr ) diff --git a/doc/fr/kbiff/index.docbook b/doc/fr/kbiff/index.docbook deleted file mode 100644 index f00c3e2..0000000 --- a/doc/fr/kbiff/index.docbook +++ /dev/null @@ -1,800 +0,0 @@ - -kbiff"> -]> - - -Manuel de KBiff - - -Kurt Granroth - -
granroth@kde.org
- - - -14 avril 2002 -3.6.1 - -KBiff est un utilitaire de notification d'arrivée de courrier électronique compatible -avec KDE. -Il supporte les boîtes aux lettres de type MBOX (façon Unix), Maildir (Qmail), -POP3, et IMAP. -Manuel de KBiff - -KDE -KBiff -Courrier électronique -Mél -Notification - - - - -Introduction - - -Caractéristiques - -KBiff est un utilitaire de notification d'arrivée de courrier pour le -projet KDE. Il a plusieurs -avantages sur bon nombre de ses concurrents : - - - -Configuration entièrement par interface -graphique. Il n'y a plus de paramètres de -ligne de commande à retenir (ou plutôt, certains restent disponibles en option -pour faciliter la -vie de certains), et plus de fichiers de configuration étranges. Tous les -réglages de KBiff peuvent -être faits depuis un simple dialogue de paramétrage. - - - -Gestion de session. KBiff redémarre avec -la configuration telle qu'elle était au moment -où vous en êtes sorti. - - - -Placement dans la barre de tâches -("docking"). KBiff peut être placé dans la barre de -tâches très facilement. C'est pratique quand vous gérez plusieurs boîtes aux -lettres et que vous n'avez -plus de place nulle part ailleurs. - - - -GIFs animés. Vous pouvez utiliser des -images GIFs animées comme icônes. - - - -Sons. Kbiff a une option pour jouer des -fichiers .wav quand du courrier arrive. - - - -POP3, IMAP4, Maildir, MBOX. KBiff supporte - les principaux formats de boîtes aux -lettres! - - - -Boîtes aux lettres multiples. KBiff peut -gérer plusieurs boîtes aux lettre depuis une -même instance du programme. - - - -Autres. KBiff a des tonnes d'autres -options. - - - - -Si vous avez des commentaires ou des demandes de nouvelles -fonctionnalités, ne vous gènez pas pour me -contacter par courrier. - -Kurt Granroth - -granroth@kde.org - - - -Améliorations prévues - -Il y a certaines caractéristiques que soit je prévois d'ajouter soit au -sujet desquelles je m'interroge. -Dans le désordre : - - - -Rajouter des points d'entrée CORBA. Eventuellement implémenter un modèle -client/serveur également. - - -Gérer les forums de discussion NNTP ? J'attends que quelqu'un me le -demande. - - - - - - - -Installation - - -Comment se procurer KBiff ? - -La version la plus récente en formats source et binaire se trouve -toujours sur le site de -KBiff, à l'adresse -http://www.granroth.org/kbiff. -KBiff fait également à présent partie du paquetage réseau "tdenetwork" et donc la version -en cours de développement se trouve toujours dans le référentiel CVS de -KDE. - - - -Configuration nécessaire - -Pour compiler avec succès KBiff, vous avez besoin au moins de la version -1.0 de KDE. -Toutes les librairies nécessaires se trouvent sur -ftp://ftp.kde.org/pub/kde. - - - -Compilation et Installation - -Il est très facile de compiler KBiff avec ce qui suit : -% ./configure -% make -% make install - - -Ca devrait suffire ! En cas de problèmes, veuillez les signaler à l' -auteur - - - - -Utilisation de KBiff - -Pratiquement toutes les caractéristiques de KBiff peuvent être changées -depuis le dialogue de -configuration. Les quelques paramètres que KBiff a en ligne de commande sont là -essentiellement -par souci de commodité, parce que c'est là qu'elles sont utiles. - - -Le profil d'utilisation - -KBiff est centré autour d'un profil d'utilisation. -Un profil est simplement un regroupement d'une ou plusieurs boîtes aux lettres -que KBiff va surveiller. -Par exemple, il y a toujours un profil par défaut appelé "Inbox" (ou autrement -si vous le renommez). -Ce profil ne contient qu'une boîte aux lettres, d'ordinaire du type -"/var/mail/username". -Il pourrait tout aussi bien contenir plusieurs boîtes aux lettres. Chaque -instance de KBiff -(c'est-à-dire, chaque icône visible) correspond à un profil. - - - -Les paramètres de ligne de commande - -KBiff supporte trois paramètres en ligne de commande. Il s'agit de : -profile, debug -et secure. --profile <nom_du_profil> Sauter le dialogue de -configuration et démarrer - KBiff directement avec le profil passé en argument, - par exemple 'kbiff -profile Inbox' --debug Passer en mode de débogage bavard. A utiliser uniquement -dans le cas de - problèmes avec KBiff --secure Désactiver le dialogue de configuration. Utile quand -vous voulez que KBiff tourne - mais lorsque vous ne voulez pas que d'autres le modifient. - - - - - -Le dialogue de configuration - -Le dialogue de configuration gère tous les aspects de la configuration de -KBiff. Par conséquent, -les paramètres de ligne de commande ne sont presque jamais nécessaires. - - -Nom du profil d'utilisation - -La partie supérieure du dialogue contient une liste déroulante et trois -boutons. -La liste déroulante contient les noms de tous les "profils". Un profil -d'utilisation -est un ensemble de réglages de configuration de boîte aux lettres. Les trois -boutons sont -intitulés Nouveau, Renommer et Supprimer. Ces boutons ne modifient que les -profils, ils -ne touchent pas aux boîtes aux lettres elles-mêmes. Quand KBiff est lancé pour la -première -fois, il n'y a qu'un profil, qui est créé automatiquement. Il s'agit du profil -"Inbox" qui surveille la boîte aux lettres système. - - - -Onglets de configuration - -Il y a quatre onglets d'options. Ils permettent de régler un grand nombre -d'options -relatives au profil courant. Le profil courant est celui qui est affiché dans la -liste -déroulante. Il n'y a pas de réglages globaux. - - -Général - -Les options générales pour chaque profil sont accessibles via cet onglet. -On y trouve cinq champs : - - -Intervalle - -Ce réglage contrôle combien de temps KBiff attend avant de revérifier la -boîte aux -lettre. La durée indiquée est en secondes. KBiff attend par défaut 60 secondes -(une minute). - -Pour savoir quelle durée choisir, il peut être judicieux d'analyser la -fréquence -à laquelle votre courrier arrive. Si, par exemple, -fetchmail télécharge le courrier arrivé toutes les -cinq minutes, il -est inutile de régler la durée sur une valeur inférieure. De la même façon, -si vous utilisez la fonctionnalité POP3 ou IMAP4 de KBiff, vous aurez sans -doute intérêt à utilisée un intervalle plus espacé. Si vous règlez -cette durée sur moind de 60 secondes, vous obtiendrez des résultats décevants -si votre connexion réseau est lente. - - - -Client de courrier - -Ce champ spécifie la commande à exécuter quand vous cliquez sur KBiff avec -le bouton -gauche de la souris. Bien qu'il s'agisse en général d'un client de courrier, -ce n'est pas indispensable. Cela peut être n'importe quelle commande ayant sa -propre -fenêtre X. Par exemple, si mettre elm dans ce -champ ne fonctionnera pas, -par contre mettre konsole -e elm marchera. La valeur -par défaut est -kmail -check - - - -Placer sur le tableau de bord - -Permet de déterminer si KBiff démarre placé dans le tableau de bord ou non -quand l'utilisateur sort du dialogue de configuration. Notez qu'il est possible -de basculer dans ou hors du tableau de bord indépendemment de cette option. Elle -ne contrôle que l'état initial, et est cochée par défaut. - - - -Utiliser la gestion de session - -Permet d'activer ou de désactiver la gestion de session KDE. Cette case ne -doit -être dévalidée que dans de rares cas. Le cas le plus courant où l'on -désactive la gestion de session est celui où un utilisateur utilise -simultanément -KDE sur plusieurs ordinateurs différents. Dans ce cas, il serait sans doute -souhaitable de désactiver la gestion de session et d'utiliser l'option de -ligne de commande -profile à la place. - -Dans tous les autres cas, la gestion de session devrait probablement être -laissée active. - - - - -Icônes - -KBiff utilise trois icônes pour représenter les trois états : Pas de -courrier, -Anciens message et Nouveau message. Les icônes proposées sont les "grandes" -icônes. -Pour en choisir de nouvelles, cliquez sur les boutons et un dialogue de -chargement -d'icône apparaîtra. Notez que bien que KBiff supporte les images GIF animées, -elles n'apparaîtront pas animées ici. - - - - -Nouveau message - -Cet onglet regroupe les options qui traitent de ce qui se passe lorsque du -courrier arrive. - - -Exécuter la commande - -Il s'agit d'une commande de ligne de commandes qui sera exécutée lorsque -du -courrier arrive. Un exemple typique serait play -newmail.au. -Cela aurait pour conséquence de faire jouer le son contenu dans le fichier -newmail.au chaque fois que du courrier arrive. -Par défaut, cette option est dévalidée. - - - -Lire un fichier son - -Cela indique un son à jouer lorsque du courrier arrive. Dans cette -version, -seuls des fichiers au format .wav peuvent être joués. -Indiquez simplement le chemin vers le fichier à jouer. -Par défaut, cette option est dévalidée. - - - -Bip système - -Si cette option est activée, KBiff bipera chaque fois que du courrier -arrive. -Il s'agit probablement de l'option la moins envahissante, bien que toujours -active, de prévenir l'utilisateur de l'arrivée de courrier. -Par défaut, cette option est validée. - - - -Notifier - -Si cette option est activée, KBiff affichera une fenêtre à chaque fois que -du courrier -arrive. Le message d'avertissement affichera aussi bien la boîte aux lettres -concernée que le nombre de messages arrivés. -Cette option est déconseillée pour les boîtes aux lettres qui recoivent beaucoup -de courrier. - - - - -Boîte aux lettres - -Cet onglet regroupe les options concernant les boîtes aux lettres réelles -elles-mêmes. - -Toutes les options de cet onglet concernent UNE SEULE boîte aux lettres. -Par -conséquent, si vous avez trois boîtes aux lettres dans ce profil utilisateur, -chaque boîte aux lettres aura ses propres réglages dans cet onglet. Par contre, -tous les réglages des autres onglets s'appliquent à l'ensemble du profil -utilisateur. -Par exemple, si vous avez l'option "Notifier" active dans l'onglet "Nouveau -message", -alors KBiff vous enverra un message d'avertissement quand du courrier arrive -dans -l'une quelconque des boîtes aux lettres de ce profil utilisateur. - - -Liste de boîtes aux lettres - -La liste déroulante à gauche de l'onglet contient la liste des boîtes aux -lettres -que le profil courant gère. Dans la plupart des cas, il n'y en aura qu'une -(la boîte aux lettres "par défaut"). Néanmoins, vous pouvez gérer autant de -boîtes -aux lettres par "profil" qu'il vous plaira. - -Il y a deux boutons sous la liste déroulante. Le bouton avec une boîte -aux lettres -dessinée dessus sert à créer une nouvelle boîte aux lettres. Le bouton avec une -croix sert -à en détruire une. Si vous désirez renommer une boîte aux lettres, vous devez -détruire la -vieille boîte aux lettres et en créer une nouvelle avec des propriétés -identiques. - - - -Protocole - -Ce champ détermine le protocole utilisé par la boîte aux lettres -couramment sélectionnée. -Il y a 4 (et demi) protocoles - mbox (Unix style), maildir (Qmail), POP3, et -IMAP4. -Le protocole 'fichier' peut être utilisé pour gérer tout fichier local car il -n'utilise que les dates de dernière lecture et de dernière modification pour -déterminer -l'état du fichier. - - - -Boîte aux lettres - -Ce champ n'est pas actif avec le protocole POP3. Dans tous les autres -cas, mettez -le chemin d'accès à votre boîte aux lettres ici. Dans le cas du protocole mbox, -il -s'agit d'un fichier. Dans le cas de maildiri et de IMAP4, il s'agira d'un -répertoire. - - - -Serveur - -Ce champ n'est actif que pour les protocoles IMAP4 et POP3. - - - -Utilisateur - -Ce champ n'est actif que pour les protocoles IMAP4 et POP3. - - - -Mot de passe - -Ce champ n'est actif que pour les protocoles IMAP4 et POP3. - - - -Stocker le mot de passe - -Cette case à cocher permet de conserver le mot de passe entre deux -sessions. - -KBiff ne crypte pas le mot de passe quand il est enregistré ! Il le -brouille un -petit peu, mais quiconque possède le code source (ou un peu de patience) -pourrait le -faire apparaître en clair en un instant. Si vous êtes sur un réseau non -sécurisé, -il est fortement recommandé que l'option "stocker le mot de passe" soit -dévalidée. - - - -Avancé - -Ce bouton permet d'afficher un dialogue concernant les caractéristiques -avancées. - - -URL de la boîte aux lettres - -KBiff gère en interne les boîtes aux lettres comme des URLs. Si vous savez -ce que vous -faites, vous pouvez modifier directement l'URL ici. La modification de cette -option est -déconseillée à moins que vous ne soyez familier avec le code de -l'application. - - - -Port - -Mettez ici le port servant à joindre votre serveur de courrier. Par défaut, -il s'agira du port -110 pour POP3 et 143 pour IMAP4. - - - -PREAUTH - -Si vous ne savez pas ce que ça veut dire, alors vous n'avez sans doute pas -besoin de l'utiliser. -En gros, ça permet de vérifier si du courrier est arrivé sans qu'IMAP4 ne -procède à une identification (login). - - - -Laisser actif - -Quand cette case est cochée en mode POP3 ou IMAP4, cela permettra de -laisser la connexion "active". -C'est-à-dire que KBiff se connectera une fois et restera connecté. Cette option -n'est pas recommandée si -votre serveur POP3 ou IMAP4 utilise des verrous. Si des verrous sont en place et -si KBiff ne se déconnecte pas -alors votre client de courrier ne sera pas capable d'accéder à votre compte de -courrier. - - - - - -A propos - -Cet onglet présente des informations au sujet de KBiff. - - -A propos de KBiff - -On trouve ici des informations sur la version de KBiff utilisée. Il y a -également -des informations permettant de contacter l'auteur. - -Notez que l'adresse mél est un hyperlien. En cliquant dessus, votre client -de courrier -est supposé se lancer afin d'envoyer un message à l'auteur. Malheureusement, -il n'y a actuellement aucun moyen d'effectuer cette opération automatiquement. -Néanmoins, il y a une amorce de code derrière. Pour envoyer du courrier en -utilisant cet -hyperlien, KBiff regarde la variable d'environnement MAILER. S'il la trouve, -il utilisera son contenu pour savoir quel programme de courrier utiliser. - -Par example, si MAILER est réglé ainsi : - % setenv MAILER "konsole -e mutt" -alors KBiff utilisera konsole -e mutt comme client de -courrier par défaut. - - - - - - -Le menu contextuel - -Le menu contextuel est activé à chaque fois que l'on clique sur le bouton -droit -de la souris dans la partie consacrée à l'icône de KBiff. - - -(Dés)arrimer - -Cette option place ou retire KBiff du tableau de bord. Cette option ne -fonctionne qu'avec des gestionnaires de fenêtres complètement compatibles -avec KDE comme KWM. L'état par défaut est défini via le dialogue de -configuration. - - - -Configuration - -Cette option affiche le dialogue de configuration. Voir la section -consacrée au dialogue de configuration pour plus de détails. - - - -Aide - -Cette option lance l'aide en ligne (ceci). - - - -Vérifier maintenant - -Cette option force KBiff à vérifier immédiatement si du courrier est -arrivé, -sans tenir compte du délai entre deux vérifications. -Cette option vérifie toutes les boîtes aux lettres d'un profil donné. - - - -Lire le courrier maintenant - -Cette option force KBiff à faire comme si toutes les boîtes aux lettres du -profil courant étaient "lues". -Celà présente de l'intérêt surtout lorsque vous avez du courrier sur un -serveur distant (pop3 ou imap4) et que vous n'avez pas envie de le télécharger -sur le champ. - - - -Arrêter/démarrer - -Cette option arrête ou démarre KBiff. - - - - -Questions, réponses et astuces - - -Y-a-t'il d'autres utilitaires "biff" compatibles avec KDE ? - -Oui. J'en connais au moins deux. Chaque "biff" a ses propres avantages. -KOrn était le premier. Sa qualité principale est -de pouvoir gérer -plusieurs boîtes aux lettres avec une seule instance de programme et de -montrer le nombre de messages dans chacune d'entre elles. Si vous avez -beaucoup de boîtes aux lettres et que vous ne recherchez pas de jolies -icônes, alors KOrn est probablement un meilleur choix que KBiff. -L'autre "biff" est KNewMail. KnewMail cherche à -imiter l'utilitaire -NewMail de Windows. Il vérifie la présence de courrier POP3 et affiche le -sujet de chaque message. - - - -Quelle est encore la différence entre un "profil" et une boîte aux -lettres ? - -Un "profil" est un groupe d'une ou plusieurs boîtes aux lettres qu'une -instance de KBiff gère. Un exemple de profil est "Inbox". Une "boîte aux -lettres" est une entité physique qui peut être géré par KBiff. Un exemple -de boîte aux lettres est "/usr/var/username". - - - -Puis-je utiliser mes propres images ? - -Réponse rapide: choisissez-les dans le menu de configuration. -Reponse plus approfondie: KBiff recherche ses icônes dans le chemin des icônes -de KDE. En ce moment, elles sont dans -tdedir()/share/apps/kbiff/toolbar -tdedir()/share/toolbar -tdedir()/share/icons -tdedir()/share/apps/kbiff/pics -$HOME/.kde/share/apps/kbiff/toolbar -$HOME/.kde/share/toolbar -$HOME/.kde/share/icons -$HOME/.kde/share/apps/kbiff/pics - - -Où "tdedir()" est habituellement "/opt/kde" et où $HOME est votre -répertoire personnel. Si vous placez vos images dans l'un de ces répertoires -(le dernier de la liste étant celui qu'on recommande), alors KBiff -ne devrait pas avoir de problèmes à les trouver et à les utiliser - -Si vous projetez de placer KBiff dans le table de bord, vous devriez avoir -une version de votre image de taille inférieure ou égale à 22x22. -Le nom de la petite image devrait être le nom de la grande image précédé par -"mini-". Ainsi si vous voulez utiliser l'image par défaut "oldmail.xpm" -pour le courrier lu mais si vous voulez utiliser votre propre petite image -"dessin_sympa.xpm" pour quand KBiff est placé dans le tableau de bord, -voud devrez renommer votre image en "mini-oldmail.xpm". Si vous ne procédez -pas ainsi, KBiff utilisera la grande version, même dans le tableau de -bord. - -Notez que KBiff détermine sa taille par rapport à l'image du courrier lu. -Ainsi si votre image pour le courrier lu a une taille de 100x100, mais si -toutes les autres images font 32x32... et bien, KBiff aura une drôle d'allure -à chaque fois que du courrier arrive. - - - -Comment fais-je pour utiliser elm (ou mutt ou PINE) avec KBiff ? - -Vous avez essayé de taper "elm" dans la zone de saisie du client de -courrier, -n'est-ce pas? Patatras! 'elm', 'mutt' et 'PINE' ont tous besoin d'un terminal -pour tourner et KBiff n'en fournit pas. L'auteur utilise le terminal suivant -comme client de courrier : -konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt -& - -Si vous utilisez un client de courrier graphique comme KMail ou Netscape, -alors -vous n'avez besoin que de mettre son nom dans la zone de saisie. Aucun terminal -n'est nécessaire. - - - -Pourquoi est-ce que KBiff ne joue pas mon fichier audio newmail.au -? - -KBiff utilise la classe KAudio pour jouer des sons quand du courrier -arrive. -Actuellement, cette classe ne supporte que des fichiers .wav. -Si vous désirez jouer un fichier .au quand du courrier arrive, essayez de vous -procurer le paquetage SOX et mettez 'play newmail.au' (ou simplement -'cat newmail.au > /dev/audio') dans l'option Lancer la commande. - - - -Est-ce que KBiff fonctionne sans gestion de session ? - -Oui. La gestion de session est activée par défaut, mais vous pouvez la -désactiver dans le dialogue de configuration. Vous pouvez toujours avoir -KBiff qui se lance au démarrage de KDE en mettant KDE dans le dossier -Ouverture au démarrage avec l'option '-profile". - - - -En cliquant sur votre adresse mél dans "A propos" il ne se passe rien -! - -Il serait très agréable de passer l'URL 'mailto:granroth@kde.org' à kfm -pour -la traiter... malheureusement, ce n'est pas encore implémenté. J'ai toutefois -codé un bout de gestion pour celà. Réglez simplement la variable -d'environnement MAILER en lui donnant le nom de votre lecteur de courrier -et le lien devrait fonctionner. -par exemple -% setenv MAILER konsole -e mutt - - -Notez que ceci présente l'avantage que si 'mailto:' est lié correctement -alors -kfm utilisera lui aussi votre lecteur de courrier. - - - -Quand j'utilise KBiff pour gérer ma boîte aux lettres, tous les autres -utilitaires 'biff' cessent de fonctionner. Que se passe-t'il ? - -Ceci est un résultat du code de comptage des messages dans KBiff. -Afin que KBiff sache combien de nouveaux messages sont dans une boîte aux -lettres de type mbox, il doit l'ouvrir afin de la lire. Quand il procède ainsi, -tous les autres utilitaires 'biff' (y compris celui inclus d'office dans le -shell) considéreront que vous êtes en train de lire votre courrier et -annonceront -qu'il s'agit de courrier déjà lu. - -Il y a trois façons de contourner ce problème : - -N'utilisez pas KBiff. - - -Utilisez le protocole 'fichier" plutôt que le protocole 'mbox' -(notez que vous ne saurez alors plus combien de méls sont arrivés) - - -Convertissez toutes vos boîtes aux lettres 'mbox' au format -'maildir' - - - - - - -Comment puis-je utiliser Netscape Mail avec KBiff? - -Vous avez essayé 'netscape -mail', n'est-ce pas ? Vous vous êtes alors -aperçu -que cela a eu pour effet que Netscape se plaint d'un fichier verrou s'il -est déjà lancé, n'est-ce pas ? Et bien, voici un contournement proposé -par l'utilisateur de KBiff Steven Boger -(sboger@marcus-online.net) -Créez un script pour le shell ainsi : -#!/bin/sh -if [ -L "$HOME/.netscape/lock" ]; -then -netscape -remote - 'xfeDoCommand(openInbox)' -else -netscape -mail & -fi - - - - -KBiff tronque le "/" initial en mode IMAP. Est-ce une bogue ? - -Non, c'est voulu ! Il est extrèmement rare d'utiliser un chemin absolu avec IMAP. -Pratiquement toutes les boîtes aux lettres sont accesibles soit à partir du répertoire de base de l'utilisateur, -soit à partir d'un nom symbolique comme "inbox". - - -Si vous essayez de lire /var/spool/mail/username, essayez d'entrer -inbox comme nom de boîte aux lettres. - - - -J'ai une idée pour ajouter une fonctionnalité géniale. Que dois-je faire ? - -D'abord lire le fichier TODO qui accompagne les sources et qui est sur le site internet. -Si votre fonctionalité est là, soyez patients. Si elle n'est pas là, ça ne coute rien de demander: -écrivez moi ! - - - diff --git a/doc/man/CMakeLists.txt b/doc/man/CMakeLists.txt deleted file mode 100644 index 8512250..0000000 --- a/doc/man/CMakeLists.txt +++ /dev/null @@ -1,5 +0,0 @@ -INSTALL( - FILES ${PROJECT_NAME}.1 - DESTINATION ${MAN_INSTALL_DIR}/man1 - COMPONENT doc -) -- cgit v1.2.3