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/de/CMakeLists.txt | 1 - doc/de/index.docbook | 644 ++++++++++++++++++++++++++++++++++++++++++++ doc/de/kbiff/CMakeLists.txt | 1 - doc/de/kbiff/index.docbook | 644 -------------------------------------------- 4 files changed, 644 insertions(+), 646 deletions(-) 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 (limited to 'doc/de') 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> - - -- cgit v1.2.1