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/index.docbook | 644 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 644 insertions(+) create mode 100644 doc/de/index.docbook (limited to 'doc/de/index.docbook') 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> + + -- cgit v1.2.1