[evolution] User docs: Embed account type configuration instructions on First Run Wizard page.



commit 6121241ffb65c72919a3c6de021386636fe8d2e4
Author: Andre Klapper <a9016009 gmx de>
Date:   Sat Jun 22 07:42:09 2013 -0700

    User docs: Embed account type configuration instructions on First Run Wizard page.
    
    The instructions per account are collapsed by default and expandable in clients that support ui: (like 
recent Yelp versions). This requires turning the <list> of account types on intro-first-run.page into 
<section>s as ui:expandable is not supported inside of <list> elements.
    
    Embedding directly does not require users to follow "Click here for configuration instructions for this 
account" links anymore, that we get rid of "Click here to get to next step if you came from the First Run 
Wizard help page" sections at the bottom of each account type configuration page.

 help/C/intro-first-run.page                        |  214 ++++++++++++++++----
 help/C/mail-receiving-options-exchange-ews.page    |    5 -
 help/C/mail-receiving-options-exchange-mapi.page   |    4 -
 help/C/mail-receiving-options-imap-plus.page       |    4 -
 help/C/mail-receiving-options-local-delivery.page  |    4 -
 ...ceiving-options-maildir-format-directories.page |    4 -
 ...il-receiving-options-mh-format-directories.page |    4 -
 help/C/mail-receiving-options-pop.page             |    4 -
 ...eceiving-options-unix-mbox-spool-directory.page |    4 -
 ...ail-receiving-options-unix-mbox-spool-file.page |    4 -
 help/C/mail-receiving-options-usenet-news.page     |    4 -
 help/C/mail-sending-options-smtp.page              |    3 -
 12 files changed, 177 insertions(+), 81 deletions(-)
---
diff --git a/help/C/intro-first-run.page b/help/C/intro-first-run.page
index 5fe79d6..1df68cf 100644
--- a/help/C/intro-first-run.page
+++ b/help/C/intro-first-run.page
@@ -42,28 +42,65 @@
    xmlns="http://www.w3.org/2001/XInclude"/>
  </section>
 </section>
+
 <section id="receiving">
 <title>Receiving Email</title>
 <p>First, choose the server type from the <gui>Server Type</gui> drop-down list.</p>
 <p>If you are unsure about the type of server to choose, ask your system administrator or Internet Service 
Provider.</p>
 
+<note style="tip"><p>Later on, if you want to change an account, or if you want to create another one, go to 
<guiseq><gui>Edit</gui><gui>Preferences</gui><gui>Mail Accounts</gui></guiseq>. Select the account you want 
to change, then click <gui style="button">Edit</gui>. Alternately, add a new account by clicking <gui 
style="button">Add</gui>.</p></note>
+
+<section id="server-type-imap+">
+<title>IMAP+</title>
+<p>Keeps the mail on the server so you can access your mail from multiple systems.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>IMAP+ receiving options</title>
+  <include href="mail-receiving-options-imap-plus.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-pop">
+<title>POP</title>
+<p>Downloads your email to your hard disk.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>POP receiving options</title>
+  <include href="mail-receiving-options-pop.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-usenet">
+<title>USENET News</title>
+<p>Connects to a news server and downloads a list of available news digests.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Usenet news receiving options</title>
+  <include href="mail-receiving-options-usenet-news.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
 
-<section id="common-server-types">
-<title>Common server types</title>
-<p>The most common available server types for normal users are:</p>
-<list>
-<item><p>None: If you do not plan to use Evolution for receiving email.</p><p>Continue <link 
xref="#sending">here</link> for configuration.</p></item>
-<item><p>IMAP+: Keeps the mail on the server so you can access your mail from multiple 
systems.</p><p>Continue <link xref="mail-receiving-options-imap-plus">here</link> for 
configuration.</p></item>
-<item><p>POP: Downloads your email to your hard disk.</p><p>Continue <link 
xref="mail-receiving-options-pop">here</link> for configuration.</p></item>
-<item><p>USENET News: Connects to a news server and downloads a list of available news 
digests.</p><p>Continue <link xref="mail-receiving-options-usenet-news">here</link> for 
configuration.</p></item>
-</list>
 </section>
 
-<section id="corporate-server-types">
-<title>Corporate server types</title>
-<p>Available server types for corporate users are:</p>
-<list>
-<item><p>Exchange EWS: For connecting to a Microsoft Exchange 2007/2010 or OpenChange server. Note that this 
is currently under development and will replace the <gui>Exchange MAPI</gui> account type in the future. It 
might not be available yet for your distribution.</p><p>Continue <link 
xref="mail-receiving-options-exchange-ews">here</link> for configuration.</p>
+<section id="server-type-exchange-ews">
+<title>Exchange EWS</title>
+<p>For connecting to a Microsoft Exchange 2007/2010 or OpenChange server. Note that this is currently under 
development and will replace the <gui>Exchange MAPI</gui> account type in the future. It might not be 
available yet for your distribution.</p>
 <note style="info package">
   <p>This requires having the <sys>evolution-ews</sys> package installed.</p>
   <if:choose>
