Git commit 4da2a533f98d7d859598d3188d4d79b204149155 by Mike Morrison. Committed on 02/12/2022 at 07:55. Pushed by cgilles into branch 'master'.
Minor edits to chapter 1 M +2 -2 digikam/intro-background.docbook M +1 -1 digikam/intro-camerasupport.docbook M +3 -3 digikam/intro-database.docbook M +6 -6 digikam/intro-firstrun.docbook M +5 -5 digikam/intro-imageformats.docbook M +4 -4 digikam/intro-movieformats.docbook https://invent.kde.org/documentation/digikam-doc/commit/4da2a533f98d7d859598d3188d4d79b204149155 diff --git a/digikam/intro-background.docbook b/digikam/intro-background.docbook index 809fd46..f140e53 100644 --- a/digikam/intro-background.docbook +++ b/digikam/intro-background.docbook @@ -9,7 +9,7 @@ </para> <para> - An easy-to-use Camera interface is provided, that will connect to your digital camera and download photographs directly into &digikam; Albums. More than <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php";>1000 digital cameras</ulink> are supported by the gphoto2 library. Of course, any media or card reader supported by your operating system will interface with &digikam;. + An easy-to-use Camera interface is provided that will connect to your digital camera and download photographs directly into &digikam; Albums. More than <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php";>1000 digital cameras</ulink> are supported by the gphoto2 library. Of course, any media or card reader supported by your operating system will interface with &digikam;. </para> <para> @@ -49,7 +49,7 @@ </para> <para> - You can also visit the <ulink url="http://www.digikam.org";>&digikam; Home Page.</ulink> for news of new releases and other &digikam; related information. + You can also visit the <ulink url="http://www.digikam.org";>&digikam; Home Page</ulink> for news of new releases and other &digikam; related information. </para> </sect2> diff --git a/digikam/intro-camerasupport.docbook b/digikam/intro-camerasupport.docbook index 80a098c..8379d7e 100644 --- a/digikam/intro-camerasupport.docbook +++ b/digikam/intro-camerasupport.docbook @@ -14,7 +14,7 @@ </note> <para> - An easy-to-use camera interface is provided, that will connect to your digital camera and download photographs directly into &digikam; Albums. More than <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php";>1000 digital cameras</ulink> are supported by the gphoto2 library. Of course, any media or card reader supported by your operating system will interface with &digikam;. + An easy-to-use camera interface is provided that will connect to your digital camera and download photographs directly into &digikam; Albums. More than <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php";>1000 digital cameras</ulink> are supported by the gphoto2 library. Of course, any media or card reader supported by your operating system will interface with &digikam;. </para> <para> diff --git a/digikam/intro-database.docbook b/digikam/intro-database.docbook index 2d63dcc..cc25adb 100644 --- a/digikam/intro-database.docbook +++ b/digikam/intro-database.docbook @@ -5,7 +5,7 @@ <title>Introduction</title> <para> - Everyone knows about database, it is used to store data. As all other photographs management programs, &digikam; too uses the database for some obvious reasons like avoiding data duplication, reducing data redundancy, a quick search engine, and greater data integrity. Moreover, the cost of data entry, storage and retrieval are drastically reduced. Additionally, any user can access the data using query language. + Everyone knows about a database; it is used to store data. As all other photographs management programs, &digikam; too uses the database for some obvious reasons like avoiding data duplication, reducing data redundancy, a quick search engine, and greater data integrity. Moreover, the cost of data entry, storage and retrieval are drastically reduced. Additionally, any user can access the data using query language. </para> <para> @@ -14,7 +14,7 @@ <para> - The &digikam; actually manages more than one databases. For convenience, it is broadly categorized in three: + The &digikam; actually manages more than one database. For convenience, it is broadly categorized in three: <orderedlist> @@ -40,7 +40,7 @@ <title>Technical Background and Configuration</title> <para> - The whole details of database settings is mostly given in the setup section about <link linkend="using-setup-database">&digikam; databases</link>. + The whole details of database settings are mostly given in the setup section about <link linkend="using-setup-database">&digikam; databases</link>. </para> </sect2> diff --git a/digikam/intro-firstrun.docbook b/digikam/intro-firstrun.docbook index 7c1fed9..92f8e33 100644 --- a/digikam/intro-firstrun.docbook +++ b/digikam/intro-firstrun.docbook @@ -14,7 +14,7 @@ </para> <para> - When you start &digikam; for the very first time it will ask you where you store your photographs. You can choose any local, remote or removable folder. Just type in the path name of a folder or click on the <guilabel>Browse...</guilabel> icon to select a folder from the dialog. + When you start &digikam; for the very first time, it will ask you where you store your photographs. You can choose any local, remote or removable folder. Just type in the path name of a folder or click on the <guilabel>Browse...</guilabel> icon to select a folder from the dialog. </para> <para> @@ -39,11 +39,11 @@ </para> <para> - Next, you will have to choose the way you would like to open RAW files : either with automatic adjustments or with the digiKam RAW import tool to adjust corrections manually. + Next, you will have to choose the way you would like to open RAW files: either with automatic adjustments or with the digiKam RAW import tool to adjust corrections manually. </para> <para> - If you don't know what is a RAW file or if your camera doesn't support RAW files, you should keep the default setting and skip this step. + If you don't know what a RAW file is, or if your camera doesn't support RAW files, you should keep the default setting and skip this step. </para> <para> @@ -87,7 +87,7 @@ </para> <para> - Tooltips are a fast and easy way to display important information about a photograph, they popup as the mouse hovers over a thumbnail. Select "Use tooltips" if you want to display them. + Tooltips are a fast and easy way to display important information about a photograph; they popup as the mouse hovers over a thumbnail. Select "Use tooltips" if you want to display them. </para> <para> @@ -129,11 +129,11 @@ </para> <para> - When you use an existing folder of photographs, as the Album Library folder, you will notice that the Albums in the Album list do not have photographs as their icons. You can change that by dragging any photograph in the Album onto the folder icon in the left sidebar and use this as the Album icon. See the <link linkend="using-mainwindow-albumsview">Album</link> section for details of how to change the Album icon. + When you use an existing folder of photographs as the Album Library folder, you will notice that the Albums in the Album list do not have photographs as their icons. You can change that by dragging any photograph in the Album onto the folder icon in the left sidebar and use this as the Album icon. See the <link linkend="using-mainwindow-albumsview">Album</link> section for details of how to change the Album icon. </para> <para> - &digikam; uses a dedicated database to store thumbnails with an optimized wavelets compression algorithm (PGF) thumbnail folders. There is no way of hiding non-standard thumbnail folders from the <quote>Albums</quote> list. If you want to keep them you could create an Album Category that just contains all the thumbnail Folders and then view your Albums in <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem><guimenuitem>By Category</guimenuitem></menuchoice> order. See the <link linkend="using-mainwindow-albumsview">Album</link> section for more about Album Categories. + &digikam; uses a dedicated database to store thumbnails with an optimized wavelets compression algorithm (PGF). There is no way of hiding non-standard thumbnail folders from the <quote>Albums</quote> list. If you want to keep them you could create an Album Category that just contains all the thumbnail Folders and then view your Albums in <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem><guimenuitem>By Category</guimenuitem></menuchoice> order. See the <link linkend="using-mainwindow-albumsview">Album</link> section for more about Album Categories. </para> <para> diff --git a/digikam/intro-imageformats.docbook b/digikam/intro-imageformats.docbook index ece8782..23dad0b 100644 --- a/digikam/intro-imageformats.docbook +++ b/digikam/intro-imageformats.docbook @@ -11,7 +11,7 @@ </para> <para> - &digikam; only displays files that are in formats that it understands. It does this by looking at the file extension on the files and checking this against a predefined list. If the file extension is in the list &digikam; will show the file in the Image View, provided the appropriate library is installed. You can change the list of file extensions that &digikam; will accept, see the <link linkend="using-setup">Configuration</link> section for more details. + &digikam; only displays files that are in formats that it understands. It does this by looking at the file extension on the files and checking this against a predefined list. If the file extension is in the list &digikam; will show the file in the Image View, provided the appropriate library is installed. You can change the list of file extensions that &digikam; will accept; see the <link linkend="using-setup">Configuration</link> section for more details. </para> <para> @@ -35,11 +35,11 @@ <sect2> <title>JPEG</title> <para> - JPEG is a compressed format, that trades some of the image quality to keep file sizes small. In fact, most cameras save their images in this format unless you specify otherwise. A JPEG image is stored using lossy compression and you can vary the amount of compression. This allows you to choose between lower compression and higher image quality or greater compression and poorer quality. The only reason to choose higher compression is because it creates smaller file so you can store more images, and it's easier to send them by e-mail or post them on the Web. Most cameras give you two or three choices equivalent to good, better, best although the names vary. + JPEG is a compressed format that trades some of the image quality to keep file sizes small. In fact, most cameras save their images in this format unless you specify otherwise. A JPEG image is stored using lossy compression, and you can vary the amount of compression. This allows you to choose between lower compression and higher image quality or greater compression and poorer quality. The only reason to choose higher compression is because it creates smaller files so you can store more images, and it's easier to send them by e-mail or post them on the Web. Most cameras give you two or three choices equivalent to good, better, best, although the names vary. </para> <para> - JPEG 2000 is supported as well. It provides for the same compression ratio the better (smoother) results compared to JPEG. The 2000 version has the option of being lossless if so specified in the settings. + JPEG 2000 is supported as well. It provides for the same compression ratio with better (smoother) results compared to JPEG. The 2000 version has the option of being lossless if so specified in the settings. </para> </sect2> @@ -47,7 +47,7 @@ <sect2> <title>TIFF</title> <para> - TIFF has been widely accepted and widely supported as an image format. Commonly, TIFF may be stored by the camera in uncompressed form or using lossless compression algorithm (Deflate). It maintains higher image quality but at the expense of much larger file sizes. Some cameras let you save your images in this format and it is a popular format because of its lossless compression algorithm. The problem is that the format has been altered by so many people that there are now 50 or more flavors and not all are recognizable by programs. + TIFF has been widely accepted and widely supported as an image format. Commonly, TIFF may be stored by the camera in uncompressed form or using a lossless compression algorithm (Deflate). It maintains higher image quality but at the expense of much larger file sizes. Some cameras let you save your images in this format, and it is a popular format because of its lossless compression algorithm. The problem is that the format has been altered by so many people that there are now 50 or more flavors and not all are recognizable by programs. </para> </sect2> @@ -79,7 +79,7 @@ </para> <para> - If you want to learn more about RAW image format visit the very helpful guides<ulink url="https://en.wikipedia.org/wiki/Raw_image_format";> Wikipedia,</ulink> <ulink url="http://www.luminous-landscape.com/tutorials/understanding-series/u-raw-files.shtml";> The Luminous Landscape,</ulink> and <ulink url="http://www.cambridgeincolour.com/tutorials/RAW-file-format.htm";> Cambridge in Colour</ulink>. You can convert RAW format images into JPEG, PNG, or TIFF in &digikam; using the <link linkend="raw-workflow">Image Editor</link>. + If you want to learn more about RAW image format visit the very helpful guides <ulink url="https://en.wikipedia.org/wiki/Raw_image_format";>Wikipedia,</ulink> <ulink url="http://www.luminous-landscape.com/tutorials/understanding-series/u-raw-files.shtml";> The Luminous Landscape,</ulink> and <ulink url="http://www.cambridgeincolour.com/tutorials/RAW-file-format.htm";> Cambridge in Colour</ulink>. You can convert RAW format images into JPEG, PNG, or TIFF in &digikam; using the <link linkend="raw-workflow">Image Editor</link>. </para> <para> diff --git a/digikam/intro-movieformats.docbook b/digikam/intro-movieformats.docbook index 73ca1f4..b542ea5 100644 --- a/digikam/intro-movieformats.docbook +++ b/digikam/intro-movieformats.docbook @@ -29,7 +29,7 @@ </para> <para> - FFmpeg codec is available under &Linux; desktop, MacOS, and Windows. You will don't need to install extra video codec on your computer. + FFmpeg codec is available under &Linux; desktop, MacOS, and Windows. You don't need to install extra video codecs on your computer. </para> </sect2> @@ -38,9 +38,9 @@ <title>Video Features</title> <para> - With &digikam;, you will be able to read video metadata, as movies length, video frames per seconds, video size, and encoding options, - in goal to populate the database at scanning and to perform searches on your collection about video properties. - You will be able to play video in embedded preview mode, and while a slideshow. This include to preview video from your camera device before + With &digikam;, you will be able to read video metadata, such as movie length, video frames per second, video size, and encoding options, + in order to populate the database at scanning and to perform searches on your collection about video properties. + You will be able to play video in embedded preview mode, and in a slideshow. This includes previewing video from your camera device before downloading (only with USB Mass Storage connection mode). </para>
