[gimp-help] Fix issue #187

[Julien Hardlin <jhardlin src gnome org>]

commit f3f961116999abc1952321ea6f6e95b417e59607
Author: Julien Hardelin <jhardlin orange fr>
Date:   Thu Oct 31 16:14:27 2019 +0100

    Fix issue #187

 src/tutorial/quickies.xml | 280 ++++++++++++++++++++++------------------------
 1 file changed, 136 insertions(+), 144 deletions(-)
---
diff --git a/src/tutorial/quickies.xml b/src/tutorial/quickies.xml
index 5f5250159..4aec7e153 100644
--- a/src/tutorial/quickies.xml
+++ b/src/tutorial/quickies.xml
@@ -3,6 +3,7 @@
 "http://www.docbook.org/xml/4.3/docbookx.dtd";
 []>
 <!--  section history:
+  2019-10-31 Julien: fix issue #187 : rearrange display
   2015-12-19 Julien: adapted save -> export
   2011-04-02 Michael: rewrote tutorial
   2007-05-11 lexa: initial version
@@ -739,151 +740,142 @@
       </mediaobject>
     </figure>
     
-    <para>Sometimes you need to separate the subject of an image from its
-    background. You may want to have the subject on a flat color, or keep the
-    background transparent so you can use it on an existing background, or any
-    other thing you have in mind. To do this, you must first use 
-    <acronym>GIMP</acronym>'s selection tools to draw a selection around your
-    subject. This is not an easy task, and selecting the correct tool is
-    crucial. You have several tools to accomplish this.</para>
-    <para>The <quote>Free Select Tool</quote> allows you to draw a border 
-    using either freehand or straight lines. Use this when the subject has a 
-    relatively simple shape. Read more about this tool here: 
-    <xref linkend="gimp-tool-free-select" /></para>
-    
-    <figure float="0">
-      <title>Free Select Tool</title>
-      <mediaobject>
-        <imageobject>
+    <para>
+      Sometimes you need to separate the subject of an image from its
+      background. You may want to have the subject on a flat color, or keep the
+      background transparent so you can use it on an existing background, or 
+      any other thing you have in mind. To do this, you must first use 
+      <acronym>GIMP</acronym>'s selection tools to draw a selection around your
+      subject. This is not an easy task, and selecting the correct tool is
+      crucial. You have several tools to accomplish this:
+      <itemizedlist>
+        <listitem>
+          <para>
+            <emphasis role = "bold">The <quote>Free Select 
+            Tool</quote></emphasis> allows you to draw a border using either 
+            freehand or straight lines. Use this when the subject has a 
+            relatively simple shape. Read more about this tool here: 
+            <xref linkend="gimp-tool-free-select" />
+          </para>
+          <figure float="0">
+            <title>Free Select Tool</title>
+            <mediaobject>
+              <imageobject>
           <imagedata format="JPG" fileref="images/toolbox/toolbox-lasso.png" />