@@ -72,9 +109,22 @@
     </if:when>
   </if:choose>
 </note>
-</item>
 
-<item><p>Exchange MAPI: For connecting to a Microsoft Exchange 2007/2010 or OpenChange 
server.</p><p>Continue <link xref="mail-receiving-options-exchange-mapi">here</link> for configuration.</p>
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Exchange Web Services receiving options</title>
+  <include href="mail-receiving-options-exchange-ews.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-exchange-mapi">
+<title>Exchange MAPI</title>
+<p>For connecting to a Microsoft Exchange 2007/2010 or OpenChange server.</p>
 <note style="info package">
   <p>This requires having the <sys>evolution-mapi</sys> package installed.</p>
   <if:choose>
@@ -83,30 +133,102 @@
     </if:when>
   </if:choose>
 </note>
-</item>
-</list>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Exchange MAPI receiving options</title>
+  <include href="mail-receiving-options-exchange-mapi.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
 </section>
 
-<section id="local-account-server-types">
-<title>Local account server types</title>
-<p>Available local account server types for advanced users are:</p>
-<list>
-<item><p>Local delivery: If you want to move email from the spool (the location where mail waits for 
delivery) and store it in your home directory. You need to provide the path to the mail spool you want to 
use. If you want to leave email in your system's spool files, choose the <gui>Standard Unix Mbox Spool</gui> 
option instead.</p><p>Continue <link xref="mail-receiving-options-local-delivery">here</link> for 
configuration.</p></item>
+<section id="server-type-local-delivery">
+<title>Local delivery</title>
+<p>Local delivery: If you want to move email from the spool (the location where mail waits for delivery) and 
store it in your home directory. You need to provide the path to the mail spool you want to use. If you want 
to leave email in your system's spool files, choose the <gui>Standard Unix Mbox Spool</gui> option 
instead.</p>
 
-<item><p>MH-Format Mail Directories: For downloading email using MH or another MH-style application.</p>
-<p>Continue <link xref="mail-receiving-options-mh-format-directories">here</link> for 
configuration.</p></item>
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Local delivery receiving options</title>
+  <include href="mail-receiving-options-local-delivery.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
 
-<item><p>Maildir-Format Mail Directories: For downloading your email using Qmail or another Maildir-style 
application.</p>
-<p>Continue <link xref="mail-receiving-options-maildir-format-directories">here</link> for 
configuration.</p></item>
+</section>
 
-<item><p>Standard Unix mbox spool file: For reading and storing email in the mail spool file on your local 
system.</p>
-<p>Continue <link xref="mail-receiving-options-unix-mbox-spool-file">here</link> for 
configuration.</p></item>
+<section id="server-type-mh-format-directories">
+<title>MH-Format Mail Directories</title>
+<p>For downloading email using MH or another MH-style application.</p>
 
-<item><p>Standard Unix mbox spool directory: For reading and storing email in the mail spool directory on 
your local system.</p>
-<p>Continue <link xref="mail-receiving-options-unix-mbox-spool-directory">here</link> for 
configuration.</p></item>
-</list>
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>MH-format mail directories receiving options</title>
+  <include href="mail-receiving-options-mh-format-directories.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-maildir-format-directories">
+<title>Maildir-Format Mail Directories</title>
+<p>Maildir-Format Mail Directories: For downloading your email using Qmail or another Maildir-style 
application.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Maildir-format mail directories receiving options</title>
+  <include href="mail-receiving-options-maildir-format-directories.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
 
-<note style="tip"><p>Later on, if you want to change an account, or if you want to create another one, go to 
<guiseq><gui>Edit</gui><gui>Preferences</gui><gui>Mail Accounts</gui></guiseq>. Select the account you want 
to change, then click <gui style="button">Edit</gui>. Alternately, add a new account by clicking <gui 
style="button">Add</gui>.</p></note>
+</section>
+
+<section id="server-type-unix-mbox-spool-file">
+<title>Standard Unix mbox spool file</title>
+<p>Standard Unix mbox spool file: For reading and storing email in the mail spool file on your local 
system.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Standard Unix mbox spool file receiving options</title>
+  <include href="mail-receiving-options-unix-mbox-spool-file.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-unix-mbox-spool-directory">
+<title>Standard Unix mbox spool directory</title>
+<p>Standard Unix mbox spool directory: For reading and storing email in the mail spool directory on your 
local system.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Standard Unix mbox spool directory receiving options</title>
+  <include href="mail-receiving-options-unix-mbox-spool-directory.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-none">
+<title>None</title>
+<p>If you do not plan to use Evolution for receiving email.</p>
 </section>
 
 </section>
