Git commit e707736bcc64b37e02c18bf7200e4c9ac8943d25 by Yuri Chornoivan. Committed on 04/09/2016 at 10:46. Pushed by yurchor into branch 'master'.
Fix minor issues M +1 -1 digikam/editor-cm-connection.docbook M +1 -1 digikam/editor-cm-monitor.docbook M +1 -1 digikam/editor-cm-pcs.docbook M +1 -1 digikam/intro-database.docbook M +2 -2 digikam/intro-movieformats.docbook M +19 -19 digikam/using-mainwindow.docbook http://commits.kde.org/digikam-doc/e707736bcc64b37e02c18bf7200e4c9ac8943d25 diff --git a/digikam/editor-cm-connection.docbook b/digikam/editor-cm-connection.docbook index f6f3724..f5b4a70 100644 --- a/digikam/editor-cm-connection.docbook +++ b/digikam/editor-cm-connection.docbook @@ -1,7 +1,7 @@ <sect2 id="editor-cm-connection"> <title>The Color Space Connections</title> <para> - So the question for each RGB trio of values in the (let us assume) 16-bit tiff produced by dcraw becomes, "What does a particular trio of RGB values for the pixels making up images produced by this particular (make and model) camera really mean in terms of some absolute standard referencing some ideal observer". This absolute standard referencing an ideal observer is more commonly called a <emphasis>Profile Connection Space</emphasis>. A camera profile is needed to accurately characterize or describe the response of a given camera's pixels to light entering that camera, so that the RGB values in the output file produced by the raw converter can be translated first into an absolute Profile Connection Space (PCS) and then from the PCS to your chosen working space. As a very important aside, for most of the open source world (including digikam), the software used to translate from the camera profile to the PCS and from the PCS to your chosen working space and eventually to your chosen output space (for printing or perhaps monitor display) is based on lcms (the <ulink url="http://littlecms.com";>little color management engine</ulink>). For what it's worth, my own testing has shown that lcms does more accurate conversions than Adobe's proprietary color conversion engine. Further, for almost all raw conversion programs, including commercial closed source software such as Adobe Photoshop, the raw conversion is typically based on decoding of the proprietary raw file done by dcraw. David Coffin, author of dcraw, is the hero of raw conversion - without him we'd all be stuck using the usually windows/mac only proprietary software that comes with our digital cameras. The dcraw's interpolation algorithms (not to be confused with the aforementioned decoding of the proprietary raw file), which are part of &digikam; if properly used, produce results equal or superior to commercial, closed source software. We in the world of linux and open source software are not second-class citizens when it comes to digital imaging. Far from. + So the question for each RGB trio of values in the (let us assume) 16-bit tiff produced by dcraw becomes, "What does a particular trio of RGB values for the pixels making up images produced by this particular (make and model) camera really mean in terms of some absolute standard referencing some ideal observer". This absolute standard referencing an ideal observer is more commonly called a <emphasis>Profile Connection Space</emphasis>. A camera profile is needed to accurately characterize or describe the response of a given camera's pixels to light entering that camera, so that the RGB values in the output file produced by the raw converter can be translated first into an absolute Profile Connection Space (PCS) and then from the PCS to your chosen working space. As a very important aside, for most of the open source world (including digikam), the software used to translate from the camera profile to the PCS and from the PCS to your chosen working space and eventually to your chosen output space (for printing or perhaps monitor display) is based on lcms (the <ulink url="http://littlecms.com";>little color management engine</ulink>). For what it's worth, my own testing has shown that lcms does more accurate conversions than Adobe's proprietary color conversion engine. Further, for almost all raw conversion programs, including commercial closed source software such as Adobe Photoshop, the raw conversion is typically based on decoding of the proprietary raw file done by dcraw. David Coffin, author of dcraw, is the hero of raw conversion - without him we'd all be stuck using the usually windows/mac only proprietary software that comes with our digital cameras. The dcraw's interpolation algorithms (not to be confused with the aforementioned decoding of the proprietary raw file), which are part of &digikam; if properly used, produce results equal or superior to commercial, closed source software. We in the world of &Linux; and open source software are not second-class citizens when it comes to digital imaging. Far from. </para> <para> diff --git a/digikam/editor-cm-monitor.docbook b/digikam/editor-cm-monitor.docbook index 611d447..e445daa 100644 --- a/digikam/editor-cm-monitor.docbook +++ b/digikam/editor-cm-monitor.docbook @@ -89,7 +89,7 @@ <title>Where are all the icc profiles are located on my computer?</title> <para> - Well, this is Linux and it depends on where you put them. I put all my icc profiles in the /usr/share/color/icc folder, which is the closest there is at this moment to a standard Linux location for icc profiles. If you use this folder for your icc profiles, likely you will need to change permissions on the folder to allow your user read/write access. Then you just tell &digikam; <ulink url="help:/digikam/using-setup.html#setup-iccprofiles">where your profiles are located</ulink>. + Well, this is &Linux; and it depends on where you put them. I put all my icc profiles in the /usr/share/color/icc folder, which is the closest there is at this moment to a standard Linux location for icc profiles. If you use this folder for your icc profiles, likely you will need to change permissions on the folder to allow your user read/write access. Then you just tell &digikam; <ulink url="help:/digikam/using-setup.html#setup-iccprofiles">where your profiles are located</ulink>. </para> </sect3> diff --git a/digikam/editor-cm-pcs.docbook b/digikam/editor-cm-pcs.docbook index 9ff3d89..dc08a71 100644 --- a/digikam/editor-cm-pcs.docbook +++ b/digikam/editor-cm-pcs.docbook @@ -44,7 +44,7 @@ </para> <para> - To be useful, color profiles need to be coupled with software that performs the translation from one color space to another via the PCS. In the world of linux open source software (and also many closed source, commercial softwares), translation from one color space to another usually is done by <ulink url="http://www.littlecms.com/";>LCMS</ulink>, the "little color management software". For what it's worth, my own testing has shown that LCMS does more accurate color space conversions than Adobe's proprietary color conversion engine. + To be useful, color profiles need to be coupled with software that performs the translation from one color space to another via the PCS. In the world of &Linux; open source software (and also many closed source, commercial softwares), translation from one color space to another usually is done by <ulink url="http://www.littlecms.com/";>LCMS</ulink>, the "little color management software". For what it's worth, my own testing has shown that LCMS does more accurate color space conversions than Adobe's proprietary color conversion engine. </para> </sect3> diff --git a/digikam/intro-database.docbook b/digikam/intro-database.docbook index 890d618..2f6d671 100644 --- a/digikam/intro-database.docbook +++ b/digikam/intro-database.docbook @@ -245,7 +245,7 @@ </para> <para> - With slow network, &digikam; hangs a lot of time especially when album contains many items (>1000). This solution relies on network performance. Problem has been reproducible using Wifi connection, for instance. Switching to Ethernet must solves the problem. + With slow network, &digikam; hangs a lot of time especially when album contains many items (>1000). This solution relies on network performance. Problem has been reproducible using Wifi connection, for instance. Switching to Ethernet must solve the problem. </para> <para> diff --git a/digikam/intro-movieformats.docbook b/digikam/intro-movieformats.docbook index 5955d6d..37edb28 100644 --- a/digikam/intro-movieformats.docbook +++ b/digikam/intro-movieformats.docbook @@ -24,13 +24,13 @@ <para> &digikam; relies on <ulink url="http://doc.qt.io/qt-5/multimediaoverview.html";>Qt5 Multimedia framework</ulink> to handle video files. - You must take a care to have installed all parts of this frameworks on your computer, and expecially the multimedia plugins interface. + You must take a care to have installed all parts of this frameworks on your computer, and especially the multimedia plugins interface. This framework will able to play video files depending on the availability of video codecs installed on your system. &digikam; do not include extra video codec. This codecs are loaded on demand at running time. </para> <para> - On Linux desktop, this framework will use GStreamer backends. You need to install GStreamer plugins named "Good", "Bad" and "Ugly", + On &Linux; desktop, this framework will use GStreamer backends. You need to install GStreamer plugins named "Good", "Bad" and "Ugly", to be sure that all video formats will be handled by Qt5 Multimedia interface. </para> diff --git a/digikam/using-mainwindow.docbook b/digikam/using-mainwindow.docbook index db47a9b..cb59f98 100644 --- a/digikam/using-mainwindow.docbook +++ b/digikam/using-mainwindow.docbook @@ -13,11 +13,11 @@ <title>Areas and Bars</title> <para> - &digikam;'s main window has two areas in the center showing your photograhps. One is the <firstterm>Icon Area</firstterm>, showing thumnails of the content of the selected album or of a search result, and the other one the <firstterm>Preview</firstterm>, showing the selected image. Together let's call them the <link linkend="using-imagearea">Image Area</link>. In the top left corner of the Preview we have a few buttons for moving back and forth through the content of the album, for rotating the image, for showing or adding face tags and to switch to fullscreen mode. By clicking on the preview you can make it disappear and by clicking on the picture area of a thumbnail open it again. + &digikam;'s main window has two areas in the center showing your photographs. One is the <firstterm>Icon Area</firstterm>, showing thumbnails of the content of the selected album or of a search result, and the other one the <firstterm>Preview</firstterm>, showing the selected image. Together let's call them the <link linkend="using-imagearea">Image Area</link>. In the top left corner of the Preview we have a few buttons for moving back and forth through the content of the album, for rotating the image, for showing or adding face tags and to switch to fullscreen mode. By clicking on the preview you can make it disappear and by clicking on the picture area of a thumbnail open it again. </para> <para> - The Image Area in the center is surrounded by the menu bar and the <link linkend="maininterface-toolbar">Main Toolbar</link> at the top, the <link linkend="maininterface-statusbar">Status Bar</link> at the bottom and the Left and <link linkend="using-sidebar-intro">Right Sidebar</link>. The Left Sidebar lets you switch between eight <quote>Views</quote>: Albums (shown here), Tags, Labels, Dates, Timeline, Search, Fuzzy (Search) and People (Tags). The Right Sidebar can be used to show all informations about your images and partly also to edit them. You can use all these views to organize and find your photographs. If you click on one of the buttons on the sidebars there will fold out another area, offering possibilities to select, to make inputs, ⪚ for searches, to edit data and to show informations. + The Image Area in the center is surrounded by the menu bar and the <link linkend="maininterface-toolbar">Main Toolbar</link> at the top, the <link linkend="maininterface-statusbar">Status Bar</link> at the bottom and the Left and <link linkend="using-sidebar-intro">Right Sidebar</link>. The Left Sidebar lets you switch between eight <quote>Views</quote>: Albums (shown here), Tags, Labels, Dates, Timeline, Search, Fuzzy (Search) and People (Tags). The Right Sidebar can be used to show all information about your images and partly also to edit them. You can use all these views to organize and find your photographs. If you click on one of the buttons on the sidebars there will fold out another area, offering possibilities to select, to make inputs, ⪚ for searches, to edit data and to show information. </para> <para> @@ -141,7 +141,7 @@ </para> <para> - As an alternative you can display the photograhps in a table by hitting the <menuchoice><guimenu>Table</guimenu></menuchoice> button on the Main Toolbar or by selecting <menuchoice><guimenu>View</guimenu><guimenuitem>Table</guimenuitem></menuchoice> menu from the menu bar. This allows to see a lot of photograhps at the same time (Tip: leave away the thumbnail column) in a way you can customize the usual way by right-clicking on the headline bar and choose the informations you want to see. Left-clicking on a line in the table will open the preview of that photograph. + As an alternative you can display the photographs in a table by hitting the <menuchoice><guimenu>Table</guimenu></menuchoice> button on the Main Toolbar or by selecting <menuchoice><guimenu>View</guimenu><guimenuitem>Table</guimenuitem></menuchoice> menu from the menu bar. This allows to see a lot of photographs at the same time (Tip: leave away the thumbnail column) in a way you can customize the usual way by right-clicking on the headline bar and choose the information you want to see. Left-clicking on a line in the table will open the preview of that photograph. </para> <para> @@ -187,7 +187,7 @@ </para> <para> - You can also view your images in a slideshow using the <quote>Slideshow</quote> drop down menu from the Main Toolbar. You have the choice to start a slideshow with a selection of photograhps, the whole content of the folder (or search result) or even including all subfolders. + You can also view your images in a slideshow using the <quote>Slideshow</quote> drop down menu from the Main Toolbar. You have the choice to start a slideshow with a selection of photographs, the whole content of the folder (or search result) or even including all subfolders. </para> </sect3> @@ -210,7 +210,7 @@ <title>Viewing or Editing a Photograph With Another Application</title> <para> - Sometimes &digikam; may not provide all of the capabilities you need. You can open a photograph in another application by right-clicking on it and selecting from the <guilabel>Open With...</guilabel> sub-menu (At the moment this function is available only under LINUX). The list of applications that appear in this menu is controlled by the standard desktop file associations for the image format type of this photograph. Consult the desktop manual for instructions on changing these file associations if the application that you need is not listed. + Sometimes &digikam; may not provide all of the capabilities you need. You can open a photograph in another application by right-clicking on it and selecting from the <guilabel>Open With...</guilabel> sub-menu (At the moment this function is available only under &Linux;). The list of applications that appear in this menu is controlled by the standard desktop file associations for the image format type of this photograph. Consult the desktop manual for instructions on changing these file associations if the application that you need is not listed. </para> <para> @@ -256,7 +256,7 @@ </para> <para> - You can also batch rename photograhps. One method is to use the <link linkend="bqm.anchor">Batch Queue Manager</link> (B). Another one is to select multiple photograhps and then press F2. A dialog will open showing the list of selected photograhps with their current name and the new name. These two are identical at first until you place the cursor in the input field, type in something and/or select a modifier from the buttons below. Make use of the tooltips! + You can also batch rename photographs. One method is to use the <link linkend="bqm.anchor">Batch Queue Manager</link> (B). Another one is to select multiple photographs and then press F2. A dialog will open showing the list of selected photographs with their current name and the new name. These two are identical at first until you place the cursor in the input field, type in something and/or select a modifier from the buttons below. Make use of the tooltips! </para> </sect3> @@ -288,8 +288,8 @@ </para> <para> - By clicking the "Albums" button on the left side bar you toggle the "Albums" tree which provides an organized view of your photograph albums. The top item "Albums" just shows the "welcome to digiKam" screen in the view area. The next level of the "Albums" tree shows your different Collections (marked by the <inlinemediaobject><imageobject><imagedata fileref="&path;using-mainwindow-icon-collection.png" format="PNG" /> </imageobject> - </inlinemediaobject> icon) or at least one if you haven't added one or more yet in the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure digiKam...</guimenuitem></menuchoice> Collections section. Each Collection represents a folder branch on your harddisk, on removable media or on network shares and the next levels in the tree show the structure of those folders, here called "Albums". The albums can be sorted by their folder layout on the hard disk, by the Category that has been set in the <link linkend="albumpropsedit.anchor">Album Properties</link> or by the Date of that Albums (this date can also be changed in the Properties of each Album). You can invert the sort order (ascending/descending) by clicking on the title bar of the album tree. + By clicking the <quote>Albums</quote> button on the left side bar you toggle the <quote>Albums</quote> tree which provides an organized view of your photograph albums. The top item <quote>Albums</quote> just shows the <quote>welcome to &digikam;</quote> screen in the view area. The next level of the <quote>Albums</quote> tree shows your different Collections (marked by the <inlinemediaobject><imageobject><imagedata fileref="&path;using-mainwindow-icon-collection.png" format="PNG" /> </imageobject> + </inlinemediaobject> icon) or at least one if you haven't added one or more yet in the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &digikam;...</guimenuitem></menuchoice> Collections section. Each Collection represents a folder branch on your harddisk, on removable media or on network shares and the next levels in the tree show the structure of those folders, here called <quote>Albums</quote>. The albums can be sorted by their folder layout on the hard disk, by the Category that has been set in the <link linkend="albumpropsedit.anchor">Album Properties</link> or by the Date of that Albums (this date can also be changed in the Properties of each Album). You can invert the sort order (ascending/descending) by clicking on the title bar of the album tree. </para> <para> @@ -300,7 +300,7 @@ <title>Creating a New Album</title> <para> - There are a number of ways to create a new Album. You can create a new Album when you upload new photographs from the Camera using <menuchoice><guimenu>Import</guimenu> <guimenuitem>Cameras</guimenuitem></menuchoice>. You can also create a new empty Album with <menuchoice><guimenu>Album</guimenu> <guimenuitem>New...</guimenuitem></menuchoice> (Ctrl+N) in the "Albums" view. As an additional option, you can create a new Album by importing an existing folder of photographs from your computer; just select <menuchoice><guimenu>Import</guimenu> <guimenuitem>Add Folders...</guimenuitem></menuchoice> from the menu bar and select the folder that you want to import. An Album will be created with the same name as the hard disk folder. You can use drag and drop to import a folder. Drag a folder icon, for example from a &konqueror; window. Then drop it on the album list on the left. A menu will appear that gives you the option to move or copy the folder into &digikam;. + There are a number of ways to create a new Album. You can create a new Album when you upload new photographs from the Camera using <menuchoice><guimenu>Import</guimenu> <guimenuitem>Cameras</guimenuitem></menuchoice>. You can also create a new empty Album with <menuchoice><guimenu>Album</guimenu> <guimenuitem>New...</guimenuitem></menuchoice> (Ctrl+N) in the <quote>Albums</quote> view. As an additional option, you can create a new Album by importing an existing folder of photographs from your computer; just select <menuchoice><guimenu>Import</guimenu> <guimenuitem>Add Folders...</guimenuitem></menuchoice> from the menu bar and select the folder that you want to import. An Album will be created with the same name as the hard disk folder. You can use drag and drop to import a folder. Drag a folder icon, for example from a &konqueror; window. Then drop it on the album list on the left. A menu will appear that gives you the option to move or copy the folder into &digikam;. </para> </sect3> @@ -309,7 +309,7 @@ <title>Deleting an Album</title> <para> - When you delete an Album from &digikam; it will be moved into the internal Trash Can. As an option you could change this behavior, so that delete really will remove the Album and all of the photographs in it. This can be changed by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &digikam;</guimenuitem></menuchoice> and selecting the Miscellaneous page. At the top of this page are the settings that control what happens when a photograph is deleted. To delete an Album right-click the Album in the "Albums" tree and select Delete Album from the context menu. + When you delete an Album from &digikam; it will be moved into the internal Trash Can. As an option you could change this behavior, so that delete really will remove the Album and all of the photographs in it. This can be changed by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &digikam;</guimenuitem></menuchoice> and selecting the Miscellaneous page. At the top of this page are the settings that control what happens when a photograph is deleted. To delete an Album right-click the Album in the <quote>Albums</quote> tree and select Delete Album from the context menu. </para> </sect3> @@ -318,7 +318,7 @@ <title>Adding a Photograph to an Album</title> <para> - Most of the time you will create new Albums and populate them with photographs directly from your camera using the Camera Tool. However, sometimes you may want to add a photograph that you already have on your computer to an existing Album. To add a photograph to an Album select <menuchoice><guimenu>Import</guimenu> <guimenuitem>Add Images...</guimenuitem></menuchoice> (Ctrl+Alt+I) from the menu bar. Select a source folder from the dialog and click OK. An import window will open. Select the photographs that you want to add and choose <guilabel>Download Selected</guilabel> from the "Download" drop down menu. A dialog will open where you can choose the destination album. The photographs will be copied into the Album. <guilabel>Download New</guilabel> (Ctrl+N) from the same menu will copy only those images which are not in the destination folder yet. + Most of the time you will create new Albums and populate them with photographs directly from your camera using the Camera Tool. However, sometimes you may want to add a photograph that you already have on your computer to an existing Album. To add a photograph to an Album select <menuchoice><guimenu>Import</guimenu> <guimenuitem>Add Images...</guimenuitem></menuchoice> (Ctrl+Alt+I) from the menu bar. Select a source folder from the dialog and click OK. An import window will open. Select the photographs that you want to add and choose <guilabel>Download Selected</guilabel> from the <quote>Download</quote> drop down menu. A dialog will open where you can choose the destination album. The photographs will be copied into the Album. <guilabel>Download New</guilabel> (Ctrl+N) from the same menu will copy only those images which are not in the destination folder yet. </para> <para> @@ -348,7 +348,7 @@ <anchor id="albumpropsedit.anchor"/> <para> - Album Properties can help you remember which kind of photographs are in an Album and can also help you to organize the "Albums" tree. To access the Album Properties right-click on an Album and select <guilabel>Properties</guilabel> (Alt+Return) from the context menu. + Album Properties can help you remember which kind of photographs are in an Album and can also help you to organize the <quote>Albums</quote> tree. To access the Album Properties right-click on an Album and select <guilabel>Properties</guilabel> (Alt+Return) from the context menu. </para> <para>The Album Properties dialog allows you to set:</para> @@ -383,11 +383,11 @@ <title>Setting the Album Icon</title> <para> - &digikam; displays the usual folder icon in the "Albums" list. You can choose one of your photographs instead.This may help you to remember what kind of photographs are contained in an Album. + &digikam; displays the usual folder icon in the <quote>Albums</quote> list. You can choose one of your photographs instead. This may help you to remember what kind of photographs are contained in an Album. </para> <para> - To select a photograph as the Album icon, right-click on the photograph that you want to use as the Album icon and select "Set as Album Thumbnail" from the context menu. Additionally you can use drag and drop to set the Album icon. Drag the photographs icon from the thumbnail area and drop it on the currently selected Album in the Album list. + To select a photograph as the Album icon, right-click on the photograph that you want to use as the Album icon and select <guimenuitem>Set as Album Thumbnail</guimenuitem> from the context menu. Additionally you can use drag and drop to set the Album icon. Drag the photographs icon from the thumbnail area and drop it on the currently selected Album in the Album list. </para> <note> @@ -412,7 +412,7 @@ </para> <para> - The "Dates" view organizes your photographs based on their dates. &digikam; uses either the + The <quote>Dates</quote> view organizes your photographs based on their dates. &digikam; uses either the EXIF date or, if no EXIF date is available, the last modification time of the file. </para> @@ -439,7 +439,7 @@ </para> <para> - Tags can be arranged in a hierarchical tree. This allows you to organize your tags in a logical manner. One can collapse parts of the tree in the "Tags" list so that one can easily find the tags that you are looking for. + Tags can be arranged in a hierarchical tree. This allows you to organize your tags in a logical manner. One can collapse parts of the tree in the <quote>Tags</quote> list so that one can easily find the tags that you are looking for. </para> <tip> @@ -451,7 +451,7 @@ <sect3 id="using-managetags"> <title>Managing Tags</title> <para> - You can add new tags by right-clicking on either the "Tags" label or an existing tag and selecting <guilabel>New Tag</guilabel>. If you add a new tag by right-clicking on an existing tag, your new tag will be created as a sub-tag. + You can add new tags by right-clicking on either the <quote>Tags</quote> label or an existing tag and selecting <guilabel>New Tag</guilabel>. If you add a new tag by right-clicking on an existing tag, your new tag will be created as a sub-tag. </para> <para> @@ -464,7 +464,7 @@ </para> <para> - You can set the Tag Properties by right-clicking on a Tag and selecting <guilabel>Edit Tag Properties</guilabel>. The Tag Properties allow you to change the name of the tag and the icon used in the "Tags" tree. + You can set the Tag Properties by right-clicking on a Tag and selecting <guilabel>Edit Tag Properties</guilabel>. The Tag Properties allow you to change the name of the tag and the icon used in the <quote>Tags</quote> tree. </para> <para> @@ -589,7 +589,7 @@ </para> <para> - The <guilabel>Search Rules</guilabel> list is used to set all options to process a search query in the albums database. All rules are listed vertically and separated by an operator. An option can be added or deleted to the list using <guilabel>Add Search Group/Remove Group</guilabel>. Each option can be combined with another one using <guilabel>Meet all..</guilabel> or <guilabel>Meet any...</guilabel> or <guilabel>one of these...</guilabel> <guilabel>At least one...</guilabel> logical operators. Thus, one can construct searches of the type "AND NOT". + The <guilabel>Search Rules</guilabel> list is used to set all options to process a search query in the albums database. All rules are listed vertically and separated by an operator. An option can be added or deleted to the list using <guilabel>Add Search Group/Remove Group</guilabel>. Each option can be combined with another one using <guilabel>Meet all..</guilabel> or <guilabel>Meet any...</guilabel> or <guilabel>one of these...</guilabel> <guilabel>At least one...</guilabel> logical operators. Thus, one can construct searches of the type <quote>AND NOT</quote>. </para> </sect3>