-        </imageobject>
-      </mediaobject>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="JPG"
-          fileref="images/tutorials/quickie-background-free-select.jpg" />
-        </imageobject>
-      </mediaobject>
-    </figure>
-    
-    <para>The <quote>Intelligent Scissors Select Tool</quote> lets you select 
-    a freehand border and uses edge-recognition algorithms to better fit the 
-    border around the object. Use this when the subject is complex but 
-    distinct enough against its current background. Read more about this tool 
-    here: <xref linkend="gimp-tool-iscissors" /></para>
-    
-    <figure float="0">
-      <title>Intelligent Scissors Select Tool</title>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="JPG"
-          fileref="images/toolbox/toolbox-scissor.png" />
-        </imageobject>
-      </mediaobject>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="JPG"
-          fileref="images/tutorials/quickie-background-scissors.jpg" />
-        </imageobject>
-      </mediaobject>
-    </figure>
-    
-    <para>The <quote>Foreground Select Tool</quote> lets you mark areas as 
-    <quote>Foreground</quote> or <quote>Background</quote> and refines the 
-    selection automatically. Read more about this tool here: 
-    <xref linkend="gimp-tool-foreground-select" /></para>
-    
-    <figure float="0">
-      <title>Foreground Select Tool</title>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="JPG"
-          fileref="images/toolbox/FG-select-toolbox.png" />
-        </imageobject>
-      </mediaobject>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="JPG"
-          fileref="images/tutorials/quickie-background-foreground-select.jpg" />
-        </imageobject>
-      </mediaobject>
-    </figure>
-    
-    <para>Once you have selected your subject successfully, use 
-    <menuchoice moreinfo="none">
-      <guimenu moreinfo="none">Select</guimenu>
-      <guimenuitem moreinfo="none">Invert</guimenuitem>
-    </menuchoice>. Now, instead of the subject, the background is selected.
-    What you do now depends on what you intended to do with the
-    background.</para>
-    
-    <itemizedlist>
-      <listitem>
-        <para>To fill the background with a single color:</para>
-        <para> 
-         Click the foreground color swatch (the top left of the two overlapping 
-         colored rectangles) in the toolbox and select the desired color. Next,
-         use <xref linkend="gimp-tool-bucket-fill"/> to replace the background 
-         with your chosen color.
-       </para>
-       
-        <figure float="0">
-          <title>Result of Adding a Plain Color Background</title>
-          <mediaobject>
-            <imageobject>
-              <imagedata format="PNG"
-              fileref="images/tutorials/quickie-background-color-result.png" />
-            </imageobject>
-          </mediaobject>
-        </figure>
-      </listitem>
-      
-      <listitem>
-        <para>To make a transparent background:</para>
-        <para>Use 
-        <menuchoice moreinfo="none">
-          <guimenu moreinfo="none">Layer</guimenu>
-          <guisubmenu moreinfo="none">Transparence</guisubmenu>
-          <guimenuitem moreinfo="none">Add Alpha Channel</guimenuitem>
-        </menuchoice> to add an alpha channel. Next, use 
-        <guimenu moreinfo="none">Edit</guimenu>
-        <guimenuitem moreinfo="none">Clear</guimenuitem> or hit the 
-        <keycap moreinfo="none">Del</keycap> key on the keyboard to remove the
-        background. Please note that only a small subset of file formats
-        support transparent areas. Your best bet is to save your image as
-        PNG.</para>
-        
-        <figure float="0">
-          <title>Result of Adding a Transparent Background</title>
-          <mediaobject>
-            <imageobject>
-              <imagedata format="PNG"
-              fileref="images/tutorials/quickie-background-alpha-result.png" />
-            </imageobject>
-          </mediaobject>
-        </figure>
-      </listitem>
+              </imageobject>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="JPG"
+                fileref="images/tutorials/quickie-background-free-select.jpg" />
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </listitem>
+        <listitem>
+          <para>
+            <emphasis role="bold">The <quote>Intelligent Scissors Select 
+            tool</quote></emphasis> lets you select a freehand border and uses 
+            edge-recognition algorithms to better fit the border around the 
+            object. Use this when the subject is complex but distinct enough 
+            against its current background. Read more about this tool here: 
+            <xref linkend="gimp-tool-iscissors" />
+          </para>
+          <figure float="0">
+            <title>Intelligent Scissors Select Tool</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="JPG"
+                fileref="images/toolbox/toolbox-scissor.png" />
+              </imageobject>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="JPG"
+                fileref="images/tutorials/quickie-background-scissors.jpg" />
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </listitem>
+        <listitem>
+          <para>
+            <emphasis role="bold">The <quote>Foreground Select 
+            Tool</quote></emphasis> lets you mark areas as  
+            <quote>Foreground</quote> or <quote>Background</quote> and refines 
+            the selection automatically. Read more about this tool here: 
+            <xref linkend="gimp-tool-foreground-select" />
+          </para>
+          <figure float="0">
+            <title>Foreground Select Tool</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="JPG"
+                fileref="images/toolbox/FG-select-toolbox.png" />
+              </imageobject>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="JPG"
+            fileref="images/tutorials/quickie-background-foreground-select.jpg"/>
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </listitem>
+      </itemizedlist>
+    </para>
+    <sect3><title>Once you have selected your subject</title>
+    <para>
+      Once you have selected your subject successfully, use 
+      <menuchoice moreinfo="none"><guimenu moreinfo="none">Select</guimenu>
+      <guimenuitem moreinfo="none">Invert</guimenuitem></menuchoice>. Now, 
+      instead of the subject, the background is selected. What you do now 
+      depends on what you intended to do with the background:
+      <itemizedlist>
+        <listitem>
+          <para>To fill the background with a single color:</para>
+          <para> 
+            Click the foreground color swatch (the top left of the two 
+            overlapping colored rectangles) in the toolbox and select the 
+            desired color. Next,use <xref linkend="gimp-tool-bucket-fill"/> 
+            to replace the background with your chosen color.
+          </para>
       
-      <listitem>
-        <para>To make a black-and-white background while keeping the subject in
-        color:</para>
-        <para>Use 
-        <menuchoice moreinfo="none">
-          <guimenu moreinfo="none">Colors</guimenu>
-          <guimenuitem moreinfo="none">Desaturate</guimenuitem>
-        </menuchoice>. In the dialog that opens, cycle between the modes and
-        select the best-looking one, then click OK.</para>
-        
-        <figure float="0">
-          <title>Result of Desaturating the Background</title>
-          <mediaobject>
-            <imageobject>
-              <imagedata format="PNG"
-              fileref="images/tutorials/quickie-background-desaturate-result.png" />
-            </imageobject>
-          </mediaobject>
-        </figure>
-      </listitem>
-    </itemizedlist>
+          <figure float="0">
+            <title>Result of Adding a Plain Color Background</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+            fileref="images/tutorials/quickie-background-color-result.png" />
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </listitem>
+        <listitem>
+          <para>
+            To make a black-and-white background while keeping the subject in
+            color:
+          </para>
+          <para>
+            Use 
+            <menuchoice moreinfo="none">
+            <guimenu moreinfo="none">Colors</guimenu>
+            <guimenuitem moreinfo="none">Desaturate</guimenuitem>
+            </menuchoice>. In the dialog that opens, cycle between the modes 
+            and select the best-looking one, then click OK.
+          </para>
+
+          <figure float="0">
+            <title>Result of Desaturating the Background</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+        fileref="images/tutorials/quickie-background-desaturate-result.png"/>
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </listitem>
+      </itemizedlist>
+    </para>
+  </sect3>
   </sect2>
 </sect1>