[digikam-doc] digikam: Enhance markup

[Yuri Chornoivan]

Git commit 86b034bd6a8508cc4283b6ba682161654cc28fb6 by Yuri Chornoivan.
Committed on 07/02/2017 at 11:33.
Pushed by yurchor into branch 'master'.

Enhance markup

M  +17   -14   digikam/using-mainwindow-mapview.docbook

https://commits.kde.org/digikam-doc/86b034bd6a8508cc4283b6ba682161654cc28fb6

diff --git a/digikam/using-mainwindow-mapview.docbook b/digikam/using-mainwindow-mapview.docbook
index 72324e5..f4d241e 100644
--- a/digikam/using-mainwindow-mapview.docbook
+++ b/digikam/using-mainwindow-mapview.docbook
@@ -1,49 +1,52 @@
-<sect2 id="using-mainwindow-mapview" >   <title>Map View</title>
+<sect2 id="using-mainwindow-mapview" >
+   <title>Map View</title>
 
     <para>
         The whole &digikam; geolocation suite - if you want to call it that way ;-) - consists of three parts:
+    </para>
         <orderedlist numeration="arabic">
             <listitem><para>This view which is the search tool for finding images by their GPS data.</para></listitem>
             <listitem><para>The <link linkend="tool-geolocationeditor">Geolocation Editor</link> which is accessible via <menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>G</keycap></keycombo></shortcut><guimenu>Item</guimenu><guimenuitem>Edit Geolocation...</guimenuitem></menuchoice> and allows to set and to edit GPS data.</para></listitem>
             <listitem><para>The <link linkend="using-sidebar-maps">Map</link> tab on the Right Sidebar which shows the location of the image on a map and is purely informative.</para></listitem>
-        </orderedlist> 
-        All three are based on the Marble widget.  
+        </orderedlist>
+    <para>
+        All three are based on the &marble; widget.
     </para>
-    
+
     <para>
         <inlinemediaobject>
             <imageobject><imagedata fileref="&path;using-mainwindow-mapsearch.png" format="PNG" /></imageobject>
         </inlinemediaobject>
     </para>
-    
-    <para>     
-        For navigating on the map refer to Marble handbook, Chapter 2. The meaning of <quote>GPS</quote> and functions and buttons that apply to all three geolocation parts are described in the <link linkend="tool-geolocationeditor">Geolocation Editor</link> chapter of this handbook. This applies to the context menu on the map and the first line of buttons under the map except the last three. The designations I use here for the buttons is the content of the respective tooltip.
+
+    <para>
+        For navigating on the map refer to &marble; handbook, Chapter 2. The meaning of <quote>GPS</quote> and functions and buttons that apply to all three geolocation parts are described in the <link linkend="tool-geolocationeditor">Geolocation Editor</link> chapter of this handbook. This applies to the context menu on the map and the first line of buttons under the map except the last three. The designations I use here for the buttons is the content of the respective tooltip.
     </para>
-    
+
     <para>
         Usually you will begin searching for images by defining a region on the map. From the <quote>Search by area:</quote> buttons click the left one, the Select-images-by-drawing-a-rectangle button, then left-click one corner on the map, draw open a rectangle and left-click another corner. All images falling within the coordinates of that rectangle will be shown in the Image Area (provided your images have been geo-coded of course).
     </para>
-    
+
     <para>
         The next button to the right is the Create-a-region-selection-from-a-thumbnail button which creates a small region around the position of a marker or thumbnail if you click on it. If there are other images hidden behind it because they have the same position or one very close to the image you click on they will be shown in the Image Area.
     </para>
-    
+
     <para>
         The last button in this row is the Remove-the-current-region-selection button. Well, do I still have to explain that after all?  O.k., I should mention that it, of course, only removes the selection, not your precious pics :-)
     </para>
-    
+
     <para>
         Now let's have a look on the three buttons at the right end of the row right under the map. They control which images you see in the Image Area out of your defined region. Let's begin with the one at the very end of the row, the Select-images button. If you activate it, it will toggle the selection of a photograph (or a group of photographs if they are hidden behind each other) once you click on it on the map. This can be helpful to fine tune your selection before carrying out operations from the Right Sidebar or the menus.
     </para>
-    
+
     <para>
         The Filter-images button (the one with the funnel on it) will, other than the Select-images button who leaves all images from your defined region visible in the Image Area, switch off all other images and show only the one you clicked on. This is particular useful if the map is just showing markers or if the thumbnails are to small to clearly identify images.
     </para>
-    
+
     <para>
         The Remove-the-current-filter button is self explaining but I want to mention here that these three last buttons won't affect your defined search region which means that once you click the button with the white cross in a red circle all images in that region should be displayed again in the Image Area.
     </para>
-    
+
     <para>
         The <guilabel>Show Non-Geolocated Items</guilabel> button displays all images without GPS data in the Image Area. If this applies to many images from your collections it might be a good idea to use the Filters tab of the Right Sidebar and/or the sorting and grouping functions in the View menu additionally.
     </para>