LC_MESSAGES/batch_queue/custom_script.po

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