# Balsa Balsa-Benutzerhandbuch

Pawel
Salek
1997-2006
Stuart Parmenter und weitere, eine vollständige Liste finden Sie in AUTOREN
2008
Mario Blättermann (mariobl@gnome.org)

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.

UNIX ist ein eingetragenes Warenzeichen von X/Open Group.

Linux ist ein eingetragenes Warenzeichen von Linus Torvalds.

X Window System ist ein eingetragenes Warenzeichen von X Consortium, Inc.

Windows ist ein eingetragenes Warenzeichen der Microsoft Corp.

Macintosh und Apple sind eingetragene Warenzeichen von Apple Computer, Inc.

Alle weiteren Warenzeichen gehören den jeweiligen Eigentümern.

Dies ist Version 2.721 des Balsa-Handbuchs.
2.721
26. Februar 2006

Bei diesem Dokument handelt es sich um das erweiterte Balsa-Handbuch.

Balsa is a graphical mail client. While it is in active development, Balsa has many features such as: IMAP and POP3 support; sendmail or direct SMTP support; optional multi-threaded retrieval and sending of messages; support for all configurations of local mail folders; automatic mail checking; mail printing; inline attachment viewing; and the proverbial much, much more.

This document will introduce a person who understands mail to using Balsa. However, it will not explain email to a confused individual. If you're looking for that, try asking a friend or visiting the Email FAQ.

## Einführung

Balsa ist ein grafisches E-Mail-Programm, ähnlich zu Eudora unter Windows. Es unterstützt die Standardfunktionen jedes guten Mailprogramms, neue Funktionen kommen ständig hinzu. Obenstehend finden Sie eine Funktionsübersicht.

Balsa is written using GTK+ and GNOME. Originally based on libmutt, the back end code to Mutt, Balsa now uses a combination of GMime for handling Mime messages, and its own drivers for local and remote mailstores.

If you want to learn more about Balsa, your best bet is the mailing list balsa-list@gnome.org, which can be subscribed to by going to the website http://mail.gnome.org/mailman/listinfo/balsa-list or by sending a message with a subject of subscribe to balsa-list-request@gnome.org. Bugs can be reported via bug-buddy, gnome-bug or to submit@bugs.gnome.org.

## Erste Schritte mit Balsa

If you're starting Balsa for the first time, the first thing you'll see is a Druid that will set up Balsa's basic settings. Balsa can guess most of what it needs to know about you. It will also create five standard local mailboxes: the Inbox, Outbox, Sentbox, Draftbox, and Trash. (These can be changed to be IMAP mailboxes later.)

### Balsa-Start-Druide

Don't worry. Balsa cooperates with other MUA's very well. They share the same locking semantics for mailboxes. If Balsa shares the same mail directory as pine or Mutt, it will detect new folders as they are created. So if you have to telnet in to your mail machine, you won't be stuck.

Es gibt noch weitaus mehr Einstellungen im Einstellungsfenster von Balsa, aber die meisten davon brauchen nicht geändert zu werden.

Sobald Balsa einmal konfiguriert ist, werden Sie zum Hauptfenster weitergeleitet.

## Das Hauptfenster

### Hauptfenster

Das Hauptfenster von Balsa gliedert sich in drei Teilbereiche. An der linken Seite befindet sich die Postfachliste. Diese stellt alle Postfächer dar, die Balsa kennt, es wird in Ihrem lokalen Mailordner danach gesucht. Das bedeutet, dass Balsa recht gut mit procmail zusammenarbeitet. Außerdem werden die von Ihnen konfigurierten IMAP-Postfächer aufgelistet. Wenn die Option Zeige Postfach-Informationen aktiviert ist, werden neben den Namen der Postfächer zwei weitere Spalten mit der Gesamtzahl der Nachrichten und der Anzahl der ungelesenen Nachrcihten angezeigt, sofern ungelesene Nachrichten existieren. Jede Mailbox, die ungelesene Nachrichten enthält, wird in Fettschrift dargestellt.

Oben rechts befindet sich die Ansicht des gegenwärtig geöffneten Postfachs, Nachrichtenindex genannt. Sie können hier Ihre Mails durchstöbern und sie bearbeiten.

Unten rechts im Hauptfenster von Balsa befinder sich die Nachrichtenansicht. Hier wird die im Nachrichtenindex ausgewählte Nachricht angezeigt. Sie können hier Anhänge betrachten oder speichern, oder eingehende Mails lesen.

### Menüs und Werkzeugleisten

#### Werkzeugleiste des Hauptfensters

Die Menüleiste am oberen Rand des Hauptfensters stellt die folgenden Befehle bereit:

Datei

  Dieses Menü enthält grundlegende Befehle.

  - Datei Neu

      - M Datei Neu Nachricht … -- Erstellt eine neue Nachricht und zeigt ein neues Fenster an, in welchem Sie die Nachricht eingeben können.

      - File New Mailbox... --

        Open a dialog box to create a new mailbox. There are various items like this, corresponding to the different types of mailbox that Balsa supports. See the discussion of different mailbox formats and their advantages and disadvantages.

      - File New Remote IMAP folder... --

        Open a dialog box to create a folder for an account on an IMAP server. This IMAP folder properties dialog can also be used to change the details of the account.

      - File New Remote IMAP subfolder... --

        Open a dialog box to create a new subfolder in an existing IMAP folder tree. This IMAP subfolder properties dialog can also be used to rename or move a subfolder.

  - C File Continue --

    Continue a postponed message.

  - CtrlM File Get New Mail --

    This causes Balsa to attempt to retrieve any new messages from the POP3 server.

  - CtrlT File Send Queued Mail -- Send all mail waiting in the Outbox mailbox to the mail server now.

  - CtrlB File Send and Receive Mail -- Send all mail waiting in the Outbox mailbox to the mail server now and retrieve any new messages.

  - File Print --

    Print the currently selected message (displayed in the message view pane.)

  - B Datei Adressbuch -- Öffnet das Adressbuch von Balsa.

  - Datei Beenden -- Beendet das Programm.

Bearbeiten

  - Bearbeiten Kopieren -- Kopiert den ausgewählten Text in die Zwischenablage.

  - Bearbeiten Alles auswählen -- Wählt den gesamten Text in der gegenwärtig angezeigten Nachricht aus.

  - Edit Find -- Find messages in the current mailbox that match a given set of conditions, using the search mailbox window.

  - Edit Find next -- Find the next matching message.

  - Edit Filters -- Open up the filters window.

  - Edit Export filters -- Open up a window for exporting filters in the Sieve format.

Ansicht

  Menü zum Anpassen der Nachrichtenansicht.

  - Ansicht Postfach-Baum anzeigen -- Schaltet die Anzeige des Postfach-Baums im Hauptfenster ein oder aus.

  - View Show Mailbox Tabs --

    Toggle the display of tabs for all open mailboxes.

  - View Wrap --

    Toggle the display of messages using word wrap. The column to which the message is wrapped is set in the Preferences window.

  - View No Headers , Selected Headers , All Headers --

    Select the headers to display in the message pane.

  - View Flat index , Simple threading, JWZ threading --

    Select the type of threading used to sort the messages in the list pane.

  - CtrlE Edit Expand All -- Expand all threads in the currently displayed mailbox.

  - CtrlL Edit Collapse All -- Collapse all threads in the currently displayed mailbox.

  - View Zoom In , Zoom Out, Zoom 100% --

    Alter the font size of HTML messages. Plain text messages will always use the font specified in the Preferences window.

Postfach

  For manipulating mailboxes.

  - N Postfach Nächste -- Wählt die nächste Nachricht im gegenwärtig geöffneten Postfach.

  - P Postfach Vorherige -- Wählt die vorherige Nachricht im gegenwärtig geöffneten Postfach.

  - CtrlN Mailbox Next Unread --

    Select the next unread message in the current mailbox.

  - CtrlAltF Mailbox Next Flagged --

    Select the next flagged message in the current mailbox.

  - Mailbox Hide messages --

    A submenu listing all the types of messages that may be hidden and unhidden in the current mailbox. Types in the submenu are toggled when selected. A Checkmark indicates it is currently hidden.

  - Mailbox Reset Filter --

    Resets to the mailbox filter.

  - Mailbox Select All --

    Selects all messages in the current mailbox.

  - Postfach Bearbeiten … -- Bearbeiten der Eigenschaften eines Postfachs.

  - Mailbox Delete... --

    Delete the currently selected mailbox.

  - Mailbox Expunge Deleted Messages --

    Physically remove from the backing mailstore all messages marked as deleted.

  - Mailbox Close --

    Close the currently selected mailbox.

  - Mailbox Empty Trash --

    Delete all messages from the Trash mailbox.

  - Mailbox Select Filters --

    Pop up a dialog that allows you to control which filters are applied to this mailbox, and optionally to apply them.

### Menü Nachricht

