diff --git a/locale/en/LC_MESSAGES/docs/training_manual/processing/log.po b/locale/en/LC_MESSAGES/docs/training_manual/processing/log.po index e0c5cadeaec..81aaaad11ef 100644 --- a/locale/en/LC_MESSAGES/docs/training_manual/processing/log.po +++ b/locale/en/LC_MESSAGES/docs/training_manual/processing/log.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: QGIS Documentation 3.34\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-28 17:50+0000\n" +"POT-Creation-Date: 2024-05-19 15:50+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.14.0\n" +"Generated-By: Babel 2.15.0\n" #: ../../:5 msgid "" @@ -115,43 +115,41 @@ msgid "" "the algorithm explained there." msgstr "" -#: ../../docs/training_manual/processing/log.rst:49 +#: ../../docs/training_manual/processing/log.rst:50 msgid "" -"Now go to the log dialog and locate the last algorithm in the list, which" -" corresponds to the algorithm you have just run." +"Now go to the History dialog and locate the last algorithm in the list, " +"which corresponds to the algorithm you have just run." msgstr "" -#: ../../docs/training_manual/processing/log.rst:50 +#: ../../docs/training_manual/processing/log.rst:52 msgid "" "Double-click on it and a new result should be produced, just like when " "you run it using the normal dialog and calling it from the toolbox." msgstr "" -#: ../../docs/training_manual/processing/log.rst:53 -msgid ":abbr:`★★★ (Advanced level)` Advanced" +#: ../../docs/training_manual/processing/log.rst:56 +msgid ":abbr:`★★☆ (Moderate level)` Follow Along" msgstr "" -#: ../../docs/training_manual/processing/log.rst:55 +#: ../../docs/training_manual/processing/log.rst:58 msgid "You can also modify the algorithm." msgstr "" -#: ../../docs/training_manual/processing/log.rst:57 +#: ../../docs/training_manual/processing/log.rst:60 msgid "Copy the algorithm call" msgstr "" -#: ../../docs/training_manual/processing/log.rst:58 +#: ../../docs/training_manual/processing/log.rst:61 msgid "Open the :menuselection:`Plugins --> Python console`" msgstr "" -#: ../../docs/training_manual/processing/log.rst:59 -msgid "Paste your copy to run the analysis; change the text at will." +#: ../../docs/training_manual/processing/log.rst:62 +msgid "Paste your copy to run the analysis; change the parameters at will." msgstr "" -#: ../../docs/training_manual/processing/log.rst:60 -msgid "To display the resulting file, type::" -msgstr "" - -#: ../../docs/training_manual/processing/log.rst:64 -msgid "Otherwise, you can use::" +#: ../../docs/training_manual/processing/log.rst:63 +msgid "" +"To display the resulting file, you may want to replace ``processing.run``" +" in the pasted command with ``processing.runAndLoadResults``." msgstr "" diff --git a/locale/en/LC_MESSAGES/docs/user_manual/processing/console.po b/locale/en/LC_MESSAGES/docs/user_manual/processing/console.po index b4b1805427f..6404fdf7caf 100644 --- a/locale/en/LC_MESSAGES/docs/user_manual/processing/console.po +++ b/locale/en/LC_MESSAGES/docs/user_manual/processing/console.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: QGIS Documentation 3.34\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-26 09:59+0000\n" +"POT-Creation-Date: 2024-05-19 15:50+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.14.0\n" +"Generated-By: Babel 2.15.0\n" #: ../../:5 msgid "" @@ -245,28 +245,23 @@ msgstr "" msgid "" "Unlike when an algorithm is executed from the toolbox, outputs are not " "added to the map canvas if you execute that same algorithm from the " -"Python console using :meth:`run() " -"`, but ``runAndLoadResults()`` will" -" do that." +"Python console using the :meth:`run() " +"` method. That method returns a " +"dictionary with one or more output names (the ones shown in the algorithm" +" description) as keys and the file paths of those outputs as values:" msgstr "" -#: ../../docs/user_manual/processing/console.rst:315 -msgid "" -"The :meth:`run() ` method returns a" -" dictionary with one or more output names (the ones shown in the " -"algorithm description) as keys and the file paths of those outputs as " -"values:" +#: ../../docs/user_manual/processing/console.rst:331 +msgid "You can then load the output in the project as any common layer:" msgstr "" -#: ../../docs/user_manual/processing/console.rst:334 +#: ../../docs/user_manual/processing/console.rst:339 msgid "" -"You can load feature output by passing the corresponding file paths to " -"the ``load()`` method. Or you could use ``runAndLoadResults()`` instead " -"of :meth:`run() ` to load them " -"immediately." +"To immediately load the processing outputs in the project, you can use " +"the ``runAndLoadResults()`` method instead of ``run()``." msgstr "" -#: ../../docs/user_manual/processing/console.rst:340 +#: ../../docs/user_manual/processing/console.rst:348 msgid "" "If you want to open an algorithm dialog from the console you can use the " "``createAlgorithmDialog`` method. The only mandatory parameter is the " @@ -274,15 +269,15 @@ msgid "" "that the dialog will be filled automatically:" msgstr "" -#: ../../docs/user_manual/processing/console.rst:359 +#: ../../docs/user_manual/processing/console.rst:367 msgid "The ``execAlgorithmDialog`` method opens the dialog immediately:" msgstr "" -#: ../../docs/user_manual/processing/console.rst:376 +#: ../../docs/user_manual/processing/console.rst:384 msgid "Creating scripts and running them from the toolbox" msgstr "" -#: ../../docs/user_manual/processing/console.rst:378 +#: ../../docs/user_manual/processing/console.rst:386 msgid "" "You can create your own algorithms by writing Python code. Processing " "scripts extend :class:`QgsProcessingAlgorithm " @@ -299,13 +294,13 @@ msgid "" "algorithm." msgstr "" -#: ../../docs/user_manual/processing/console.rst:393 +#: ../../docs/user_manual/processing/console.rst:401 msgid "" "The name of the algorithm (the one you will see in the toolbox) is " "defined within the code." msgstr "" -#: ../../docs/user_manual/processing/console.rst:396 +#: ../../docs/user_manual/processing/console.rst:404 msgid "" "Let's have a look at the following code, which defines a Processing " "algorithm that performs a buffer operation with a user defined buffer " @@ -313,52 +308,52 @@ msgid "" "smoothing the layer." msgstr "" -#: ../../docs/user_manual/processing/console.rst:461 +#: ../../docs/user_manual/processing/console.rst:469 msgid "" "After doing the necessary imports, the following " ":class:`QgsProcessingAlgorithm ` " "functions are specified:" msgstr "" -#: ../../docs/user_manual/processing/console.rst:465 +#: ../../docs/user_manual/processing/console.rst:473 msgid "" ":meth:`name() `: The id of the " "algorithm (lowercase)." msgstr "" -#: ../../docs/user_manual/processing/console.rst:467 +#: ../../docs/user_manual/processing/console.rst:475 msgid "" ":meth:`displayName() `: A " "human readable name for the algorithm." msgstr "" -#: ../../docs/user_manual/processing/console.rst:469 +#: ../../docs/user_manual/processing/console.rst:477 msgid "" ":meth:`createInstance() " "`: Create a new instance" " of the algorithm class." msgstr "" -#: ../../docs/user_manual/processing/console.rst:471 +#: ../../docs/user_manual/processing/console.rst:479 msgid "" ":meth:`initAlgorithm() `:" " Configure the parameterDefinitions and outputDefinitions." msgstr "" -#: ../../docs/user_manual/processing/console.rst:474 +#: ../../docs/user_manual/processing/console.rst:482 msgid "" "Here you describe the parameters and output of the algorithm. In this " "case, a feature source for the input, a feature sink for the result and a" " number for the buffer distance." msgstr "" -#: ../../docs/user_manual/processing/console.rst:477 +#: ../../docs/user_manual/processing/console.rst:485 msgid "" ":meth:`processAlgorithm() " "`: Do the work." msgstr "" -#: ../../docs/user_manual/processing/console.rst:480 +#: ../../docs/user_manual/processing/console.rst:488 msgid "" "Here we first run the ``smoothgeometry`` algorithm to smooth the " "geometry, and then we run the ``buffer`` algorithm on the smoothed " @@ -368,21 +363,21 @@ msgid "" "``smoothgeometry`` and ``buffer`` algorithms." msgstr "" -#: ../../docs/user_manual/processing/console.rst:488 +#: ../../docs/user_manual/processing/console.rst:496 msgid "" "There are a number of different parameter types available for input and " "output. You can find the full list at " ":ref:`processing_algs_input_output`." msgstr "" -#: ../../docs/user_manual/processing/console.rst:491 +#: ../../docs/user_manual/processing/console.rst:499 msgid "" "The first parameter to the constructors is the name of the parameter, and" " the second is the description of the parameter (for the user interface)." " The rest of the constructor parameters are parameter type specific." msgstr "" -#: ../../docs/user_manual/processing/console.rst:496 +#: ../../docs/user_manual/processing/console.rst:504 msgid "" "The input can be turned into QGIS classes using the ``parameterAs`` " "functions of :class:`QgsProcessingAlgorithm " @@ -390,7 +385,7 @@ msgid "" "provided for the buffer distance as a double::" msgstr "" -#: ../../docs/user_manual/processing/console.rst:502 +#: ../../docs/user_manual/processing/console.rst:510 msgid "" "The ``processAlgorithm`` function should return a dictionary containing " "values for every output defined by the algorithm. This allows access to " @@ -398,7 +393,7 @@ msgid "" " within the same model." msgstr "" -#: ../../docs/user_manual/processing/console.rst:507 +#: ../../docs/user_manual/processing/console.rst:515 msgid "" "Well behaved algorithms should define and return as many outputs as makes" " sense. Non-feature outputs, such as numbers and strings, are very useful" @@ -410,11 +405,11 @@ msgid "" "useful your algorithm becomes!" msgstr "" -#: ../../docs/user_manual/processing/console.rst:517 +#: ../../docs/user_manual/processing/console.rst:525 msgid "Feedback" msgstr "" -#: ../../docs/user_manual/processing/console.rst:519 +#: ../../docs/user_manual/processing/console.rst:527 msgid "" "The :class:`feedback ` object passed to " ":meth:`processAlgorithm() " @@ -426,7 +421,7 @@ msgid "" "very useful if your algorithm takes a long time to complete." msgstr "" -#: ../../docs/user_manual/processing/console.rst:527 +#: ../../docs/user_manual/processing/console.rst:535 msgid "" "The :class:`feedback ` object provides " "an :meth:`isCanceled() ` method that " @@ -438,7 +433,7 @@ msgid "" "fatal errors to users." msgstr "" -#: ../../docs/user_manual/processing/console.rst:535 +#: ../../docs/user_manual/processing/console.rst:543 msgid "" "Algorithms should avoid using other forms of providing feedback to users," " such as print statements or logging to :class:`QgsMessageLog " @@ -448,11 +443,11 @@ msgid "" "in a background thread)." msgstr "" -#: ../../docs/user_manual/processing/console.rst:544 +#: ../../docs/user_manual/processing/console.rst:552 msgid "Handling errors" msgstr "" -#: ../../docs/user_manual/processing/console.rst:546 +#: ../../docs/user_manual/processing/console.rst:554 msgid "" "If your algorithm encounters an error which prevents it from executing, " "such as invalid input values or some other condition from which it cannot" @@ -461,7 +456,7 @@ msgid "" "E.g.::" msgstr "" -#: ../../docs/user_manual/processing/console.rst:555 +#: ../../docs/user_manual/processing/console.rst:563 msgid "" "Try to avoid raising :class:`QgsProcessingException " "` for non-fatal errors (e.g. when a " @@ -471,17 +466,17 @@ msgid "" "entire algorithm when a non-fatal error is encountered." msgstr "" -#: ../../docs/user_manual/processing/console.rst:565 +#: ../../docs/user_manual/processing/console.rst:573 msgid "Documenting your scripts" msgstr "" -#: ../../docs/user_manual/processing/console.rst:567 +#: ../../docs/user_manual/processing/console.rst:575 msgid "" "As in the case of models, you can create additional documentation for " "your scripts, to explain what they do and how to use them." msgstr "" -#: ../../docs/user_manual/processing/console.rst:570 +#: ../../docs/user_manual/processing/console.rst:578 msgid "" ":class:`QgsProcessingAlgorithm ` " "provides the :meth:`helpString() " @@ -491,18 +486,18 @@ msgid "" "Specify / override these to provide more help to the user." msgstr "" -#: ../../docs/user_manual/processing/console.rst:576 +#: ../../docs/user_manual/processing/console.rst:584 msgid "" ":meth:`shortDescription() " "` is used in the " "tooltip when hovering over the algorithm in the toolbox." msgstr "" -#: ../../docs/user_manual/processing/console.rst:580 +#: ../../docs/user_manual/processing/console.rst:588 msgid "Pre- and post-execution script hooks" msgstr "" -#: ../../docs/user_manual/processing/console.rst:582 +#: ../../docs/user_manual/processing/console.rst:590 msgid "" "Scripts can also be used as pre- and post-execution hooks that are run " "before and after an algorithm is run, respectively. This can be used to " @@ -510,14 +505,14 @@ msgid "" "executed." msgstr "" -#: ../../docs/user_manual/processing/console.rst:586 +#: ../../docs/user_manual/processing/console.rst:594 msgid "" "The syntax is identical to the syntax explained above, but an additional " "global variable named ``alg`` is available, representing the algorithm " "that has just been (or is about to be) executed." msgstr "" -#: ../../docs/user_manual/processing/console.rst:590 +#: ../../docs/user_manual/processing/console.rst:598 msgid "" "In the :guilabel:`General` group of the processing options dialog, you " "will find two entries named :guilabel:`Pre-execution script` and "