[documentation/digikam-doc/sphinx] /: polish
Gilles Caulier
null at kde.org
Thu Dec 15 14:57:42 GMT 2022
Git commit cc15e7ef31c7d13921796efd70610e0cc2d53417 by Gilles Caulier.
Committed on 15/12/2022 at 14:57.
Pushed by cgilles into branch 'sphinx'.
polish
D +- -- attic/digikam/using-mainwindow-advsearch.png
D +0 -133 attic/digikam/using-mainwindow-albumsview.docbook
D +0 -30 attic/digikam/using-mainwindow-datesview.docbook
D +0 -64 attic/digikam/using-mainwindow-fuzzysearches.docbook
D +0 -223 attic/digikam/using-mainwindow-imageview.docbook
D +0 -106 attic/digikam/using-mainwindow-intro.docbook
D +0 -31 attic/digikam/using-mainwindow-labelsview.docbook
D +0 -61 attic/digikam/using-mainwindow-mapview.docbook
D +0 -126 attic/digikam/using-mainwindow-peopleview.docbook
D +0 -113 attic/digikam/using-mainwindow-searchesview.docbook
D +0 -151 attic/digikam/using-mainwindow-tagsview.docbook
D +0 -28 attic/digikam/using-mainwindow-timelineview.docbook
D +0 -24 attic/digikam/using-mainwindow.docbook
M +1 -1 main_window/map_view.rst
https://invent.kde.org/documentation/digikam-doc/commit/cc15e7ef31c7d13921796efd70610e0cc2d53417
diff --git a/attic/digikam/using-mainwindow-advsearch.png b/attic/digikam/using-mainwindow-advsearch.png
deleted file mode 100644
index 7e7db9c..0000000
Binary files a/attic/digikam/using-mainwindow-advsearch.png and /dev/null differ
diff --git a/attic/digikam/using-mainwindow-albumsview.docbook b/attic/digikam/using-mainwindow-albumsview.docbook
deleted file mode 100644
index 0e83873..0000000
--- a/attic/digikam/using-mainwindow-albumsview.docbook
+++ /dev/null
@@ -1,133 +0,0 @@
-<sect2 id="using-mainwindow-albumsview">
-<title>Albums View</title>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-albumview.png" format="PNG" /></imageobject>
- </mediaobject>
- </para>
-
- <para>
- By clicking the <quote>Albums</quote> button on the left side bar you toggle the <quote>Albums</quote> tree which provides an organized view of your photograph albums. The top item <quote>Albums</quote> just shows the <quote>welcome to &digikam;</quote> screen in the view area. The next level of the <quote>Albums</quote> tree shows your different Collections (marked by the <inlinemediaobject><imageobject><imagedata fileref="&path;using-mainwindow-icon-collection.png" format="PNG" /></imageobject></inlinemediaobject> icon) or at least one if you haven't added one or more yet in the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &digikam;...</guimenuitem></menuchoice> Collections section. Each Collection represents a folder branch on your hard disk, on removable media or on network shares and the next levels in the tree show the structure of those folders, here called <quote>Albums</quote>. The albums can be sorted by their folder layout on the hard disk, by the Category that has been set in the <link linkend="albumpropsedit.anchor">Album Properties</link> or by the Date of that Albums (this date can also be changed in the Properties of each Album). You can invert the sort order (ascending/descending) by clicking on the title bar of the album tree.
- </para>
-
- <para>
- You can switch between these sort orders using <guimenuitem>Sort Albums</guimenuitem> from the <guimenu>View</guimenu> menu.
- </para>
-
- <sect3 id="using-createnewalbum">
- <title>Creating a New Album</title>
-
- <para>
- There are a number of ways to create a new Album. You can create a new Album when you upload new photographs from the Camera using <menuchoice><guimenu>Import</guimenu> <guimenuitem>Cameras</guimenuitem></menuchoice>. You can also create a new empty Album with <menuchoice><guimenu>Album</guimenu> <guimenuitem>New...</guimenuitem></menuchoice> (<keycombo>&Ctrl;<keycap>N</keycap></keycombo>) in the <quote>Albums</quote> view. As an additional option, you can create a new Album by importing an existing folder of photographs from your computer; just select <menuchoice><guimenu>Import</guimenu> <guimenuitem>Add Folders...</guimenuitem></menuchoice> from the menu bar and select the folder that you want to import. An Album will be created with the same name as the hard disk folder. You can use drag and drop to import a folder. Drag a folder icon, for example from a &dolphin; window. Then drop it on the album list on the left. A menu will appear that gives you the option to move or copy the folder into &digikam;.
- </para>
-
- </sect3>
-
- <sect3 id="using-deletealbum">
- <title>Deleting an Album</title>
-
- <para>
- When you delete an Album from &digikam; it will be moved into the internal Trash Can. As an option you could change this behavior, so that delete really will remove the Album and all of the photographs in it. This can be changed by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &digikam;...</guimenuitem></menuchoice> and selecting the Miscellaneous page. At the top of this page are the settings that control what happens when a photograph is deleted. To delete an Album, click with the &RMB; over the Album in the <quote>Albums</quote> tree and select Delete Album from the context menu.
- </para>
-
- </sect3>
-
- <sect3 id="using-addphototoalbum">
- <title>Adding a Photograph to an Album</title>
-
- <para>
- Most of the time you will create new Albums and populate them with photographs directly from your camera using the Camera Tool. However, sometimes you may want to add a photograph that you already have on your computer to an existing Album. To add a photograph to an Album select <menuchoice><guimenu>Import</guimenu> <guimenuitem>Add Images...</guimenuitem></menuchoice> (<keycombo>&Ctrl;&Alt;<keycap>I</keycap></keycombo>) from the menu bar. Select a source folder from the dialog and click OK. An import window will open. Select the photographs that you want to add and choose <guilabel>Download Selected</guilabel> from the <quote>Download</quote> drop down menu. A dialog will open where you can choose the destination album. The photographs will be copied into the Album. <guilabel>Download New</guilabel> (<keycombo>&Ctrl;<keycap>N</keycap></keycombo>) from the same menu will copy only those images which are not in the destination folder yet.
- </para>
-
- <para>
- Additionally, you can use drag and drop to import photographs. Drag the photographs icons, for example from a &dolphin; window. Then drop it on the image list on the right hand side.
- </para>
-
- <para>
- If you have a scanner configured, you can also scan a photograph straight into an Album. Select
- <menuchoice><guimenu>Import</guimenu>
- <guimenuitem>Import from Scanner...</guimenuitem></menuchoice>.
- </para>
-
- </sect3>
-
- <sect3 id="using-movecopyitem">
- <title>Moving or Copying Photographs Between Albums</title>
-
- <para>
- Simply drag the photograph and drop it on the destination Album to move or copy it from one Album to another. A menu will appear that gives you the option to <guilabel>Move</guilabel> or <guilabel>Copy</guilabel> the photograph. You can move or copy multiple photographs the same way, just select all the photographs that you want to move and drag them on to the destination Album.
- </para>
-
- </sect3>
-
- <sect3 id="using-managealbums">
- <title>Managing Albums</title>
-
- <anchor id="albumpropsedit.anchor"/>
-
- <para>
- Album Properties can help you remember which kind of photographs are in an Album and can also help you to organize the <quote>Albums</quote> tree. To access the Album Properties, click with the &RMB; on an Album and select <guilabel>Properties</guilabel> (<keycombo>&Alt;&Enter;</keycombo>) from the context menu.
- </para>
-
- <para>
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-albumproperties.png" format="PNG"/></imageobject>
- </inlinemediaobject>
- </para>
-
- <para>The Album Properties dialog allows you to set:</para>
-
- <itemizedlist>
-
- <listitem><para>The Album <guilabel>Title</guilabel> : Name of the Album, identical with the name of the folder on your hard disk. If you edit it here, the folder will also be renamed.
- </para></listitem>
-
- <listitem><para>The Album <guilabel>Category</guilabel> : this is a way of grouping your Albums together by a common label. The Category you set will be used to order your albums when you select <guilabel>By Category</guilabel> from the drop down box in the tool bar or using <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem><guimenuitem>By Category</guimenuitem></menuchoice>. If you want to add and delete Category labels, choose from the menu <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &digikam;...</guimenuitem></menuchoice> and here the Album Category section.
- </para></listitem>
-
- <listitem><para>The <guilabel>Caption</guilabel> for the Album : Usually a short description of the content, but of course you are free to abuse it in any conceivable way. But beware: this will be shown in the banner at the top of the main Image Window ;-)
- </para></listitem>
-
- <listitem><para>The Album <guilabel>Date</guilabel> : this will be used when you order your Albums by date using <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem><guimenuitem>By Date</guimenuitem></menuchoice>.
- </para></listitem>
-
- <listitem><para><guilabel>Oldest, Average, Newest</guilabel> buttons : these will set the <guilabel>Date</guilabel> to the oldest, average or latest date of the images in that album. It will first try to calculate the average date of the images in the album based on the EXIF-headers. If that fails it will fall back to the modification date of the files in that folder.
- </para></listitem>
-
- </itemizedlist>
-
- </sect3>
-
- <sect3 id="using-setalbumicon">
- <title>Setting the Album Icon</title>
-
- <para>
- &digikam; displays the usual folder icon in the <quote>Albums</quote> list. You can choose one of your photographs instead. This may help you to remember what kind of photographs are contained in an Album.
- </para>
-
- <para>
- To select a photograph as the Album icon, click with the &RMB; on the photograph that you want to use as the Album icon and select <guimenuitem>Set as Album Thumbnail</guimenuitem> from the context menu. Additionally you can use drag and drop to set the Album icon. Drag the photographs icon from the thumbnail area and drop it on the currently selected Album in the Album list.
- </para>
-
- <note>
- <para>
- An Album can only be in one Album Collection and Album Collections cannot be nested.
- </para>
-
- <para>
- &digikam; also supports tagging individual photographs. Album Categories are different from photograph tagging because the Album Category applies to all the photographs in an Album rather than to individual photographs. You can use both Album Category and tagging to organize your photographs.
- </para>
- </note>
-
- </sect3>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-datesview.docbook b/attic/digikam/using-mainwindow-datesview.docbook
deleted file mode 100644
index 4f059f5..0000000
--- a/attic/digikam/using-mainwindow-datesview.docbook
+++ /dev/null
@@ -1,30 +0,0 @@
-<sect2 id="using-mainwindow-datesview">
- <title>Dates View</title>
-
- <para>
- <mediaobject>
- <imageobject>
- <imagedata fileref="&path;using-mainwindow-dateview.png" format="PNG" />
- </imageobject>
- </mediaobject>
- </para>
-
- <para>
- The Dates View organizes your photographs based on their dates. &digikam; uses either the
- EXIF date or, if no EXIF date is available, the last modification time of the file.
- </para>
-
- <para>
- When you select a month from the list, all images from that month are displayed in the Image Area.
- You can select days or weeks in the date sheet at the bottom of the Left Sidebar to show only the images from the selected dates.
- </para>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-fuzzysearches.docbook b/attic/digikam/using-mainwindow-fuzzysearches.docbook
deleted file mode 100644
index 129f179..0000000
--- a/attic/digikam/using-mainwindow-fuzzysearches.docbook
+++ /dev/null
@@ -1,64 +0,0 @@
-<sect2 id="using-mainwindow-fuzzysearches">
- <title>Fuzzy View</title>
-
- <para>
- &digikam; characterizes every image by a lengthy number using a special technique (Haar algorithm) that makes it possible to compare images by comparing this calculated signature. The less numerical difference there is between any two image signatures, the more they resemble each other. This technique has three implementations in &digikam;:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- Duplicates: before you can have &digikam; finding duplicates the signatures (or fingerprints) have to be calculated. You can start that process with the button <guilabel>Update fingerprints</guilabel> which initiates a total rebuild of the image signatures (may take hours if you have a large collection, an estimate is 2 hours for 10'000 images). Once the fingerprints are calculated you can use <guilabel>Find duplicates</guilabel>, but it will take a long time too as it has to compare every image with any other image. So the way to go in both cases is to confine your search to certain albums and/or tags. With the Similarity range you can narrow down or enlarge the search result. Note that by lowering the upper threshold a little bit below 100 % you can keep things like exact copies, images from series shots, &etc; out of the search result if you want.
- </para>
-
- <example>
- <title>Find duplicates while restricting to an album</title>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-duplicates-albumsfilter.png" format="PNG"/></imageobject>
- </mediaobject>
- </example>
-
- <para>
- An overview of the result will be given in the Left Sidebar. The first column shows the reference images of each single result. The Items column tells you how many images belong to each result including the reference image. The last column shows the average similarity which gives you an idea about how similar the images of every result might be. The reference image with its 100 % is <emphasis>not</emphasis> included in the average. Note that the results can be sorted by clicking on one of the column headers.
- </para>
-
- <para>
- Individual similarity values for each item can be obtained in the table view of the Image Area (<guilabel>Table</guilabel> button on the Main Toolbar). Click with the &RMB; over one of the column headers and select <guilabel>Similarity</guilabel> from <guilabel>Item properties</guilabel> to display the similarity column. By clicking on the header of this column then the results will be sorted by similarity grouped by reference images. Clicking repeatedly on the header will toggle between ascending and descending order.
- </para>
- </listitem>
-
- <listitem>
- <para id="find-similar">
- Image (Similar items): This is a drag&drop zone where you can drop any image to find a similar one. Drag an image from anywhere, even from outside &digikam; (file manager, other programs), over the fuzzy search icon in the left sidebar, it will open and you drop it there or use <guilabel>Find Similar...</guilabel> from the context menu of a thumbnail in any other view. You can narrow down or enlarge the resulting selection with the similarity range here as well. In the field below you can enter a name for the search and save it. In the searches list below you find your saved searches. Clicking on the title bar of that list toggles the sorting order between ascending and descending. At the bottom you find an adaptive search field which can help you to find a particular search.
- </para>
-
- <example>
- <title>Fuzzy search for similar image</title>
- <mediaobject><imageobject><imagedata fileref="&path;using-mainwindow-searchsimilar.png" format="PNG"/></imageobject></mediaobject>
- </example>
- </listitem>
-
- <listitem>
- <para>
- Sketch: free hand color sketching: draw a quick sketch and &digikam; will find corresponding images. You will find the same means to save your search as in the <guilabel>Image</guilabel> tab.
- </para>
-
- <example>
- <title>Fuzzy search by sketch</title>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-searchsketch.png" format="PNG"/></imageobject>
- </mediaobject>
- </example>
- </listitem>
-
- </itemizedlist>
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-imageview.docbook b/attic/digikam/using-mainwindow-imageview.docbook
deleted file mode 100644
index e376ca3..0000000
--- a/attic/digikam/using-mainwindow-imageview.docbook
+++ /dev/null
@@ -1,223 +0,0 @@
-<sect2 id="using-mainwindow-imageview">
-<title>Image Area</title>
-
- <sect3>
- <title>General Information</title>
-
- <para>
- In all eight views the Image Area shows the result of your selection or search on the Left Sidebar in the Icon Area. Each image is displayed as a thumbnail. You can alter the size of the thumbnails using the magnifier slider close to the right end of the status bar.
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-zoombuttons.png" format="PNG"/></imageobject>
- </mediaobject>
- </para>
-
- <para>
- The first time you select an Album you may have to wait briefly while the thumbnails are generated.
- </para>
-
- <para>
- Information about each photograph is displayed below each thumbnail. You can control what information is displayed from the
- <menuchoice>
- <guimenu>Settings</guimenu>
- <guimenuitem>Configure &digikam;...</guimenuitem>
- </menuchoice>
- dialog. Select the <guilabel>Album View</guilabel> page and look for the <guilabel>Icon-View Options</guilabel> section.
- </para>
-
- <para>
- The thumbnails have <firstterm>Tool Tips</firstterm> which will pop up if you allow the mouse to dwell over a thumbnail for a moment. The Tool Tip shows the most important properties of the photograph including any tags that you have applied.
- </para>
-
- <para>
- <screenshot><mediaobject><imageobject><imagedata fileref="&path;using-mainwindow-tooltip.png" format="PNG" /> </imageobject></mediaobject></screenshot>
- </para>
-
- <para>
- The content of the Tool Tips can be configured in the Tool Tip section of
-
- <menuchoice>
- <guimenu>Settings</guimenu>
- <guimenuitem>Configure &digikam;...</guimenuitem>
- </menuchoice>
- </para>
-
- <para>
- As an alternative you can display the photographs in a table by hitting the <menuchoice><guimenu>Table</guimenu></menuchoice> button on the Main Toolbar or by selecting <menuchoice><guimenu>View</guimenu><guimenuitem>Table</guimenuitem></menuchoice> menu from the menu bar. This allows to see a lot of photographs at the same time (Tip: leave away the thumbnail column) in a way you can customize the usual way by clicking with the &RMB; on the headline bar and choosing the information you want to see. Clicking with the &LMB; on a line in the table will open the preview of that photograph.
- </para>
-
- <para>
- You can access most of the functions that &digikam; can perform on a photograph by clicking with the &RMB; over the thumbnail or line in the table (context menu) or by selecting from the <menuchoice><guimenu>Item</guimenu></menuchoice> menu in the menu bar.
- </para>
-
- </sect3>
-
- <sect3 id="using-imageviewing">
- <title>Viewing an image</title>
-
- <para>
- There are several possibilities to view an image. You can either click on it, select
- <menuchoice>
- <shortcut><keycombo action="press"><keycap>F3</keycap></keycombo></shortcut>
- <guimenu>View</guimenu><guimenuitem>Preview Image</guimenuitem>
- </menuchoice>
- from the menu bar or select <guilabel>Preview Image</guilabel> from the context menu. The Preview Area will open and the Icon Area will be reduced to one line. For viewing it larger, click the sidebars away (by just clicking on the active button on them). An even larger view you can achieve by clicking the <quote>Show Fullscreen</quote> icon
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-icon-fullscreen.png" format="PNG"/> </imageobject>
- </inlinemediaobject>
- either on the thumbnail or on the preview. While viewing images you can take action from the context menu at any time (not in fullscreen mode). To close the preview, just click again or press
- &Esc;
- or
- <keycap>F3</keycap>
- or click the
- <menuchoice><guimenu>Table</guimenu></menuchoice> or
- <menuchoice><guimenu>Thumbnails</guimenu></menuchoice> button.
- </para>
-
- <para>
- </para>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-preview.png" format="PNG"/></imageobject>
- </mediaobject>
- </para>
-
- <para>
- You can also view your images in a slideshow using the <quote>Slideshow</quote> drop down menu from the Main Toolbar. You have the choice to start a slideshow with a selection of photographs, the whole content of the folder (or search result) or even including all subfolders.
- </para>
-
- </sect3>
-
- <sect3 id="using-imageediting">
- <title>Editing a Photograph</title>
-
- <para>
- You can open the Image Editor on a photograph either clicking the <guilabel>Image Editor</guilabel> button on the Main Toolbar or by selecting
- <menuchoice>
- <shortcut><keycap>F4</keycap></shortcut>
- <guimenu>Item</guimenu><guimenuitem>Open...</guimenuitem>
- </menuchoice>
- from the menu bar or clicking with the &RMB; and selecting <guilabel>Open...</guilabel> from the context menu. See the <link linkend="editor-using">&digikam; Image Editor</link> section for instructions on how to edit your photographs. The Image Editor offers a wide range of tools to enhance, decorate and/or modify your photographs.
- </para>
-
- </sect3>
-
- <sect3 id="using-externalapp">
- <title>Viewing or Editing a Photograph With Another Application</title>
-
- <para>
- Sometimes &digikam; may not provide all of the capabilities you need. You can open a photograph in another application by clicking with the &RMB; on it and selecting from the <guilabel>Open With...</guilabel> sub-menu (At the moment this function is available only under &Linux;). The list of applications that appear in this menu is controlled by the standard desktop file associations for the image format type of this photograph. Consult the desktop manual for instructions on changing these file associations if the application that you need is not listed.
- </para>
-
- <para>
- Note that there can be a problem with meta-data embedded in photographs when they are edited by other image manipulation applications. Some applications do not retain the photograph's meta-data when you save a modified image. This means that if you modify a photograph using one of these programs you will lose information such as orientation, aperture &etc; that are stored in the EXIF and IPTC tags.
- </para>
-
- </sect3>
-
- <sect3 id="using-rotateimage">
- <title>Lossless Image Rotation</title>
-
- <note><para>
- There is a difference between rotating a photograph in one of the Views of &digikam; or in the Image Editor. The Image Editor uses a different method of rotating an image, you may not notice any difference but the Image Editor method can cause some loss of quality in the photograph when saving the picture as JPEG. The rotation methods described here preserve the original quality of the photograph also in JPEG - Files.
- </para></note>
-
- <para>
- &digikam; provides two ways to get your photographs the right way up. The simplest method is to click one of the rotate icons on the thumbnail or the preview or to click with the &RMB; for the context menu and select <guilabel>Rotate</guilabel> and then pick the direction of rotation needed.
- </para>
-
- <para>
- The second method is to select
- <menuchoice>
- <guimenu>Item</guimenu><guimenuitem>Auto Rotate/Flip Using EXIF Information</guimenuitem>
- </menuchoice>
- from the menu bar. Most digital cameras have an orientation sensor. This sensor can detect how you hold the camera while taking an image. It stores this orientation information inside the image. This meta data is stored in an embedded meta-data section called EXIF. The cameras could rotate the image themselves right away, but they have limited processing power, so they leave this job to an application like &digikam;. If the camera is storing the orientation, then &digikam; can use it to automatically rotate your photographs so that they are the correct way up when you display them. &digikam; will rotate the image on disk according to this orientation information.
- </para>
-
- <para>
- The photograph is rotated without loss of quality and the orientation information is set to normal, so that other EXIF-aware applications will handle it correctly. The <link linkend="camerainterface.anchor">Import Tool</link> can perform this operation automatically when it uploads the photographs from your camera which will ensure that your photographs are always the right way up. The rotate operation will do nothing if your camera does not include this information in the photos.
- </para>
-
- </sect3>
-
- <sect3 id="using-renameimage">
- <title>Renaming a Photograph</title>
-
- <para>
- You can change the filename for a photograph by clicking with the &RMB; over a thumbnail and selecting
- <menuchoice>
- <shortcut><keycap>F2</keycap></shortcut>
- <guimenu>Rename</guimenu>
- </menuchoice>. Remember to keep the file extension (.jpg, .tif, &etc;).
- </para>
-
- <para>
- You can also batch rename photographs. One method is to use the <link linkend="bqm.anchor">Batch Queue Manager</link> (B). Another one is to select multiple photographs and then press <keycap>F2</keycap>. A dialog will open showing the list of selected photographs with their current name and the new name. These two are identical at first until you place the cursor in the input field, type in something and/or select a modifier from the buttons below. Make use of the tooltips!
- </para>
-
- </sect3>
-
- <sect3 id="using-deleteimage">
- <title>Deleting a Photograph</title>
-
- <para>
- When you delete a photograph from &digikam; with
- <menuchoice>
- <shortcut><keycombo action="simul">∇</keycombo></shortcut>
- <guimenu>Item</guimenu><guimenuitem>Move to Trash</guimenuitem>
- </menuchoice>
- it will be moved from its folder on the hard disk to the internal Trash Can.
- </para>
-
- <para>Deleting works from anywhere in any &digikam; window.</para>
-
- </sect3>
-
- <sect3 id="using-groupimages">
- <title>Grouping Photographs</title>
-
- <para>
- Grouping items is a very useful way to organize Photographs and/or videos that are related to each other and to adjust the way they are displayed in the image area. This function is available through the context menu on a selection of items (more than one item selected).
- </para>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-group.png" format="PNG"/></imageobject>
- </mediaobject>
- </para>
-
- <para>
- You can put the whole selection into one group using <guilabel>Group Selected Here</guilabel> or you can create more than one group determined by time (seconds will be ignored) or by file name. Note that the latter will put items with the same name but different file types into one group. Use case see further below!
- </para>
-
- <para>
- The next group in the menu is to control whether only the reference icon of the group (the first of the group according to the sorting order at the moment of grouping) is displayed or all of them. These two functions can also be accessed by the little grouping indicator (folder symbol) on the reference icon (see upper left icon on the screenshot). While the mouse pointer is hovering over it there will pop up an information <quote>n grouped items. Group is closed/open.</quote> where n indicates the number of items in the group which are invisible if the group is closed. Clicking on the indicator toggles between open and closed. In the Table mode of the Image Area groups are indicated the way we know from many other lists and tables: with a little triangle in front of the reference item. Clicking on this triangle will fold out/in the grouped items.
- </para>
-
- <para>
- The last group in the Group context menu allows to remove individual items from the group or to disband the whole group. The content of the menu will change depending on whether you use it on a selection of still un-grouped items, on a group or on single items of a group.
- </para>
-
- <para>
- What can you do with a group? In terms of functions of &digikam; you can perform a lot of operations like copy, delete, move, rotate on the whole group by selecting only the reference icon provided the group is closed. The same way you can load the whole group into tools like Light Table or the Batch Queue Manager, even into the Image Editor where you can navigate through the group members with the page keys on your keyboard. You can assign tags and labels (see further below in this chapter) and also write descriptions (see <link linkend="using-sidebar-captions">Captions</link>). Give it a try!
- </para>
-
- <para>
- In terms of use cases you can for instance group videos together with the .jpg - images related to them which most cameras provide or RAW images with their JPG counterpart. This is made easy by <guilabel>Group Selected By Filename</guilabel>. In the screenshot above exposure bracketed images are being grouped. One could do the same for archiving purposes with images used for a panorama. If you have very specific requirements for documenting of editing steps the <link linkend="using-sidebar-versions">Versions</link> function of &digikam; cannot meet you may find a solution using grouping. I can think of more use cases for grouping but I don't want to overload this section of the handbook here. Maybe a last hint for your own ideas: grouping is not restricted to items out of the same album. The whole group (open or closed) will only be visible in the album of the reference item. The other members of the group will be visible in their own albums only if the group is open. Can be confusing, use with care!
- </para>
-
- <note><para>
- Everything described in this Grouping section has nothing to do with <guilabel>Group Images</guilabel> in the View menu. That function doesn't form permanent groups of items, it only organizes the way icons are displayed in the Image Area.
- </para></note>
-
- </sect3>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag:
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-intro.docbook b/attic/digikam/using-mainwindow-intro.docbook
deleted file mode 100644
index 3d82fe1..0000000
--- a/attic/digikam/using-mainwindow-intro.docbook
+++ /dev/null
@@ -1,106 +0,0 @@
-<sect2 id="using-mainwindow-intro">
- <title>Introduction to the Main Window</title>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-preview.png" format="PNG" /></imageobject>
- </mediaobject>
- </para>
-
- <sect3 id="using-areasandbars">
- <title>Areas and Bars</title>
-
- <para>
- &digikam;'s main window has two areas in the center showing your photographs. One is the <firstterm>Icon Area</firstterm>, showing thumbnails of the content of the selected album or of a search result, and the other one the <firstterm>Preview</firstterm>, showing the selected image. Together let's call them the <link linkend="using-mainwindow-imageview">Image Area</link>. In the top left corner of the Preview we have a few buttons for moving back and forth through the content of the album, for rotating the image, for showing or adding face tags and to switch to full screen mode. By clicking on the preview you can make it disappear and by clicking on the picture area of a thumbnail open it again.
- </para>
-
- <para>
- The Image Area in the center is surrounded by the menu bar and the <link linkend="maininterface-toolbar">Main Toolbar</link> at the top, the <link linkend="maininterface-statusbar">Status Bar</link> at the bottom and the Left and <link linkend="using-sidebar-intro">Right Sidebar</link>. The Left Sidebar lets you switch between nine <quote>Views</quote>: Albums (shown here), Tags, Labels, Dates, Timeline, Search, Fuzzy (Search), Map and People (Tags). The Right Sidebar can be used to show all information about your images and partly also to edit them. You can use all these views to organize and find your photographs. If you click on one of the buttons on the sidebars there will fold out another area, offering possibilities to select, to make inputs, ⪚ for searches, to edit data and to show information.
- </para>
-
- <para>
- Don't worry if your main window looks quite different at the moment. You will soon learn how to switch the different areas on and off and at some point you might get a look very similar to the above screenshot.
- </para>
-
- <para>
- Drag & Drop of images works about everywhere: d&d an image into another branch of the album tree, across the horizontal album separation line, or to another application window. The only restriction is that you cannot d&d into tag, date or searches.
- </para>
-
- </sect3>
-
- <sect3 id="maininterface-statusbar">
- <title> The Status Bar</title>
-
- <para>The status bar at the bottom shows in all eight views:
- <itemizedlist>
- <listitem><para>the file name when selecting a single file</para></listitem>
- <listitem><para>selection information when several items are selected</para></listitem>
- <listitem><para>Quick filters:</para>
- <para>- Information how many filters are active</para>
- <para>- a trash bin button to reset all active filters</para>
- <para>- a funnel button to open the filter settings panel</para>
- </listitem>
- <listitem><para>a progress bar for batch processes, ⪚ assigning tags</para></listitem>
- <listitem><para>a thumbnail and preview size slider with buttons for "Fit to Window" and "Zoom to 100%"</para></listitem>
- <listitem><para>a size selection pop up list in % for the preview</para></listitem>
- </itemizedlist>
- </para>
-
- </sect3>
-
- <sect3 id="maininterface-toolbar">
- <title> Main Toolbar</title>
- <para>
- The window top shows the Menu Bar and the <firstterm>Main Toolbar</firstterm> below.
- </para>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-toolbar.png" format="PNG"/></imageobject>
- </mediaobject>
- </para>
-
- <para>
-
- <orderedlist>
-
- <listitem><para>Open Image Editor with the selected image</para> </listitem>
-
- <listitem><para>Open Light Table (L)</para> </listitem>
-
- <listitem><para>Open <link linkend="bqm.anchor">Batch Queue Manager</link> (B)</para></listitem>
-
- <listitem><para>Import (drop down menu showing all connected cameras and mass storage devices)</para></listitem>
-
- <listitem><para>Switch to thumbnail view</para></listitem>
-
- <listitem><para>Toggle preview of selected image</para></listitem>
-
- <listitem><para>Switch to map view to display images with geolocation data</para></listitem>
-
- <listitem><para>Switch to configurable table view</para></listitem>
-
- <listitem><para>Slideshow drop down menu</para></listitem>
-
- <listitem><para>Toggle Full Screen (<keycombo>&Ctrl;&Shift;<keycap>F</keycap></keycombo>)</para></listitem>
-
- <listitem><para>Link to digikam.org, also an indicator for ongoing processes</para></listitem>
-
- </orderedlist>
-
- </para>
-
- <para>
- You can customize the Toolbar by choosing <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> or click with the &RMB; on it and choose <guimenuitem>Configure Toolbars...</guimenuitem> from the context menu.
- </para>
- </sect3>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-labelsview.docbook b/attic/digikam/using-mainwindow-labelsview.docbook
deleted file mode 100644
index ec5e565..0000000
--- a/attic/digikam/using-mainwindow-labelsview.docbook
+++ /dev/null
@@ -1,31 +0,0 @@
-<sect2 id="using-mainwindow-labelsview">
- <title>Labels View</title>
-
- <para>
- The Labels View allows you to select photographs by the Rating, Pick and Color labels you assigned to them previously either by using the context menu of a thumbnail or the <guilabel>Description</guilabel> tab of the <guilabel>Captions/Tags</guilabel> section on the Right Sidebar.
- </para>
-
- <para>
-
- <mediaobject>
- <imageobject>
- <imagedata fileref="&path;using-mainwindow-labelsview.png" format="PNG" />
- </imageobject>
- </mediaobject>
-
- </para>
-
- <para>
- You may select more than one label by <keycombo action="simul">&Ctrl;<mousebutton>left</mousebutton></keycombo> click. The selected labels are connected by boolean AND, ⪚ selecting Four Star and Yellow will display only photographs that have <emphasis>both</emphasis> labels assigned. You can perform even more sophisticated searches by using the <guilabel>Filters</guilabel> section of <link linkend="using-sidebar-filters">The Right Sidebar</link>.
- </para>
-
-</sect2>
-
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-mapview.docbook b/attic/digikam/using-mainwindow-mapview.docbook
deleted file mode 100644
index 561acbe..0000000
--- a/attic/digikam/using-mainwindow-mapview.docbook
+++ /dev/null
@@ -1,61 +0,0 @@
-<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 four parts:
- </para>
- <orderedlist numeration="arabic">
- <listitem><para>
- The Map mode of the Image Area which displays images with GPS data on a map depending on the selection on the Left Sidebar, ⪚ the images in the album you selected in the Album View, the images with a certain tag assigned (selected in the Tag View), with a certain label and so on.
- </para></listitem>
- <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>
- <para>
- All four 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>
-
- <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 click with the &LMB; over one corner on the map, draw open a rectangle and click with the &LMB; over 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 too 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 <guimenu>View</guimenu> menu additionally.
- </para>
-
- <para>
- In the box below you can enter a name for your geo filter. It will be added to the list view below for future reference once you click the save button to the right of it, it acts as a live geo folder. The search field at the bottom searches in the Searches list above.
- </para>
-
-</sect2>
diff --git a/attic/digikam/using-mainwindow-peopleview.docbook b/attic/digikam/using-mainwindow-peopleview.docbook
deleted file mode 100644
index 80cbfb4..0000000
--- a/attic/digikam/using-mainwindow-peopleview.docbook
+++ /dev/null
@@ -1,126 +0,0 @@
-<sect2 id="using-mainwindow-peopleview">
- <title>People View</title>
-
- <para>
- As long as you are not just taking pictures from machines or stars or something like that, Face Management might be an interesting feature for you (even with a machine there might be a human being operating it). In &digikam; it consists of two tasks: Face Detection and Face Recognition.
- </para>
-
- <sect3> <title>Face Detection</title>
-
- <para>
- The first step is to have &digikam; finding all those pics that show faces not even knowing yet who's face it is. To prepare that process you click <guilabel>Scan collection for faces</guilabel> which will open the Scanning faces dialog. Right under the header you have a drop down menu where you can choose between
- <itemizedlist>
- <listitem>
- <para>Skip images already scanned</para>
- </listitem>
- <listitem>
- <para>Scan again and merge results</para>
- </listitem>
- <listitem>
- <para>Clear unconfirmed results and rescan</para>
- </listitem>
- </itemizedlist>
- </para>
-
- <para>
- The first one you would choose if you didn't scan yet or if you did with a satisfying result but added new photographs since then or if you already improved a search result, ⪚ by removing face tags which obviously don't show a face. The second you would choose if you want the images already scanned to be included in the next scan. The third is more interesting in the context of Face Recognition since <quote>unconfirmed results</quote> means face tags that don't have a name assigned to them yet.
- </para>
-
- <para>
- For the task we are talking about you check <guilabel>Detect faces</guilabel>, of course. Since face detection is a time-consuming task you better <emphasis>don't</emphasis> hit <guilabel>Scan</guilabel> right away, rather <guilabel>Options</guilabel>. An additional area will fold out organized with three tabs. In <guilabel>Albums</guilabel> you can confine the scan to certain albums or tags. In <guilabel>Parameters</guilabel> you can try to find a balance between speed and accuracy that suits your needs. Under <guilabel>Advanced</guilabel> you will find two checkboxes. The first is explained by the text above it. The second is for face recognition, see next article.
- </para>
-
- <para>
- Once you have chosen your options carefully you click <guilabel>Scan</guilabel> and after a while, depending on the scope of your selection, the result will be presented in the Image Area. In the Tags list of the Left Sidebar you will see the People branch of your tag tree. You will see the whole scan result only if the topmost tag <quote>People</quote> is selected. In the tree you will see a new virtual tag called <quote>Unknown</quote> which will show all those images where faces are recognized but not yet connected to a person. If you just scanned for the first time you will find the whole result also here.
- </para>
-
- <para>
- <example>
- <title>Face Detection result</title>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-facedetection.png" format="PNG" /></imageobject>
- </mediaobject>
- </example>
- </para>
-
- <para>
- Note that the thumbnails presented here are not showing the whole image. They show the area of the image where the scan algorithm put down a <firstterm>Face Tag</firstterm>. You can see that if you click on the thumbnail. In the preview that opens you will see the whole image with all the face tags on them. If you don't see them, click the
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-icon-showfacetags.png" format="PNG" /></imageobject>
- </inlinemediaobject>
- button in the upper left corner of the preview. If there is more than one face tag on the image it will also be represented by more than one thumbnail. In the screenshot above this is the case with the two topmost thumbnails.
- </para>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-facedetectiontag.png" format="PNG" /></imageobject>
- </mediaobject>
- </para>
-
- <para>
- This screenshot image have been chosen because it shows one important issue: the algorithm will find inevitably details in an image that resemble a face but are actually something else. That's what the <guilabel>Remove</guilabel> button is for. It will remove the face tag from the photograph and if it is the only face tag (left) the photograph will disappear from the scan result.
- </para>
-
- <para>
- If it really is a face the field labeled "Who is this?" comes into play. Here you can either type in the name of an existing People tag out of your tag tree or use the drop down function to show your tag tree and select a tag. With <guilabel>Confirm</guilabel> you can save that to the database. If it was the only face tag (left) the image will disappear from the <quote>Unknown</quote> selection and you will find it once you select either the <quote>People</quote> tag or one of the tags you assigned to one of the face tags in that image.
- </para>
-
- <para>
- In the context menu of the preview there are two more items related to face tags: <guilabel>Add a Face Tag</guilabel> and <guilabel>Clear all faces on this image</guilabel>.
- </para>
-
- </sect3>
-
- <sect3> <title>Face Recognition</title>
-
- <para>
- Assigning People tags to face tags is an important prerequisite to Face Recognition. Very obviously &digikam; can only recognize faces if it has something to compare with. So it's up to you to show it the ropes, which means in this case to tell &digikam;: This is Lara, this is Juan, this is Peter and so forth. For that you would, after performing a Face Detection as described in the previous article, typically select the <quote>unknown</quote> tag on the Left Sidebar, click on a thumbnail and click, if necessary, on the
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-icon-showfacetags.png" format="PNG" /></imageobject>
- </inlinemediaobject>
- (Show Face Tags) button. Now you should see the face tags of that photograph. Those which have a people (or other) tag already assigned will simply show the name of that tag. The others, showing <quote>unknown</quote> faces, will show a field and two buttons as in the screenshot of the previous article. In the field labeled "Who is this?" you can either type in the name of an existing People tag out of your tag tree or use the drop down function to show your tag tree and select a tag. With <guilabel>Confirm</guilabel> you can save that to the database.
- </para>
-
- <note>
- <para>
- If you use the context menu item <guilabel>Assign Tag</guilabel> instead of the procedure described above that will <emphasis>not</emphasis> assign a face tag. It will assign an ordinary tag and it will assign it to the whole image.
- </para>
- </note>
-
- <para>
- If a face tag is confirmed and thus showing only the name of the tag but not the buttons to remove, edit or confirm it, but you need this buttons because ⪚ it's wrong and you want to edit or remove it, just double-click on the name and the buttons will re-appear.
- </para>
-
- <para>
- Once you have a tag assigned to a few photographs you can have &digikam; looking if it can find more photographs showing the same face. To prepare that process you click <guilabel>Scan collection for faces</guilabel> but this time you select <guilabel>Recognize faces</guilabel>.
- </para>
-
- <note>
- <para>
- To be able to recognize a new face automatically, a minimum of 4 similar faces tagged in different images need to be previously trained using manual face management workflow.
- </para>
- </note>
-
- <para>
- Face Recognition is faster than Face Detection but it still makes sense to click <guilabel>Options</guilabel> and confine the scan to certain albums or tags in the <guilabel>Albums</guilabel> tab, ⪚ to the "Unknown" tag. In the <guilabel>Parameters</guilabel> tab we can play with the balance between speed and accuracy. Under <guilabel>Advanced</guilabel> you will find two checkboxes. The first is explained by the text above it.
- </para>
-
- <para>
- In case of unsatisfying results it might be helpful to use <guilabel>Clear and rebuild all training data</guilabel>. One reason can be that there are too many face tags assigned to a person which shows this person in a way that doesn't really help the search algorithm, ⪚ with sunglasses, blurred, unusual colors, carnival make up, dark shaded areas in the face, baby/kid/adult photographs mixed... Another reason to use that option can be false face recognition due to a wrong accuracy setting in the <guilabel>Parameters</guilabel> tab.
- </para>
-
- <para>
- To start the Face Recognition you click <guilabel>Scan</guilabel>. The process will tag every recognized face with the appropriate People tag out of your tag tree and the corresponding thumbnail will disappear from the "Unknown" tag selection.
- </para>
-
- </sect3>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-searchesview.docbook b/attic/digikam/using-mainwindow-searchesview.docbook
deleted file mode 100644
index 775006c..0000000
--- a/attic/digikam/using-mainwindow-searchesview.docbook
+++ /dev/null
@@ -1,113 +0,0 @@
-<sect2 id="using-mainwindow-searchesview">
- <title>Search View</title>
- <para>
- We talked about quite a few views already and their searching capabilities, which are all kind of specialized. The Search View now offers a more versatile and general way of searching. There are two different approaches.
- </para>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-searchview.png" format="PNG" /> </imageobject>
- </mediaobject>
- </para>
-
- <sect3> <title>The Quick Search</title>
- <anchor id="quicksearchtool.anchor"/>
-
- <para>
- Quick Search is the adaptive search box at the top of the search dialog (Left Sidebar) and provides you with a simple means to search the &digikam; database with a single query. You can enter any arguments in the <guilabel>Search:</guilabel> text field and it will be used to determine the results. For instance, you can enter the string 'birthday' to search the complete database for occurrences of the word 'birthday' in all metadata text fields, or '05.png' to search for a specific image file name '05.png' (no escaping as in regexpressions needed).
- </para>
-
- <para>Search Properties:
- <itemizedlist>
- <listitem><para>searches are case insensitive</para></listitem>
- <listitem><para>blank separated search terms are boolean AND combinations</para></listitem>
- <listitem><para>special characters are literal and not interpreted ( . * ? / &etc;)</para></listitem>
- <listitem><para>include all elements of the database: names, rating, keywords, tags, albums, collections, dates (and more in the future)</para></listitem>
- </itemizedlist>
- </para>
-
- <para>
- You can save your searches as a live folder that always filters for what you entered as search criteria. Just type a name for the search into the <guilabel>Save Current Search</guilabel> field and click the save button to the right of it. When saved, the filter will appear in the <guilabel>Searches</guilabel> list. By clicking the title bar of this list you can invert the sorting order. Once you select one of your saved searches, the search result will be presented in the Image Area immediately and the <guilabel>Save Current Search</guilabel> field will convert into a <guilabel>Edit Stored Search</guilabel> field where you can edit your search criteria. The name of the saved search will be used to label the search result in the Image Area.
- </para>
-
- <para>
- If you want to delete or rename a saved search from the list, click with the &RMB; on it and select from the context menu.
- </para>
-
- </sect3>
-
- <sect3 id="using-mainwindow-advancedsearchtool">
- <title>The Advanced Search Tool</title>
-
- <para>
- Advanced Search tool provides an extended search form which can be used to search in specific fields of the &digikam; database in a more sophisticated way. Click the <guilabel>Advanced Search...</guilabel> button and it will come up like this:
- </para>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-advancedsearchtool.png" format="PNG" /></imageobject>
- </mediaobject>
- </para>
-
- <para>
- The field labeled <quote>Find pictures that have associated all these words:</quote> is just a duplicate of the Quick Search field.
- </para>
-
- <para>
- Click on one of the blue categories and there will fold out an area with all the fields you can search for in that very category. Depending on the kind of data each field contains different input fields for your search, sometimes more than one type for the same field. Simplest are selection buttons, ⪚ for colors. Then you have plain fields of the <quote>The <replaceable>field content</replaceable> contains</quote> type, drop down lists and checkboxes. Many fields have two input fields allowing you to define a range, ⪚ <quote>Find pictures with a width between</quote>. And often you find a link type thing called <quote>Any</quote> which opens a drop down field with checkboxes for the possible contents of that field.
- </para>
-
- <example>
- <title>Advanced Search Criteria</title>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-advancedsearchtool2.png" format="PNG" /></imageobject>
- </mediaobject>
- </example>
-
- <para>
- Thanks to the labeling of the search fields they are pretty much self explaining. What we have to talk about is how they work together if you fill in or select more than one. On the right side of the header (blue area at the top) you find a little link <quote>Options</quote>. If you click on that one the header will change and you see four options.
- </para>
-
- <para>
- <itemizedlist>
- <listitem><para>
- <quote>Meet All of the following conditions</quote> means that your different search parameters will be connected by boolean AND for the search. Example: if you selected Album name <quote>Holidays</quote> and color <quote>red</quote> the search will find all pictures labeled with <quote>red</quote> out of the Album <quote>Holidays</quote>.
- </para></listitem>
-
- <listitem><para>
- <quote>Meet Any of the following conditions</quote> means that your different search parameters will be connected by boolean OR for the search. Example: if you selected Album name <quote>Holidays</quote> and color <quote>red</quote> the search will find the content of the Album <quote>Holidays</quote> <emphasis>and</emphasis> all pictures labeled with <quote>red</quote> out of your whole collection.
- </para></listitem>
-
- <listitem><para>
- <quote>None of these conditions are met</quote> means that your different search parameters will be connected by boolean NAND for the search. Again our example: if you selected Album name <quote>Holidays</quote> and color <quote>red</quote> the search will find all pictures of your collection except those labeled with <quote>red</quote> <emphasis>and</emphasis> except those out of the Album <quote>Holidays</quote>.
- </para></listitem>
-
- <listitem><para>
- <quote>At least one of these conditions is not met</quote> means that your different search parameters will be connected by boolean NOR for the search. One more example: if you selected Album name <quote>Holidays</quote> and color <quote>red</quote> the search will find all pictures of your collection except those labeled with <quote>red</quote> out of the Album <quote>Holidays</quote>.
- </para></listitem>
- </itemizedlist>
- </para>
-
- <para>
- Complicated? No, good! Because the real stuff is yet to come. Have a look at the footer of the Advanced Search Tool. Here you find <guilabel>+ Add Search Group</guilabel>. If you hit this button another list with the same categories of search fields will open below the first one (scroll down in case you don't see it right away) separated by a blue header showing the same options we were just talking about. On top of them you see an underlined OR meaning that this list is connected to the first one by boolean OR. You can change that to AND by clicking on it.
- </para>
-
- <para>
- To explain how it works let's make another example based on one of those we had already. I want to use the second one. That means: in the first group you checked <quote>Meet Any of the following conditions</quote> and you selected Album name <quote>Holidays</quote> and color <quote>red</quote>. As we said already this will produce all pictures labeled with <quote>red</quote> out of your whole collection <emphasis>and</emphasis> the content of the Album <quote>Holidays</quote>. Now let's assume for some reason you want to exclude all rejected files and all files with a rating lower than three stars. So you open a second group, click on the underlined OR in the header in order to change it to AND, select <quote>None of these conditions are met</quote>, fold out the <quote>Picture Properties</quote>, check under <quote>Labels</quote> the red flag (rejected) and select under <quote>Rating</quote> no star (five white stars) in the first field and two stars in the second field. Note that there is a difference between <quote>no star</quote> and <quote>No Rating assigned</quote>! If you want to exclude the pictures without any rating as well you got to open another Search Group, click on the underlined OR in the header in order to change it to AND, select <quote>None of these conditions are met</quote> and select <quote>No Rating assigned</quote> in the <quote>Picture Properties</quote> category.
- </para>
-
- <para>
- Which brings us to the fact that you can open as many additional Search Groups as you need to formulate your query. But since the purpose of this handbook is not to open a competition in creating the most sophisticated queries I leave it to you to figure out how far you have to go or can go in this respect and rather finish this section with a few hints about the other buttons in the Advanced Search Tool. Beside the <guilabel>+ Add Search Group</guilabel> button you see <guilabel>Reset</guilabel>. This removes all additional Search Groups and clears all the fields in the remaining one. It's a good policy to use this button before starting to create a new search, in particular when you leave the Advanced Search Tool with the intention to use the Quick Search for your next query, because otherwise the search criteria remain active even if you don't see them and screw up your new search. <guilabel>Try</guilabel> carries out the search but leaves the Advanced Search Tool window open, <guilabel>OK</guilabel> does the same but closes the window. <quote>Remove Group</quote> in the header of the additional Search Groups doesn't need an explanation, I think.
- </para>
-
- </sect3>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-tagsview.docbook b/attic/digikam/using-mainwindow-tagsview.docbook
deleted file mode 100644
index 9a103bf..0000000
--- a/attic/digikam/using-mainwindow-tagsview.docbook
+++ /dev/null
@@ -1,151 +0,0 @@
-<sect2 id="using-mainwindow-tagsview">
- <title>Tags View</title>
-
- <para>
- (Hierarchical) tagging provides a flexible and powerful way to organize and catalog your images. Tags (also called <quote>keywords</quote> in other applications) are labels that can be applied to individual images or whole groups. Once a tag has been set to an image the image can be found again by selecting the tag or doing a search.
- </para>
-
- <para>
- Tags can be arranged in a hierarchical tree. This allows you to organize your tags in a logical manner. You can collapse parts of the tree in the <quote>Tags</quote> list so that you can easily find the tags that you are looking for.
- </para>
-
- <para></para>
-
- <para>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-tagsview.png" format="PNG" /></imageobject>
- </mediaobject>
- </para>
-
- <para>
- When a tag is selected in the Left Sidebar, all of the images that are marked with that tag are displayed in the View Area.
- </para>
-
- <para>
- But before assigning and using tags you first have to define them. If you import photographs with tags assigned &digikam; will build an appropriate tag tree during import. Other than that you have to define tags by yourself. An easy access to that is the context menu shown in the screenshot above.
- </para>
-
- <sect3 id="using-managetags"> <title>Managing Tags</title>
-
- <para>
- You can add new tags by clicking with the &RMB; on either the <quote>Tags</quote> label or an existing tag and selecting <guilabel>New Tag...</guilabel>. A dialog will open where you can type in the tag name (or even a whole hierarchy branch), assign an icon and/or a shortcut to the tag. If you add a new tag by clicking with the &RMB; on an existing tag, your new tag will be created as a sub-tag.
- </para>
-
- <para>
- You can delete a tag by clicking with the &RMB; on the tag you want to delete and selecting <guilabel>Delete Tag</guilabel>. When you delete a tag, the photographs themselves are not deleted. Simply the tag is removed from those photographs.
- </para>
-
- <para>
- You can move the position of a tag within the tree by dragging it to the position that you want and dropping it there. A menu will appear that gives you the option to
- <guilabel>Move</guilabel> the tag. This works from the left and right sidebar. A tag can only be in one place in the tree at a time.
- </para>
-
- <para>
- You can set the Tag Properties by clicking with the &RMB; on a tag and selecting <guilabel>Properties...</guilabel>. The Tag Properties allow you to change the name of the tag, the icon used in the Tags tree and the shortcut.
- </para>
-
- <para>
- To select a photograph as the tag icon, click with the &RMB; on the photograph that you want to use as the tag icon and select <guilabel>Set as Tag Thumbnail</guilabel> from the context menu. Additionally you can use drag and drop to set the tag icon. Drag the images icon and drop it on the currently selected tag in the tag list.
- </para>
-
- <para>
- A tool for more elaborate work on big tag trees is the <link linkend="using-tagsmngr">Tags Manager</link> which you can access by clicking the <guilabel>Open Tag Manager</guilabel> button at the top of the Tags tree.
- </para>
-
- <para>
- In the <link linkend="keywords">Digital Asset Management (DAM)</link> chapter of this handbook you can find some useful considerations about how to build your Tags tree.
- </para>
-
- <para>
- It is not always easy to build a logical hierarchy from general and generic categories. You might run into a problem like this:
- </para>
-
- <blockquote><screen>
- Animal
- - Domestic Animal
- - Cat
- - Cattle
- - Dog
-
- - Wild Animal
- - Bird
- - Cat
- - Cheetah
- - Lion
- - Tiger
-
- - Zoo Animal
- - Bird
- - Cat
- - Cheetah
- - Leopard
- </screen></blockquote>
-
- <para>
- In this tag tree the keyword <quote>Cat</quote> appears three times. This will not cause a problem within &digikam; but there are quite a few views where the user cannot know which of the three is applied to an image because he might not be able to see the whole hierarchy of the tag. A help could be to tag the image in a case like this also with the parent tag or even the whole hierarchy but it becomes quite unwieldy, ⪚ in the image icon if you have the tags displayed there. The second <quote>Cat</quote> can be avoided by calling it <quote>Wild Cat</quote> but calling the third one <quote>Zoo Cat</quote> is a bit out of the roof, I think. And still: there are also two <quote>Cheetah</quote>!
- </para>
-
- <para>
- Solution: You replace the <quote>Zoo Animal</quote> branch by a single tag <quote>Zoo</quote> which you use in addition to the tag you choose from the two remaining branches. You could even put it on the top level of your hierarchy if you have photographs taken in a zoo but not showing animals.
- </para>
-
- </sect3>
-
- <sect3 id="using-taggingimages"> <title>Tagging Photographs</title>
-
- <para>
- Before you can get the most out of &digikam;'s tagging capabilities, you must first tag your photographs. There are a few methods for that task. Once you have identified the photographs that you want to tag you can either drag and drop them onto the tag in the Tags tree or, by clicking with the &RMB; on the selected photographs in the Image Window, you can use the <guilabel>Assign Tag</guilabel> menu to select the tags you wish to set.
- </para>
-
- <para>
- Drag and Drop: works with both sidebars provided they are showing tags of course. With the Right Sidebar it works the obvious way: you drag the tag and drop it onto the photograph or selection of photographs you want to tag. With the Left Sidebar you have to drag the photographs to the tags. You want to know why? Just try it the other way and you will see :-)
- </para>
-
- <para>
- Shortcuts: as mentioned earlier in this chapter you can assign keyboard shortcuts in the Tag Properties. With these you can assign or un-assign a tag to the selected photograph(s).
- </para>
-
- <para>
- Context menu: by clicking with the &RMB; on the selected photographs and choosing <guilabel>Assign Tag</guilabel> you will see the next menu step offering the ten most recently used tags, <guilabel>Add New Tag...</guilabel>, described at the beginning of the previous <link linkend="using-managetags">article</link>, and <guilabel>More Tags...</guilabel> which leads to what is described in the next paragraph. The context menu method is obviously very useful if you use only a limited number of tags out of your whole tree for a while.
- </para>
-
- <example>
- <title>Tagging Image with context menu</title>
- <mediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-assigntags.png" format="PNG" /></imageobject>
- </mediaobject>
- </example>
-
- <para>
- You can remove a tag from a photograph by clicking with the &RMB; on the photograph and using the <guilabel>Remove Tag</guilabel> menu. This menu will only show those tags that have been set on this photograph.
- </para>
-
- <para>
- The Right Sidebar: this is what I would call my standard method for assigning tags. Click <guilabel>Captions/Tags</guilabel> on the Right Sidebar and then the <guilabel>Tags</guilabel> tab and you will see the whole tags tree. Simply check/un-check the boxes of the tags you want to assign/un-assign and then click <guilabel>Apply</guilabel>. If you change focus without that you will be asked whether you want to apply the changes unless you disabled that confirmation either by checking <quote>Always apply changes without confirmation</quote> or by checking <quote>Do not confirm when applying changes in the right sidebar</quote> in the Miscellaneous section of <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure digiKam...</guimenuitem></menuchoice>. More details about the other buttons and fields in the <guilabel>Tags</guilabel> tab see in <link linkend="using-sidebar-tags">&digikam; sidebar</link>.
- </para>
-
- <para>
- You can label a photograph with as many tags as you like. The photograph will appear when you select any of the tags that are set against it. This way you can set a tag for each person in a photograph, as well as the place the photograph was taken, the event it was taken at, &etc;
- </para>
-
- <para>
- Once you have tagged a photograph, the tag name will appear under the thumbnail in the Image Area.
- </para>
-
- <tip>
- <para>
- Tags are stored in a database for fast access, and, the applied tags are written into IPTC data fields of the image (at least for JPEG). So you can use your tags with other programs or, in case of loss of that data in the database, the tags will be re-imported when the image is noticed by &digikam;.
- </para>
- </tip>
-
- </sect3>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow-timelineview.docbook b/attic/digikam/using-mainwindow-timelineview.docbook
deleted file mode 100644
index bec67d7..0000000
--- a/attic/digikam/using-mainwindow-timelineview.docbook
+++ /dev/null
@@ -1,28 +0,0 @@
-<sect2 id="using-mainwindow-timelineview">
- <title>Timeline View</title>
-
- <para>
- The Timeline View shows a timescale-adjustable histogram of the numbers of images per time unit which is selectable by a drop down field. To the right of that you can choose between a linear or logarithmic histogram. A selection frame moves over the histogram. To display the photographs out of a certain time frame just click on the corresponding bar. You are not restricted to one bar. With <keycombo action="simul">&Shift;<mousebutton>left</mousebutton></keycombo> click or <keycombo action="simul">&Ctrl;<mousebutton>left</mousebutton></keycombo> click you can add more bars to the first one.
- </para>
-
- <para>
- <mediaobject>
- <imageobject>
- <imagedata fileref="&path;using-mainwindow-timeline.png" format="PNG" />
- </imageobject>
- </mediaobject>
- </para>
-
- <para>
- In the field right below you can enter a title and save your selection. It will then appear in the <quote>Searches</quote> list field below. But the best is still to come: the Timeline View offers a search for a search! If you have a lot more searches saved than my ridiculous four in the screenshot the adaptive search field at the bottom may help to find a certain search.
- </para>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-mainwindow.docbook b/attic/digikam/using-mainwindow.docbook
deleted file mode 100644
index 302cbbd..0000000
--- a/attic/digikam/using-mainwindow.docbook
+++ /dev/null
@@ -1,24 +0,0 @@
-<sect1 id="using-mainwindow">
- <title>The Main &digikam; Window</title>
-
- &doc-using-mainwindow-intro;
- &doc-using-mainwindow-imageview;
- &doc-using-mainwindow-albumsview;
- &doc-using-mainwindow-tagsview;
- &doc-using-mainwindow-labelsview;
- &doc-using-mainwindow-datesview;
- &doc-using-mainwindow-timelineview;
- &doc-using-mainwindow-searchesview;
- &doc-using-mainwindow-fuzzysearches;
- &doc-using-mainwindow-mapview;
- &doc-using-mainwindow-peopleview;
-
-</sect1>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/main_window/map_view.rst b/main_window/map_view.rst
index 1517542..00a85f0 100644
--- a/main_window/map_view.rst
+++ b/main_window/map_view.rst
@@ -33,7 +33,7 @@ Usually you will begin searching for images by defining a region on the map. Fro
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.
-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 :-)
+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.
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.
More information about the kde-doc-english
mailing list