Nachricht

  Dieses Menü verfügt über Befehle zum Bearbeiten von Nachrichten.

  - R Message Reply... -- Reply to the currently selected message(s).

  - A Message Reply to All... --

    Reply to the currently selected message(s), sending the reply to all senders and recipients of the message.

  - G Message Reply to Group... --

    Reply to a mailing list, instead of the sender to that list.

  - F Message Forward attached... --

    Forward the currently selected message(s) as an attachment.

  - Message Forward inline... --

    Forward the currently selected message(s), quoted inline.

  - Ctrl. Message Next Part --

    View the next part of the message (if the message is multi-part).

  - Ctrl, Message Previous Part --

    View the previous part of the message.

  - CtrlS Message Save Current Part... --

    Save the currently selected part of the message to a file.

  - CtrlU Message View Source... --

    Opens a new window that displays the raw message as received from the MTA.

  - Message Copy --

    Copies to the clipboard any text selected in the message view of the current message.

  - Message Select Text --

    Selects the entire text of the current message in the message view.

  - D Message Move to Trash --

    Moves the currently selected message(s) to the Trash.

  - Nachricht Toggle flag

    - X Message Toggle flag Flagged --

      Toggle the flag on the currently selected message(s). This is shown as an exclamation mark next in the message index.

    - CtrlD Message Toggle flag Deleted --

      Marks the message as set for deletion. The message will be actually removed from the backing mailstore when it is expunged either manually, or as specified in the Preferences. The icon is a small trash can.

    - CtrlR Message Toggle flag New --

      Marks a message that has been read as new, and vice-versa. The message will display the standard icon and font for a new message.

    - Message Toggle flag Answered --

      Toggles the reply icon for a message.

  - S Message Store Address... --

    Add the sender of the currently selected message to your address book.

Einstellungen

  Menü zum Ändern der Konfiguration von Balsa.

  - Settings Preferences... --

    Open the Preferences window to change the settings of Balsa.

  - Settings Toolbars... --

    Open the Toolbars window to modify the content and arrangement of the toolbars in Balsa.

  - Settings Identities... --

    Open the Identities window to customize how you present yourself to the rest of the world.

### Die Postfachliste

The mailbox list in the main window lists all of your mailboxes. Balsa will automatically detect your local mailboxes by searching for mailboxes under your local mail directory (probably ~/mail). This lets Balsa coexist with pine and procmail without causing problems.

Your mailboxes will be displayed as a tree view, with mailboxes in subdirectories of your local mail directory initially hidden but accessible by expanding the tree. IMAP mailboxes will also be displayed as being at the top level of the tree. POP3 mailboxes are not displayed.

### Der Nachrichtenindex

The message index displays the messages in the current folder, and lets you choose which messages to view. Click on the notebook tabs, or click on a folder in the mailbox list to bring it to the front.

From the message index you can do a lot. Clicking on a message will cause it to be displayed in the message view. Right-clicking on it will give a pop-up menu letting you reply to the message (or forward it, etc.) and move it to another folder (using the Move to menu item). Double-clicking on a message will open it in a separate window. Also, it is possible to drag and drop messages from the index to other mailboxes in the mailbox list and open mailbox tabs.

Das Kontextmenü enthält die folgenden Einträge:

- Reply, Reply To All, Reply To Group, Forward Attached, Forward Inline, Store Address, Delete, Undelete, Move To Trash, Toggle Flagged, Toggle Unread, Move to, View Source --

  These perform the same actions as their counterparts in the message menu.

- Move to --

  Moves the currently selected message(s) to another mailbox. When this menu item is selected a list of available mailboxes is displayed from which the destination should be selected.

### Das Nachrichtenfenster

Dies zeigt die im Nachrichtenindex ausgewählte Nachricht angezeigt. Die Kopfzeilen werden oberhalb des Nachrichtentexts dargestellt, es sei denn, Sie haben dies deaktiviert. Der Nachrichtentext wird unterhalb der Kopfzeilen angezeigt.

If the message is multipart, an attachment icon will appear beside the headers. Clicking this icon will display a list of the parts from which you may select one. If Balsa is unable to display it, you will be given a choice of applications known to handle the part. Additionally, there is always an option to save the attachment to a file.

Gegenwärtig unterstützt Balsa nur dann HTML-Nachrichten, wenn das Programm mit gtkhtml-Unterstützung kompiliert wurde. gtkhtml ist derzeit hinreichend stabil und wird verwendet, wenn beim Erstellen des Programms die gtkhtml-Entwicklerdateien gefunden wurden.

You are not restricted to that pane either. Double-clicking on a message in the message index will open it in a separate window.

## Der Nachrichteneditor

### Fenster des Nachrichteneditors

When the New Message or Reply or Forward action is selected, the message to be sent is brought up in the Message Composer. This window is where you can type the text of the message, attach files, and specify recipients. The window also provides an interface to spell check the message. Signing and encryption of messages using GnuPG or PGP are also supported, when Balsa is built with cryptographic support.

When the message window first opens, you will see the several main sections:

- Die Menüleiste

- Werkzeugleiste

- Kopfzeilen

- The attachment box

- Der Nachrichtenrumpf

Diese werden nachstehend genauer erklärt:

### Menüleiste

This contains all of the available commands for acting on the message, from selecting the headers to display to changing the character set of the message. Some of the menu items are not always available, depending on what state the message is currently in.

Datei

  Das Datei-Menü enthält Befehle zum Bearbeiten der Nachricht an sich.

  - File Include File... --

    Include a text file in the body of the message; only works for plain text files.

  - File Attach File... --

    Attach any kind of file to the message.

  - Datei Senden -- Sendet die Nachricht.

  - File Queue --

    Queue the message in the outbox for sending later.

  - File Postpone --

    Save the message in the Draftbox for later revision and sending. You will be unable to postpone a message that is not currently valid.

  - File Print... --

    Print a hard-copy of the current message.

  - CtrlW File Close --

    Close and discard the current message.

  Eine Nachricht wird als gültig (sendebereit) betrachtet, wenn sie im Feld An: nur gültige E-Mail-Adressen enthält.

Bearbeiten

  Das Bearbeiten-Menü enthält Befehle, die zum Bearbeiten des Nachrichtenrumpfs verwendet werden.

  - CtrlX Edit Cut --

    Cut the selected text to the clipboard.

  - CtrlC Edit Copy --

    Copy the selected text to the clipboard

  - CtrlV Edit Paste --

    Paste the contents of the clipboard to the current position of the cursor.

  - StrgA Bearbeiten Alles auswählen

  - CtrlZ Edit Wrap Body

    -- Cause all the lines in the message to be wrapped to the specified outgoing mail wrap column.

  - CtrlR Edit Reflow Paragraph --

    Cause all the lines in the paragraph the cursor is in to be wrapped to the specified outgoing mail wrap column.

  - CtrlShiftR Edit Reflow Message --

    Cause all the lines in the message to be wrapped to the specified outgoing mail wrap column.

  - CtrlShiftS Edit Check Spelling --

    Start spell checking the current message.

Zeigen

  The Show menu is used to control which headers are displayed in the composer window for editing.

  - Show From -- Display the `From` header.

  - Show To -- Display the `To` header.

  - Show Subject -- Display the `Subject` header.

  - Show Cc -- Display the `Cc` header.

  - Show Bcc -- Display the `Bcc` header.

  - Show Fcc -- Display the `Fcc` header.

  - Show Reply To -- Display the `Reply-To` header.

  - Show Attachments -- Display the `Attachments` box.

  - Show Comments -- Display the `Comments` header.

  - Show Keywords -- Display the `Keywords` header.

Sprache

  Das Sprachmenü ermöglicht Ihnen die Einstellung der Sprache zum Schreiben desw Nachrichtentexts. Balsa unterstützt nicht mehrere Zeichensätze innerhalb ein und derselben Nachricht. Die gegenwärtig verwendete Sprache wird am unteren Rand des Menüs angezeigt, zusammen mit dem verwendeten Zeichensatz.

  Liste der verfügbaren Sprachen:

  - Brasilianisches Portugiesisch

  - Katalanisch

  - Chinesisch

  - Tschechisch

  - Dänisch

  - Niederländisch

  - Englisch

  - Estnisch

  - Finnisch

  - Französisch

  - Deutsch

  - Griechisch

  - Ungarisch

  - Italienisch

  - Japanisch

  - Koreanisch

  - Norwegisch

  - Polnisch

  - Portugiesisch

  - Russisch

  - Slowakisch

  - Spanisch

  - Schwedisch

  - Türkisch

  - Ukrainisch

  and more may have been added.

