diff --git a/digikam/menu-mainwindow.docbook b/digikam/menu-mainwindow.docbook
index 51afbfd..9f86b35 100644
--- a/digikam/menu-mainwindow.docbook
+++ b/digikam/menu-mainwindow.docbook
@@ -1,1234 +1,1234 @@
The main &digikam; windowThe Browse Menu
The Browse menu provides access to the same views you can see on the Left Sidebar. Descriptions see under The Main &digikam; Window. In addition there are "Back" and "Forward" menu items that will lead you through the history of your &digikam; use in the same way you are used to from an internet browser for example. And finally there is the "Quit" item to leave &digikam;.
The Album Menu
The first five items of this menu (above the separator) are only active if you are in the Albums View.
&Ctrl;NAlbumNew...Opens a dialog to create a new album folder similar to the album properties dialog described here. It just has an additional drop down field where you can choose whether the new album is created as a child of the current one or at the root of the current collection.AlbumPropertiesEdit the currently selected album title, caption and collection as described here.F5AlbumRenameRename the current album.AlbumOpen in File ManagerOpen the default file manager with the current Album path.AlbumDelete AlbumDelete/Move to trash selected Album and all items in it.______________________________AlbumWrite Metadata to ImagesWrite the metadata in the database to the file's metadata of all items in the current album. The images will inherit the database metadata, not the other way round as in the next menu item.AlbumReread Metadata From ImagesWrite the metadata of all items in the current album to the database. The database will inherit the images metadata, not the other way round as in the previous menu item.The Tag Menu
The items below the separator are only active if you are in the Tags View.
TagTag ManagerOpens the &digikam; Tag Manager.______________________________TagNew...A dialog will open where you can type in the tag name (or even a whole hierarchy branch), assign an icon and/or a shortcut to the tag. The new tag will be created as a sub-tag of the selected tag.TagPropertiesThe Tag Properties allow you to change the name of the tag, the icon used in the Tags tree and the shortcut.TagDeleteRemove the currently selected Tag from the Album's Database. This doesn't delete the images the tag was assigned to.The Item MenuF4ItemOpen...Opens the selected image in the &digikam; image editor.MetaF4ItemOpen With Default ApplicationOpens the selected item in the default application according to the mimetype, ⪚ Gwenview.______________________________F2ItemRenameRenames the currently selected item(s). See description
here.
DelItemMove to trashMoves selected item(s) to trash (recoverable delete).______________________________&Ctrl;LItemPlace onto Light TableInserts selection into the Light Table thumbbar and puts the Light Table into the foreground.&Ctrl;&Shift;LItemAdd to Light TableAdds selection to the Light Table thumbbar and puts the Light Table into the foreground.&Ctrl;BItemAdd to Current QueueOpens the &digikam; Batch Queue Manager and adds selection to the current queue or, if there is no queue yet, to a new queue.&Ctrl;&Shift;BItemAdd to New QueueOpens the &digikam; Batch Queue Manager and puts selection into a new queue.ItemFind Similar...Puts the selected item into the Image tab in the Fuzzy View.
See the dedicated
Image (Similar items)
for more information.
ItemWrite Metadata to ImageTODOItemReread Metadata from ImageWhen editing metadata using the Metadata Editor the data will be written to the image only. If you want them to appear in the Metadata Tab of the Right Sidebar you got to use this function first.______________________________ItemRotate
Menu entry for rotating the currently selected images lossless
&Ctrl;&Shift;&Left;Left
or
&Ctrl;&Shift;&Right;Right
in 90 degree steps (see submenu).
ItemFlip
Menu entry for flipping the currently selected images lossless
&Ctrl;*Horizontally
or
&Ctrl;/Vertically
(see submenu).
ItemAuto Rotate/Flip using EXIF information
Menu entry to manually activate the auto rotate/flip feature for the currently selected images using the EXIF orientation tag. For a more detailed description see
Lossless Image Rotation.
ItemAdjust EXIF Orientation TagThe EXIF Orientation Tag of the current selection will be changed depending on the option you choose from the submenu. The thumbnail(s) and preview(s) will be rotated accordingly if Show images/thumbnails rotated according to orientation tag is checked in
SettingsConfigure &digikam;...MetadataRotationRotate actions
, but not the actual image file. If you want to rotate that as well you got to use the function
ItemAuto Rotate/Flip using EXIF information
described above additionally. If you open the file in the &digikam; Image Editor it will also come up in the rotated version and will be stored that way on disc if you save it. But be aware of the fact that this would be a lossy operation as long as it is not a lossless file format.ItemEdit Metadata...
Opens the &digikam; Metadata Editor to handle meta data of the image (EXIF, IPTC, XMP).
See the dedicated
Metadata Editor
chapter for more information.
ItemEdit Geolocation...
Opens the &digikam; Geolocation Editor to handle GPS meta data of the image.
See the dedicated
Geolocation Tool
for more information.
______________________________ItemPrint
Calls standard print dialog.
ItemPrint Assistant...
Tool to print Album images.
See the dedicated
Print Wizard
for more information.
The Edit Menu
Beside the usual "Cut", "Copy" and "Paste" the Edit Menu contains the following items:
&Ctrl;AEditSelect AllSelect all images currently shown&Ctrl;&Shift;AEditSelect NoneUn-select all items in the current view&Ctrl;IEditInvert SelectionInvert the current selectionThe View MenuViewThumbnailsShows thumbnails in the Image AreaF3ViewPreview ImageShows additionally a preview in the Image Area.
The preview has "Back" and "Forward" buttons at the top left corner to navigate through all the images currently shown.
ViewMapShows images on a map.ViewTable
- Shows images in a table where you can choose by right clicking on the title bar which informations you want to be displayed.
+ Shows images in a table where you can choose by right clicking on the title bar which information you want to be displayed.
By default you have these four items also on the main toolbar.
______________________________ViewSlideshowSlide Show including RAW files.F9ViewSlideshowAllStart slide show of all images in current window.&Alt;F9ViewSlideshowSelectionStart slide show on selected images.&Shift;F9ViewSlideshowWith All Sub-AlbumsSlide show that recurses through the current album tree.&Alt;&Shift;F9ViewSlideshowPresentation...
Tool to display an advanced slide show with Album items.
See the dedicated
Presentation Tool
for more information.
&Ctrl;&Shift;FViewFull Screen ModeSwitch to full screen (Return with the same keyboard shortcut).______________________________&Ctrl;+,+ViewZoom inIncrease preview or the thumbnail size of the currently selected Album.&Ctrl;-,-ViewZoom outDecrease preview or the thumbnail size of the currently selected Album.______________________________&Ctrl;,ViewZoom to 100%Will show the image 1:1 (meaning 1 image pixel is mapped exactly to 1 screen pixel) in preview mode.
&Ctrl;&Alt;EViewFit to WindowWill size the image as to fit snug into the window.______________________________ViewSort AlbumsSort all &digikam; Albums by Folder, by Category or by Date.ViewSort ImagesSort all images in current Album by Name, Path, Date, File Size, Rating, Image Size, Aspect Ratio or by Similarity, the latter only in the Fuzzy View.ViewImage Sorting OrderSelect whether images should be sorted in ascending or descending order.ViewGroup ImagesSelect whether images should be shown un-grouped (Flat List) or grouped by album or by format.ViewGroup Sorting OrderSelect whether groups should be sorted in ascending or descending order.ViewInclude Album Sub-TreeIf a hierarchical album structure exists, the currently selected branch will be displayed in full depth.ViewInclude Tag Sub-TreeIf a hierarchical tag structure exists, the currently selected branch will be displayed in full depth.______________________________F12ViewColor-Managed ViewToggles between showing thumbnails and preview in color-managed mode or not.
For more information about color management see
this
lengthy chapter.
The Tools MenuToolsImage Editor
Opens the &digikam; Image Editor.
LToolsLight Table
Switches to the Light Table window.
BToolsBatch Queue Manager
Opens the Batch Queue Manager window.
______________________________&Ctrl;FToolsSearch...
Switches to the Search View with focus on the simple search field.
&Ctrl;&Alt;FToolsAdvanced Search...
Switches to the Search View and launches the advanced search dialog.
&Ctrl;DToolsFind Duplicates
Leads to the "Duplicates" tab in the Fuzzy View.
See
Fuzzy View
for more information.
______________________________ToolsMaintenance...
Opens the maintenance tool.
For a detailed description see this Chapter
______________________________ToolsBlend Bracketed or Focus Stack Images...
TODO
ToolsCreate Panorama...
TODO
ToolsCreate Calendar...
Tool to create a calendar with Album items.
See the dedicated
Calendar Tool
for more information.
ToolsEmail Images...
Tool to send images with your favorite email client.
See the dedicated
Send Images Tool
for more information.
The Import MenuImportCamerasAny configured digital camera will be listed here. You can use the "Add Camera Manually..." menu entry to add a new camera to the list. Please, read the Camera Settings for more information.
Once you choose a camera from the list the Camera Interface will open. For a detailed description see Using a Digital Camera With &digikam;..
ImportUSB Storage DevicesAll currently mounted USB storage devices will be listed here. The function will open the same interface as the Import/Cameras menu item.ImportCard ReadersAll currently mounted card readers will be listed here. The function will open the same interface as the Import/Cameras menu item.______________________________&Ctrl;&Alt;IImportAdd Images...After asking for the source folder with the standard Open dialog of your OS the function will display the images in that folder in the same interface as the Import/Cameras menu item.
This item is only active in the Albums View.
ImportAdd Folders...Navigate to a folder and import it entirely
This item is only active in the Albums View.
ImportImport from Scanner...Opens a scanner dialog
See the dedicated
Acquire Images Tool
for more information.
______________________________ImportImport from ...Here are following the import menu items for the webservices you have chosen in SettingsConfigure &digikam;...Plugins
and which are labeled Export in the Categories column.
The Export MenuExportKML Export...
Tool to export the images series into a KML structure. KML files can then be opened and displayed with GoogleEarth.
See the dedicated
KML Export Tool
for more information.
ToolsExport to Piwigo
Tool to upload or update images to Piwigo galleries
See the dedicated
Piwigo Export Tool
for more information.
ExportExport to Flickr...
Tool to upload or update images to Flickr server.
See the dedicated
Flickr Export Tool
for more information.
ExportExport to Google Photos...
Tool upload or update images to Google Photos galleries.
See the dedicated
Google Services Tool
for more information.
ExportExport to Google Drive...
Tool upload images to Google Drive.
See the dedicated
Google Services Tool
for more information.
ExportFlash Export
Tool to create a Flash gallery with Albums.
See the dedicated
Flash Export Tool
for more information.
The Settings MenuSettingsShow ToolbarEnable or disable the main &digikam; toolbar.&Ctrl;MSettingsShow MenubarEnable or disable the main &digikam; menu bar.
Remind the keyboard shortcut in order to be able to get it back! Another way is the context menu within the Image Area.
SettingsShow StatusbarEnable or disable the main &digikam; status bar.&Ctrl;TSettingsShow ThumbbarEnable or disable the thumbbar in the &digikam; Image Area.
This item is only active while a preview is displayed because it is meant to make more space for the preview in the Image Area.
______________________________SettingsThemesChoose from a list (submenu) of predefined color themes for the appearance of &digikam;.SettingsConfigure Shortcuts...Configure the &digikam; shortcuts and manage different schemes of shortcuts.SettingsConfigure Toolbars...Configure the &digikam; toolbars.SettingsConfigure Notifications...Configure the &digikam; notifications including actions like "Play a sound", "Log to a file" or "Run command".SettingsDatabase Migration...Launch tool to migrate the &digikam; databases from SQLite to MySQL or vice versa.
Find more information about the databases and database migration in the setup section about &digikam; databases.
SettingsConfigure &digikam;...Launch &digikam; configure dialog.
For a detailed description see &digikam; Configuration.
The Help MenuHelpSupported RAW CamerasDisplays a live filter of all supported RAW format cameras.RAW camera supportHelpComponents InformationDisplays an information panel with shared libraries and components.RAW camera supportHelpDatabase StatisticsDisplays an information panel with a database summary.RAW camera support
diff --git a/digikam/using-camera-processing.docbook b/digikam/using-camera-processing.docbook
index 220432b..cb638a3 100644
--- a/digikam/using-camera-processing.docbook
+++ b/digikam/using-camera-processing.docbook
@@ -1,175 +1,175 @@
Advanced Import Interface Operations
The Settings tab of the Right Sidebar in the Import Interface opens five sections with advanced options for the import processing.
File Renaming Options
Cameras often do not use very meaningful filenames for photographs. The filenames are usually reused once the photographs have been deleted from the camera. This can lead to filename clashes if you download photographs from many shootings into the same Album. It can also be useful to include the date and time that an image was taken into the filename.
If you select Camera filenames the image filenames will not be altered. But you have the option to change their case to upper or lower case with the Change case to: drop down field. If you select Customize you will be able to put together a renaming pattern from the Options drop down menu which contains original file name, file extension, owner and group, directory, a dialog for defining a sequence number and a dialog for adding date and time information, either fixed or based on the time information written by the camera into the image file.
In the sequence number dialog you will find two options: Extension aware numbering and Folder aware numbering. If they are checked &digikam; will start a new sequence for every file extension and / or folder.
The Date & Time dialog looks like this:
The calendar is active only if Fixed Date is selected from the Source: drop down field. This way you can add the same date and time information to the filenames of all imported images or videos. If Image is selected instead &digikam; will use the time information from the metadata of the image files. With the Format: drop down field you can choose from several standard date/time formats and a custom format. For the latter choose Custom in Format: drop-down list and fill in for example "dd.MM.yyyy hh:mm:ss". For more information, read QDateTime class reference.
In addition these options can be customized further with the help of a number of modifiers. A list of all options and modifiers together with a short explanations will open when clicking the info button.
The sequence number may be needed if you have a camera with a very fast multi-shoot mode where it is possible to get two photographs with exactly the same data and time.
The new filename that &digikam; will use for the photographs when they are downloaded is shown underneath the thumbnail in the image icon. The renaming settings will be remembered the next time you use the camera interface.
Auto-Creation of Albums
Check Extension-based sub-albums and &digikam; will create subalbums based on the file extensions of the imported images in the target album. &digikam; will open a dialog where you can choose the target album once you click one of the download options either from the toolbar or from the Item menu. If you want to create a new Album, into which you could download the photographs, click the New Album button. The new Album will be created as a sub-folder of the Album that is currently selected in the existing Album list. This means that if you do not want your new Album to be a sub-folder of an existing folder you must first select the collection where you want to create the new album. Collections are indicated by the
icon.
If your camera provides information about the date of the photograph's taking or, if you import from a USB device or a folder, the images contain EXIF metadata with date/time information, &digikam; can use this to automatically create subalbums in the target album during import. Subalbums names will be based on the image dates. All images which have the same date will be downloaded into the same subalbum if you check Date-based sub-albums. Not all cameras include this information. See the sidebar Metadata section for more detail about information your camera may have embedded in your photographs.
On the Fly Operations
This section of the Settings tab offers several options for JPEG images. The Template: drop-down field lets you choose one of your metadata templates you customized in Templates Settings. You can access the Template Manager also with the edit button to the right of the drop-down field.
- Write the document name to EXIF and Fix internal date & time writes these informations into the respective EXIF tags and XMP fields.
+ Write the document name to EXIF and Fix internal date & time writes this information into the respective EXIF tags and XMP fields.
If you check the next box &digikam; will perform the auto-rotate/flip action described in Lossless Image Rotation.
Convert to lossless file format allows you to convert the images to PNG, TIFF, PGF or JPEG2000 during import.
DNG Convert Options
This section allows to enable the DNG conversion of RAW images by checking Convert RAW images to DNG container and to select options for that conversion. To learn more about Digital Negative (DNG) use the link DNG container.
Embed original file
Embeds the original RAW file into the DNG container.
Lossless Compression
Enables lossless compression. The difference between lossy and lossless compression is said to be practically indistinguishable with DNG.
JPEG preview
Choose whether you want a medium or full size JPEG preview to be embedded into the DNG container or none at all.
Scripting
This last section of the Settings tab offers to run scripts to manipulate the images during import. You can type the filename of the script into the input field or search for it using the Browse... button. Check out the info button for additional expressions to customize the command line!
diff --git a/digikam/using-sidebar-properties.docbook b/digikam/using-sidebar-properties.docbook
index 12f3296..4d30c8f 100644
--- a/digikam/using-sidebar-properties.docbook
+++ b/digikam/using-sidebar-properties.docbook
@@ -1,48 +1,48 @@
Properties
- The properties sidebar shows the essential informations about the selected image which are largely self-explanatory. It is grouped into the following sections:
+ The properties sidebar shows the essential information about the selected image which are largely self-explanatory. It is grouped into the following sections:
- File Properties: these are file system related informations
+ File Properties: these are file system related information
Image Properties: shows the image and format properties like dimension, compression, color-depth, &etc;
Photograph Properties: shows a summary of the most important parameters when taking the photograph. These data are taken from the EXIF or XMP data fields if available.
&digikam; Properties: optional view to show a summary of the most important values set in &digikam; database.
diff --git a/digikam/using-sidebar-versions.docbook b/digikam/using-sidebar-versions.docbook
index 9cab1d0..3a79437 100644
--- a/digikam/using-sidebar-versions.docbook
+++ b/digikam/using-sidebar-versions.docbook
@@ -1,46 +1,46 @@
Versions view
The Versions tab shows the history and the saved versions of a photograph. With the three buttons in the top right corner you can choose between a simple list of the saved versions, a tree view and a combined list that shows the versions together with the actions performed with the selected photograph.
The tree view shows the parent and child versions of the selected image. Here the second and the fifth version derive directly from the original image, the third and forth version are children of the second version.
The combined list shows the versions together with the actions/filters applied to them. Here the second version was created by resizing the original, applying the unsharp mask, correcting the white balance and finally adding a frame with the border tool. The child versions are grouped in Derived Versions and Related Versions. Related Versions arise if you modify the original and save the changes with Save As New Version.
- To learn how to control what is stored as a seperate version and which versions are displayed in the Image Area see Image Versioning Settings.
+ To learn how to control what is stored as a separate version and which versions are displayed in the Image Area see Image Versioning Settings.