[digikam-doc] digikam: APlly new patch from Wolfgang to exlain how to use sidebar

Sat Jan 7 14:07:20 UTC 2017

Git commit e9a3189b2c0584e71b8a5fb68965e16533991c98 by Gilles Caulier, on behalf of Wolfgang Scheffner.
Committed on 07/01/2017 at 14:06.
Pushed by cgilles into branch 'master'.

APlly new patch from Wolfgang to exlain how to use sidebar

M  +18   -6    digikam/using-sidebar-filters.docbook
M  +-    --    digikam/using-sidebar-filters.png

https://commits.kde.org/digikam-doc/e9a3189b2c0584e71b8a5fb68965e16533991c98

diff --git a/digikam/using-sidebar-filters.docbook b/digikam/using-sidebar-filters.docbook
index 18e6236..cfa1d9a 100644
--- a/digikam/using-sidebar-filters.docbook
+++ b/digikam/using-sidebar-filters.docbook
@@ -1,22 +1,30 @@
 <sect2 id="using-sidebar-filters">
-    <title>Tag Filters</title>
+    <title>Filters</title>
 
         <para>
-            The tag filter sidebar is used to modify the set of images displayed in the main window view. Normally one uses the left sidebar with its Album, Date, Tags and Searches view. When additionally one or more tags on right sidebar tag filter is checked, only the cross-section of these two selections will be displayed. All created tags are available.
+            The <guilabel>Filters</guilabel> tab is used to limit the set of images displayed in the Image Area. Normally one uses the Left Sidebar with its different views to confine the images displayed for example to the content of an album or to images with a certain label assigned to them. The <guilabel>Filters</guilabel> tab on the Right Sidebar offers a number of filters and if one of these are filled in, selected or checked only the cross-section of these two selections will be displayed in the Image Area.
         </para>
 
         <para>
-            To give an example, suppose you have a tag called 'public' which tags all images except your private ones. Then you can check this 'public' tag in the right sidebar to hide the private images (all those not having 'public' tag). Whatever view mode you chose from the left sidebar, 'public' only image will be displayed. Another typical example is the selection of a subset of tags in a hierarchical tree. Suppose you want to display 'red' and 'green' from a tag tree containing 7 different colors as sub-tags. Simply click on the 'color' tag of the main view and check 'red' and 'green' from the right sidebar.
+            To give an example, suppose you have a tag called 'public' which tags all images except your private ones. Then you can check this 'public' tag in the Right Sidebar to hide the private images (all those not having 'public' tag). Whatever view mode you chose from the Left Sidebar, only 'public' images will be displayed. Another typical example is the selection of a subset of tags in a hierarchical tree. Suppose you want to display 'red' and 'green' from a tag tree containing 7 different colors as sub-tags. Simply click on the 'color' tag of the main view and check 'red' and 'green' from the Right Sidebar.
+        </para>
+        
+        <para>
+            You can also use a combination of the filters but here we have to look a little bit closer: The main filters and also the different types of labels in the Labels Filter (color, pick, rating) are connected with boolean AND which means that <emphasis>all</emphasis> selected filters have to fit for the images to be displayed. If you select 'JPG' in the MIME type filter and 'red' in the labels filter only those photographs from the selection on the Left Sidebar will be displayed that have JPG format AND are labeled 'red'.
+        </para>
+        
+        <para>
+            On the other hand the tags in the tag filter and the individual labels within one type of labels are connected with boolean OR as you might have noticed already in the public/private example above. That means if you check more than one tag in the Tags Filter all images with at least one of these tags applied will show up (as long as they are not ruled out by one of the other filters).
         </para>
 
         <para>
-            Another use is <emphasis>drag-and-drop tagging</emphasis>. Lets say you selected in the main view a number of images to tag them. If the tag already exists, simply drag it from the right sidebar onto the selection (any one of the highlighted images). A dialog will pop-up and ask if this tag should be applied.
+            Another use of this tab of the Right Sidebar is <emphasis>drag-and-drop tagging</emphasis>. Lets say you chose with the help of the Left Sidebar a number of images to tag them and they are now displayed in the Image Area. If the tag already exists, simply drag it from the Right Sidebar onto one of the icons. A dialog will pop-up and ask if this tag should be applied to this item only, to all items or, if there is more than one icon selected (highlighted), to the selected items.
         </para>
 
         <para>
             <inlinemediaobject>
                 <imageobject>
-                    <imagedata fileref="&path;using-sidebar-filters.png" format="PNG" />
+                    <imagedata fileref="&path;using-sidebar-filters.png" format="PNG"/>
                 </imageobject>
                 <textobject>
                     <phrase>Sidebar Tag Filters</phrase>
@@ -25,7 +33,11 @@
         </para>
 
         <para>
-            In the above example the main window shows the images from a calendar date, the tag filter is set to 'not tagged', which reduces the set to 3 images. They have been selected with Ctrl+a, then a tag is dragged from the right tag tree over the selection and dropped. A pop-up dialog asks if the tag shall be applied.
+            In the above example the main window shows the images from a calendar date, the tag filter is set to 'Oldtimer', which reduces the set to 3 images. In the Text Filter I typed <quote>Funeral</quote> which leaves only one picture of the only funeral car oldtimer in my collections. Then a tag is dragged from the Tag Filter over the icon and dropped. A pop-up dialog asks if the tag shall be applied to this item only or to all (displayed) items.
+        </para>
+        
+        <para>
+            Note that the Text Filter has a little drop-down menu to select which image information should be included in the search and the rating group in the Labels Filter has one to choose whether you want a certain rating or a range.
         </para>
 
 </sect2>
diff --git a/digikam/using-sidebar-filters.png b/digikam/using-sidebar-filters.png
index 70d8d48..f567451 100644
Binary files a/digikam/using-sidebar-filters.png and b/digikam/using-sidebar-filters.png differ