Optionen

  - Options Request Disposition Notification

    -- If checked Balsa will include the `Disposition-Notification-To` header line with your `From` address. Please note that the handling of this request depends on the receiving mail program and that it not guaranteed that this notification will be sent back.

  - Options Format = Flowed

    --

  - Options Sign message

    -- Cryptographically sign the message. The recipients can check the signature to prove the sender's (=your) identity or to detect any tampering with the message.

  - Options Encrypt message

    -- Encrypt the message. Only the intended recipient(s) can decrypt and read the contents.

  - Die folgenden Optionen legen das Protokoll fest, welches zum Signieren und/oder Verschlüsseln der Nachricht verwendet wird. Sie sollten dasjenige Protokoll auswählen, mit dem alle Empfänger umgehen können.

    - Options GnuPG uses MIME mode

      -- Sign and/or encrypt the complete message, including all attachments, using the PGP/MIME mode (RFC 3156). Note that the message envelope (including the Subject) is not protected.

    - Options GnuPG uses old OpenPGP mode

      -- Sign and/or encrypt only the message text, but not attachments, using the OpenPGP mode (RFC 2440). If you want to add any attachments, sign and/or encrypt them manually before adding.

    - Options S/MIME mode (GpgSM)

      -- Sign and/or encrypt the complete message, including all attachments, using the S/MIME mode (RFC 2633). Note that the message envelope (including the Subject) is not protected.

  Kryptografisches Signieren und Verschlüsselung sind nur dann möglich, wenn Balsa mit GnuPG-Unterstützung gebaut wurde. Eine detaillierte Beschreibung der E-Mail-Kryptografie finden Sie im GnuPG-Handbuch und im GnuPG-HOWTO.

### Werkzeugleiste

Die Werkzeugleiste enthält Knöpfe für die meistbenutzten Funktionen zum Senden von Nachrichten, einschließlich Beilegen von Dateien und Speichern. Wie in der Menüleiste, sind auch hier einige Knöpfe deaktiviert, falls die Nachricht noch nicht korrekt sendefähig ist.

#### Werkzeugleiste

Senden

  Send the current message. Only available if the message is legal to be sent (i.e. proper email addresses). This button may also be configured to queue the message in the outbox to be sent later (see the Preferences dialog).

Beilegen

  Öffnet einen Dialog zum Beilegen einer Datei zur aktuellen Nachricht.

Zurückstellen

  Stellt eine Nachricht in den Entwürfe-Ordner zurück, um diese später zu bearbeiten und zu senden.

Rechtschreibung prüfen

  Start a spell check on the current message. Balsa can currently use either the standard ispell or the newer aspell to do the spell checking. Settings for this can be found in the Preferences dialog.

Drucken

  Print out the draft of the message.

Abbrechen

  Schließt das Editorfenster, ohne die darin befindliche Nachricht zu speichern oder zu senden.

### Kopfzeilen

The headers area is where the information regarding where the message is being sent to and from, as well as comments and keywords can be entered. All of the available headers are not shown by default, but they can be turned on and off very quickly using the menu.

Von

  `Von` wird verwendet, um die Herkunft der Nachricht anzugeben. Balsa füllt dieses Feld automatisch, wenn Sie Ihren Namen und Ihre E-Mail-Adresse im Identitäten-Fenster eingegeben haben

Nach

  The `To` header is used to indicate the intended recipient of the message; Balsa automatically fills this in for you if you are replying to a message.

Betreff

  Die Kopfzeile `Betreff` stellt eine Zusammenfassung des Themas oder Anliegens der Nachricht dar.

Kopie

  The "Carbon Copy" header. A comma separated list of recipients other than the main recipient should go here.

Blindkopie

  The `Bcc`, or "Blind Carbon Copy" header. Similar to the Cc header, except that email addresses placed in this header will not appear as recipients to readers of the message. Also known as a "silent" carbon copy.

Durchschlag in

  The `Fcc` header stands for "Folder Carbon Copy", and it is used to specify any folders that you want the message copied to after being sent. It is presented as a drop-down combo box with a list of all available mailboxes, simply select the destination.

Antwort an

  The `Reply-To` header is for specifying what email address you want any replies to go to.

Kommentare

  Although not widely used, the `Comments` header can be used to specify short comments for email's.

Schlüsselwörter

  Again, not a very widely used header, this can be used to embed general information about the content of the message in the email, to allow for easier searching or filtering at a later date.

#### Specifying Addresses

Balsa supports many different methods of selecting email addresss. All of the headers that can contain addresses have a small colored book to the right of them that will open up Balsa's address book.

However, Balsa will also attempt to guess what the headers should contain depending on what context the composition window is opened in, so it may not be neccessary to fill them in most of the time.

Also, Balsa supports alias expansion. As you type a name, Balsa will guess the e-mail address from all the entries in the GnomeCard application. To enable this feature, read the section on Alias Expansion. In addtion, the composition window supports drag-and-drop of addresses from the GnomeCard application.

### Anlagen

#### Liste der Anlagen

Below the headers may be a large box displaying a list of attachments; this view can be toggled in the Show menu.

When there are attachments displayed, it is possible to right-click on one of them to access an option menu. Inline and Attachment are mutually exclusive options that will display to the recipient either the attachment inline with the rest of the message, or separately as an attachment. Selecting Reference will send a MIME external part reference (a kind of link) in lieu of the actual file. Remove, and any available Open with options are also available.

### Nachrichtenrumpf

Finally, below the attachment list is the main area of the window where the text of the message is displayed. The text editing capabilities are very basic, but it supports cut, copy, and paste so it is possible to write a message in your favorite editor and simply paste it in.

If the message is a reply or forward, the referenced message will be displayed in the body text widget, with the prefix specified in the Preferences dialog.

### Rechtschreibprüfung

Once the spell check has been started, it will take a moment to load the text and spell checking module, and then it will automatically begin checking the message. If it finds any words that are incorrect, the word will be highlighted and a panel will be shown that offers a number of suggestions and available courses of action.

#### Spell Checking Panel

As shown above, the panel consists of a list of two panes, one the left containing a list of suggestions and an entry box, while the right contains several buttons to choose your action. The list on the left is re-generated for each incorrect word, with all the suggestions the spell check program comes up with. You can choose what program you want to use through loadable modules, selectable in the Preferences dialog. The entry box above the list is what will be used to replace the current word, and usually reflects the current selection in the list, but can be edited by hand if you wish to make manual changes.

The buttons on the left control the actions to take for each incorrect word. The buttons include:

Ändern

  Change the incorrect word with the currently selected suggested word or the user's edited word.

Change All

  Change all occurances of the current incorrect word with the currently selected suggestion.

Ignorieren

  Ignore the current incorrect word and continue to the next one.

Alle ignorieren

  Ignore all occurrances of the current word, and continue to the next incorrect word.

Lernen

  Add the current incorrect word to your personal dictionary. This will cause it to be considered correct for all future spell checks.

Fertig

  Stop the spell check at the current point, keeping all changes so far and returning to the normal message window interface.

Abbrechen

  Stop the spell check at the current point, reverting all changes so far, including any words added to your personal dictionary.

### Adressbuch

When composing a message, clicking on any of the colored book icons next to a destination field (To, Cc, Bcc) will bring up the Balsa address book. It helps you to select recipients for your messages quickly and easily.

#### Adressbuch-Fenster

The address book provides two panes, the one on the left consisting of all available addresses, while the one on the right contains the intended recipients of your message. Addresses are added to the recipient list by selecting them in the left pane and clicking the arrow button pointing to the right, or by simply double-clicking on the address. This will remove the address from the left pane, so they cannot be added more than once. If you decide that you no longer want to send the message to a particular address, simply select it in the right-hand pane and click the left-arrow button, or double-click it again, to move it back.

If, while selecting people to send your message to, you decide to add someone new to the address book, it is a simple matter to click on the Run GnomeCard button. This will bring up the GnomeCard application, allowing you to easily manipulate your contact list. After any changes have been made using the address book, they can be forced to show up in the left hand pane by clicking on the Re-Import button.

## Das Nachrichtenfenster

In addition to the preview pane, Balsa can display messages in separate windows. Simply double-click on the desired message from the message index in the main window, or select the message and press the space bar. Any number of windows may be opened, although only one per unique message.

The message window has a menu and toolbar containing commands pertinent to an individual message. Commands are as described in the main window. Below the menu and toolbar are the message headers in a box, followed by the message body.

### Das Nachrichtenfenster

If your copy of Balsa has cryptographic support, there will be an icon in the header box depicting an envelope with a lock and a check mark. Clicking the icon will check the key used to sign the message. The message body will contain an icon and some descriptive text noting whether the signing key is valid, invalid, or unchecked.

If the message contains attachments or more than one part of any kind, an attachment icon will be present in the header box as shown below. Clicking this icon will show a menu of all available parts. Selecting a part will update the display of the message body accordingly.

### Selecting a Message Part

The complete message selection will do its best to render all parts at once, but some may have to be selected individually or opened in an external program. Parts which cannot be rendered within Balsa will instead display a list of options for opening external programs or saving the data. Right-clicking on a part will also provide a menu with these options.

Navigation between messages is possible without returning to the index in the main window. Next unread being quite useful for checking all new mail. Deleting the current message will automatically display the next unread one. This behavior can be changed in the preferences.

## Das Einstellungsfenster

Balsa has many more options than the initial Druid reveals. To access the Preferences window, select Settings Preferences . In the Preferences window, options are organized into groups, and related groups are shown on individual pages. The pages and groups are explained below.

## Mailserver

This page lets you specify how you get POP3 mail, send mail, etc.

