annotate doc/docbook/GuideOptionsMetadata.xml @ 1773:2ae81598b254

scripts for converting wiki documentation to docbook

<?xml version="1.0" encoding="utf-8"?>
<section id="GuideOptionsMetadata">
    <title>
      Metadata Options
    </title>
    <para>
      This section describes the metadata writing process and options that influences it.
    </para>
    <para/><section id="Metadatahandling"><title>
      Metadata handling
    </title>
    <para/><section id="Readalgorithm"><title>
      Read algorithm
    </title>
    <orderedlist spacing="compact"><listitem><para>Read exif, iptc and XMP from the file.
      </para></listitem><listitem><para>Now we have "raw" data -&gt; show them in <link linkend="GuideOtherWindowsExif">Exif Window</link>.
      </para></listitem><listitem><para>Read XMP sidecar or Geeqie private metadata file, which overrides the XMP read from the file.
      </para></listitem><listitem><para>Sync XMP with exif and Iptc, this corresponds to the "reconciliation" as described in [<ulink url="http://www.adobe.com/devnet/xmp/pdfs/XMPSpecificationPart3.pdf">XMP Specification</ulink>]
        <itemizedlist spacing="compact"><listitem><para>detect which of Exif and Xmp.exif is newer and copy the data in appropriate direction
          </para></listitem><listitem><para>detect which of Iptc and Xmp is newer and copy the data in appropriate direction
          </para></listitem></itemizedlist>
      </para></listitem><listitem><para>Now we have "processed" data - use them for Info Sidebar (title, keywords, ...), Orientation, Color management, etc.
      </para></listitem></orderedlist>
    <para/></section><section id="Metadatamodification"><title>
      Metadata modification
    </title>
    <itemizedlist spacing="compact"><listitem><para>Grouped files handling (raw + jpeg): description tags (keywords, comments) are written to all image files in the group (a group contains the same image in various formats, descriptions should be the same), technical tags (exif) are handled separately for each file.
      </para></listitem><listitem><para>Modifying the keywords, comment, orientation, etc. does not ask for confirmation, but immediately modifies the metadata in memory and adds the file to "write queue"
      </para></listitem><listitem><para>Writing of the queued changes is triggered from the menu or via auto-save. It is possible to review the changes and exclude selected files.
      </para></listitem></itemizedlist>
    <para/></section><section id="Writealgorithm"><title>
      Write algorithm
    </title>
    <orderedlist spacing="compact"><listitem><para>Exif and IPTC is updated from XMP (for example Exif.Image.Orientation is updated from Xmp.exif.orientation). See XMP and IPTC4XMP specs for the list of corresponding tags.
      </para></listitem><listitem><para>Try to write exif, iptc and XMP to the image file
      </para></listitem><listitem><para>Try to write XMP sidecar for raw file if previous step was not possible.
      </para></listitem><listitem><para>If previous steps were not possible, write XMP metadata to .metadata.
      </para></listitem><listitem><para>If previous steps were not possible, write XMP metadata to geeqie private directory.
      </para></listitem><listitem><para>After the first successful write attempt delete old metadata files in all possible locations.
      </para></listitem></orderedlist>
    <para/></section></section><section id="Optionsthatinfluencestheprocess"><title>
      Options that influences the process
    </title>
    <para>
      File types with allowed sidecars are listed in the Files tab.
    </para>
  <para/></section></section>