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