Entfernte Postfachserver

  These are IMAP and POP3 servers that you receive email from. The three buttons let you create, modify, and remove records. POP3 mailboxes will not show up in the mailbox list. You can specify multiple servers, when adding a server you will be asked to give:

  - mailbox name that will identify the mailbox

  - Der Server, auf dem sich Ihr POP-Postfach befindet.

  - The port that will be used to connect to the server. The port number is usually 110 but you may change it if you for example use some kind of connection tunneling,

  - Der Benutzername auf dem Postfachserver.

  - Das zugehörige Passwort.

  - You can select the 'delete from server' button to remove the downoladed messages from the server.

  - Sie können wählen, dass Ihre Nachrichten mit procmail gefiltert werden sollen.

  - Der procmail-Befehl.

  - Whether to check for new mail.

Lokaler E-Mail-Ordner

  Dies ist der Ordner, den Balsa nach Mailordnern durchsucht.

Server für ausgehende E-Mails

  Die meisten Benutzer werden nur einen Server für ausgehende Nachrichten benötigen, aber vielleicht möchten Sie auch mehrere verwenden? Balsa ermöglicht Ihnen, so viele zu verwenden wie Sie wollen. Der für eine bestimmte Nachricht verwendete Server wird durch die Identität bestimmt, welche Sie für die Nachricht ausgewählt haben.

  To view or change the details of a server, select it and click Modify. To create a new server, click Add. A dialog will open, showing the properties of the selected server. Specify the domain name and optionally the port for of the SMTP server you use for submitting mail. Please note that the default port number is 587. The syntax is hostname[:port]. Port can be a decimal number or the name of the service as specified in `/etc/services`. Typically you can just set this to localhost:smtp. Balsa can also break up a large message into fragments, which can be reassembled by Balsa or any RFC 2046-compliant mailer. This dialog allows you to set this option, and the size above which a message should be split.

  Sie werden um folgende Eingaben gebeten:

  - Ein aussagekräftger Name, der den Server identifiziert

  - The domain name and port

  - The user name on the SMTP server. If the remote SMTP server requires authentication, enter your user name here. Note that the exact format depends on the MTA in use. For example, some systems expect a user name, others may require an email address.

  - Corresponding pass phrase. If the remote SMTP server requires authentication, enter your pass phrase here. Some systems refer to the pass phrase as a password. Limitations on the length of the pass phrase depend on the SMTP server.

  - When you want Balsa to use TLS.

  - Das Kennwort des TLS-Zertifikats.

  - Whether to split large messages, and the threshhold size.

## Incoming and Outgoing Mail

Auf dieser Seite können Sie das Verhalten von Balsa bezüglich eingehender und ausgehender Nachrichten anpassen.

### Eingang

Automatisch nach neuen Nachrichten sehen

  If selected, Balsa will connect to your POP3 servers at the given interval and check for mail.

IMAP-Postfächer überprüfen

  If selected, Balsa will include your IMAP mailboxes when checking for mail. You can also specify that INBOX is the only mailbox to be checked.

  Checking IMAP mailboxes can take some time; these options give you extra control over how long the mailbox check will take.

Nachricht anzeigen, wenn neue E-Mail eingetroffen ist

  Wenn dies ausgewählt ist, benachrichtigt Sie Balsa, wenn neue Post eingegangen ist.

Do background check quietly

  If selected, Balsa will give you no indication that a background mail check is in progress.

Wrap Incoming Text

  If selected, Balsa will wrap text of incoming messages at the specified line length.

Reflow messages of type `text/plain;format=flowed'

  The `format' parameter distinguishes two ways of representing paragraphs in messages of type `text/plain' (that is, simple text). The value `flowed' indicates that paragraphs have been broken into lines ended with `soft' line breaks: a space is left at the end of the line. A `hard' line break (one that is not preceded by a space) indicates the end of a paragraph.

  Balsa can reflow the paragraphs, quoted or otherwise, in a message of this type. Reflowing eliminates the line fragments that are left when text is first wrapped at one length and then rewrapped to a shorter length, which are often misquoted.

  The only other value of `format' is `fixed', which is the value assumed by default when `format' is not specified, as with older mailers. In this case, all line breaks must be respected. If you do not select the `Reflow...' option, Balsa will treat all messages of type `text/plain' as if they were `format=fixed'. Long lines will still be wrapped, if the `Wrap Incoming Messages' option is selected, but this will usually leave unquoted line fragments.

Bitte um Empfangsbestätigung

  You will sometimes receive a message whose sender has asked for notification that you have received or seen the message. You can specify how Balsa responds to these requests.

### Ausgehend

Wrap Outgoing Text

  Have Balsa wrap all outgoing mail at the specified column.

Send message as type `text/plain; format=flowed'

  The `format' parameter distinguishes two ways of representing paragraphs in messages of type `text/plain' (that is, simple text). The value `flowed' indicates that paragraphs have been broken into lines ended with `soft' line breaks: a space is left at the end of the line. A `hard' line break (one that is not preceded by a space) indicates the end of a paragraph.

  Balsa can prepare the message using this convention, and a flowed-aware mailer receiving it can then reflow its paragraphs to fit its display without leaving misquoted line fragments. If you do not select this option, Balsa will use hard line breaks to end lines, and no receiving mailer will be able to identify paragraphs.

Antwortpräfix

  The string that Balsa should use as a prefix when quoting a message. Note: if you select `Send message as type text/plain; format=flowed', Balsa is required to use the one-character string ">".

Automatically quote original when replying

  Have Balsa include the text of a message in the reply. The text will be prefixed as shown above.

  You can instead include the original message using an option on the `Edit' menu, or by dragging the message from the message index into the text area of the reply. If you prefer to include text this way, do not select the `Automatically quote...' option.

Don't include HTML parts as text when replying or forwarding mail

  Tell Balsa to be sensible.

Forward a mail as attachment instead of quoting it

  If this option is selected, messages that are `Automatically quoted' will actually be attached unmodified, instead of included in the text of the reply, prefixed by the reply string.

  You can also attach any message to a new message by dragging it from the message index into the attachment area of the new message (or, in fact, any part of the new message window except the text area or the address lines).

Send button always queues outgoing mail in outbox

  This option gives you control over when Balsa connects to a server to send messages.

Ausgehende Nachrichten in den Verschickt-Ordner kopieren

  Have Balsa save a copy of each message you send in the mailbox marked as the `Sentbox'.

Kodierung

  Set the character encoding method to either 7 bit, 8 bit, or what the quoted message is using.

## Einstellungen für die Anzeige

This page controls how Balsa appears to you.

### Hauptfenster

Vorschaufeld anzeigen

  Set whether to use the preview pane to display messages, or rely on the separate mail viewing window.

Show Mailbox Info

  This will allow the number of total and unread messages for each mailbox to be shown in the left pane of the Balsa main window. You can save space by not showing them; if you choose not to show them, Balsa will then show the number of unread messages (in parentheses) after the mailbox name.

Alternatives Layout

  Balsa's default layout has a full-height mailbox list on the left, and the message list above the preview pane on the right. You can choose an alternative layout, in which the mailbox list and the message list occupy the upper part of the window, and the preview pane is full-width below them.

Automatic View

  Select this option if you want Balsa to open the first unread message when you open a mailbox. If no message is unread, Balsa opens the most recent message.

Page Up and Page Down

  By default, the Page Up and Page Down keys scroll the message by whole pages. Use this option to choose a different amount.

### Das Nachrichtenfenster

Moving a Message

  If you are reading a message in its own message window and you move it (to the trash, or another mailbox), Balsa can move on the next unread message or the next message in the same mailbox, or simply close the window.

### Sort and Thread

Default sort column

  Choose the column by which you would like a new mailbox to be sorted.

Default threading style

  Choose the default threading style for a new mailbox.

Expand threads

  If you choose a threaded view of a mailbox, you can decide whether the threads should be expanded or collapsed when the mailbox is opened.

### Nachricht

Schriftarten

  Choose the fonts that you want to be used to display a message. You can choose a distinct font for the message's subject line.

Regulärer Ausdruck, auf den zitierter Text passt

  The entry box allows you to set a regular expression you would like to use to identify text that should be considered quoted for incoming messages. The regular expression should match the beginning of line of quoted text a single level deep, the program will then use this to calculate the depth of quoting and alter the quoted text colors appropriately. A default regexp is provided that should work in most situations.

  This regexp affects both highlighting and spell checking, and uses the extended regular expression set. For more information see the `grep`(1) manual or info page.

Alternative Parts

  You can choose whether Balsa should show a text/plain part or a text/html part, when a message contains both.

### Farben

Message Colors

  Choose the colors for quoted text.

Link-Farbe

  Balsa verwendet diese Farbe, um einen Hyperlink in einer Nachricht hervorzuheben.

Editor-Fenster

  When you are composing a message, Balsa uses color to show when one of the address fields is incomplete. Choose that color here.

### Format

