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