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