Date Encoding

  Set the format used to display dates in Balsa. This uses the same format string as `strftime`, a summary which is provided below:

  - `%a` -- The abbreviated weekday name.

  - `%A` -- Der volle Name des Wochentags.

  - `%b` -- The abbreviated month name.

  - `%B` -- Der volle Name des Monats.

  - `%d` -- Der Tag des Monats.

  - `%R` -- The time using a 24-hour clock. (HH:MM)

  - `%r` -- The time using a 12-hour clock (HH:MM AM/PM).

  - `%T` -- The time using a 24-hour clock, with seconds (HH:MM:SS).

  See the `strftime` manual page for a full listing of conversion specifiers.

Ausgewählte Kopfzeilen

  A space-separated list of the headers to display in the message window.

Fallback codeset

  Some messages contain national characters without specifying how they are encoded. You can choose whether Balsa displays such characters as '?', or tries a specific character set to display such messages.

### Statusmeldungen

Informationsmeldungen

  Balsa gives you information in the form of five different levels of messages. You can specify how you want all five levels to be presented to you.

Fortschrittsdialog anzeigen

  This sets the behaviour of the dialog that is shown when Balsa retrieves messages from it's specified POP3 servers. The dialog can be shown only while the messages are being retrieved, automatically closing after Balsa is finished. Or it can be set to stay active until manually closed. Finally, the dialog can not be displayed at all.

## Rechtschreibung:

If Balsa is using GtkSpell, you can choose to have your spelling checked as you type. Balsa uses GtkSpell's default settings.

If Balsa is not using GtkSpell, you can use this pane to setup Balsa spell check options. Balsa uses the Portable Spell Checking library (pspell) to provide an interface to the spell checking program of your choice. Currently there are modules for ispell or aspell, both of which can be found at the pspell website. For more information visit the Balsa homepage.

Pspell Module

  The Pspell library allows you to use whatever spell checking engine you prefer, though the use of loadable modules. Currently Pspell has support for two modules, the traditional ispell, and the newer and more advanced aspell.

  Ispell is most likely available on your system as it is a Unix standard; however Aspell is more advanced as it uses an advanced phonetics engine and adaptive techniques to learn how you tend to misspell words. More information is available at the Aspell website.

  Balsa will attempt to use whatever module you specify here, however if the module is not installed it will not work and generate an error.

Vorschlagmodus

  The suggestion mode determines how hard the computer will search for suggestions for misspelled words. There are three options:

  Schnell

    This mode quickly scans for replacements, which means it might be used by a good speller who occasionally makes typographical errors.

  Normal

    The Normal mode is probably good enough for most people; it should produce the correct suggestion in the majority of cases.

  Bad Spellers

    The Bad Spellers mode is the most thorough and accurate mode; however, it also takes the longest to find a list of suggestions.

Ignore Length

  This provides the ability to ignore words shorter than a certain length. It may be useful to automatically skip short acronyms that are normally flagged as incorrect.

## Adressbücher

Balsa supports the use of multiple address books, both local VCARD and remote LDAP address books, both of which can be configured here. GnomeCard also uses VCARD address books, so this allows Balsa to share address books with other GNOME applications.

The main portion of the preferences page is occupied by the list of current address books for Balsa. The list shows the type of address book, the name, and whether it is included in automatic alias expansion when typing new messages. There are also several buttons that manipulate the list of address books:

Hinzufügen

  Using this adds a new address book for Balsa to use to find addresses. It brings up a series of dialog boxes that step through the process of adding a new address book.

  ### Add Address Book Dialog (Step 1)

  If Balsa was not compiled with LDAP support it will not let you choose LDAP as an addressbook type. Once the type of address book is selected you must specify the name and location of the address book.

  ### VCARD-Adressbuch-Dialog (Schritt 2)

  With LDAP support, the dialog looks somewhat different, offering options to set the location of the directory instead of a file.

  ### LDAP Address Book Dialog (Step 2)

  In order to use a LDAP address book, you need to know the host name of the LDAP server. Depending on the server configuration, you may need also so called Base Domain Name which identifies your particular department. You can always try leaving Base Domain Name field empty and a default value will be used (OpenLDAP stores the default Base Domain Name in `/etc/openldap/ldap.conf`). If this does not work, you may need to ask your administrator for the value of this. The usual values are usually similar to: dc=theochem,dc=KTH,dc=se or o=Theoretical Chemistry, c=SE.

Ändern

  Dies ermöglicht Ihnen die Anpassung der Eigenschaften des ausgewählten Adressbuchs.

  ### Bearbeiten eines Adressbuchs

  Für jedes Adressbuch können Sie sowohl den Namen als auch den Speicherort ändern. Außerdem können Sie festlegen, ob der Inhalt des Adressbuchs beim Auto-Vervollständigen von Adressen verwendet werden soll, wenn Sie eine Nachricht senden.

Löschen

  Delete the selected address book.

Zur Vorgabe machen

  Setzt das ausgewählte Adressbuch als Standard.

## Programmstart

Beim Start Eingang öffnen

  If set, Balsa will open your system inbox upon startup.

Beim Start auf neue Mail prüfen

  If set, Balsa will automatically attempt to download mail from the POP3 mail server upon startup, and will check for new mail on an IMAP server.

Geöffnete Postfächer während den Sitzungen merken

  When marked, Balsa will remember and reopen mailboxes that were open when Balsa was last quit.

Folder Scanning

  Scanning a folder tree can be time-consuming, because of the need to explore an entire tree of subfolders. You can defer scanning the tree by setting the scan depth to 1. Balsa will then descend into the tree only far enough to discover whether any folders that you can see have subfolders. The first time you expand any subtree, Balsa will explore more of the tree.

  Falls Sie es bevorzugen, den gesamten Baum sofort beim Start verfügbar zu haben, wählen Sie eine Tiefe, die der Tiefe Ihres Ordnerbaums entspricht. Die Angabe von Zwischenwerten ist hier ebenfalls möglich.

  You may set the depth for initial scanning separately for local and IMAP trees.

## Miscellaneous

Fehlerdiagnose

  Toggle the output of debugging information. Depending on what notification priority set for it in the Display page, it can show up in list or dialog as the program runs.

Müllordner beim Beenden leeren

  Set Balsa to delete all messages in the Trash mailbox when Balsa exits.

Automatically close mailbox

  Set Balsa to close any mailbox that is unused for more than the specified time. The currently displayed mailbox is never automatically closed.

Als gelöscht markierte Nachrichten verbergen

  When a message is moved to another mailbox, including the Trash mailbox, it is actually copied to the destination, and the original is marked as deleted. Deleted messages may either be shown in the mailbox index, with the trashcan icon indicating that they are deleted, or hidden. This item controls which of those actions is taken.

  A message may also be simply marked as deleted, without copying it to another mailbox: Message Toggle flag Deleted . Again, this item controls whether such a message is hidden.

Als gelöscht markierte Nachrichten endgültig entfernen, wenn Postfach geschlossen wird

  Expunging is the act of physically removing from the backing mailstore all messages marked as deleted. You can expunge messages manually: Mailbox Expunge deleted messages , or you can set Balsa to expunge deleted messages when the mailbox is closed (all mailboxes are closed when you exit Balsa).

## Anpassen der Werkzeugleisten

Balsa allows you to change the layout of the toolbars on the three main types of window: the main window, message windows, and compose windows. You open the dialog with the Settings Toolbars... menu item.

The dialog contains a notebook with a page for each type of window. On each page, you'll see a Preview of the toolbar, which changes as you change the layout. The list of Available buttons shows buttons that may be used on the toolbar, but aren't currently used, and the Current toolbar list shows the current layout, including both buttons and separators. You can add buttons to the current toolbar, remove them, or move them up or down in the list, using the controls in the central button box.

Below the notebook is a checkbox for wrapping the button labels (the text that may accompany the buttons). This option applies to the toolbars on all three types of window. If you choose wrapping, long labels will be shown on two lines.

This is an instant apply dialog: the changes you make take effect immediately, as shown in the Preview toolbar. Below the Preview toolbar you'll find a button that restores the standard layout for that toolbar. Note that the standard layout is the one that you see before the toolbar has been customized. If you use this option, all current and past changes will be undone.

A second button below the Preview toolbar pops up a menu that gives you control over what is shown in the toolbar: icons, text, or both. The popup (right click) menu for any actual toolbar offers the same choices, as well as the option to open up this dialog (Customize Toolbars...).

## IMAP Folder configuration

The folder configuration edit dialog allows you to configure entire mailbox sets on remote IMAP servers. Entire configuration is split into basic and advanced parts.

### Basic IMAP folder configuration

Die grundlegende Konfiguration des IMAP-Ordners ist möglicherweise der einzige Teil, den Sie ausfüllen müssen.

- Descriptive name is the name of the root node that will be shown in the mailbox tree on the left side.

- Server is the host name or IP number of the IMAP server.

- User name is the name used for authorization on the IMAP server.

- Einige Server ermöglichen den anonymen Zugang zu »Schwarzen Brettern« oder Mailinglisten-Archiven. Aktivieren Sie dieses Kontrollkästchen - Sie werden nicht nach einem Passwort gefragt.

