[digikam-doc] /: implement metadata editor section for digiKam and Showfoto
Gilles Caulier
caulier.gilles at gmail.com
Sat Aug 27 15:02:56 UTC 2016
Git commit 5f225eca1dc2d75e8c9044b682cc10428e832b14 by Gilles Caulier.
Committed on 27/08/2016 at 15:01.
Pushed by cgilles into branch 'master'.
implement metadata editor section for digiKam and Showfoto
BUGS: 242630
FIXED-IN: 5.2.0
M +4 -3 README
M +1 -1 TODO
A +- -- digikam/tool-metadataeditor-exif.png
A +- -- digikam/tool-metadataeditor-xmp.png
M +35 -1 digikam/tool-metadataeditor.docbook
A +28 -0 project/optpng.sh
http://commits.kde.org/digikam-doc/5f225eca1dc2d75e8c9044b682cc10428e832b14
diff --git a/README b/README
index c740395..33bf301 100644
--- a/README
+++ b/README
@@ -45,11 +45,12 @@ Note : Another script by Andi Clemens can be used to automate the above instruct
----------------------------------------------------------------------
!----------Important-------------!
+
Since the documentation is very good it is also very demanding in terms of volume, 99% whereof are screenshots.
+
In order to limit the byte count to the minimum the following command chain shall be used to reduce the png file size.
-A factor of 2-4 can be gained. From within the folder where the png reside issue this command (requires pngnq and optipng
-to be installed on the system):
-pngnq -s 1 ./*.png && optipng *-nq8.png && rename -f s/-nq8\.png/.png/ *-nq8.png
+A factor of 2-4 can be gained. From within the folder where the png reside, use script optpng.sh from project/ sub-dir
+(requires pngnq and optipng to be installed on the system)
digiKam team
diff --git a/TODO b/TODO
index afa035b..b2c7eee 100644
--- a/TODO
+++ b/TODO
@@ -42,7 +42,7 @@ tool-imgur.docbook
tool-kmlexport.docbook Need to be created
tool-maintenance.docbook Need to be created
tool-mediawiki.docbook Need to be created
-tool-metadataeditor.docbook Need to be created
+tool-metadataeditor.docbook DONE DONE Gilles
tool-panorama.docbook Need to be created
tool-piwigoexport.docbook Need to be created
tool-presentation.docbook
diff --git a/digikam/tool-metadataeditor-exif.png b/digikam/tool-metadataeditor-exif.png
new file mode 100644
index 0000000..8199bfe
Binary files /dev/null and b/digikam/tool-metadataeditor-exif.png differ
diff --git a/digikam/tool-metadataeditor-xmp.png b/digikam/tool-metadataeditor-xmp.png
new file mode 100644
index 0000000..1ede19a
Binary files /dev/null and b/digikam/tool-metadataeditor-xmp.png differ
diff --git a/digikam/tool-metadataeditor.docbook b/digikam/tool-metadataeditor.docbook
index d4c0644..ddfe6c1 100644
--- a/digikam/tool-metadataeditor.docbook
+++ b/digikam/tool-metadataeditor.docbook
@@ -20,7 +20,41 @@ The Metadata Editor is a tool for adding and editing Exif, Iptc, or Xmp metadata
<title>Metadata Editor</title>
<para>
- TODO
+ Inside each digital photo hides metadata in the Exif, Iptc, or Xmp formats, and digiKam provides tools for viewing and editing this useful information.
+</para>
+
+<para>
+ The application offers metadata editing tools available through the <guimenu>Edit Metadata</guimenu> menu entry.
+ The metadata editor conveniently organizes all metadata into sections for each king of metadata chunck, making it easier to find and edit
+ specific entries. For example, to edit hardware-related information, switch to the Device section. Here you can modify device manufacturer,
+ device model, exposure-related settings, and other information.
+</para>
+
+<para>
+ <inlinemediaobject>
+ <imageobject><imagedata fileref="&path;tool-metadataeditor-exif.png" format="PNG"/></imageobject>
+ <textobject><phrase>The Metadata Editor Working on Device Information from Exif</phrase></textobject>
+ </inlinemediaobject>
+</para>
+
+<para>
+ In addition to Exif, IPTC and XMP formats are supported, so you can perform the described actions on metadata stored in these metadata chuncks as for Exif.
+ Remember that Exif is dedicated to store camera information, where Iptc and Xmp are more used to store post process text information as rights management.
+ So, it's not recommended to edit the metadata that the camera creates but more to add the author/copyright/etc. information, excepted if you need to fix wrong
+ internal values.
+</para>
+
+<para>
+ <inlinemediaobject>
+ <imageobject><imagedata fileref="&path;tool-metadataeditor-xmp.png" format="PNG"/></imageobject>
+ <textobject><phrase>The Metadata Editor Working on Right Management Information from Xmp</phrase></textobject>
+ </inlinemediaobject>
+</para>
+
+<para>
+ Note that you can synchronize some specific metadata entries from one chunck to another one, as for example the comments which is available into
+ Exif, Iptc, and Xmpp as different forms. When relevant checkbox are set in the section, relevant chunck entries are backported and adjusted in most
+ compatible format.
</para>
</chapter>
diff --git a/project/optpng.sh b/project/optpng.sh
new file mode 100755
index 0000000..98af1c5
--- /dev/null
+++ b/project/optpng.sh
@@ -0,0 +1,28 @@
+#!/bin/bash
+
+ # ============================================================
+ #
+ # This file is a part of digiKam project
+ # http://www.digikam.org
+ #
+ # Date : 2016-08-27
+ # Description : PNG optimizations for handbook
+ #
+ # Copyright (C) 2016 by Gilles Caulier <caulier dot gilles at gmail dot com>
+ #
+ # This program is free software; you can redistribute it
+ # and/or modify it under the terms of the GNU General
+ # Public License as published by the Free Software Foundation;
+ # either version 2, or (at your option)
+ # any later version.
+ #
+ # This program is distributed in the hope that it will be useful,
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ # GNU General Public License for more details.
+ #
+ # ============================================================ */
+
+ls -al $1
+pngnq -s 1 -f $1 && optipng $1
+ls -al $1
More information about the kde-doc-english
mailing list