LC_MESSAGES/batch_queue/custom_script.po

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