diff options
Diffstat (limited to 'help/C/config-prefs.sgml')
| -rw-r--r-- | help/C/config-prefs.sgml | 925 |
1 files changed, 925 insertions, 0 deletions
diff --git a/help/C/config-prefs.sgml b/help/C/config-prefs.sgml new file mode 100644 index 0000000000..15c9bf15a1 --- /dev/null +++ b/help/C/config-prefs.sgml @@ -0,0 +1,925 @@ +<!-- +<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> +--> +<chapter id="config-prefs"> + + <title>Advanced Configuration</title> + <para> + Perhaps your mail server has changed names. Perhaps you've + grown tired of a certain layout for your appointments. + Whatever the reason, you want to change your + <application>Evolution</application> settings. This chapter + will tell you how to do just that. + </para> + + <sect1 id="config-prefs-mail"> + <title>Mail Settings</title> + <para> + To change your mail settings, select <menuchoice> + <guimenu>Tools</guimenu> <guimenuitem>Mail + Settings</guimenuitem></menuchoice> in the Inbox. This + will open the <interface>mail preferences window</interface>, + illustrated in <xref linkend="config-prefs-mail-fig">. Mail + preferences are separated into several categories: + <variablelist> + <varlistentry> + <term><guilabel>Accounts</guilabel></term> + <listitem> + <para> + This allows you to create and alter one or more + identities for your email. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Display</guilabel></term> + <listitem> + <para> + Allows you to edit how email appears. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Composer</guilabel></term> + <listitem> + <para> + Customizes the behavior of the email message composer. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Other</guilabel></term> + <listitem> + <para> + Configures miscellanious aspects of + <application>Evolution</application> such as character + set and encryption tools. + </para> + </listitem> + </varlistentry> + </variablelist> + + </para> + + <!-- ==============Figure===================== --> + <figure id="config-prefs-mail-fig"> + <title>Account Editor Window</title> + <screenshot> + <screeninfo>Account Editor Window</screeninfo> + <mediaobject><imageobject><imagedata fileref="figures/config-mail" format="png" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + <!-- ==============End of Figure================--> + + + <sect2 id="config-prefs-mail-identity"> + <title>Working with the Accounts Tab</title> + <para> + <application>Ximian Evolution</application> allows you to + maintain multiple accounts, or identities. This is useful + want to keep personal and professional email separate, or if + you wear several hats at work. When you are writing an email + message, you can which account to use by selecting from the + drop-down list next to the <guilabel>From</guilabel> entry in + the message composer. + </para> + + <para> + Clicking <guibutton>Get Mail</guibutton> will refresh any + IMAP, <filename>mh</filename>, or + <filename>mbox</filename> listings + and check and download mail from all POP servers. In other + words, <guibutton>Get Mail</guibutton> gets your mail, no + matter how many sources you have, or what types they are. If + you don't want to check mail for a given account, select it + in the <guilabel>Accounts</guilabel> tab and click the + <guibutton>Disable</guibutton> button. + </para> + + <para> + To add a new account, simply click <guibutton>Add</guibutton> + to open the mail configuration assistant. To alter an + existing identity, select it in the + <interface>Preferences</interface> window, and then click + <guibutton>Edit</guibutton> to open the account editor + dialog. + </para> + <para> + The account editor dialog has six sections: + <variablelist> + + <varlistentry> + <term>Identity:</term> + <listitem> + <para> + Here, enter the name, + email address, and other identifying information for the + account. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Receiving Mail</term> + <listitem> + <para> + Here, select the way you will be getting mail: you may + download mail from a server (<glossterm + linkend="pop">POP</glossterm>), read and keep it on the + server (Microsoft Exchange or <glossterm + linkend="imap">IMAP</glossterm>), or read it from files + that already exist on your desktop computer. If you use + a server, it may permit or require you to use a Secure + Socket Layer (SSL) connection. To turn SSL connections + on, just click the <guibutton>Use Secure Connection + (SSL)</guibutton> button. + +<note id="config-arbitrary-port"> +<title>Specifying Port Numbers</title> +<para> +Your system administrator may ask you to connect to a specific port on +a mail server. To specify which port you use, just type a colon and +the port number after the server name. For example, to connect to port +143 on the server smtp.omniport.com, you would enter +as +<userinput> +smtp.omniport.com:143 +</userinput> as the server name. +</para> +</note> + + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Receiving Options</term> + <listitem> + <para> + Here, decide whether you'd like to check for mail + automatically and how often. + + <variablelist> + <varlistentry> + <term>If you chose POP:</term> + <listitem> + <para> + <itemizedlist> + <listitem> + <para>Checking for new mail: If you would + like <application>Evolution</application> + to check for new mail automatically, + check the box and select a frequency in + minutes. + </para> + </listitem> + + <listitem> + <para> + Message Storage: If you'd like to store + copies of your mail on the server, check + this option. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>If you chose Microsoft Exchange:</term> + <listitem> + <para> + + <itemizedlist> <listitem> + <para>Checking for new mail: If you would like + <application>Evolution</application> to check for new mail + automatically, check the box and select a frequency in + minutes. + </para> + </listitem> + + <listitem> + <para>Exchange Server: If your active directory user name + is different from your Exchange mail user name, check this + box and enter your mail username here. + </para> + </listitem> + + <listitem> + <para>Create a Global Address List folder: If you would + like to have a seperate folder for the Active Directory's + Global Address List, leave this box checked. </para> + </listitem> + + <listitem> + <para> + Active Directory Server Name: In most organizations, + the Active Directory server will be different from + the Exchange mail server. If so, check the box and + enter the Active Directory server name here. + </para> + </listitem> + + <listitem> + <para>Limit number of Responses: Select a maximum number + of results for an address search. A maximum number of + results limits the load on your system and on your network. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>If you chose IMAP:</term> + <listitem> + <para> + + <itemizedlist> + <listitem> + <para>Checking for new mail: If you would like + <application>Evolution</application> to check for new mail + automatically, check the box and select a frequency in + minutes. + </para> + </listitem> + + <listitem> + <para>If you want <application>Evolution</application> + to check for new messages in <emphasis>all</emphasis> your + IMAP folders, make sure the <guilabel>Check for new + messages in all folders</guilabel> box is selected.</para> + </listitem> + + <listitem> + <para>Show only subscribed folders: Check this box if you + have more folders in your IMAP view than you want to + read.</para> + </listitem> + + <listitem> + <para> + Override server-supplied namespace: If you like, enter a + specific directory where your server stores mail for + you. Typical values are "mail" and "Mail." For more + information about how to use IMAP mail, see <xref + linkend="usage-mail-subscriptions">.</para> + </listitem> + + <listitem> + <para>Apply filters to new messages in INBOX on this + server: If you'd like your filters to work on this account + as well as on locally downloaded mail, check this box.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + + </variablelist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Sending Mail</term> + <listitem> + <para> + In this section, you will choose and configure a method + for sending mail. You may choose <glossterm + linkend="smtp">SMTP</glossterm>, Microsoft Exchange (if + you have purchased the Ximian Connector for Microsoft + Exchange) or <glossterm + linkend="sendmail">sendmail</glossterm>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Special Folders</term> + <listitem> + <para> + Here, you can decide where this account will store the + messages that it has sent, and the messages that you + save as drafts. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Security</term> + <listitem> + <para> + In this section, you will set the security options for + this account. Enter your PGP Key ID and decide how + frequently to encrypt and sign your messages. You can + learn more about PGP and encryption in <xref + linkend="encryption">. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + + <sect2 id="config-prefs-mail-display"> + <title>Mail Display Options</title> + <para> + In this tab you can decide how you would like + <application>Ximian Evolution</application> to display your + mail: how to display citations, how long to wait before + marking a message as read, and so forth. + </para> + <para> + This is also where you can decide how you would like + <application>Ximian Evolution</application> to handle inline + images in HTML mail that you get. There is a detailed + discussion of the issues surrounding these options in <xref + linkend="usage-mail-getnsend-get-attach-html">. + </para> + <para> + To hange the font which <application>Ximian + Evolution</application> uses to display mail, do the + following: + <orderedlist numeration="arabic"> + <listitem> + <para> + Open the Control Center by selecting <menuchoice> + <guimenu>System</guimenu> + <guimenuitem>Settings</guimenuitem> </menuchoice> from + the menu panel. + </para> + </listitem> + <listitem> + <para> + Select the HTML Viewer settings tool. + </para> + </listitem> + <listitem> + <para>Choose the font and font size you would like to use. + </para> + </listitem> + </orderedlist> + + Alternately, open a terminal and run the + <command>gtkhtml-properties-capplet</command> command. This + will open the GNOME HTML Display Properties tool, and you can + select a font and other attributes of your HTML display, + including that in <application>Ximian Evolution</application>. + </para> + </sect2> + + <sect2 id="config-prefs-mail-composer"> + <title>Message Composer Preferences</title> + + <para> + Mercifully, there are only four preferences you can prefer in + the message composer preferences dialog: + <variablelist> + <varlistentry> + <term>Send mail in HTML format by default </term> + <listitem> + <para> + If you would like all email messages that you compose + to begin in HTML format, leave this box checked. You + can convert messages between HTML and plain text by + selecting the <menuchoice> <guimenu>Format</guimenu> + <guimenuitem>HTML</guimenuitem> </menuchoice> toggle + in the message composer. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Default Forward style</term> + <listitem> + <para> + Select from: + <simplelist> + <member><guilabel>Attachment:</guilabel> the + message you forward appended to the message you send + as a seperate file.</member> + + <member> <guilabel>Inline:</guilabel> The message + you forward is included at the end of the message + you send.</member> + + <member> + <guilabel>Quoted:</guilabel> The message + you forward is included at the end of the message + you send, and a greater-than symbol (>) is + inserted at the beginning of each line to + indicate that it is quoted. + </member> + </simplelist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Prompt when sending messages with an empty subject</term> + <listitem> + <para> + The composer will warn you if you try to send a + message without a subject. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Prompt when sending messages with only Bcc recipients defined</term> + <listitem> + <para> + The composer will warn you if you try to send a + message that has only <guilabel>Bcc</guilabel> + recipients. This is important because some mail + servers will fail to honor blind carbon copy if you + do not have at least one recipient that is visible to + all readers. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + <sect2 id="config-prefs-mail-other"> + <title>Other Mail Preferences</title> + <para> + Not everything fits neatly into categories. This tab + contains some miscellaneous configuration options that + didn't fit anywhere else. + <variablelist> + + <varlistentry> + <term> + <guilabel>PGP binary path</guilabel> + </term> + <listitem> + <para> + The complete path to your external encryption tool On + most Linux systems, this will be + <filename>/usr/bin/gpg</filename>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <guilabel>Remember PGP Passphrase until Exit</guilabel> + </term> + <listitem> + <para> Check this box if you want <application>Ximian + Evolution</application> to remember your PGP + passphrase for as long as it is running. You will + still have to enter your passphrase again each time + you start <application>Ximian Evolution</application>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <guilabel>Default Character Encoding</guilabel> + </term> + <listitem> <para> Choose a default character encoding for + your messages. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <guilabel>Empty Trash Folders on Exit</guilabel> + </term> + <listitem> <para> If you would like to expunge all deleted + mail when you quit <application>Ximian + Evolution</application>, check this box. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <guilabel>Log filter actions to:</guilabel> + </term> + <listitem> <para> If you like, you can have + <application>Ximian Evolution</application> write all + its message filter actions to a log file. Select a log + file here. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + </sect1> + + +<!-- NOT FOR 1.0, see usage-mail.sgml + <sect1 id="config-prefs-news"> + <title>News Servers</title> + <para> + Newsgroups are so much like mailing lists that there's no + reason not to keep them right next to your mail. When you + first select the <guilabel>News Servers</guilabel> tab, + you will see a blank box with the three familiar buttons + on the right: <guibutton>Add</guibutton>, + <guibutton>Edit</guibutton>, and + <guibutton>Delete</guibutton>. + </para> + <para> + Click <guibutton>Add</guibutton> to add a news server; you + will be prompted for its name. Enter the name, click + <guibutton>OK</guibutton>, and you're done. You can have + as many news servers as you like, of course. News servers + will appear next to your IMAP servers in the + <interface>folder bar</interface>. + </para> + </sect2> +--> + + + <sect1 id="config-prefs-cal"> + <title>Configuring the Calendar</title> + <para> + To set your calendar preferences, select + <menuchoice><guimenu>Settings</guimenu> + <guimenuitem>Calendar + Settings</guimenuitem></menuchoice> from the Calendar + view. This will open up the + <interface>Preferences</interface> window. It contains four + tabs: <guilabel>General</guilabel>, <guilabel>Display</guilabel>, <guilabel>Task List</guilabel>, and <guilabel>Other</guilabel>. The <interface>calendar + preferences window</interface> is illustrated in <xref + linkend="config-prefs-cal-fig">. + + <!-- ==============Figure===================== --> + <figure id="config-prefs-cal-fig"> + <title>Calendar Preferences Dialog</title> + <screenshot> + <screeninfo>If this worked on my job as well as my calendar...</screeninfo> + <mediaobject><imageobject><imagedata fileref="figures/config-cal" format="png" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + <!-- ==============End of Figure================--> + </para> + + <sect2 id="config-prefs-cal-general"> + <title>Calendar's General Settings</title> + <para> + The <guilabel>Time display</guilabel> tab lets you set the + following: + <variablelist> + <varlistentry> + <term>Time zone</term> + <listitem> + <para> + The city you're located in, to judge your time zone. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Time format</term> + <listitem> + <para>You may choose between twelve-hour (AM/PM) and + twenty-four hour time formats here by clicking the + appropriate radio button. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Work Week</term> + <listitem> + <para> + When does your work day start, and when does it end? + In the day and week views, + <application>Evolution</application> displays all the + hours in the range you select here, even if there are + no appointments for those times. Of course, you can + still schedule an appointment outside of these hours, + and if you do, the display will be extended to show + it. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>First day of the week</term> + <listitem> + <para>You can set weeks to start on Sunday or on Monday.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Start of day</term> + <listitem> + <para> + Says what time of the day your weekday starts. This will show all times till the end of the day, regardless of there is an appointment during the time period. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>End of day</term> + <listitem> + <para> + Sets the time the day ends at. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + <sect2 id="config-prefs-cal-display"> + <title>Display</title> + <para> + The <interface>Display</interface> section lets you configure some visual properties of the calendar. + </para> + <para>The display properties you can set are: + + <variablelist> + <varlistentry> + <term>Time divisions</term> + <listitem> + <para> + Sets the increments shown on the daily view in the calendar. You can set this to be: + <itemizedlist> + <listitem> + <para> + 5 minutes + </para> + </listitem> + <listitem> + <para> + 10 minutes + </para> + </listitem> + <listitem> + <para> + 15 minutes + </para> + </listitem> + <listitem> + <para> + 30 minutes + </para> + </listitem> + <listitem> + <para> + 60 minutes + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Show appointment end times in week and month views</term> + <listitem> + <para> + If there is space, <application>Evolution</application> will show the end times in the week and month views for each appointment. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Compress weekends in month view</term> + <listitem> + <para> + If checked, your weekends will be shown in one box, instead of one for each day in the month view. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Show week numbers in date navigator</term> + <listitem> + <para> + This will show the week numbers next to the respective weeks in the calendar. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + + <sect2 id="config-prefs-cal-tasklist"> + <title>Task List Settings</title> + <para> + You can choose what information the To Do list displays and the + way it is displayed. + <variablelist> + <varlistentry> + <term>Tasks due today</term> + <listitem> + <para> + Configures what color to set your tasks that are due today to. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Overdue tasks</term> + <listitem> + <para> + Configures what color to set your overdue items to. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + + <sect2 id="config-prefs-cal-other"> + <title>Other Calendar Settings</title> + <para> + This configures miscellaneous items for the calendar and todo list's functionality. + <variablelist> + <varlistentry> + <term>Ask for confirmation when deleting items</term> + <listitem> + <para> + When you delete an item in either the Task List or the Calendar, you will be prompted to confirm that you want to delete the item. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Create new appointments with a default reminder</term> + <listitem> + <para> + All your appointments will be created using a default reminder enabled. You can still change what way you are reminded though. If enabled, you can then set the time before your appointment to be reminded. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + </sect1> + + <sect1 id="config-prefs-contact"> + <title>Managing the Addressbook</title> + <para> + The addressbook does not have a large list of configuration + settings, but those that are there can be found in the + <guimenu>Tools</guimenu> menu. + </para> + + <sect2 id="config-prefs-contact-ldap-add"> + <title>Adding Directory Servers</title> + <para> + To add a new <glossterm linkend="ldap">LDAP</glossterm> server + to your available contact folders: + <orderedlist numeration="arabic"> + <listitem> + <para> + Select + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Addressbook Sources</guimenuitem> + </menuchoice> + from the menu. + </para> + </listitem> + <listitem> + <para> + Click the <guibutton>Add</guibutton> button on the right + side. + </para> + </listitem> + <listitem> + <para> + Enter the server information: + <variablelist> + <varlistentry> + <term>Account name</term> + <listitem> + <para> + The name that you see on the screen. This could + be anything you wish. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Server name</term> + <listitem> + <para> + Address of the server where the addressbook is located. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>My server requires authentication</term> + <listitem> + <para> + Select this if the server requires + <application>Evolution</application> to provide + a server in order to access the LDAP contacts. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Port</term> + <listitem> + <para> + The internet port + <application>Evolution</application> connects to + in order to access the LDAP database. This is + normally 389. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><glossterm linkend="search-base">Search base</glossterm></term> + <listitem> + <para> + The base entry to use for all your searches. + Contact your administrator for information about + the correct settings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><glossterm linkend="search-scope">Search scope</glossterm></term> + <listitem> + <para> + How broad the search is in the directory. The + following options are available: + <variablelist> + <varlistentry> + <term>Base</term> + <listitem> + <para> + Searches just the Search Base. Most of the time, + not very useful. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>One</term> + <listitem> + <para> + Searches the Search Base and one entry + below it. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Sub</term> + <listitem> + <para> + Searches the Search Base and all entries + below it. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </listitem> + <listitem> + <para> + Click <guibutton>OK</guibutton>. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>OK</guibutton> to permanenty make + changes or <guibutton>Apply</guibutton> to temporarily + set the changes. + </para> + </listitem> + </orderedlist> +<!-- I gotta finish this example --> + <example id="ldap-config-example"> + <title>LDAP Configuration</title> + <para> + Rich works at a large chip manufacturer. He needs to + access the company's LDAP server. Their LDAP address is + wemakechips.com. + </para> + <para> + His Account Name would be: We Make Chips Employees + </para> + <para> + His Server Name would be: ldap.wemakechips.com + </para> + </example> + </para> + </sect2> + </sect1> + + +<!-- + <sect1 id="config-prefs-general"> + <title>General Preferences</title> + <para> + Additional configuration options will be covered here, as + they become available. + </para> + </sect1> +--> +</chapter> + + + + + + |