[documentation/digikam-doc/sphinx] /: add light tbale section
Gilles Caulier
null at kde.org
Sun Dec 18 09:20:58 GMT 2022
Git commit bf4495d02ca824d7d0ca2d0daa54c1f87afe46f5 by Gilles Caulier.
Committed on 18/12/2022 at 09:20.
Pushed by cgilles into branch 'sphinx'.
add light tbale section
D +0 -69 attic/digikam/using-lighttable.docbook
D +- -- attic/digikam/using-lighttable.png
M +16 -0 index.rst
A +24 -0 light_table.rst
A +- -- light_table/images/using-light-table.png
A +34 -0 light_table/lighttable_overview.rst
https://invent.kde.org/documentation/digikam-doc/commit/bf4495d02ca824d7d0ca2d0daa54c1f87afe46f5
diff --git a/attic/digikam/using-lighttable.docbook b/attic/digikam/using-lighttable.docbook
deleted file mode 100644
index 5a58b17..0000000
--- a/attic/digikam/using-lighttable.docbook
+++ /dev/null
@@ -1,69 +0,0 @@
-<sect1 id="using-lighttable"> <title>The &digikam; Light Table</title>
-
- <para>
- &digikam; features a light table in a separate window to easily compare images. It works with all supported image formats including RAW files.
- </para>
-
- <para>
- Select one or several images in any view from the main window, call
-
- <menuchoice> <shortcut><keycombo>&Ctrl;<keycap>L</keycap></keycombo> </shortcut>
- <guimenu>Place onto Light Table</guimenu>
- </menuchoice>
-
- from the context menu. The selection will be added to the light table, and its separate window will open. When you are back to the &digikam; main window you can quickly access the light table with
-
- <menuchoice> <shortcut><keycombo action="press"><keycap>L</keycap></keycombo></shortcut>
- <guimenu>Tools</guimenu><guimenuitem>Light Table</guimenuitem>
- </menuchoice>.
-
-</para>
-
- <para>
- From the thumbbar drag & drop images to the left and right comparison pane below. A little arrow will indicate which copy is shown in which pane. If you choose <guilabel>Synchronize</guilabel> from the toolbar, any zoom and panning in one window will be synchronously executed in the other pane, so that you can compare the same areas of two images.
- </para>
-
- <para>
- Another mode is better suited for quickly culling from a series of images. If you choose <guilabel>By Pair</guilabel> from the toolbar, the first two images will be automatically inserted into the comparison panes. Click on any thumbnail to make it the left side preview, the adjacent thumbnail to the right will be inserted into the right pane. That make it easy to sift through a series of similar images.
- </para>
-
- <para>
-
- Of course, the usual delete actions work from the light table directly as well as
-
- <menuchoice> <shortcut><keycombo action="press"><keycap>F4</keycap></keycombo> </shortcut>
- <guimenu>File</guimenu><guimenuitem>Edit...</guimenuitem>
- </menuchoice>
-
- </para>
-
- <para>
- All image information from the main window right sidebar is available for each of the two previews in the light table. This makes it easy to link visual differences to exposure data for example.
- </para>
-
- <para>
- In the lower right corner of each pane there you find a built-in panning action (crossed arrows). Click on it and keep the &LMB; pressed to pan across the image (in synchronous mode both images will show the same viewing point).
- </para>
-
- <para>
- Zooming works the same as in other views: use indifferently the zoom slider below the panes or <keycombo action="press">&Ctrl;<keycap>scroll wheel</keycap></keycombo> to zoom in and out, with both images when in synchronous mode.
- </para>
-
- <example>
-
- <title>The Light Table in Action</title>
- <screenshot><mediaobject><imageobject>
- <imagedata fileref="&path;using-lighttable.png" format="PNG" />
- </imageobject></mediaobject></screenshot>
-
- </example>
-
- </sect1>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-lighttable.png b/attic/digikam/using-lighttable.png
deleted file mode 100644
index 6f03d12..0000000
Binary files a/attic/digikam/using-lighttable.png and /dev/null differ
diff --git a/index.rst b/index.rst
index 102a964..cd69df4 100644
--- a/index.rst
+++ b/index.rst
@@ -159,4 +159,20 @@ The Right Sidebar
right_sidebar
+###############
+The Light Table
+###############
+
+.. container:: toctile
+
+ .. container:: tile no-descr
+
+ :ref:`lighttable_overview`
+
+.. toctree::
+ :maxdepth: 2
+ :hidden:
+
+ light_table
+
.. TODO Add more top level entries here...
diff --git a/light_table.rst b/light_table.rst
new file mode 100644
index 0000000..d2ec7bf
--- /dev/null
+++ b/light_table.rst
@@ -0,0 +1,24 @@
+.. meta::
+ :description: Using the digiKam light table
+ :keywords: digiKam, documentation, user manual, photo management, open source, free, help, learn
+
+.. metadata-placeholder
+
+ :authors: - Gilles Caulier <caulier dot gilles at gmail dot com>
+
+ :license: Creative Commons License SA 4.0
+
+.. _light_table:
+
+################
+The Light Table
+################
+
+Using the digiKam light table
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ light_table/lighttable_overview.rst
diff --git a/light_table/images/using-light-table.png b/light_table/images/using-light-table.png
new file mode 100644
index 0000000..525006e
Binary files /dev/null and b/light_table/images/using-light-table.png differ
diff --git a/light_table/lighttable_overview.rst b/light_table/lighttable_overview.rst
new file mode 100644
index 0000000..1c6799e
--- /dev/null
+++ b/light_table/lighttable_overview.rst
@@ -0,0 +1,34 @@
+.. meta::
+ :description: Overview to digiKam Light Table
+ :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy
+
+.. metadata-placeholder
+
+ :authors: - Gilles Caulier <caulier dot gilles at gmail dot com>
+
+ :license: Creative Commons License SA 4.0
+
+.. _lighttable_overview:
+
+Overview
+========
+
+.. contents::
+
+digiKam features a light table in a separate window to easily compare images. It works with all supported image formats including RAW files.
+
+Select one or several images in any view from the main window, call Place onto Light Table (Ctrl+L) from the context menu. The selection will be added to the light table, and its separate window will open. When you are back to the digiKam main window you can quickly access the light table with Tools → Light Table (L).
+
+From the thumbbar drag & drop images to the left and right comparison pane below. A little arrow will indicate which copy is shown in which pane. If you choose Synchronize from the toolbar, any zoom and panning in one window will be synchronously executed in the other pane, so that you can compare the same areas of two images.
+
+Another mode is better suited for quickly culling from a series of images. If you choose By Pair from the toolbar, the first two images will be automatically inserted into the comparison panes. Click on any thumbnail to make it the left side preview, the adjacent thumbnail to the right will be inserted into the right pane. That make it easy to sift through a series of similar images.
+
+Of course, the usual delete actions work from the light table directly as well as File → Edit... (F4)
+
+All image information from the main window right sidebar is available for each of the two previews in the light table. This makes it easy to link visual differences to exposure data for example.
+
+In the lower right corner of each pane there you find a built-in panning action (crossed arrows). Click on it and keep the left mouse button pressed to pan across the image (in synchronous mode both images will show the same viewing point).
+
+Zooming works the same as in other views: use indifferently the zoom slider below the panes or Ctrl-scroll wheel to zoom in and out, with both images when in synchronous mode.
+
+.. figure:: images/using-light-table.png
More information about the kde-doc-english
mailing list