Add more pictures, and remove all locally defined entities from index.docbook. Compressed
the images used in the first two chapters to 8-bit color using pngquant.
IMPORTANT NOTE: I have recently updated "contributor.entities" and "general.entities"
in the central "kdoctools" repository (src/customization/entities/), so these .docbook
files (index, intro, and getting-started) will work locally if, and only if, you update
those two files in /usr/share/kf5/kdoctools/customization/entities/.
<para>The wizard will take you through the process of creating your email accounts. Your screens will vary depending
<para>The wizard will lead you through the process of creating an email account. Your screens will vary depending
on how much the wizard can determine on its own. Below is an outline of the screens you may encounter while using this wizard.</para>
on how much the wizard can determine on its own. Here is an outline of the screens you will encounter while using this wizard.</para>
<itemizedlist>
<para> </para> <!-- whitespace -->
<listitem>
<para><guilabel>Provide personal data</guilabel> is the first screen of the wizard. It will prompt you for your basic account information: <guilabel>Full name:</guilabel>, <guilabel>E-mail address</guilabel>, and <guilabel>Password</guilabel>.
<procedure id="procedure-add-an-email-account">
By default, the <guilabel>Find provider settings on the Internet</guilabel> option is checked, the wizard will attempt to retrieve the necessary
<step id="Provide-personal-data">
information from the server. Uncheck this option if you are an expert user and you need to set up advanced configuration. Click the <guibutton>Next</guibutton> button once finished.
<para>The first screen of the wizard is <guilabel>Provide personal data</guilabel>. It will prompt you for your basic account information: <guilabel>Full name:</guilabel>, <guilabel>E-mail address</guilabel>, and <guilabel>Password</guilabel>.
<note><para>If you use GMail 2-step verification you will need to generate an application-specific password within gmail security settings and enter that password
By default, the <guilabel>Find provider settings on the Internet</guilabel> option is checked, so the wizard will attempt to retrieve the necessary
in the password text box.</para></note><!--FIXME verify this-->
information from the email server. Uncheck this option if you are an expert user and you want to set up advanced configuration. Click the
<guibutton>Next</guibutton> button when finished.</para>
<para>If you want to secure your communications with GnuPG you can generate a new key and publish the key on a public key server,
or you can import an existing key. If you decide to generate a new key pair, do not forget the password used to generate it. You will
need that password every time you want to use the key.
</para>
</para>
</listitem>
<para>When sending mail, &kmail; optionally looks for encryption keys for your recipients, and encrypts the message if a key can be found.
<listitem>
&kmail; can also sign your mail cryptographically, so that each recipient can verify that your message has not been tampered with. <!-- ToDo: dtls -->
<para>If you want to secure your communication with GnuPG you can generate a new key and publish the key on a public key server
or import an existing key.
</para>
</para>
<para>When sending mails &kmail; then automatically looks for encryption keys of your recipients and secures the mail when keys for each recipient can be found.
<para> </para> <!-- whitespace -->
It also signs your mails cryptographically so that it can be verified that your messages have not been tampered with.
</step>
<step id="Select-account-type">
<para>A <guilabel>Setup complete</guilabel> screen will appear if the wizard determined the account type successfully.
Click <guibutton>Details...</guibutton> to view the settings &kmail; has established. Click the <guibutton>Finish</guibutton>
button to set up the account, complete the wizard, and close the window.
</para>
</para>
</listitem>
<listitem>
<screenshot>
<para>The <guilabel>Select Account Type</guilabel> screen will be next if the wizard cannot determine your account type. Select your account type from the
<para>If the wizard cannot determine your account type, the <guilabel>Select Account Type</guilabel> screen will appear. Select your account type from the
list (if you do not know, you will need to contact your email provider). If your account type is not listed, click the <guibutton>Check for more on Internet</guibutton> button.
list (if you do not know, you will need to contact your email provider). If your account type is not listed, click the <guibutton>Check for more on Internet</guibutton> button.
Once your account type has been selected, click the <guibutton>Next</guibutton> button, and you will be presented with the <guilabel>Personal Settings</guilabel> screen.
Once your account type has been selected, click the <guibutton>Next</guibutton> button, and you will be presented with the <guilabel>Personal Settings</guilabel> screen.
</para>
</para>
<para>The <guilabel>Provide personal data</guilabel> screen will show again with the server details it found if the wizard was successful at determining the account type.
<para> </para> <!-- whitespace -->
Click the <guibutton>Finish</guibutton> set up the account, complete the wizard and close the window.
</step>
</para>
<!--FIXME Maildir + MailBox URL: but no input field on the next screen?-->
<step id="Personal-settings">
</listitem>
<listitem>
<para>If the wizard could not locate your email server by searching the internet, the <guibutton>Personal Settings</guibutton>
<para>The <guilabel>Personal Settings</guilabel> screen will show if you had to enter your account type.
screen will appear.</para>
Verify that your information is correct on this page. Select <guilabel>Download all messages for offline use</guilabel>
if you want your messages available when you do not have an Internet connection (&IMAP; only).
<screenshot>
Click the <guibutton>Next</guibutton> button once finished.</para>
<screeninfo>Account Wizard 4</screeninfo>
</listitem>
<mediaobject>
<listitem>
<imageobject>
<para>Your account will then be set up, and you can click the <guibutton>Finish</guibutton> button to complete the wizard and close the window.</para>
<para>The <guilabel>Advanced</guilabel> and <guilabel>Templates</guilabel> tabs can
be used to tailor the way outgoing messages from this identy will be formatted and
processed. See <link linkend="configure-generalinfo">Configure &kmail;</link> for
more detailed instructions.
</para>
<para>
<para>
Optionally, go to the <guilabel>Signature</guilabel> tab and
Optionally, go to the <guilabel>Signature</guilabel> tab and
enter your signature. This is a short text that will be
enter your signature. This is a short bit of verbiage that will be
automatically appended to all your messages. It has nothing to
automatically appended to all your messages. It has nothing to
do with <emphasis>digital signatures</emphasis>.
do with <emphasis>digital signatures</emphasis>. You may also wish
to insert a small personal avatar in outgoing message headers via the
<guilabel>Picture</guilabel> tab.
</para>
</para>
<para> </para> <!-- whitespace -->
</sect2>
</sect2>
<sect2 id="setting-up-your-account">
<sect2 id="setting-up-your-account">
<title>Setting up your Account</title>
<title>Setting up your Account</title>
<para>The <guilabel>Accounts</guilabel> page contains the settings that
<para>The <guilabel>Accounts</guilabel> page also contains the settings that
tell &kmail; how to send and receive your email messages. Many of these settings
tell &kmail; how to send and receive your email messages. Many of these settings
can vary greatly depending on the setup of your system and on the kind
can vary greatly depending on the way your system is set up, and on the kind
of network that your mail server is located in. If you do not know what
of network in which your mail server is located. If you do not know what
setting to choose or what to put in a field, consult your Internet
setting to choose or what to put in a field, consult your <acronym>ISP</acronym>
Service Provider (<acronym>ISP</acronym>) or system
(Internet Service Provider) or system administrator.</para>
administrator.</para>
<sect3 id="sending-mail">
<title>Sending Messages</title>
<para>The <guilabel>Sending</guilabel> tab provides a list of
ways to send messages. The first item in the list is the default
way to send messages. Using the <guibutton>Add...</guibutton>
button you can fill in the <guilabel>Name</guilabel>
field with a descriptive name
(⪚ <userinput>My Mail Account</userinput>). Click the <guibutton>Create and Configure</guibutton>
and fill the <guilabel>Outgoing mail server</guilabel>
field with the name and domain of your mail server
(⪚ <userinput>smtp.provider.com</userinput>). You will probably
not need to change the <guilabel>Port</guilabel> setting (the default is
<userinput>25</userinput>).</para>
<para>The way of sending messages configured here will be used for
your default identity and for all other identities that do not have their own
way of sending messages. You can use different ways of sending
messages for different identities by selecting the <guilabel>Outgoing
Account</guilabel> check box in the <guilabel>Advanced</guilabel>
tab of the <guilabel>Identities</guilabel> page.</para>
<para>A description of the other options can be found
in the <link linkend="configure-accounts-sending">Configuration</link>
chapter.</para>
</sect3>
<sect3 id="sending-mail-kolab">
<title>Options relevant to <acronym>Kolab</acronym> server</title>
<para>When configuring an <guilabel>SMTP</guilabel> account with a <guilabel>Kolab</guilabel> server Host, you need to check the <guilabel>Server requires authentication</guilabel> option and to fill in your <guilabel>Kolab</guilabel> user's email address and password in the <guilabel>Login</guilabel> and <guilabel>Password</guilabel> fields. Then select the <guilabel>Security</guilabel> tab and click on the <guibutton>Check What the Server Supports</guibutton> for automated setup of your <guilabel>Security</guilabel> configuration. The default should be <guilabel>TLS/PLAIN</guilabel>. The <guilabel>Kolab</guilabel> server supports <guilabel>SSL/PLAIN</guilabel> as well. These settings may of course be configured manually.</para>
</sect3>
</sect2>
</sect2>
<sect2 id="receiving-mail">
<sect2 id="sending-mail">
<title>Receiving Messages</title>
<title>Sending Messages</title>
<para>Here's one way to create an outgoing mail account.</para>
<para>By default the <guilabel>Local Folders</guilabel> (inbox, outgoing, sentmail,
trash, drafts and templates) with data from a local Maildir folder are predefined on this tab.
<screenshot>
Using the drop down box you can select the <guilabel>Retrieval Options</guilabel> for these folders.</para>
<screeninfo>Outgoing account choices</screeninfo>
<mediaobject>
<para>To set up an account so you can receive mail, press the
<imageobject>
<guibutton>Add...</guibutton> button in the <guilabel>Receiving</guilabel>
<imagedata fileref="sending.png" format="PNG"/>
tab. You will then be prompted for the type of your email account. Most users should
</imageobject>
select <guilabel>POP3 E-Mail Server</guilabel> or <guilabel>IMAP E-Mail Server</guilabel>. If
<textobject>
you want to use a local mailbox file, please see the <link linkend="faq-file-locking">FAQ
<phrase>Outgoing account choices</phrase>
about file locking</link>.</para>
</textobject>
<caption>
<para>You will then be presented with
<para>Choosing an outgoing email account type</para>
the account settings window. First, fill in the
</caption>
<guilabel>Account name</guilabel> field to name your account. You can choose any name
</mediaobject>
you like. <guilabel>Username</guilabel>, <guilabel>Password</guilabel>, and
</screenshot>
<guilabel>Incoming mail server</guilabel> should be filled in with the appropriate information
<para> </para> <!-- whitespace -->
from your <acronym>ISP</acronym> or system administrator. You should not
need to change the <guilabel>Port</guilabel> setting (the default for POP3 is
<userinput>110</userinput>, the default for &IMAP; is
<para>
<userinput>143</userinput>).</para>
When you click the <guibutton>Add...</guibutton> button on the
<guilabel>Sending</guilabel> tab, this screen will appear. If
<sect3 id="receiving-mail-imap">
your computer is connected directly to the internet you will most
<title>Options only relevant to &IMAP;</title>
likely want to choose &SMTP;. If you need to use &Sendmail;
or &Microsoft; <acronym>EWS</acronym>, please consult the
<para>If you check <guilabel>Automatically compact folders</guilabel>
<para>The &kmail; Team welcomes you to &kmail;, a user-friendly email client by &kde;.
<para>The &kmail; Team welcomes you to &kmail;, a user-friendly email client by &kde;.
Our goal is to make &kmail; a program that is beautiful and intuitive without sacrificing power. </para>
Our goal is to make &kmail; a program that is both beautiful and intuitive without sacrificing power. </para>
<para>If you have never set up an email client on a &UNIX; system
<para>If you have never set up an email client on a &UNIX; system
before, we suggest that you read through the <link linkend="getting-started">Getting Started</link>
before, we suggest that you read through the <link linkend="getting-started">Getting Started</link>
section first.</para>
section first.</para>
<sect1 id="features">
<sect1 id="features">
<title>Some &kmail; Features</title>
<title>Some &kmail; Features</title>
<para>Some links to the great features available in &kmail;</para>
<para>Here is a brief guide to some of the great features available in &kmail;</para>
<itemizedlist>
<itemizedlist>
<listitem>
<listitem>
<para>You do not have to use your mouse to use &kmail;. Everything can
<para>You do not have to use your mouse when working with &kmail;. Everything can
be done by using <link linkend="keyboard-shortcuts">Keyboard Shortcuts</link>.</para>
be done with <link linkend="keyboard-shortcuts">Keyboard Shortcuts</link>.</para>
</listitem>
</listitem>
<listitem>
<listitem>
<para>Although &kmail; can be considered reliable you should keep
<para>Although &kmail; is very reliable, you should keep
backups of your messages, &ie; use one of the export/archive options listed in <link
backups of your messages, &ie;, use one of the export/archive options listed in <link
linkend="backups">Backup Options</link> to backup your settings and email to a safe place.</para>
linkend="backups">Backup Options</link> to back up your settings and email regularly.</para>
</listitem>
</listitem>
<listitem>
<listitem>
<para>&kmail; is capable of importing email in several formats from your previous email applications using
<para>&kmail; makes it easy to import email from many different email applications.
options in <link linkend="import-restore">Restore and Import in &kmail;</link>.</para>
The options are described in <link linkend="import-restore">Restore and Import in &kmail;</link>.</para>
</listitem>
</listitem>
<listitem>
<listitem>
<para>Organize your folders with ease using &kmail;s extensive <link linkend="folders">Folders</link> options.
<para>You can separate your messages into different categories by using &kmail;'s extensive <link linkend="folders">Folders</link> options.
Some of the features include handling per folder: mailing lists, acl (&IMAP; only), and archiving.</para>
Features include special handling for specified folders: mailing lists, acl (&IMAP; only), and archiving.</para> <!-- todo: start a glossary -->
</listitem>
</listitem>
<listitem>
<listitem>
<para>Compliment your folder setup with highly configurable <link linkend="filters">filters</link>.</para>
<para>You can complement your folder setup with highly configurable <link linkend="filters">filters</link>.</para>
</listitem>
</listitem>
<listitem>
<listitem>
<para>By default &kmail; will detect common email <link linkend="configure-security-email-scams">scams</link>.
<para>By default &kmail; will detect common email <link linkend="configure-security-email-scams">scams</link>.
You can also fight SPAM and viruses with built in wizards to work with external programs to scan email as it comes in.
You can also fight SPAM and viruses by creating filters that work with external programs to scan email as it comes in.
See <link linkend="the-anti-spam-wizard">Anti Spam Wizard</link> and <link linkend="the-anti-virus-wizard">Anti-Virus-Wizard</link>
See <link linkend="the-anti-spam-wizard">Anti Spam</link> and <link linkend="the-anti-virus-wizard">Anti Virus</link>
for details.</para>
for details.</para>
</listitem>
</listitem>
<listitem>
<listitem>
<para>Easily manage per-account settings using multiple <link linkend="configure-identity">identities</link>.</para>
<para>It's easy to manage several email accounts by using different <link linkend="configure-identity">identities</link>.</para>
</listitem>
</listitem>
</itemizedlist>
</itemizedlist>
<para>We hope you will enjoy &kmail;!</para>
<para>We hope you will enjoy &kmail;!</para>
@ -80,7 +84,7 @@ for details.</para>
<note><para>If you experience any problems migrating to &kmail; 2 please read the chapter <link linkend="troubleshooting">Troubleshooting</link>.
<note><para>If you experience any problems migrating to &kmail; 2 please read the chapter <link linkend="troubleshooting">Troubleshooting</link>.
</para></note>
</para></note>
<para>&kmail;'s homepage can be found at <ulink url="https://userbase.kde.org/Special:MyLanguage/KMail">https://userbase.kde.org/KMail</ulink>. There you will
<para>&kmail;'s homepage can be found at <ulink url="https://userbase.kde.org/Special:MyLanguage/KMail">https://userbase.kde.org/KMail</ulink>. There you will
find useful links, ⪚ to the user and developer mailing lists. Please report bugs in &kmail; using
find useful links (⪚, to the user and developer mailing lists, and to the community wiki pages.) Please report any bugs in &kmail; using
David Bryant
6 years ago
