Commit 9315d47d authored by David Bryant's avatar David Bryant 💬
Browse files

WIP: Revise the first two chapters, bringing them up to release 5.14.2 (20.04.2).

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/.
parent c4a41736
Pipeline #31243 passed with stage
in 31 minutes and 17 seconds
doc/kmail2/accountwizard.png

31.8 KB | W: | H:

doc/kmail2/accountwizard.png

15.3 KB | W: | H:

doc/kmail2/accountwizard.png
doc/kmail2/accountwizard.png
doc/kmail2/accountwizard.png
doc/kmail2/accountwizard.png
  • 2-up
  • Swipe
  • Onion skin
doc/kmail2/configure.png

27.6 KB | W: | H:

doc/kmail2/configure.png

18.3 KB | W: | H:

doc/kmail2/configure.png
doc/kmail2/configure.png
doc/kmail2/configure.png
doc/kmail2/configure.png
  • 2-up
  • Swipe
  • Onion skin
This diff is collapsed.
......@@ -10,14 +10,6 @@
<!ENTITY kmail-credits-and-licenses SYSTEM "credits-and-licenses.docbook">
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
<!ENTITY gpg "<application>GPG</application>">
<!ENTITY gpgsm "<application>GpgSM</application>">
<!ENTITY mdn "<acronym>MDN</acronym>">
<!ENTITY acl "<acronym>ACL</acronym>">
<!ENTITY nntp "<acronym>NNTP</acronym>">
<!ENTITY openpgp "<acronym>OpenPGP</acronym>">
<!ENTITY smime "<acronym>S/MIME</acronym>">
<!ENTITY kolab "<acronym>Kolab</acronym>">
]>
<book id="kmail" lang="&language;">
<bookinfo>
......@@ -75,6 +67,10 @@
&Scarlett.Clark.mail;
</author>
<author>
&David.Bryant;
&David.Bryant.mail;
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
......@@ -99,10 +95,14 @@
<year>2013</year>
<holder>&Laurent.Montel;</holder>
</copyright>
<copyright>
<year>2020</year>
<holder>&David.Bryant;</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
<date>2020-08-14</date>
<releaseinfo>(&kde;5.14.3)</releaseinfo>
<releaseinfo>&kde;5.14.2 (20.04.2)</releaseinfo>
<abstract>
......
......@@ -10,10 +10,14 @@
&Scarlett.Clark;
&Scarlett.Clark.mail;
</author>
<author>
&David.Bryant;
&David.Bryant.mail;
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<date>2013-12-12</date>
<releaseinfo>&kde; 4.12</releaseinfo>
<date>2020-08-16</date>
<releaseinfo>&kde; 5.14.2 (20.04.2)</releaseinfo>
</chapterinfo>
......@@ -35,43 +39,43 @@
</screenshot>
<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
before, we suggest that you read through the <link linkend="getting-started">Getting Started</link>
section first.</para>
<sect1 id="features">
<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>
<listitem>
<para>You do not have to use your mouse to use &kmail;. Everything can
be done by using <link linkend="keyboard-shortcuts">Keyboard Shortcuts</link>.</para>
<para>You do not have to use your mouse when working with &kmail;. Everything can
be done with <link linkend="keyboard-shortcuts">Keyboard Shortcuts</link>.</para>
</listitem>
<listitem>
<para>Although &kmail; can be considered reliable you should keep
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>
<para>Although &kmail; is very reliable, you should keep
backups of your messages, &ie;, use one of the export/archive options listed in <link
linkend="backups">Backup Options</link> to back up your settings and email regularly.</para>
</listitem>
<listitem>
<para>&kmail; is capable of importing email in several formats from your previous email applications using
options in <link linkend="import-restore">Restore and Import in &kmail;</link>.</para>
<para>&kmail; makes it easy to import email from many different email applications.
The options are described in <link linkend="import-restore">Restore and Import in &kmail;</link>.</para>
</listitem>
<listitem>
<para>Organize your folders with ease 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>
<para>You can separate your messages into different categories by using &kmail;'s extensive <link linkend="folders">Folders</link> options.
Features include special handling for specified folders: mailing lists, acl (&IMAP; only), and archiving.</para> <!-- todo: start a glossary -->
</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>
<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.
See <link linkend="the-anti-spam-wizard">Anti Spam Wizard</link> and <link linkend="the-anti-virus-wizard">Anti-Virus-Wizard</link>
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</link> and <link linkend="the-anti-virus-wizard">Anti Virus</link>
for details.</para>
</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>
</itemizedlist>
<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>.
</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
find useful links, &eg; to the user and developer mailing lists. Please report bugs in &kmail; using
find useful links (&eg;, to the user and developer mailing lists, and to the community wiki pages.) Please report any bugs in &kmail; using
<menuchoice><guimenu>Help</guimenu><guimenuitem>Report Bug...</guimenuitem></menuchoice>.</para>
</sect2>
......
doc/kmail2/kmailwelcome.png

487 KB | W: | H:

doc/kmail2/kmailwelcome.png

131 KB | W: | H:

doc/kmail2/kmailwelcome.png
doc/kmail2/kmailwelcome.png
doc/kmail2/kmailwelcome.png
doc/kmail2/kmailwelcome.png
  • 2-up
  • Swipe
  • Onion skin
  • I would appreciate some proofreading help. It looked OK to me, but there might be a few typos.

  • Looks fine. Many thanks for your work.

    I can merge it (with all corrections should they be made) 2020-08-29.

Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment