[digikam-doc] /: add missing new file from Wolfgang
Gilles Caulier
null at kde.org
Mon Feb 6 19:30:33 UTC 2017
Git commit 61423831fd8f86c0ac5e6b2f1356fdf1d047cdaa by Gilles Caulier, on behalf of Wolfgang Scheffner.
Committed on 06/02/2017 at 19:30.
Pushed by cgilles into branch 'master'.
add missing new file from Wolfgang
M +1 -1 digikam/index.docbook
A +55 -0 digikam/using-mainwindow-mapview.docbook
M +1 -1 digikam/using-mainwindow.docbook
M +2 -2 showfoto/index.docbook
https://commits.kde.org/digikam-doc/61423831fd8f86c0ac5e6b2f1356fdf1d047cdaa
diff --git a/digikam/index.docbook b/digikam/index.docbook
index 081e5ba..d0f558b 100644
--- a/digikam/index.docbook
+++ b/digikam/index.docbook
@@ -30,7 +30,7 @@
<!ENTITY doc-using-mainwindow-timelineview SYSTEM "using-mainwindow-timelineview.docbook">
<!ENTITY doc-using-mainwindow-searchesview SYSTEM "using-mainwindow-searchesview.docbook">
<!ENTITY doc-using-mainwindow-fuzzysearches SYSTEM "using-mainwindow-fuzzysearches.docbook">
-<!-- <!ENTITY doc-using-mainwindow-mapview SYSTEM "using-mainwindow-mapview.docbook"> -->
+ <!ENTITY doc-using-mainwindow-mapview SYSTEM "using-mainwindow-mapview.docbook">
<!ENTITY doc-using-mainwindow-peopleview SYSTEM "using-mainwindow-peopleview.docbook">
<!ENTITY doc-using-sidebar SYSTEM "using-sidebar.docbook">
diff --git a/digikam/using-mainwindow-mapview.docbook b/digikam/using-mainwindow-mapview.docbook
new file mode 100644
index 0000000..72324e5
--- /dev/null
+++ b/digikam/using-mainwindow-mapview.docbook
@@ -0,0 +1,55 @@
+<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:
+ <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.
+ </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 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>
+
+ <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/digikam/using-mainwindow.docbook b/digikam/using-mainwindow.docbook
index 597787b..302cbbd 100644
--- a/digikam/using-mainwindow.docbook
+++ b/digikam/using-mainwindow.docbook
@@ -10,7 +10,7 @@
&doc-using-mainwindow-timelineview;
&doc-using-mainwindow-searchesview;
&doc-using-mainwindow-fuzzysearches;
-<!-- &doc-using-mainwindow-mapview; -->
+ &doc-using-mainwindow-mapview;
&doc-using-mainwindow-peopleview;
</sect1>
diff --git a/showfoto/index.docbook b/showfoto/index.docbook
index 47f91e6..61686bc 100644
--- a/showfoto/index.docbook
+++ b/showfoto/index.docbook
@@ -14,7 +14,7 @@
<!ENTITY doc-intro-imageformats SYSTEM "../digikam/intro-imageformats.docbook">
<!ENTITY doc-using-mainwindow SYSTEM "../digikam/using-mainwindow.docbook">
-<!-- <!ENTITY doc-using-mainwindow-mapview SYSTEM "../digikam/using-mainwindow-mapview.docbook"> -->
+ <!ENTITY doc-using-mainwindow-mapview SYSTEM "../digikam/using-mainwindow-mapview.docbook">
<!ENTITY doc-using-sidebar SYSTEM "../digikam/using-sidebar.docbook">
<!ENTITY doc-using-sidebar-intro SYSTEM "../digikam/using-sidebar-intro.docbook">
@@ -23,7 +23,7 @@
<!ENTITY doc-using-sidebar-colors SYSTEM "../digikam/using-sidebar-colors.docbook">
<!ENTITY doc-using-sidebar-maps SYSTEM "../digikam/using-sidebar-maps.docbook">
<!ENTITY doc-using-sidebar-captions SYSTEM "../digikam/using-sidebar-captions.docbook">
- <!ENTITY doc-using-sidebar-versions SYSTEM "../digikam/using-sidebar-versions.docbook">
+ <!ENTITY doc-using-sidebar-versions SYSTEM "../digikam/using-sidebar-versions.docbook">
<!ENTITY doc-using-sidebar-filters SYSTEM "../digikam/using-sidebar-filters.docbook">
<!ENTITY doc-using-sidebar-tools SYSTEM "../digikam/using-sidebar-tools.docbook">
More information about the kde-doc-english
mailing list