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

Reply via email to