Warning, /documentation/digikam-doc/locale/lt/LC_MESSAGES/batch_queue/custom_script.po is written in an unsupported language. File is not indexed.
0001 # Lithuanian translations for Digikam Manual package. 0002 # Copyright (C) licensed under the <a href="https://spdx.org/licenses/GFDL-1.2-or-later.html">licensed under the terms of the GNU Free Documentation License 1.2+</a> unless stated otherwise 0003 # This file is distributed under the same license as the Digikam Manual package. 0004 # Automatically generated, 2023. 0005 # 0006 msgid "" 0007 msgstr "" 0008 "Project-Id-Version: Digikam Manual 8.0.0\n" 0009 "Report-Msgid-Bugs-To: \n" 0010 "POT-Creation-Date: 2023-12-02 00:35+0000\n" 0011 "PO-Revision-Date: 2023-02-09 00:53+0000\n" 0012 "Last-Translator: Automatically generated\n" 0013 "Language-Team: none\n" 0014 "Language: lt\n" 0015 "MIME-Version: 1.0\n" 0016 "Content-Type: text/plain; charset=UTF-8\n" 0017 "Content-Transfer-Encoding: 8bit\n" 0018 "Plural-Forms: nplurals=4; plural=(n==1 ? 0 : n%10>=2 && (n%100<10 || n" 0019 "%100>=20) ? 1 : n%10==0 || (n%100>10 && n%100<20) ? 2 : 3);\n" 0020 0021 #: ../../batch_queue/custom_script.rst:1 0022 msgid "digiKam Custom Script from Batch Queue Manager" 0023 msgstr "" 0024 0025 #: ../../batch_queue/custom_script.rst:1 0026 msgid "" 0027 "digiKam, documentation, user manual, photo management, open source, free, " 0028 "learn, easy, batch, custom, script" 0029 msgstr "" 0030 0031 #: ../../batch_queue/custom_script.rst:14 0032 msgid "Custom Script" 0033 msgstr "" 0034 0035 #: ../../batch_queue/custom_script.rst:16 0036 msgid "Contents" 0037 msgstr "" 0038 0039 #: ../../batch_queue/custom_script.rst:19 0040 msgid "Overview" 0041 msgstr "" 0042 0043 #: ../../batch_queue/custom_script.rst:21 0044 msgid "" 0045 "The batch Queue Manager allows to customize a **Workflow** with a specific " 0046 "plugin dedicated to run a script and process your images with external tools " 0047 "as `ImageMagick <https://imagemagick.org/>`_ or `ExifTool <https://en." 0048 "wikipedia.org/wiki/ExifTool>`_ for example." 0049 msgstr "" 0050 0051 #: ../../batch_queue/custom_script.rst:23 0052 msgid "" 0053 "The Tool is named **Custom Script**, available in **Base Tools** list, and " 0054 "**Custom Tools** category. The goal is to pass to a script source code " 0055 "written by the user in the plugin, a series of environment variables handled " 0056 "in the code and re-routed for a custom usage with delegate command line " 0057 "programs installed on your computer." 0058 msgstr "" 0059 0060 #: ../../batch_queue/custom_script.rst:29 0061 msgid "The Batch Queue Manager Including a Custom Script in a Workflow" 0062 msgstr "" 0063 0064 #: ../../batch_queue/custom_script.rst:31 0065 msgid "The tool provides these options:" 0066 msgstr "" 0067 0068 #: ../../batch_queue/custom_script.rst:33 0069 msgid "" 0070 "**Output Image Type**: this value allows to setup the expected type of image " 0071 "format to use at the output of your script. The default is **Same as " 0072 "input**, but you can set **JPEG**, **PNG**, or **TIFF**. Take a care that " 0073 "JPEG is a lossy compression format, only support 8-bit color depth, and does " 0074 "not supports transparency." 0075 msgstr "" 0076 0077 #: ../../batch_queue/custom_script.rst:35 0078 msgid "" 0079 "**Shell Script**: this text edit field allows to enter the source code of " 0080 "your shell script. Under **Linux** and **macOS**, `Bash script <https://en." 0081 "wikipedia.org/wiki/Bash_(Unix_shell)>`_ is supported. Under **Windows** " 0082 "`Batch script <https://en.wikipedia.org/wiki/Batch_file>`_ is supported." 0083 msgstr "" 0084 0085 #: ../../batch_queue/custom_script.rst:37 0086 msgid "" 0087 "The keywords that you can use in your script code are listed below. The tool " 0088 "will replace all occurrences of keywords in script at run time before shell " 0089 "execution. Take a care that keywords are case sensitive." 0090 msgstr "" 0091 0092 #: ../../batch_queue/custom_script.rst:39 0093 msgid "" 0094 "**$INPUT** for workflow input filename (with special characters escaped)." 0095 msgstr "" 0096 0097 #: ../../batch_queue/custom_script.rst:41 0098 msgid "" 0099 "**$OUTPUT** for workflow output filename (with special characters escaped)." 0100 msgstr "" 0101 0102 #: ../../batch_queue/custom_script.rst:45 0103 msgid "" 0104 "A new file is always expected on **$OUTPUT**. With a script programs that do " 0105 "not create a new file (e.g. changing metadata with ExifTool) you must first " 0106 "copy **$INPUT** to **$OUTPUT** with a command appropriate to the operating " 0107 "system and then make the changes to **$OUTPUT**." 0108 msgstr "" 0109 0110 #: ../../batch_queue/custom_script.rst:47 0111 msgid "" 0112 "The environment variables that you can use in your script code are listed " 0113 "below:" 0114 msgstr "" 0115 0116 #: ../../batch_queue/custom_script.rst:49 0117 msgid "**TITLE**: to handle digiKam **Title** item properties from database." 0118 msgstr "" 0119 0120 #: ../../batch_queue/custom_script.rst:51 0121 msgid "" 0122 "**COMMENTS**: to handle digiKam **Caption** item properties from database." 0123 msgstr "" 0124 0125 #: ../../batch_queue/custom_script.rst:53 0126 msgid "" 0127 "**COLORLABEL**: to handle digiKam **Color Label** item properties from " 0128 "database." 0129 msgstr "" 0130 0131 #: ../../batch_queue/custom_script.rst:55 0132 msgid "" 0133 "**PICKLABEL**: to handle digiKam **Pick Label** item properties from " 0134 "database." 0135 msgstr "" 0136 0137 #: ../../batch_queue/custom_script.rst:57 0138 msgid "**RATING**: to handle digiKam **Rating** item properties from database." 0139 msgstr "" 0140 0141 #: ../../batch_queue/custom_script.rst:59 0142 msgid "**TAGSPATH**: to handle digiKam **Tags** item properties from database." 0143 msgstr "" 0144 0145 #: ../../batch_queue/custom_script.rst:63 0146 msgid "" 0147 "Under Linux and macOS, environment variables can be accessed in script with " 0148 "**$** as prefix of variable names (for example **$INPUT**). The interpreter " 0149 "used to run the script is **/bin/bash**." 0150 msgstr "" 0151 0152 #: ../../batch_queue/custom_script.rst:65 0153 msgid "" 0154 "Under Windows, environment variables can be accessed in script with **%** as " 0155 "prefix and suffix of variable names (for example **%INPUT%**). The " 0156 "interpreter used to run the script is **cmd.exe**." 0157 msgstr "" 0158 0159 #: ../../batch_queue/custom_script.rst:69 0160 msgid "Return Value" 0161 msgstr "" 0162 0163 #: ../../batch_queue/custom_script.rst:71 0164 msgid "" 0165 "By convention, a **Bash script** under Linux and macOS, 0 is returned on " 0166 "success or an integer in the range 1-255 for something else. Use **exit < " 0167 "error_code >** to pass the return value on the workflow." 0168 msgstr "" 0169 0170 #: ../../batch_queue/custom_script.rst:73 0171 msgid "" 0172 "Under Windows, a **Batch script** returns 0 on success and another value for " 0173 "something else, but the value is a signed integer, so a negative value is " 0174 "possible. Use **EXIT /B < error_code >** to pass the return value on the " 0175 "workflow." 0176 msgstr "" 0177 0178 #: ../../batch_queue/custom_script.rst:75 0179 msgid "" 0180 "The Batch Queue Manager handles the value returned by your script. If zero " 0181 "is returned, the workflow continue as expected, else the workflow is broken " 0182 "and Batch Queue Manager stop the process." 0183 msgstr "" 0184 0185 #: ../../batch_queue/custom_script.rst:78 0186 msgid "Examples" 0187 msgstr "" 0188 0189 #: ../../batch_queue/custom_script.rst:81 0190 msgid "Proof of Concept" 0191 msgstr "" 0192 0193 #: ../../batch_queue/custom_script.rst:83 0194 msgid "" 0195 "This First example that you can see below, ...do nothing special. It will " 0196 "print on the console the input/output file names and item properties passed " 0197 "from batch queue manager to the script and copy input file to output file " 0198 "(this stage is required else Batch Queue Manager returns an error as the " 0199 "target file does not exist). The script returns the value from the file copy " 0200 "command, this one is parsed by the Batch Queue Manager to check the workflow " 0201 "stream." 0202 msgstr "" 0203 0204 #: ../../batch_queue/custom_script.rst:100 0205 msgid "" 0206 "If you have started digiKam from a terminal and enabled the debug traces on :" 0207 "ref:`Setup/Miscs/System dialog page <system_settings>`, you will see " 0208 "something like this:" 0209 msgstr "" 0210 0211 #: ../../batch_queue/custom_script.rst:114 0212 msgid "The digiKam information taken from the database are:" 0213 msgstr "" 0214 0215 #: ../../batch_queue/custom_script.rst:116 0216 msgid "Item processed is **/mnt/data/Images/SALAGOU/DSC08833.JPG**." 0217 msgstr "" 0218 0219 #: ../../batch_queue/custom_script.rst:117 0220 msgid "" 0221 "Target filename is **/mnt/data/Images/SALAGOU/BatchTool-EpEjEz-9e1c7a12." 0222 "digikamtempfile.JPG** (a temporary file generated by Batch Queue Manager)." 0223 msgstr "" 0224 0225 #: ../../batch_queue/custom_script.rst:118 0226 msgid "Item Title is **Salagou Trip**." 0227 msgstr "" 0228 0229 #: ../../batch_queue/custom_script.rst:119 0230 msgid "Item Comment is null." 0231 msgstr "" 0232 0233 #: ../../batch_queue/custom_script.rst:120 0234 msgid "Item Color Label is **5** (Green)." 0235 msgstr "" 0236 0237 #: ../../batch_queue/custom_script.rst:121 0238 msgid "Item Pick Label is **3** (Accepted)." 0239 msgstr "" 0240 0241 #: ../../batch_queue/custom_script.rst:122 0242 msgid "Item Rating is **3 stars**." 0243 msgstr "" 0244 0245 #: ../../batch_queue/custom_script.rst:123 0246 msgid "" 0247 "Item Tags are **Places**, **Places/France**, **Places/France/Salagou Lake**." 0248 msgstr "" 0249 0250 #: ../../batch_queue/custom_script.rst:126 0251 msgid "Add a Watermark with ImageMagick" 0252 msgstr "" 0253 0254 #: ../../batch_queue/custom_script.rst:128 0255 msgid "" 0256 "The second example below is more complex and uses **ImageMagick** command " 0257 "like tool to add a multiline text superimposed over pictures to create a " 0258 "visible watermark on the center of images." 0259 msgstr "" 0260 0261 #: ../../batch_queue/custom_script.rst:146 0262 msgid "" 0263 "In this example, there is no explicit **exit** call to return a value to the " 0264 "Workflow. Bash uses the last called method as the returned value from the " 0265 "script, here the ImageMagick command line tool **convert**." 0266 msgstr "" 0267 0268 #: ../../batch_queue/custom_script.rst:148 0269 msgid "This give a result like below." 0270 msgstr "" 0271 0272 #: ../../batch_queue/custom_script.rst:154 0273 msgid "The result of the Script Using ImageMagick to Apply a Watermark" 0274 msgstr ""