Warning, /graphics/kphotoalbum/doc/introduction.docbook is written in an unsupported language. File is not indexed.

 <!--
 SPDX-FileCopyrightText: 2003-2006 Jesper K. Pedersen <jesper.pedersen@kdab.com>
 SPDX-FileCopyrightText: 2012 Miika Turkia <miika.turkia@gmail.com>
 SPDX-FileCopyrightText: 2012 Yuri Chornoivan <yurchor@ukr.net>
 
 SPDX-License-Identifier: GFDL-1.2-only
 -->
 
 <chapter id="introduction">
   <title>Introduction</title>
   <para>If you are like me you have thousands of images
 ever since you got your first camera, some taken with a normal camera other
 with a digital camera. Through all the years you believed that until
 eternity you would be able to remember the story behind every single
 picture, you would be able to remember the names of all the people on your
 images, and you would be able to remember the exact date of every single
 image. I personally realized that this was not possible anymore, and
 especially for my digital images - but also for my paper images - I needed
 a tool to help me describe my images, and to search in the pile of
 images. This is exactly what &kphotoalbum; is all about.</para>
   
   
   <para>&kphotoalbum; focuses on three key points: 
 <itemizedlist>
       <listitem><para>It must be easy to annotate a number of images at a
 time. It must for example not take more than a few mouse clicks to mark all
 your images from your holiday as being from Italy, 1992. &kphotoalbum; offers two
 ways of describing images: <guilabel>one at a time</guilabel>, which is
 useful for writing text about images, and <guilabel>All
 Simultaneously</guilabel>, which is useful for selecting a 
 number of images, and setting properties like location, people on images,
 and date of image.</para></listitem>
       
       <listitem><para>It must be easy to search for images. &kphotoalbum; offers to
 describe images with a number of properties. These includes date, people,
 places, plus a keyword field the user can use for custom keywords like
 <emphasis>Album 7</emphasis> or <emphasis>Holiday trip to
 Italy</emphasis>. With &kphotoalbum; you can  search for images in each of
 the categories - e.g. find all the images with Jesper on them from the
 holiday in Italy. It is of course possible to create your own categories,
 much more on that later.</para></listitem> 
       
       <listitem><para>It must be easy to browse and View the images. When viewing
 images, your focus often changes - one moment you are looking at images
 from your holiday in 1992, and when seeing an image of a friend whom you
 spent that holiday with, you focus suddenly changes, so you want to see all
 images of that friend.</para></listitem>
     </itemizedlist></para>
   
   <!-- ====================================================================== -->
   <sect1 id="sect-overview-of-manual">
     <title>Overview of the manual</title>
     <para>In this manual I will take you through the steps of (1)
 annotating your images, (2) browsing and viewing images and (3)
 advanced topics and customization.</para>
 
 <para>&kphotoalbum; started out as an application for managing your images,
 but since then it has been extended, so it today also takes care of your
 videos. In many places in this manual I will talk about images, but just as
 often the discussion does include videos.</para>
   
 
   </sect1>
   
   
   <!-- ====================================================================== -->
   <sect1 id="sec-organization-of-images-and-KPhotoAlbum-files">
     <title>Organization of images and &kphotoalbum; files</title>
     <para>&kphotoalbum; uses all the images of a directory and all subdirectories
 below it, first time you start &kphotoalbum;, you will be asked for the location of
 this directory. &kphotoalbum; will not modify any images, so you do not have to
 be afraid of &kphotoalbum; altering your images <footnote><para>The two
 exceptions to this rule is (1) if you ask &kphotoalbum; to delete individual
 images, from <menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete
 Selected</guimenuitem></menuchoice>, and (2) plug-in operations.</para></footnote>, 
 actually if you do not trust &kphotoalbum;, feel free to make all your images 
 write protected.</para>
     
     <para>&kphotoalbum; will save all its information in the file
 <filename>index.xml</filename> in your topmost image directory. This file
 is a simple XML file, so you can easily back it up using whatever tools
 you prefer, including normal backup utilities, copying the file to a
 floppy disk, or keeping revisions using VCS. There is also a backup script
 (<emphasis>kpa-backup.sh</emphasis>) provided in &kphotoalbum;'s sources that
 backs up not only the index.xml but also the configuration files inside user's
 home directory.</para>
     
     <para>&kphotoalbum; will remember where you told it your images were
 located, and reuse that in future use of &kphotoalbum;. Should you ever want to
 load another database into &kphotoalbum; (i.e. another directory tree of
 images), then you may start it with the  <option>-c</option> option. For
 example: <userinput><command>kphotoalbum</command> <option>-c</option> 
 <filename>~/CompanyImages/index.xml</filename></userinput>.</para>
   </sect1>
 </chapter>
 
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: xml
 sgml-namecase-general:t
 sgml-general-insert-case:lower
 sgml-always-quote-attributes:t
 sgml-indent-step:2
 sgml-parent-document: "index.docbook"
 End:
 -->