@@ -114,10 +236,28 @@
 <section id="sending"> <!-- Do not rename, we link to it from the subpages -->
 <title>Sending mail</title>
 <p>Available server types are:</p>
-<list>
-<item><p>SMTP: Sends mail using an outbound mail server. This is the most common choice for sending 
mail.</p><p>Continue <link xref="mail-sending-options-smtp">here</link> for configuration.</p></item>
-<item><p>Sendmail: Uses the <app>Sendmail</app> application to send mail from your system. It is not easy to 
configure, so you should select this option only if you know how to set up a Sendmail service.</p></item>
-</list>
+
+<section id="server-type-smtp">
+<title>SMTP</title>
+<p>Sends mail using an outbound mail server. This is the most common choice for sending mail.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>SMTP sending options</title>
+  <include href="mail-sending-options-smtp.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:list)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type=sendmail">
+<title>Sendmail</title>
+<p>Uses the <app>Sendmail</app> application to send mail from your system. It is not easy to configure, so 
you should select this option only if you know how to set up a Sendmail service.</p>
+</section>
+
 </section>
 
 <section id="account-information">
diff --git a/help/C/mail-receiving-options-exchange-ews.page b/help/C/mail-receiving-options-exchange-ews.page
index b79efc3..e67690d 100644
--- a/help/C/mail-receiving-options-exchange-ews.page
+++ b/help/C/mail-receiving-options-exchange-ews.page
@@ -47,9 +47,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
-
 </page>
diff --git a/help/C/mail-receiving-options-exchange-mapi.page 
b/help/C/mail-receiving-options-exchange-mapi.page
index 90a3bad..6c46b3c 100644
--- a/help/C/mail-receiving-options-exchange-mapi.page
+++ b/help/C/mail-receiving-options-exchange-mapi.page
@@ -47,8 +47,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-imap-plus.page b/help/C/mail-receiving-options-imap-plus.page
index 73cd223..9ff70c0 100644
--- a/help/C/mail-receiving-options-imap-plus.page
+++ b/help/C/mail-receiving-options-imap-plus.page
@@ -53,8 +53,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-local-delivery.page 
b/help/C/mail-receiving-options-local-delivery.page
index d64f268..bbe1476 100644
--- a/help/C/mail-receiving-options-local-delivery.page
+++ b/help/C/mail-receiving-options-local-delivery.page
@@ -41,8 +41,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-maildir-format-directories.page 
b/help/C/mail-receiving-options-maildir-format-directories.page
index 75cf4ad..e78fb26 100644
--- a/help/C/mail-receiving-options-maildir-format-directories.page
+++ b/help/C/mail-receiving-options-maildir-format-directories.page
@@ -42,8 +42,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-mh-format-directories.page 
b/help/C/mail-receiving-options-mh-format-directories.page
index fd109af..11ff2b1 100644
--- a/help/C/mail-receiving-options-mh-format-directories.page
+++ b/help/C/mail-receiving-options-mh-format-directories.page
@@ -41,8 +41,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-pop.page b/help/C/mail-receiving-options-pop.page
index 26a262d..11a903c 100644
--- a/help/C/mail-receiving-options-pop.page
+++ b/help/C/mail-receiving-options-pop.page
@@ -54,8 +54,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-unix-mbox-spool-directory.page 
b/help/C/mail-receiving-options-unix-mbox-spool-directory.page
index 310ccaa..86912e4 100644
--- a/help/C/mail-receiving-options-unix-mbox-spool-directory.page
+++ b/help/C/mail-receiving-options-unix-mbox-spool-directory.page
@@ -41,8 +41,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-unix-mbox-spool-file.page 
b/help/C/mail-receiving-options-unix-mbox-spool-file.page
index d32b71e..d1a758a 100644
--- a/help/C/mail-receiving-options-unix-mbox-spool-file.page
+++ b/help/C/mail-receiving-options-unix-mbox-spool-file.page
@@ -42,8 +42,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-usenet-news.page b/help/C/mail-receiving-options-usenet-news.page
index 2f433d2..8f1d7a1 100644
--- a/help/C/mail-receiving-options-usenet-news.page
+++ b/help/C/mail-receiving-options-usenet-news.page
@@ -52,8 +52,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-sending-options-smtp.page b/help/C/mail-sending-options-smtp.page
index 55097cf..da34213 100644
--- a/help/C/mail-sending-options-smtp.page
+++ b/help/C/mail-sending-options-smtp.page
@@ -38,7 +38,4 @@
 <item><p>Choose <gui>Use secure connection</gui> if you want to connect securely.</p></item>
 </list>
 
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in 
intro-first-run.page itself, so content is embedded there and expandable. See 
http://projectmallard.org/ui/1.0/ui_expanded.html and 
https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link 
xref="intro-first-run#account-information">here</link> to continue with the next step.</p>
-
 </page>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]