- Password is the password used for authorization on the IMAP server.

- Check box allows you to choose all mailboxes on the server, or only those you subscribed to.

- Prefix is the root mailbox on the server. You may leave it empty if you want to show all the folders on your server but if your IMAP server stores also other kind of files you may specify for instance "mail".

### Advanced IMAP folder configuration

Sometimes, it is necessary to tune the folder configuration in order to assure a secure connection, adjust to server limits or just obtain better performance. This functionality is provided by the Advanced IMAP folder configuration tab.

- The Use SSL check box should be active if the connection is to be made to IMAPS service on port 993. Connection to this port will be encrypted from the start. Not all servers provide this service - many provide only negotiated TLS encryption.

- The Use TLS option list determines instruct balsa how to negotiate the TLS encryption. Balsa can never attempt to negotiate it, can start TLS encryption whenever it is supported by server, or can abort the connection if TLS is inavailable or fails for some reason.

- Max. number of connections limits the number of concurrent connections open to the IMAP server. A number around 15-40 is a sane option as it avoids time-consuming and load-creating reselections of imap mailboxes. Some IMAP servers -- notably Courier -- limit the number of connections open from single IP number to 4 by default. The limit in balsa has to be in such a case adjusted accordingly.

- The Enable persistent cache check box chooses whether Balsa should try to store downloaded messages between sessions or throw them away when it is closed. The optimal choice depends on the local configuration. If the connection to the IMAP server is slow and local storage in the home directory fast and cheap, it is recommended to enable persistent message cache. If the home directory is slow (eg. NFS-mounted) and the connection to the imap server - fast, persistent cache becomes just a burden and should be disabled.

- The Use IDLE command check box chooses whether Balsa should try to use IDLE command when available. With this command, some servers notify immediately when a new command arrives. Also, this command may reduce the amount of network traffic. There are some downsides, too: some firewalls do not track IMAP connections correctly and will incorrectly interrupt a session in an IDLE state. In particular, home-grade network routers with NAT translation have notoriously this bug. In such case, it may be safer to disable this command.

- The Enable bug workarounds check box makes Balsa work even with IMAP server that cannot fail to provide selected message parts. Balsa in such a case will try to fetch entire messages instead.

- The Use STATUS for mailbox checking check box enables a more thorough but potentially more expensive way of checking mailboxes on IMAP server. This method can be consume many resources on the server and should be used only on IMAP servers that have optimized STATUS command.

### IMAP Subfolder Properties

The subfolder properties dialog allows you to manage folders on remote IMAP servers. Specifically, you can create a new subfolder, rename an existing subfolder, or move a subfolder within the folder tree.

- Folder name is how the folder is shown in the mailbox tree on the left side.

- Subfolder of indicates the immediate parent of the folder.

When the dialog is opened from File New Remote IMAP subfolder , you can enter the folder name and browse IMAP trees to find the parent folder. If you had already selected a mailbox in an IMAP tree, only that tree is shown for browsing; otherwise, all IMAP trees will be shown.

When the dialog is opened from Mailbox Edit with an IMAP folder selected, or by right-clicking on an IMAP mailbox and selecting Properties..., the mailbox may be:

- Renamed, by editing the folder name;

- Moved, by browsing for a different parent folder in the same tree.

## Adressbuch-Einstellungen

Dies ist auszufüllen.

### Adressbuch-Typ

Sie können zwischen verschiedenen Adressbuchtypen wählen.

### Externes Adressbuch

The balsa addressbook supports input from programs. Thus, you can use (no importing needed!) for example your pine or mutt addressbook. The mutt mailer (www.mutt.org) uses an identical system to retrieve addresses from programs.

#### Existing programs

The following programs are compatible with the mutt mail reader and /should/ be with balsa. Submit links to more programs.

- http://www.spinnaker.de/lbdb/ - The little brother database. Read emailaddresses and names from: finger, /etc/passwd, incoming procmail email, NIS, fido, the abook program, mutt addressbook, pine addressbook, palm addressbook, gnomecard addressbook, big brother database, ldap database.

- http://www.fiction.net/blong/programs/mutt/ - palm address database, ldapsearch wrapper, ph/qi server, UIUC, ph,

#### Schreiben eigener Ladeskripte

Balsa ignores the first line of output from your program. You might want to write comments or debug output on this line. The remaining lines should have this format:

`e-mail address full name nickname`

Die drei Felder sollten mittels Tabulatoren voneinander getrennt werden. Das dritte Feld wird gegenwärtig von Balsa nicht benutzt, jedoch möglicherweise in Zukunft. Es stellt allerdings die Kompatibilität zu Mutt sicher.

Balsa führt Ihr Skript mit einem Argument aus: dem Suchmuster. Ein Leerzeichen » « wird als erstes Argument verwendet, wenn eine Liste aller Benutzer erstellt wird.

Alle Zeichen sind erlaubt, mit Ausnahme des Tabulators (\t), weil dieses Zeichen die Felder voneinander trennt.

Eine Ausgabe könnte zum Beispiel lauten:

`lbdbq: 3 matches`

`balsa-list@gnome.org Balsa List balsa-list`

`jelmer@nl.linux.org Jelmer Vernooij jelmer`

`balsa-maintainer@theochem.kth.se Pawel Salek balsa-maintainer`

Your script/program should write it's output to stdout and not to stderr!

#### Schreiben eigener Speicherskripte

Adding addresses is also possible. Your script should receive 3 arguments. The first is an email address, the second a full name and the third is an alias (currently not used and replaced by 'TODO').

Beachten Sie, dass Mutt das Hinzufügen von Adressen nicht unterstützt und daher in diesem Fall keine Kompatibilität besteht.

Kommentare sind willkommen: jelmer@nl.linux.org

## Identitäten

This dialog window lets you specify how you present yourself to the rest of the world through your email. The first page has your general information:

I

  A unique title by which this identity will be named within Balsa.

Vollständiger Name

  This doesn't have to be your name, I guess. But it's the word prefixing your email address in mail you send.

E-Mail-Adresse

  As you wish it to appear in your "From" header.

Antwortadresse

  The address that you wish people to reply to your email with (if you have a home and a work address, for instance).

Standard-Domäne

  The domain that you wish to append to all e-mail entries where you did not specify the domain. Normally you would use your local domain. You need to enable Alias Expansion for this to work.

The Messages page shows various initial settings for the new message:

Blindkopie

  The default value for the blind-carbon-copy field when using this identity. Useful if you want to always send a copy of outgoing mail to another account.

Antwortzeichenkette

  The prefix for the subject line when replying to a message.

Weiterleitungs-Zeichenkette

  The prefix for the subject line when forwarding a message.

Bitte um Empfangsbestätigung

  Whether Message Disposition Notification should be requested by default.

Face Path

  Whether a "Face" header should be attached to a program. Specified path points out to a file containing a textual representation of the face icon. Please see a description of Face and X-Face headers for more details as well as the list of mail programs supporting this feature.

X-Face Path

  Whether a "Face" header should be attached to a program. Specified path points out to a file containing a textual representation of the face icon.

SMTP-Server

  The SMTP server to be used for this identity.

You control the signature that Balsa appends to your messages on the Signature page:

Pfad zur Signatur

  Die Datei mit der Signatur, welche an alle Ihre Nachrichten angehängt wird. Diese kann auf eine dieser drei Arten erstellt werden:

  - Aus einer gewöhnlichen Datei. Geben Sie den Pfad zu einer Datei ein, und der Text dieser Datei wird an Ihre Nachrichten angehängt.

  - A named pipe or FIFO. In this case, to Balsa, the file looks normal, but in reality, it is a pipe to a program that is generating the content. List the path to the pipe.

  - An executable program. Balsa will execute the program and read its output, appending that text to the message. List the path to the program with a | prepended to it. For example:

    |/home/user/dynsig.pl

Signatur ausführen

  Execute the instructions in the signature file and use the results as the signature to append to outgoing mail. Select this when generating the signature from an executable program as outlined above in Signature Path.

Signatur _einfügen

  Fügt die Signatur am Ende jeder ausgehenden Nachricht hinzu.

Signatur beim Weiterleiten einfügen

  Fügt die Signatur hinzu, wenn Sie eine bestehende Nachricht weiterleiten.

Signatur beim Antworten einfügen

  Fügt die Signatur hinzu, wenn Sie auf eine bestehende Nachricht antworten.

Signatur-Trennstrich einfügen

  When checked, this has Balsa insert the standard signature separator before your signature.

Signatur voranstellen

  Add the signature before the message text, rather than after it.

Die Sicherheitseinstellungen befinden sich im vierten Reiter:

Ausgehende Nachrichten per Vorgabe signieren.

  By default enable the cryptographic signature for every new message. The default protocol is determined by the Default protocol option.

Ausgehende Nachrichten per Vorgabe verschlüsseln.

  By default encrypt every new message. The default protocol is determined by the Default protocol option.

Voreingestelltes Protokoll.

  Choose the default protocol for the cryptographic signature and message encryption.

