[digikam-doc] digikam: split LT section

Gilles Caulier caulier.gilles at gmail.com
Tue Aug 23 10:31:22 UTC 2016


Git commit d9db4286649d81b1b98391cf0b5be30820234006 by Gilles Caulier.
Committed on 23/08/2016 at 10:31.
Pushed by cgilles into branch 'master'.

split LT section

M  +6    -47   digikam/index.docbook
A  +57   -0    digikam/using-lighttable.docbook

http://commits.kde.org/digikam-doc/d9db4286649d81b1b98391cf0b5be30820234006

diff --git a/digikam/index.docbook b/digikam/index.docbook
index 99ccdb0..f42d180 100644
--- a/digikam/index.docbook
+++ b/digikam/index.docbook
@@ -16,6 +16,7 @@
 <!-- using application -->
   <!ENTITY doc-using-mainwindow       SYSTEM "using-mainwindow.docbook">
   <!ENTITY doc-using-sidebar          SYSTEM "using-sidebar.docbook">
+  <!ENTITY doc-using-lighttable       SYSTEM "using-lighttable.docbook">  
 <!-- image editor -->
   <!ENTITY doc-photo-editing          SYSTEM "photo-editing.docbook">
   <!ENTITY doc-editor-color           SYSTEM "editor-color.docbook">
@@ -90,7 +91,7 @@
 
 <!-- *********************************************************************** -->
 
-<chapter id="introduction">    <title>Introduction</title>
+<chapter id="introduction"> <title>Introduction</title>
 
     &doc-intro-background;
 
@@ -106,57 +107,15 @@
 
 <!-- *********************************************************************** -->
 
-<chapter id="using-digikam">   <title>Using &digikam;</title>
+<chapter id="using-digikam"> <title>Using &digikam;</title>
 
     &doc-using-mainwindow;
 
- <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 Preview</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>Navigate 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 port).
-      </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;lighttable.png" format="PNG" /> </imageobject></mediaobject></screenshot>
-                </example>
-
- </sect1>
+    &doc-using-lighttable;
 
-&doc-using-sidebar;
+    &doc-using-sidebar;
 
- <sect1 id="dam">                      <title>Digital Asset Management (DAM) with &digikam;</title>
+ <sect1 id="dam"> <title>Digital Asset Management (DAM) with &digikam;</title>
 
     <para><link linkend="build-dam">Build a system to organize and find your photographs</link></para>
     <itemizedlist>
diff --git a/digikam/using-lighttable.docbook b/digikam/using-lighttable.docbook
new file mode 100644
index 0000000..361da1b
--- /dev/null
+++ b/digikam/using-lighttable.docbook
@@ -0,0 +1,57 @@
+<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 Preview</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>Navigate 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 port).
+      </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;lighttable.png" format="PNG" /> </imageobject></mediaobject></screenshot>
+      </example>
+
+ </sect1>
+ 
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->


More information about the kde-doc-english mailing list