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