GnuPG-Schlüsseln immer vertrauen, wenn diese verschlüsselt sind

  Do not ask for confirmation when encrypting for a recipient whose GnuPG key is not fully trusted.

Erinnern, wenn Nachrichten verschlüsselt werden können

  Before sending a message, check if valid keys are present for all recipients and show a dialog in this case.

Use secret key with this id for signing.

  Usually, Balsa automaticylly selects a proper secret key for cryptographic signatures from the identity's mail address. Therefore, most users should leave this entry empty. If you want to force using a specific secret key for cryptographic signatures, enter the key id here. You can get the key id by running the command 'gpg --list-secret-keys'.

These security options are available only if Balsa is built with GnuPG support.

## The Search Mailbox Window

You can search a mailbox to find and display messages that contain a given string in the To, From, Subject, or Cc headers, or in the message body. This window allows you to specify the string for which you want to search and where Balsa should look.

Sie können die Übereinstimmungen enthaltenden Nachrichten auf zwei Arten anzeigen lassen:

Nur zutreffende Nachrichten anzeigen

  If you click the Apply button, the mailbox view will be filtered to show only the messages that match the conditions. If you click the Clear button, the filter will be cleared, and the mailbox view will be restored to show all messages. You can also use Mailbox Reset Filter to restore the view.

Nächste zutreffende Nachricht öffnen

  Alternatively, you can step through the matching messages, either forward or in reverse, and optionally wrapping the search when it reaches the end of the mailbox. Click the OK button to view the first matching message after (or before) the current message. Then you can use CtrlG Edit Find Next to step through the matching messages.

## Das Filter-Fenster

This window is divided in two parts: the left part is the list of all filters. When you select one of them, the right part displays its properties. The right part is a two-page notebook (the match page, and the action page); their descriptions follow.

There are two buttons under the filters list:

- The New button: you click on it to create a new filter; the filter is initially named "New Filter", and contains no condition. Then you fill in the different fields in the notebook pages (in particular remember to change the name of the filter), add the conditions that will describe how this filters matches a message, and to confirm the modifications push the Apply button on the right hand side of the Filters window.

- The Remove button: removes the currently selected filter.

### The match page

Each filter is made of one or several conditions; each condition represents a test to be applied to the messages. The results of these tests is then combined following the type of operation specified:

- AND: all condition tests must be true to make the match.

- OR: one condition test must be true to make the match.

Then the page displays the name of the filter and the conditions that describes how the filters matches a message. The list displays the type of the conditions (the conditions will be described later):

- Simple: the match is done by a simple substring test.

- Regular expression: the match uses regular expressions on the message headers.

- Date interval: the match is done by checking if the date of the message is within certain bounds.

- Flag condition: the match is done by checking the flags of the message: unread, replied, deleted, flagged.

The three buttons under the list allows you to edit the selected condition, add a new one, or remove one. Editing or creating a condition is done in the condition window, which pops up when you click on the Edit or the New button.

The two buttons under the notebook at the right hand side of the window lets you manipulate the currently selected filter. The Apply button is used to confirm the modifications you have made on any field. If you make changes and select another filter without first clicking on the Apply button, all your changes will be lost.

The Revert button cancels all previous changes: the current filter is reverted to its state just before the last click on the Apply button.

### The action page

This page describes the actions to take in case the filter matches. First you specify the notification to inform you that the one or several messages has matched the filter in the Notification frame. Then in the Action frame you tell what to do with the matching messages. You can ask Balsa to copy or move them to any mailbox, or to send them to the trash can. The other actions are not yet implemented.

### D

This window is used to edit an existing condition or to create a new one. It displays all the information needed to describe the condition, it is launched when you click on the Edit or New buttons under the conditions list in the match page of the notebook in the right part of the filters window.

Dieses Fenster besteht aus drei Teilfenstern:

- The Match in frame: it's a set of check boxes, one per match field. For example if you want to match all messages that was sent by hotmail users, you just have to check the From box, or if you want to match all messages about Balsa, check the Subject box.

  Be careful with Body match, this can take time for large messages.

  For advanced use you can also specify directly the name of the header to match on. A standard example the "X-Mailer" is a header added to your message by the MUAs with their name and versions.

  The All button will check all boxes, whereas the Clear button will uncheck all boxes (as you might have guessed).

  If you specify several headers, a message will match this condition if one of the header matches. For example if you want to filter all messages talking about Balsa, you should check the Body and the Subject boxes, so that all mails with the word Balsa in its subject or its body will match. You can also, if you're fed up with Balsa ;-), match all mails that does NOT contain the word Balsa in their subject and in their body neither. See the description of the search types to see how to do this.

- The Search Type frame: it's a list of the different condition types. You choose Simple, Regular expression, Date interval, or flag condition. Your choice will change the third frame so that it displays the fields needed by the type of match chosen.

- Dieser Teil ist von dem von Ihnen gewählten Suchtyp abhängig:

  - Simple type: a text entry lets you input the string to look for (case does not matter, the search is case-insensitive). The button lets you specify if a message matches when the string is or is NOT a substring of the specified headers, the sentence above the text entry will be updated accordingly.

  - Regular expression: you can input a list of regular expressions. You type your regular expression in the text entry, then you click on the Add button to put it into the list. Of course the Remove button destroys the selected regular expression in the list. The last button One matches/None matches lets you specify when a message matches the condition: when one of the regular expression matches or when none matches. The sentence above te list will be updated accordingly.

  - Date interval: you can input the interval by the mean of the two text entries. A blank entry means no bound. The button tells to match when the message date is within the bounds or not. The sentence above the text entries will be updated accordingly.

  - Flag condition: the four check boxes let you select which messages will match this condition. If you want to match all replied OR unread messages, check the corresponding boxes. The button let you specify that the match will be done when none of the specified flags are set, the sentence above the check boxes will be updated accordingly. For example if you want to filter all read and replied messages, check the unread and replied boxes, and click on the button.

## Das Filter-Fenster

This window is divided in two lists: the left one displays all available filters, and the right part displays all filters to be applied on the mailbox (the name of which is shown in the window title). See the filters window section to see how to set up filters.

The right list has three columns. The first one contains the filters name. The two others tells you if the filter will be automatically applied: e.g. if a dot is displayed in the second column (On reception), this tells you that whenever new messages arrived in this mailbox, they will be filtered by the corresponding filter (Note: the filter is applied only on the new messages, not the entire mailbox; this is similar to the use of procmail). In the same way, if a dot is displayed in the third column (On exit), the filter will be applied to the entire mailbox when you exit Balsa.

Note: the On exit feature is not yet implemented.

When you tell Balsa to apply several filters on the same mailbox (i.e. when you put several filters in the right list), only the first match counts: the filters are applied in the specified order and the first that matches on the current message will be applied but not the following ones.

Zwischen den Filterlisten befinden sich zwei Knöpfe:

- The Add button: moves the selected filters from the left list to the right one, adding more filters to be applied to the mailbox.

- The Remove button: removes the currently selected filter in the right list and puts it back in the left list.

The Up and Down buttons under the right list serve to reorder the filters that are to be applied. This is a sort of priority between filters, because if several filters could match the current message, only the first one will be applied. The Apply Now button applies all filters of the right list to the entire mailbox immediately (be patient, this can take a quite a long time on big mailboxes or remote ones).

You can also use this dialog to apply a filter to a mailbox without actually attaching it to the mailbox. Select one or more filters in the left hand list, and click the Apply Selected button below that list.

Unterhalb der Filterlisten befinden sich drei Knöpfe:

- The OK button: saves the list of filters associated to the mailbox. Note that this does not apply the filters to the mailbox. It is useful only when you have set up automatic filters, or when you have to manually apply a lot of filters frequently to this mailbox: the next time Balsa will reload the saved filters and you will only have to press the Apply button.

- The Cancel button: this discards any changes and closes the dialog box.

- The Help button: opens this help window.

## Verfügbare Postfachformate

Balsa unterstützt verschiedene Postfachformate, darunter mbox.

Weitere Informationen finden Sie in den folgenden Dokumenten:

- Benchmarking mbox versus maildir http://www.courier-mta.org/mbox-vs-maildir/

- Mailbox Format Characteristics http://www.washington.edu/imap/documentation/formats.txt.html

- maildir(5) manual page (from qmail) http://www.qmail.org/qmail-manual-html/man5/maildir.html

- Using maildir format http://cr.yp.to/proto/maildir.html

- mbox(5) manual page (from qmail) http://www.qmail.org/qmail-manual-html/man5/mbox.html

- Mailbox formats (from Mail-Administrator HOWTO) http://linuxdocs.org/HOWTOs/Mail-Administrator-HOWTO-3.html#ss3.5

## Einfache Aufgaben in Balsa

This section explains many of the things you might want to do with Balsa.

- Erstellen neuer Postfächer

- Verschieben von Nachrichten

- Making one of the main folders IMAP-based

- Expanding e-mail addresses automatically

- Konfigurieren von LDAP-Adressbüchern

### Erstellen neuer Postfächer

