Warning, /documentation/digikam-doc/right_sidebar/captions_view.rst is written in an unsupported language. File is not indexed.
0001 .. meta:: 0002 :description: digiKam Right Sidebar Captions View 0003 :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, description, captions, title, author, labels, rating, date, tags, template 0004 0005 .. metadata-placeholder 0006 0007 :authors: - digiKam Team 0008 0009 :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html) 0010 0011 .. _captions_view: 0012 0013 Captions View 0014 ============= 0015 0016 .. contents:: 0017 0018 Overview 0019 ~~~~~~~~ 0020 0021 This sidebar tab serves to apply and edit image attributes like captions, rating, date and tags. The attributes are stored in the associated database, in the IPTC, XMP, and Exif data fields and become part of the image. All attributes are accessible in one sidebar view as shown in the screenshot below. During image reading the order of priority is ``a)`` database ``b)`` XMP/IPTC and ``c)`` Exif. So if there is a discrepancy between any of the three, this priority will take effect and a synchronization will take place. This sidebar has a first-previous-next-last arrow navigator field on top if shown in the main application. 0022 0023 .. figure:: images/sidebar_captions.webp 0024 :alt: 0025 :align: center 0026 0027 The Captions View From Right Sidebar Displaying Description Information 0028 0029 .. _comment_editors: 0030 0031 Comment Editors 0032 ~~~~~~~~~~~~~~~ 0033 0034 The descriptions view can be used to type or paste in a title and/or a captions of unlimited size (see note below). The text is UTF-8 compatible, meaning that all special characters are allowed. The captions are copied to Exif, IPTC, and XMP fields to be used by other applications. 0035 0036 .. caution:: 0037 0038 IPTC data only supports ASCII characters and is limited to 2000 characters (old American norm). All texts will be truncated after 2000 chars, and special characters will be malformed. If you intend to use the IPTC caption field in other applications you should be compliant with these restrictions. 0039 0040 Title and caption editors are powerful tool which supports: 0041 0042 - Multiple alternative language strings. 0043 - Translate strings online to another language. 0044 - Author strings definition. 0045 0046 The default language from an alternative strings stack is **x-default** and must be written by preference in English. If one string must be entered in the stack, the x-default must be present in prior. 0047 0048 After commenting, either choose the **Apply** button or go straight to the next image, the descriptions will be saved. 0049 0050 Next to the Apply button there is the **More** button. From it you can either choose to read metadata from the selected file to the database, or the other way around, to write metadata to the files (the latter take place anyway if you chose a metadata setting so that all metadata is always saved to the images). 0051 0052 .. _date_edit: 0053 0054 Date and Time 0055 ~~~~~~~~~~~~~ 0056 0057 In the Date and Time section, which reflects the time of taking the photograph, you can change all values. From the date combo-box a calendar opens, and the time setting spin-box can also be written by directly typing the time. The dating is copied to the Exif **Date and Time** field. If you need to change a number of images for their creating time & date, there is a more comfortable method available in **Batch Queue Manager** or from :menuselection:`Item --> Adjust time & date...` menu entry in **Main Window**. Select the images to be changed in the main view and call the tool. 0058 0059 .. _labels_edit: 0060 0061 Labels 0062 ~~~~~~ 0063 0064 The Rating section displays a 0...5 star rating scheme that can be used in searches and sort orders. It can be applied by a single mouse click to the 5 stars in the sidebar or with a keyboard shortcut :kbd:`Ctrl+0...5`. The rating from the sidebar is always applied to one image at a time. To rate a number of images, select them and pop-up the context menu (click with the right mouse button) to apply a common rating. 0065 0066 The labels view allow to assign also the Color and the Pick tags that you can use in your workflow to classify items. 0067 0068 The rating is then transcribed into the IPTC *urgency* data field. The transcoding follows the scheme in this table: 0069 0070 ============== ============ 0071 digiKam Rating IPTC Urgency 0072 ============== ============ 0073 no star 8 0074 1 star 7 0075 1 star 6 0076 2 stars 5 0077 3 stars 4 0078 4 stars 3 0079 4 stars 2 0080 5 stars 1 0081 ============== ============ 0082 0083 .. _tags_tree: 0084 0085 Tags Tree 0086 ~~~~~~~~~ 0087 0088 The tag view shows an adaptive filter tag search box, the tag tree and a combo-box containing the tags previously applied in this digiKam session. 0089 0090 .. figure:: images/sidebar_tags.webp 0091 :alt: 0092 :align: center 0093 0094 The Metadata View From Right Sidebar Displaying Tags Information 0095 0096 The tag tree will be adapted dynamically as a function of the search word as you type into the box. So it is easy to quickly reduce the number of possibilities when searching for a tag. Of course, this feature is only useful if you have many tags. 0097 0098 The combo-box at the bottom is another ergonomic feature for easy tagging of an image series. As you apply different tags they will be memorized in this box for quick access. 0099 0100 Otherwise tags are simply applied by checking the respective boxes in the tree. All tags of an image are transcribed into the XMP/IPTC *keywords* data field. 0101 0102 .. note:: 0103 0104 In case you have selected a number of images in the Icon-View and you check a tag in the tag tree, this one is only applied to the highlighted images, and not to the whole Album contents. 0105 0106 .. _informaton_view: 0107 0108 Information View 0109 ~~~~~~~~~~~~~~~~ 0110 0111 .. figure:: images/sidebar_information.webp 0112 :alt: 0113 :align: center 0114 0115 The Metadata View From Right Sidebar Displaying Template Information 0116 0117 The Information view allows to assign a template of textuals information to items in one pass. This information can be populated in Setup/Template dialog. They contain all strings describing the contents, the scene, the authors, the rights, the place etc. 0118 0119 For more details about Template, see the description of the :ref:`Template Settings <templates_settings>` section.