You can create new local and IMAP mailboxes by right-clicking in the mailbox list and selecting New Mailbox. This will start a dialog that will let you name the mailbox and specify its location.

To create a new POP3 mailbox, go to the configuration dialog, select the Mailboxes section, and click Add in the POP3 area. A dialog will be displayed that will let you set up the new mailbox.

Under Sawfish, this dialog has been known to become obscured, causing the appearance that Balsa has locked up. Move the configuration dialog and see if the new dialog was hidden.

### Verschieben von Nachrichten

There are several methods available for moving or copying messages from one mailbox to another. The first is via the Transfer context menu, and the second is using drag and drop.

To transfer messages using the Transfer menu, simply select the messages you desire to move from one mailbox, then bring up the context menu and select the Transfer submenu. This will display a list of mailboxes similar to the mailbox list in the main window. The list can be scrolled and trees expanded and collapsed, although these changes will not be reflected in the main list. Selecting a mailbox will start the transfer.

The other method of transferring messages is to simply drag and drop the message(s) from the message index to the desired destination. Select the message(s) you wish to transfer, then drag them using the mouse until they are over the intended mailbox. The destination can either be in the mailbox list in the main window, or if open mailbox tabs are enabled the messages can be dragged to them. Messages are copied by default, but holding down the Shift key when dropping the messages will move them instead.

### I want one of the main folders to be IMAP

First, create the IMAP folder as you want it configured. Then, press right mouse button on the mailbox entry and select Mark as Inbox. That is all!

### I want Balsa to guess my friends

Balsa can expand the names of your contacts it finds in Balsa addressbooks. It will do this by any part of the contact's name or email address.

As you type a username in any of the To:, Cc:, or Bcc: entry boxes in the Compose window, it will do a case insensitive search in the addressbook for a matching username, and pop up a list of matching complete addresses. Press Cursor-Down to highlight one of the addresses, and Enter to select it.

To enable this feature, you must select which address books you wish to be searched for aliases to expand. This can be done in the Preferences window, on the Address Books page. Also, some address books are expensive to lookup. You will need then to press Escape to explicitly expand the alias.

### Konfigurieren von LDAP-Adressbüchern

Only steps crucial for Balsa are described here. Some of the steps may be specific to OpenLDAP server. Whenever in doubt, consult the documentation provided with your LDAP server.

- Installieren Sie die LDAP-Serversoftware.

- Configure. In the case of OpenLDAP, edit `/etc/openldap/ldap.conf` and `/etc/openldap/slapd.conf`. Consult your LDAP configuration and other sources to choose the right Domain Name for your institution and authentication level apriopriate to your environment.

- Import data to your LDAP server. OpenLDAP comes with a set of migration tools but they do not create directly objects of standard `inetOrgPerson` class which is an apropriate type for address book entry. You may need to tune them.

Balsa searches for objects having mail attribute. The search is done on the cn attribute and the search filter has a form (&(mail=*)(cn=John D)). Balsa uses cn (common name), givenName (given name), sn (surname) and mail (e-mail address) attributes of the found objects.

## Es funktioniert nicht!!!

This is a FAQ for when Balsa appears to lock up, or other things that you think should be happening aren't. If you can't figure out how to do something but Balsa lets you do it, that's a bug. Report it.

- I want one of the main folders to be IMAP

- Balsa's frozen!

- Was ist das für ein Fenster, das auf dem Bildschirm blinkt?

- Das Adressbuch importiert meine Adressen nicht.

### I want a basic mailbox to use IMAP

See this section.

### Balsa ist eingefroren!

Odds are it isn't. Watch out for:

- If you don't have threading, Balsa will stop responding when it sends and receives email. Use threading, if possible.

- Balsa is downloading a new message or closing a large mailbox. This could take a while, especially when this file is accessed via NFS.

- A dialog box is being displayed but it is obscured by another one. This seems to happen under Sawfish. Try moving the windows around and see if there's a hidden dialog somewhere.

### Was ist das für ein Fenster, das auf dem Bildschirm blinkt?

Were you checking your mail? Probably. This is the window that displays progress for retrieving POP3 mail. If you don't have any POP3 accounts, it will still appear -- but it'll disappear almost instantly. You can disable displaying this window in preferences.

### Das Adressbuch importiert meine Adressen nicht.

Balsa versucht die Datei `~/.gnome/GnomeCard.gcrd` zu öffnen. Falls Sie diese nicht verwenden, müssen Sie eine symbolische Verknüpfung anlegen, so dass Balsa sie öffnen kann.

There have been slight changes in GnomeCard's file format between its various versions. Balsa is known to work with at least GnomeCard version 1.0.10 and probably most other releases.

## Autoren

Balsa wird gegenwärtig entwickelt von (in alphabetischer Reihenfolge):

- Carlos Morgado (chbm@chbm.nu)

- Pawel Salek (pawsa@theochem.kth.se)

In the past, numerous people contributed to balsa, including (in alphabetical order):

- Hector Garcia Alvarez (hector@scouts-es.org)

- Matthew Guenther (guentherm@asme.org)

- Bruno Pires Marinho (bapm@camoes.rnl.ist.utl.pt)

- Jay Painter (jpaint@gimp.org)

- Stuart Parmenter (pavlov@pavlov.net)

- David Pickens (dpickens@iaesthetic.com)

- Peter Williams (peter@newton.cx)

To find more information about it, please visit the Balsa Web page. Please send all comments, suggestions, and bug reports to the GNOME bug tracking database. Instructions for submitting bug reports can be found on-line at http://www.balsa.net/bugs.html. If you are using GNOME 1.1 or later, you can also use command `bug-buddy` for submitting bug reports.

Following people contributed to this manual:

- Peter Bloomfield (peterbloomfield@bellsouth.net)

- Matthew Guenther (guentherm@asme.org)

- Craig Routledge (webstuff@craigroutledge.com)

- Berend De Schouwer (bds@jhb.ucs.co.za)

- Pawel Salek (pawsa@theochem.kth.se)

- Peter Williams (peter@newton.cx)

- Jelmer Vernooij (jelmer@nl.linux.org)

Please send all comments and suggestions regarding the manual to the GNOME Documentation Project at docs@gnome.org and the Balsa Discussion List balsa-list@gnome.org. You can also add your comments online by using GNOME Documentation Status Table.

## Glossar

POP

  An acronym for "Post Office Protocol", a simple method of retrieving mail messages from a remote mail server. Widely used by mail clients from an Internet Service Provider's mail server to a user's machine for viewing. Currently most people use version three of the protocol, otherwise known as POP3. A very simple protocol, and not very flexible, but simple to implement and ubiquitous throughout the internet.

Druide

  Das GNOME-Äquivalent zu den Wizards in Microsoft Windows, ein Schritt-für-Schritt-Dialog, der den Benutzer durch eine Einstellungsprozedur führt.

IMAP

  An acronym that stands for "Internet Mail Access Protocol". It is a newer method of accessing mail over the internet. It is far more featureful than POP3, allowing for remote folders on the mail server, and more control over mail delivery. However it is not as widely supported.

LDAP

  An acronym for "Lightweight Directory Access Protocol". It is a widely-accepted standard for accessing contact information over a network. This enables organizations to store address information in a central database, but have many people able to access it.

libmutt

  The library based on Mutt's code and used by previous versions of Balsa to handle local mail and IMAP servers.

Die Postfachliste

  The list of mailboxes found in Balsa's left hand pane.

Der Nachrichtenindex

  The list of messages in Balsa's upper-right hand pane.

Nachrichtenansicht

  M

MDA

  An acronym for "Mail Delivery Agent", this type of program is also known as a Local Delivery Agent (LDA). It is responsible for delivering the mail recieved for someone on a machine to the mail folder of that person. procmail is an example of this type of program, although many MTA's have their own MDA implementations.

MTA

  An acronym for "Mail Transfer Agent", this class of program is responsible for moving mail around between people, be they on the same computer, on on completely separate networks. Examples of this type of program include sendmail, qmail, and postfix.

MUA

  An acronym for "Mail User Agent", this the program a user would use to read existing mail and create new messages. MUAs are one of three types of programs that allow internet email to work. The other two types of programs are MTAs and MDAs. Balsa is primarily an MUA, but it also functions as an MDA/MTA when retrieving mail from a remote server.

Regulärer Ausdruck

  Often abbreviated as a regexp, this is a method of specifing a pattern to match in text. Both very simple and very complex patterns can be easily matched using this method. For information on how to understand and construct regular expressions the best source is the grep manual or info page.

SMTP

  An acronym that stands for "Simple Mail Transfer Protocol", it is exactly that. A standard that defines a simple an reliable way to transfer messages between computers on a network. It is used by most, if not all, mail programs to transfer mail.

VCARD

  VCARD ist eine Standardmethode zum Speichern von Kontaktinformationen zum leichten Austausch zwischen Anwendungen. Balsa unterstützt VCARD-Adressbücher, wie auch GnomeCard und Evolution. Auch viele andere Anwendungen können ihre Kontaktlisten im VCARD-Format exportieren.