diff options
Diffstat (limited to 'source/zh-TW/helpcontent2/source/text/sbasic/python.po')
| -rw-r--r-- | source/zh-TW/helpcontent2/source/text/sbasic/python.po | 799 |
1 files changed, 530 insertions, 269 deletions
diff --git a/source/zh-TW/helpcontent2/source/text/sbasic/python.po b/source/zh-TW/helpcontent2/source/text/sbasic/python.po index baaaf96900e..a0392202ce2 100644 --- a/source/zh-TW/helpcontent2/source/text/sbasic/python.po +++ b/source/zh-TW/helpcontent2/source/text/sbasic/python.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2020-07-02 14:37+0200\n" +"POT-Creation-Date: 2024-02-28 17:20+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -31,31 +31,31 @@ msgctxt "" msgid "<bookmark_value>macros;Python scripts</bookmark_value> <bookmark_value>Python;macros</bookmark_value> <bookmark_value>scripts;Python</bookmark_value>" msgstr "" -#. vAoRU +#. KSaCr #: main0000.xhp msgctxt "" "main0000.xhp\n" "hd_id3154232\n" "help.text" -msgid "<variable id=\"pythonscriptshelp\"><link href=\"text/sbasic/python/main0000.xhp\" name=\"mainpython\">%PRODUCTNAME Python Scripts Help</link></variable>" +msgid "<variable id=\"pythonscriptshelp\"><link href=\"text/sbasic/python/main0000.xhp\">%PRODUCTNAME Python Scripts Help</link></variable>" msgstr "" -#. snE38 +#. nFipH #: main0000.xhp msgctxt "" "main0000.xhp\n" "par_id3153894\n" "help.text" -msgid "%PRODUCTNAME provides an Application Programming Interface (API) that allows controlling the $[officename] components with different programming languages by using the $[officename] Software Development Kit (SDK). For more information about the $[officename] API and the Software Development Kit, visit <link href=\"https://api.libreoffice.org/\" name=\"api.libreoffice.org\">https://api.libreoffice.org</link>" +msgid "%PRODUCTNAME provides an Application Programming Interface (API) that allows controlling the $[officename] components with different programming languages by using the $[officename] Software Development Kit (SDK). For more information about the $[officename] API and the Software Development Kit, visit <link href=\"https://api.libreoffice.org/\">https://api.libreoffice.org</link>" msgstr "" -#. 9EUoJ +#. yEBNs #: main0000.xhp msgctxt "" "main0000.xhp\n" "par_id3147226\n" "help.text" -msgid "This help section explains the most common Python script functions for %PRODUCTNAME. For more in-depth information please refer to the <link href=\"https://wiki.documentfoundation.org/Macros/Python_Design_Guide\" name=\"wiki.documentfoundation.org PYTHON Guide\">Designing & Developing Python Applications</link> on the Wiki." +msgid "This help section explains the most common Python script functions for %PRODUCTNAME. For more in-depth information please refer to the <link href=\"https://wiki.documentfoundation.org/Macros/Python_Design_Guide\">Designing & Developing Python Applications</link> on the Wiki." msgstr "" #. FjaiD @@ -76,13 +76,49 @@ msgctxt "" msgid "You can execute Python scripts choosing <menuitem>Tools - Macros - Run Macro</menuitem>. Editing scripts can be done with your preferred text editor. Python scripts are present in various locations detailed hereafter. You can refer to Programming examples for macros illustrating how to run the Python interactive console from %PRODUCTNAME." msgstr "" -#. bb68x +#. nytCF #: main0000.xhp msgctxt "" "main0000.xhp\n" "par_id131568902936659\n" "help.text" -msgid "The %PRODUCTNAME scripting framework for Python is optional on some GNU/Linux distributions. If it is installed, selecting <menuitem>Tools - Macros - Run Macro...</menuitem> and checking <literal>%PRODUCTNAME Macros</literal> for the presence of <literal>HelloWorld – HelloWorldPython</literal> macro is sufficient. If absent, please refer to your distribution documentation in order to install the %PRODUCTNAME scripting framework for Python." +msgid "The %PRODUCTNAME scripting framework for Python is optional on some GNU/Linux distributions. If it is installed, selecting <menuitem>Tools - Macros - Run Macro</menuitem> and checking <literal>Application Macros</literal> for the presence of <literal>HelloWorld – HelloWorldPython</literal> macro is sufficient. If absent, please refer to your distribution documentation in order to install the %PRODUCTNAME scripting framework for Python." +msgstr "" + +#. STRqN +#: main0000.xhp +msgctxt "" +"main0000.xhp\n" +"hd_id901655365903313\n" +"help.text" +msgid "%PRODUCTNAME Python Modules" +msgstr "" + +#. dtVM5 +#: main0000.xhp +msgctxt "" +"main0000.xhp\n" +"par_id21655367848705\n" +"help.text" +msgid "<link href=\"text/sbasic/python/python_screen.xhp\"><literal>msgbox</literal> module</link>" +msgstr "" + +#. vzq4f +#: main0000.xhp +msgctxt "" +"main0000.xhp\n" +"par_id801655368030968\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/lib_ScriptForge.xhp\"><literal>scriptforge</literal> module</link>" +msgstr "" + +#. LN2JT +#: main0000.xhp +msgctxt "" +"main0000.xhp\n" +"par_id12655637848750\n" +"help.text" +msgid "<link href=\"text/sbasic/python/python_programming.xhp#uno\"><literal>uno</literal> module</link>" msgstr "" #. naZBV @@ -103,13 +139,13 @@ msgctxt "" msgid "<bookmark_value>Python;Calling Basic</bookmark_value> <bookmark_value>ParamArray</bookmark_value>" msgstr "" -#. rGfKE +#. GAu3K #: python_2_basic.xhp msgctxt "" "python_2_basic.xhp\n" "N0331\n" "help.text" -msgid "<variable id=\"py2ba_h1\"><link href=\"text/sbasic/python/python_2_basic.xhp\" name=\"Calling Basic macros from Python\">Calling Basic Macros from Python</link></variable>" +msgid "<variable id=\"py2ba_h1\"><link href=\"text/sbasic/python/python_2_basic.xhp\">Calling Basic Macros from Python</link></variable>" msgstr "" #. XzJcA @@ -148,13 +184,13 @@ msgctxt "" msgid "<literal>Xray</literal> calls interrupting Python script execution to help inspect variables." msgstr "" -#. nABRD +#. fDXhz #: python_2_basic.xhp msgctxt "" "python_2_basic.xhp\n" "N0336\n" "help.text" -msgid "The %PRODUCTNAME Application Programming Interface (API) Scripting Framework supports inter-language script execution between Python and Basic, or other supported programming languages for that matter. Arguments can be passed back and fourth across calls, providing they represent primitives data types that both languages recognize, and assuming that the Scripting Framework converts them appropriately." +msgid "The %PRODUCTNAME Application Programming Interface (API) Scripting Framework supports inter-language script execution between Python and Basic, or other supported programming languages for that matter. Arguments can be passed back and forth across calls, provided that they represent primitive data types that both languages recognize, and assuming that the Scripting Framework converts them appropriately." msgstr "" #. Gn9Bv @@ -166,13 +202,13 @@ msgctxt "" msgid "It is recommended to have knowledge of Python standard modules and %PRODUCTNAME API features prior to perform inter-language calls from Python to Basic, JavaScript or any other script engine." msgstr "" -#. yXTrk +#. raHqP #: python_2_basic.xhp msgctxt "" "python_2_basic.xhp\n" "N0338\n" "help.text" -msgid "When running Python scripts from an Integrated Development Environment (IDE), the %PRODUCTNAME nested Basic engine may be absent. Avoid Python to %PRODUCTNAME Basic calls in such context. However Python environment and Universal Networks Objects (UNO) are fully available. Refer to <link href=\"text/sbasic/python/python_ide.xhp\" name=\"Setting Up an Integrated IDE for Python\">Setting Up an Integrated IDE for Python</link> for more information." +msgid "When running Python scripts from an Integrated Development Environment (IDE), the %PRODUCTNAME-embedded Basic engine may be absent. Avoid Python-to-%PRODUCTNAME Basic calls in such contexts. However Python environment and Universal Networks Objects (UNO) are fully available. Refer to <link href=\"text/sbasic/python/python_ide.xhp\">Setting Up an Integrated IDE for Python</link> for more information." msgstr "" #. NcuDF @@ -184,13 +220,13 @@ msgctxt "" msgid "Retrieving %PRODUCTNAME Basic Scripts" msgstr "" -#. yiTqz +#. yS5os #: python_2_basic.xhp msgctxt "" "python_2_basic.xhp\n" "N0340\n" "help.text" -msgid "%PRODUCTNAME Basic macros can be personal, shared, or embedded in documents. In order to execute them, Python run time needs to be provided with Basic macro locations. Implementing the <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1script_1_1provider_1_1XScript.html\" name=\"XScriptProvider interface\">com.sun.star.script.provider.XScriptProvider</link> interface allows the retrieval of executable scripts:" +msgid "%PRODUCTNAME Basic macros can be personal, shared, or embedded in documents. In order to execute them, Python run time needs to be provided with Basic macro locations. Implementing the <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1script_1_1provider_1_1XScript.html\">com.sun.star.script.provider.XScriptProvider</link> interface allows the retrieval of executable scripts:" msgstr "" #. w4UAs @@ -229,13 +265,13 @@ msgctxt "" msgid "<bookmark_value>API;script.provider.XScript : Executing Basic scripts</bookmark_value>" msgstr "" -#. 7BfDh +#. cHSHW #: python_2_basic.xhp msgctxt "" "python_2_basic.xhp\n" "N0364\n" "help.text" -msgid "The %PRODUCTNAME Software Development Kit (SDK) documentation for <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1script_1_1provider_1_1XScript.html#a11a551f5a2520f74c5109cd8c9f8c7b7\" name=\"XScript interface\">com.sun.star.script.provider.XScript</link> interface details the calling convention for inter-language calls. Invocation of functions requires three arrays:" +msgid "The %PRODUCTNAME Software Development Kit (SDK) documentation for <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1script_1_1provider_1_1XScript.html#a11a551f5a2520f74c5109cd8c9f8c7b7\">com.sun.star.script.provider.XScript</link> interface details the calling convention for inter-language calls. Invocation of functions requires three arrays:" msgstr "" #. UDhtt @@ -274,33 +310,6 @@ msgctxt "" msgid "Python Syntax" msgstr "" -#. GXEC9 -#: python_2_basic.xhp -msgctxt "" -"python_2_basic.xhp\n" -"N0369\n" -"help.text" -msgid "<literal>results = script.invoke((prompt,buttons,title), (), ())</literal>" -msgstr "" - -#. 465No -#: python_2_basic.xhp -msgctxt "" -"python_2_basic.xhp\n" -"N0370\n" -"help.text" -msgid "<literal>script.invoke((message,), tuple, ())</literal>" -msgstr "" - -#. wnGWp -#: python_2_basic.xhp -msgctxt "" -"python_2_basic.xhp\n" -"N0371\n" -"help.text" -msgid "<literal>script.invoke((args), (), results)</literal>" -msgstr "" - #. oWBhX #: python_2_basic.xhp msgctxt "" @@ -310,22 +319,22 @@ msgctxt "" msgid "Examples of Personal or Shared Scripts" msgstr "" -#. nyNGG +#. Grgdj #: python_2_basic.xhp msgctxt "" "python_2_basic.xhp\n" "N0373\n" "help.text" -msgid "Examples in <link href=\"text/sbasic/python/python_screen.xhp\" name=\"Input/Output to Screen\">Input/Output to Screen</link> detail Python to Basic invocation calls. <link href=\"text/sbasic/python/python_document_events.xhp\" name=\"Monitoring Document Events\">Monitoring Document Events</link> illustrates the usage of *args Python idiom to print a variable number of parameters to <literal>Access2Base</literal> logging console dialog." +msgid "Examples in <link href=\"text/sbasic/python/python_screen.xhp\">Input/Output to Screen</link> detail Python to Basic invocation calls. <link href=\"text/sbasic/python/python_document_events.xhp\">Monitoring Document Events</link> illustrates the usage of *args Python idiom to print a variable number of parameters to <literal>Access2Base</literal> logging console dialog." msgstr "" -#. dt25D +#. vPub5 #: python_2_basic.xhp msgctxt "" "python_2_basic.xhp\n" "N0374\n" "help.text" -msgid "At time of development you can interrupt Python script execution using <link href=\"https://berma.pagesperso-orange.fr/index2.html\" name=\"Xray extension\">Xray extension</link> in order to inspect properties and methods of UNO objects. The APSO extension debugger allows object introspection using either Xray either MRI extensions." +msgid "At time of development you can interrupt Python script execution using <link href=\"https://berma.pagesperso-orange.fr/index2.html\">Xray extension</link> in order to inspect properties and methods of UNO objects. The APSO extension debugger allows object introspection using either Xray either MRI extensions." msgstr "" #. F8dF9 @@ -418,40 +427,40 @@ msgctxt "" msgid "<bookmark_value>Python;dialogs</bookmark_value> <bookmark_value>dialog box;Python</bookmark_value> <bookmark_value>dialogs;Python</bookmark_value>" msgstr "" -#. rXdUF +#. D6egS #: python_dialogs.xhp msgctxt "" "python_dialogs.xhp\n" "N0336\n" "help.text" -msgid "<variable id=\"pythondialog\"><link href=\"text/sbasic/python/python_dialogs.xhp\" name=\"command_name\">Opening a Dialog with Python</link></variable>" +msgid "<variable id=\"pythondialog\"><link href=\"text/sbasic/python/python_dialogs.xhp\">Opening a Dialog with Python</link></variable>" msgstr "" -#. WAuH7 +#. X8omL #: python_dialogs.xhp msgctxt "" "python_dialogs.xhp\n" "N0337\n" "help.text" -msgid "%PRODUCTNAME static dialogs are created with the <link href=\"text/sbasic/guide/create_dialog.xhp\" name=\"dialog editor\">Dialog editor</link> and are stored in varying places according to their personal (My Macros), shared (%PRODUCTNAME Macros) or document-embedded nature. In reverse, dynamic dialogs are constructed at runtime, from Basic or Python scripts, or using any other <link href=\"text/shared/guide/scripting.xhp\">%PRODUCTNAME supported language</link> for that matter. Opening static dialogs with Python is illustrated herewith. Exception handling and internationalization are omitted for clarity." +msgid "%PRODUCTNAME static dialogs are created with the <link href=\"text/sbasic/guide/create_dialog.xhp\">Dialog editor</link> and are stored in varying places according to their personal (My Macros), shared (Application Macros) or document-embedded nature. In reverse, dynamic dialogs are constructed at runtime, from Basic or Python scripts, or using any other <link href=\"text/shared/guide/scripting.xhp\">%PRODUCTNAME supported language</link> for that matter. Opening static dialogs with Python is illustrated herewith. Exception handling and internationalization are omitted for clarity." msgstr "" -#. BNxEA +#. AbdfS #: python_dialogs.xhp msgctxt "" "python_dialogs.xhp\n" "N0338\n" "help.text" -msgid "My Macros or %PRODUCTNAME Macros dialogs" +msgid "My Macros or Application Macros dialogs" msgstr "" -#. jCE4m +#. pcUEy #: python_dialogs.xhp msgctxt "" "python_dialogs.xhp\n" "N0339\n" "help.text" -msgid "The examples below open <literal>Access2Base Trace</literal> console or the imported <literal>TutorialsDialog</literal> dialog with <menuitem>Tools – Macros – Run Macro...</menuitem> menu:" +msgid "The examples below open <literal>Access2Base Trace</literal> console or the imported <literal>TutorialsDialog</literal> dialog with <menuitem>Tools - Macros - Run Macro</menuitem> menu:" msgstr "" #. ChW9B @@ -463,13 +472,13 @@ msgctxt "" msgid "Document embedded dialogs" msgstr "" -#. SsPGJ +#. uHH6H #: python_dialogs.xhp msgctxt "" "python_dialogs.xhp\n" "N0365\n" "help.text" -msgid "The example below opens a newly edited <literal>Dialog1</literal> dialog from a document with <menuitem>Tools – Macros – Run Macro...</menuitem> menu:" +msgid "The example below opens a newly edited <literal>Dialog1</literal> dialog from a document with <menuitem>Tools - Macros - Run Macro</menuitem> menu:" msgstr "" #. mMo7w @@ -490,67 +499,112 @@ msgctxt "" msgid "Refer to <literal>msgbox.py</literal> in <literal>{installation}/program/</literal> directory for Python dynamic dialog examples." msgstr "" -#. r6FEK +#. zNyQB #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "tit\n" "help.text" -msgid "Python : Monitoring Document Events" +msgid "Monitoring Document Events" msgstr "" -#. 7vwHs +#. GyBAT #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0526\n" "help.text" -msgid "<bookmark_value>Basic;Monitoring Document Events</bookmark_value> <bookmark_value>Python;Monitoring Document Events</bookmark_value> <bookmark_value>Access2Base;Console</bookmark_value> <bookmark_value>Access2Base;Trace</bookmark_value> <bookmark_value>Tools;Strings</bookmark_value> <bookmark_value>API;GlobalScope.BasicLibraries</bookmark_value> <bookmark_value>API;document.DocumentEvent: Monitoring Document Event</bookmark_value> <bookmark_value>API;document.XDocumentEventBroadcaster: Monitoring Document Event</bookmark_value> <bookmark_value>API;document.XDocumentEventListener: Monitoring Document Event</bookmark_value> <bookmark_value>API;frame.Desktop: Monitoring Document Event</bookmark_value> <bookmark_value>API;frame.GlobalEventBroadcaster: Monitoring Document Event</bookmark_value> <bookmark_value>API;lang.EventObject: Monitoring Document Event</bookmark_value> <bookmark_value>API;script.provider.MasterScriptProviderFactory: Monitoring Document Event</bookmark_value> <bookmark_value>API;script.provider.XScript: Monitoring Document Event</bookmark_value>" +msgid "<bookmark_value>Basic;Monitoring Document Events</bookmark_value> <bookmark_value>Python;Monitoring Document Events</bookmark_value> <bookmark_value>Access2Base;Console</bookmark_value> <bookmark_value>Access2Base;Trace</bookmark_value> <bookmark_value>API;document.DocumentEvent: Monitoring Document Event</bookmark_value> <bookmark_value>API;document.XDocumentEventBroadcaster: Monitoring Document Event</bookmark_value> <bookmark_value>API;document.XDocumentEventListener: Monitoring Document Event</bookmark_value> <bookmark_value>API;lang.EventObject: Monitoring Document Event</bookmark_value>" msgstr "" -#. gsCNB +#. CXFbV #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0527\n" "help.text" -msgid "<variable id=\"pythonmonitor\"><link href=\"text/sbasic/python/python_document_events.xhp\" name=\"Monitoring Document Events\">Monitoring Document Events</link></variable>" +msgid "<variable id=\"pythonmonitor\"><link href=\"text/sbasic/python/python_document_events.xhp\">Listening to Document Events</link></variable>" +msgstr "" + +#. 9kSGW +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"par_id641630582314861\n" +"help.text" +msgid "Listening to document events can help in the following situations:" +msgstr "" + +#. NEQoZ +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"par_id431630582396327\n" +"help.text" +msgid "Identify a new document at opening time, as opposed to existing ones, and perform a dedicated setup." msgstr "" -#. bXprs +#. Tror9 +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"par_id461630582396782\n" +"help.text" +msgid "Control the processing of document save, document copy, print or mailmerge requests." +msgstr "" + +#. xrRHB +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"par_id631630582394790\n" +"help.text" +msgid "Recalculate table of contents, indexes or table entries of a Writer document when document is going to be closed" +msgstr "" + +#. fCNvj +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"par_id601630582398998\n" +"help.text" +msgid "Import math Python packages before opening a Calc document. Release these packages when the document closes." +msgstr "" + +#. MviLj #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0528\n" "help.text" -msgid "Next to <link href=\"text/sbasic/shared/01040000.xhp\" name=\"assigning macros to events\">assigning macros to events</link>, one can monitor events raised by %PRODUCTNAME documents. Application Programming Interface (API) broadcasters are responsible for calling event scripts. Unlike listeners that require to define all supported methods, even if unused, document monitors require only two methods next to hooked event scripts." +msgid "Next to <link href=\"text/sbasic/shared/01040000.xhp\">assigning macros to events</link>, one can monitor events raised by %PRODUCTNAME documents. Application Programming Interface (API) broadcasters are responsible for calling event scripts. Unlike listeners that require to define all supported methods, even if unused, document monitors require only two methods next to hooked event scripts." msgstr "" -#. HztRG +#. 6j5Bu #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0529\n" "help.text" -msgid "Listening to Document Events" +msgid "Monitoring Document Events" msgstr "" -#. tFSkv +#. VwSwW #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0530\n" "help.text" -msgid "Monitoring is illustrated herewith for Basic and Python languages using object-oriented programming. Assigning <literal>OnLoad</literal> script, to the <literal>Open Document</literal> event, suffices to initiate and terminate document event monitoring. <menuitem>Tools – Customise...</menuitem> menu <menuitem>Events</menuitem> tab is used to assign either scripts." +msgid "Monitoring is illustrated herewith for Basic and Python languages using object-oriented programming. Assigning <literal>OnLoad</literal> script, to the <menuitem>Open Document</menuitem> event, suffices to initiate and terminate document event monitoring. <menuitem>Tools - Customize</menuitem> menu <menuitem>Events</menuitem> tab is used to assign either scripts." msgstr "" -#. 27Dcq +#. KgWvt #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0531\n" "help.text" -msgid "Intercepting events helps setting scripts pre- and post-conditions such as loading and unloading libraries or track script processing in the background. <literal>Access2Base Trace</literal> module usage is illustrating that second context." +msgid "Intercepting events helps setting scripts pre- and post-conditions such as loading and unloading libraries or track script processing in the background. <literal>Access2Base.Trace</literal> module usage is illustrating that second context." msgstr "" #. BG7Xs @@ -562,31 +616,31 @@ msgctxt "" msgid "With Python" msgstr "" -#. eGKkK +#. B4G2y #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" -"N0533\n" +"bm_id721622446590963\n" "help.text" -msgid "Events monitoring starts from object instantiation and ultimately stops when Python releases the object. Raised events are reported using <literal>Access2Base</literal> console." +msgid "<bookmark_value>API;frame.Desktop: Monitoring Document Event</bookmark_value> <bookmark_value>API;script.provider.MasterScriptProviderFactory: Monitoring Document Event</bookmark_value> <bookmark_value>API;script.provider.XScript: Monitoring Document Event</bookmark_value>" msgstr "" -#. 35oEi +#. eGKkK #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" -"N0534\n" +"N0533\n" "help.text" -msgid "<literal>OnLoad</literal> and <literal>OnUnload</literal> events can be used to respectively set and unset Python programs path. They are described as <literal>Open document</literal> and <literal>Document closed</literal>." +msgid "Events monitoring starts from object instantiation and ultimately stops when Python releases the object. Raised events are reported using <literal>Access2Base</literal> console." msgstr "" -#. AdYNb +#. mCDwK #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" -"N0543\n" +"N0534\n" "help.text" -msgid "class UiDocument(unohelper.Base, AdapterPattern):" +msgid "<literal>OnLoad</literal> and <literal>OnUnload</literal> events can be used to respectively set and unset Python programs path. They are described as <menuitem>Open document</menuitem> and <menuitem>Document closed</menuitem>." msgstr "" #. i7waD @@ -751,6 +805,15 @@ msgctxt "" msgid "def OnLoad(*args): # 'Open Document' event" msgstr "" +#. PmjAB +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"N0602\n" +"help.text" +msgid "listener = UiDocument() # Initiates listening" +msgstr "" + #. CkJg4 #: python_document_events.xhp msgctxt "" @@ -814,6 +877,15 @@ msgctxt "" msgid "\"\"\" Display console content/dialog \"\"\"" msgstr "" +#. mPJ3B +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"N0638\n" +"help.text" +msgid "''' Grab application-based Basic script '''" +msgstr "" + #. 2dfeg #: python_document_events.xhp msgctxt "" @@ -823,13 +895,13 @@ msgctxt "" msgid "Mind the misspelled <literal>documentEventOccured</literal> method that inherits a typo from %PRODUCTNAME Application Programming Interface (API)." msgstr "" -#. uGHTE +#. notj8 #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0648\n" "help.text" -msgid "<literal>Start application</literal> and <literal>Close application</literal> events can respectively be used to set and to unset Python path for user scripts or %PRODUCTNAME scripts. In a similar fashion, document based Python libraries or modules can be loaded and released using <literal>Open document</literal> and <literal>Document closed</literal> events. Refer to <link href=\"text/sbasic/python/python_import.xhp\" name=\"Importing Python Modules\">Importing Python Modules</link> for more information." +msgid "<menuitem>Start application</menuitem> and <menuitem>Close application</menuitem> events can respectively be used to set and to unset Python path for user scripts or %PRODUCTNAME scripts. In a similar fashion, document based Python libraries or modules can be loaded and released using <menuitem>Open document</menuitem> and <menuitem>Document closed</menuitem> events. Refer to <link href=\"text/sbasic/python/python_import.xhp\">Importing Python Modules</link> for more information." msgstr "" #. 8pHCg @@ -841,31 +913,40 @@ msgctxt "" msgid "With %PRODUCTNAME Basic" msgstr "" -#. SEw8V +#. QpCjq +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"bm_id591622446367707\n" +"help.text" +msgid "<bookmark_value>API;GlobalScope.BasicLibraries</bookmark_value> <bookmark_value>Tools;Strings</bookmark_value>" +msgstr "" + +#. D5Lsi #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0650\n" "help.text" -msgid "The <literal>Onload</literal> script is assigned to <literal>Open document</literal> event using <menuitem>Tools – Customise...</menuitem> menu <menuitem>Events</menuitem> tab. Events monitoring starts from the moment a <literal>ConsoleLogger</literal> object is instantiated and ultimately stops when Basic engine releases it. <literal>OnLoad</literal> event loads necessary Basic libraries, while caught events are reported using <literal>Access2Base.Trace</literal> module." +msgid "Using <menuitem>Tools - Customize</menuitem> menu <menuitem>Events</menuitem> tab, the <menuitem>Open document</menuitem> event fires a <literal>ConsoleLogger</literal> initialisation. <literal>_documentEventOccured</literal> routine - set by <literal>ConsoleLogger</literal> - serves as a unique entry point to trap all document events." msgstr "" -#. TAiMF +#. gGpkW #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" -"N0651\n" +"hd_id421630510141729\n" "help.text" -msgid "REM controller.Events module" +msgid "controller.Events module" msgstr "" -#. kYy8A +#. rJX92 #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" -"N0653\n" +"bas_id431630567378062\n" "help.text" -msgid "Private _obj As Object ' controller.ConsoleLogger instance" +msgid "Global _obj As Object ' controller.ConsoleLogger instance" msgstr "" #. PfRq6 @@ -877,31 +958,49 @@ msgctxt "" msgid "Sub OnLoad(evt As com.sun.star.document.DocumentEvent) ' >> Open Document <<" msgstr "" -#. BEVFV +#. p8RfU +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"bas_id371630509596674\n" +"help.text" +msgid "''' ConsoleLogger unique entry point '''" +msgstr "" + +#. upGWH #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" -"N0659\n" +"hd_id721630511986813\n" "help.text" -msgid "REM controller.ConsoleLogger class module" +msgid "controller.ConsoleLogger class module" msgstr "" -#. PG65V +#. AN8tn +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"par_id901630509435225\n" +"help.text" +msgid "Events monitoring starts from the moment a <literal>ConsoleLogger</literal> object is instantiated and ultimately stops upon document closure. <literal>StartAdapter</literal> routine loads necessary Basic libraries, while caught events are reported using <literal>Access2Base.Trace</literal> module." +msgstr "" + +#. 2jXHB #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0664\n" "help.text" -msgid "' ADAPTER design pattern object to be instantiated in « Open Document » event" +msgid "' ADAPTER design pattern object to be instantiated in the \"Open Document\" event" msgstr "" -#. 9ZNpG +#. ueeGx #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" -"N0668\n" +"N0666\n" "help.text" -msgid "' CONSTRUCTOR/DESTRUCTOR" +msgid "Private Const UI_NOPROMPT = False ' Set it to True to visualise documents events" msgstr "" #. EQG8C @@ -913,6 +1012,24 @@ msgctxt "" msgid "' MEMBERS" msgstr "" +#. r5AkD +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"bas_id131630510956418\n" +"help.text" +msgid "Private _txtMsg As String ' text message to log in console" +msgstr "" + +#. JaEhY +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"N0677\n" +"help.text" +msgid "' PROPERTIES" +msgstr "" + #. aGuEg #: python_document_events.xhp msgctxt "" @@ -949,13 +1066,13 @@ msgctxt "" msgid "''' Initialize document events logging '''" msgstr "" -#. A5RuU +#. hxzE4 #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" -"N0706\n" +"N0705\n" "help.text" -msgid "IIf(IsMissing(evt),\"\",evt.EventName & \"-\") & \"Document events are being logged\", _" +msgid "Access2Base.Trace.TraceLog(\"INFO\", _txtMsg & \"Document events are being logged\", UI_PROMPT)" msgstr "" #. NkHa4 @@ -967,13 +1084,31 @@ msgctxt "" msgid "''' Terminate document events logging '''" msgstr "" -#. np2xy +#. JEve4 #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0717\n" "help.text" -msgid "IIf(IsMissing(evt),\"\",evt.EventName & \"-\") & \"Document events have been logged\", _" +msgid "Access2Base.Trace.TraceLog(\"INFO\", _txtMsg & \"Document events have been logged\", UI_PROMPT)" +msgstr "" + +#. GAD2E +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"N0719\n" +"help.text" +msgid "Access2Base.Trace.TraceConsole() ' Captured events dialog" +msgstr "" + +#. X8Kdh +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"N0722\n" +"help.text" +msgid "' EVENTS" msgstr "" #. uVpJf @@ -1003,6 +1138,15 @@ msgctxt "" msgid "Discovering Documents Events" msgstr "" +#. Ys35P +#: python_document_events.xhp +msgctxt "" +"python_document_events.xhp\n" +"bm_id681622445958242\n" +"help.text" +msgid "<bookmark_value>API;frame.GlobalEventBroadcaster: Monitoring Document Event</bookmark_value>" +msgstr "" + #. BDj9Q #: python_document_events.xhp msgctxt "" @@ -1039,13 +1183,13 @@ msgctxt "" msgid "adapted from DisplayAvailableEvents() by A. Pitonyak" msgstr "" -#. wXN8p +#. o2YTy #: python_document_events.xhp msgctxt "" "python_document_events.xhp\n" "N0747\n" "help.text" -msgid "The <link href=\"https://extensions.libreoffice.org/extensions/apso-alternative-script-organizer-for-python\" name=\"Alternative Python Script Organizer\">Alternative Python Script Organizer (APSO)</link> extension is used to render events information on screen." +msgid "The <link href=\"https://extensions.libreoffice.org/extensions/apso-alternative-script-organizer-for-python\">Alternative Python Script Organizer (APSO)</link> extension is used to render events information on screen." msgstr "" #. kgY8m @@ -1075,22 +1219,22 @@ msgctxt "" msgid "Python examples" msgstr "" -#. Etrfb +#. DAoFA #: python_examples.xhp msgctxt "" "python_examples.xhp\n" "bm_id20191031405\n" "help.text" -msgid "<bookmark_value>Python;examples</bookmark_value> <bookmark_value>Python;shell</bookmark_value> <bookmark_value>Python;platform</bookmark_value> <bookmark_value>Python;session</bookmark_value> <bookmark_value>Python;screen input/output</bookmark_value>" +msgid "<bookmark_value>Python;examples</bookmark_value> <bookmark_value>Python;platform</bookmark_value> <bookmark_value>Python;session</bookmark_value> <bookmark_value>Python;screen input/output</bookmark_value>" msgstr "" -#. 2vmkq +#. QbiDM #: python_examples.xhp msgctxt "" "python_examples.xhp\n" "hd_id201901031407\n" "help.text" -msgid "<variable id=\"pythonexamples2\"><link href=\"text/sbasic/python/python_examples.xhp\" name=\"python examples\">Python programming examples</link></variable>" +msgid "<variable id=\"pythonexamples2\"><link href=\"text/sbasic/python/python_examples.xhp\">Python programming examples</link></variable>" msgstr "" #. xkeov @@ -1111,22 +1255,22 @@ msgctxt "" msgid "<bookmark_value>Basic;Dialog Handler</bookmark_value> <bookmark_value>Python;Dialog Handler</bookmark_value> <bookmark_value>Access2Base;dlgTrace</bookmark_value> <bookmark_value>Access2Base;_DumpToFile</bookmark_value> <bookmark_value>API;DialogProvider2</bookmark_value> <bookmark_value>API;XDialogEventHandler</bookmark_value>" msgstr "" -#. MQUtw +#. 6ADFX #: python_handler.xhp msgctxt "" "python_handler.xhp\n" "N0665\n" "help.text" -msgid "<variable id=\"pythonhandler_h1\"><link href=\"text/sbasic/python/python_handler.xhp\" name=\"Creating a Dialog Handler\">Creating a Dialog Handler</link></variable>" +msgid "<variable id=\"pythonhandler_h1\"><link href=\"text/sbasic/python/python_handler.xhp\">Creating a Dialog Handler</link></variable>" msgstr "" -#. AxGAd +#. ykPkA #: python_handler.xhp msgctxt "" "python_handler.xhp\n" "N0666\n" "help.text" -msgid "Next to <link href=\"text/sbasic/shared/01040000.xhp\" name=\"Assigning macros to events\">assigning macros to events</link> or <link href=\"text/sbasic/basic/python/python_listener\" name=\"creating event listeners\">creating event listeners</link>, one can use dialog handlers, whose principle is to define UNO keywords, or methods, that are mapped to events to watch for. The event handler is responsible for executing methods using the <literal>vnd.sun.star.UNO:<method_name></literal> protocol. Unlike listeners that require to define all supported methods, even if unused, dialog handlers require only two methods on top of intended control hook scripts." +msgid "Next to <link href=\"text/sbasic/shared/01040000.xhp\">assigning macros to events</link> or <link href=\"text/sbasic/basic/python/python_listener\">creating event listeners</link>, one can use dialog handlers, whose principle is to define UNO keywords, or methods, that are mapped to events to watch for. The event handler is responsible for executing methods using the <literal>vnd.sun.star.UNO:<method_name></literal> protocol. Unlike listeners that require to define all supported methods, even if unused, dialog handlers require only two methods on top of intended control hook scripts." msgstr "" #. Waa56 @@ -1183,13 +1327,13 @@ msgctxt "" msgid "Export <literal>Access2Base</literal> <literal>dlgTrace</literal> dialog and import it into <literal>MyLib</literal> application library." msgstr "" -#. QKmBa +#. vFWDG #: python_handler.xhp msgctxt "" "python_handler.xhp\n" "N0673\n" "help.text" -msgid "Inside the control properties pane of the <link href=\"text/sbasic/guide/create_dialog.xhp\" name=\"Dialog Editor\">Dialog Editor</link>, use the Events tab to replace macro assignments by component assignments, and type in the intended method names:" +msgid "Inside the control properties pane of the <link href=\"text/sbasic/guide/create_dialog.xhp\">Dialog Editor</link>, use the Events tab to replace macro assignments by component assignments, and type in the intended method names:" msgstr "" #. qNEVD @@ -1237,13 +1381,13 @@ msgctxt "" msgid "Creating the handler" msgstr "" -#. nHvEi +#. BN7Lo #: python_handler.xhp msgctxt "" "python_handler.xhp\n" "N0679\n" "help.text" -msgid "<literal>createDialogWithHandler</literal> method of <link href=\"https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1awt_1_1DialogProvider2.html\" name=\"com.sun.star.awt.DialogProvider2\">com.sun.star.awt.DialogProvider2</link> service is used to set the dialog and its handler. The handler is responsible for implementing <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1XDialogEventHandler.html\" name=\"com.sun.star.awt.XDialogEventHandler\">com.sun.star.awt.XDialogEventHandler</link> interface." +msgid "<literal>createDialogWithHandler</literal> method of <link href=\"https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1awt_1_1DialogProvider2.html\">com.sun.star.awt.DialogProvider2</link> service is used to set the dialog and its handler. The handler is responsible for implementing <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1XDialogEventHandler.html\">com.sun.star.awt.XDialogEventHandler</link> interface." msgstr "" #. 2CCEz @@ -1318,13 +1462,13 @@ msgctxt "" msgid "As expected, <literal>onOkHasFocus</literal> missing method throws an exception." msgstr "" -#. 63rxz +#. vC7GW #: python_handler.xhp msgctxt "" "python_handler.xhp\n" "N0741\n" "help.text" -msgid "Refer to <link href=\"text/sbasic/python/python_2_basic.xhp\" name=\"Python calls to %PRODUCTNAME Basic\">Python calls to %PRODUCTNAME Basic</link> page for <literal>getBasicScript</literal> routine description and for details about cross-language scripting execution." +msgid "Refer to <link href=\"text/sbasic/python/python_2_basic.xhp\">Python calls to %PRODUCTNAME Basic</link> page for <literal>getBasicScript</literal> routine description and for details about cross-language scripting execution." msgstr "" #. b6xGw @@ -1390,13 +1534,13 @@ msgctxt "" msgid "As expected, <literal>onOkHasFocus</literal> missing method throws an exception." msgstr "" -#. 4RevF +#. EX74b #: python_handler.xhp msgctxt "" "python_handler.xhp\n" "N0505\n" "help.text" -msgid "<link href=\"text/sbasic/shared/03132000.xhp\" name=\"CreateUnoListener Function\">CreateUnoListener Function</link>" +msgid "<link href=\"text/sbasic/shared/03132000.xhp\">CreateUnoListener Function</link>" msgstr "" #. Ur3DA @@ -1417,13 +1561,13 @@ msgctxt "" msgid "<bookmark_value>APSO</bookmark_value> <bookmark_value>Alternative Python Scripts Organizer</bookmark_value> <bookmark_value>python;IDE - integrated development environment</bookmark_value> <bookmark_value>python;editor</bookmark_value>" msgstr "" -#. cANSA +#. fzoAS #: python_ide.xhp msgctxt "" "python_ide.xhp\n" "hd_id151543348965464\n" "help.text" -msgid "<variable id=\"pythonideh1\"><link href=\"text/sbasic/python/python_ide.xhp\" name=\"Python IDE Setup\">Setting up an Integrated Development Environment (IDE) for Python</link></variable>" +msgid "<variable id=\"pythonideh1\"><link href=\"text/sbasic/python/python_ide.xhp\">Setting up an Integrated Development Environment (IDE) for Python</link></variable>" msgstr "" #. k7syF @@ -1435,13 +1579,13 @@ msgctxt "" msgid "Writing Python macros requires extra configuration steps to set an IDE of choice." msgstr "" -#. NGxNi +#. pYeKm #: python_ide.xhp msgctxt "" "python_ide.xhp\n" "N0106\n" "help.text" -msgid "Unlike Basic language macros development in %PRODUCTNAME, developing Python scripts for %PRODUCTNAME requires to configure an external Integrated Development Environment (IDE). Multiple IDEs are available that range from beginners to advanced Python coders. While using a Python IDE programmers benefit from numerous features such as syntax highlighting, code folding, class browsing, code completion, coding standard enforcement, test driven development, debugging, version control and many more. You can refer to <link href=\"https://wiki.documentfoundation.org/Macros/Python_Design_Guide\" name=\"Designing & Developing Python Applications\">Designing & Developing Python Applications</link> on the Wiki for more in-depth information about the setup of a bridge between your IDE and a running instance %PRODUCTNAME." +msgid "Unlike Basic language macros development in %PRODUCTNAME, developing Python scripts for %PRODUCTNAME requires to configure an external Integrated Development Environment (IDE). Multiple IDEs are available that range from beginners to advanced Python coders. While using a Python IDE programmers benefit from numerous features such as syntax highlighting, code folding, class browsing, code completion, coding standard enforcement, test driven development, debugging, version control and many more. You can refer to <link href=\"https://wiki.documentfoundation.org/Macros/Python_Design_Guide\">Designing & Developing Python Applications</link> on the Wiki for more in-depth information about the setup of a bridge between your IDE and a running instance %PRODUCTNAME." msgstr "" #. u2xio @@ -1453,13 +1597,13 @@ msgctxt "" msgid "The APSO Extension" msgstr "" -#. 4isF2 +#. TZvni #: python_ide.xhp msgctxt "" "python_ide.xhp\n" "N0104\n" "help.text" -msgid "The <link href=\"https://extensions.libreoffice.org/extensions/apso-alternative-script-organizer-for-python\" name=\"Alternative Python Script Organizer (APSO)\">Alternative Python Script Organizer (APSO)</link> extension eases the edition of Python scripts, in particular when embedded in a document. Using APSO you can configure your preferred source code editor, start the integrated Python shell and debug Python scripts. Extensions exist that help inspect arbitrary UNO objects, refer to <link href=\"https://wiki.documentfoundation.org/Macros/Python_Design_Guide\" name=\"eDesigning & Developing Python Applications\">Designing & Developing Python Applications</link> for additional details on such extensions." +msgid "The <link href=\"https://extensions.libreoffice.org/extensions/apso-alternative-script-organizer-for-python\">Alternative Python Script Organizer (APSO)</link> extension eases the edition of Python scripts, in particular when embedded in a document. Using APSO you can configure your preferred source code editor, start the integrated Python shell and debug Python scripts. Extensions exist that help inspect arbitrary UNO objects, refer to <link href=\"https://wiki.documentfoundation.org/Macros/Python_Design_Guide\">Designing & Developing Python Applications</link> for additional details on such extensions." msgstr "" #. 5E2EV @@ -1480,13 +1624,13 @@ msgctxt "" msgid "<bookmark_value>Python;import</bookmark_value> <bookmark_value>Python;Modules</bookmark_value> <bookmark_value>Python;pythonpath</bookmark_value> <bookmark_value>PythonLibraries</bookmark_value>" msgstr "" -#. 5QqdJ +#. MHcrX #: python_import.xhp msgctxt "" "python_import.xhp\n" "N0462\n" "help.text" -msgid "<variable id=\"pythonimporth1\"><link href=\"text/sbasic/python/python_import.xhp\" name=\"python imports\">Importing Python Modules</link></variable>" +msgid "<variable id=\"pythonimporth1\"><link href=\"text/sbasic/python/python_import.xhp\">Importing Python Modules</link></variable>" msgstr "" #. VHAM5 @@ -1813,31 +1957,31 @@ msgctxt "" msgid "<bookmark_value>Python;Event Listener</bookmark_value> <bookmark_value>Python;createUnoListener</bookmark_value> <bookmark_value>Basic;Event Listener</bookmark_value> <bookmark_value>API;ActionEvent</bookmark_value> <bookmark_value>API;DialogProvider</bookmark_value> <bookmark_value>API;EventObject</bookmark_value> <bookmark_value>API;ExecutableDialogResults</bookmark_value> <bookmark_value>API;XActionListener</bookmark_value>" msgstr "" -#. Pjc9z +#. o4QUC #: python_listener.xhp msgctxt "" "python_listener.xhp\n" "N0386\n" "help.text" -msgid "<variable id=\"pythonlistener\"><link href=\"text/sbasic/python/python_listener.xhp\" name=\"python listeners\">Creating Event Listeners</link></variable>" +msgid "<variable id=\"pythonlistener\"><link href=\"text/sbasic/python/python_listener.xhp\">Creating Event Listeners</link></variable>" msgstr "" -#. DGgrp +#. S8UHm #: python_listener.xhp msgctxt "" "python_listener.xhp\n" "N0387\n" "help.text" -msgid "Events raised by dialogs, documents, forms or graphical controls can be linked to macros, which is referred to as event-driven programming. The most common method to relate events to macros are the <literal>Events</literal> tab in <menuitem>Tools – Customize</menuitem> menu and the <link href=\"text/sbasic/guide/create_dialog.xhp\" name=\"Create dialog\">Dialog Editor</link> Control properties pane from <menuitem>Tools - Macros – Organise Dialogs...</menuitem> menu." +msgid "Events raised by dialogs, documents, forms or graphical controls can be linked to macros, which is referred to as event-driven programming. The most common method to relate events to macros are the <literal>Events</literal> tab in <menuitem>Tools – Customize</menuitem> menu and the <link href=\"text/sbasic/guide/create_dialog.xhp\">Dialog Editor</link> Control properties pane from <menuitem>Tools - Macros – Organise Dialogs...</menuitem> menu." msgstr "" -#. DmmbY +#. Dd2YW #: python_listener.xhp msgctxt "" "python_listener.xhp\n" "N0388\n" "help.text" -msgid "Graphical artifacts, keyboard inputs, mouse moves and other man/machine interactions can be controlled using UNO listeners that watch for the user’s behaviour. Listeners are dynamic program code alternatives to macro assignments. One may create as many UNO listeners as events to watch for. A single listener can also handle multiple user interface controls." +msgid "Graphical artifacts, keyboard inputs, mouse moves and other man/machine interactions can be controlled using UNO listeners that watch for the user’s behavior. Listeners are dynamic program code alternatives to macro assignments. One may create as many UNO listeners as events to watch for. A single listener can also handle multiple user interface controls." msgstr "" #. UVzsE @@ -2002,40 +2146,31 @@ msgctxt "" msgid "Other Event Listeners" msgstr "" -#. HsXBE +#. 5CsEJ #: python_listener.xhp msgctxt "" "python_listener.xhp\n" "N0499\n" "help.text" -msgid "Listeners are usually coded along with <link href=\"text/sbasic/python/python_dialogs.xhp\" name=\"dialog opening\">dialog opening</link>. Numerous listener approaches are possible such as event handlers for dialogs or event monitors for documents or forms." +msgid "Listeners are usually coded along with <link href=\"text/sbasic/python/python_dialogs.xhp\">dialog opening</link>. Numerous listener approaches are possible such as event handlers for dialogs or event monitors for documents or forms." msgstr "" -#. Xyv2b -#: python_listener.xhp -msgctxt "" -"python_listener.xhp\n" -"N0505\n" -"help.text" -msgid "<link href=\"text/sbasic/shared/03132000.xhp\" name=\"CreateUnoListener Function\">CreateUnoListener Function</link>" -msgstr "" - -#. zKQhy +#. 2u4dC #: python_listener.xhp msgctxt "" "python_listener.xhp\n" "N0506\n" "help.text" -msgid "<link href=\"text/swriter/01/05060700.xhp\" name=\"Events mapping to objects\">Events mapping to objects</link>" +msgid "<link href=\"text/swriter/01/05060700.xhp\">Events mapping to objects</link>" msgstr "" -#. Xbxfm +#. CWePB #: python_listener.xhp msgctxt "" "python_listener.xhp\n" "N0509\n" "help.text" -msgid "See also <link href=\"text/sbasic/shared/01040000.xhp\" name=\"Document events\">Document events</link>, <link href=\"text/shared/02/01170202.xhp\" name=\"Form events\">Form events</link>." +msgid "See also <link href=\"text/sbasic/shared/01040000.xhp\">Document events</link>, <link href=\"text/shared/02/01170202.xhp\">Form events</link>." msgstr "" #. GC8Ny @@ -2047,22 +2182,94 @@ msgctxt "" msgid "Python Scripts Organization" msgstr "" -#. KKGnc +#. ENGH2 #: python_locations.xhp msgctxt "" "python_locations.xhp\n" "hd_id391543358231021\n" "help.text" -msgid "<variable id=\"pythonlocations1\"><link href=\"text/sbasic/python/python_locations.xhp\" name=\"command_name\">Python Scripts Organization and Location</link></variable>" +msgid "<variable id=\"pythonlocations1\"><link href=\"text/sbasic/python/python_locations.xhp\">Python Scripts Organization and Location</link></variable>" msgstr "" -#. sG2Rn +#. rRufi +#: python_locations.xhp +msgctxt "" +"python_locations.xhp\n" +"par_id481636114810038\n" +"help.text" +msgid "%PRODUCTNAME macros are grouped in module files, modules are usually grouped in library folders, and libraries are grouped in library containers although containers can contain modules too." +msgstr "" + +#. wGWz9 #: python_locations.xhp msgctxt "" "python_locations.xhp\n" "par_id771543358231022\n" "help.text" -msgid "The Python script files are stored in the filesystem, in folders controlled by %PRODUCTNAME. The macros can be started at installation, user or file level." +msgid "A library is used as a major grouping for either an entire category of macros, or for an entire application. Modules usually split functionality, such as user interaction and calculations. Individual macros are subroutines and functions. The Figure below shows an example of the hierarchical structure of macro libraries in %PRODUCTNAME." +msgstr "" + +#. b8iEG +#: python_locations.xhp +msgctxt "" +"python_locations.xhp\n" +"par_id771636279690940\n" +"help.text" +msgid "<image src=\"media/helpimg/sbasic/Library-Container.svg\" id=\"img_id121636285791637\" width=\"8cm\" height=\"5.5cm\"><alt id=\"alt_id471636279690940\">Library Container diagram</alt></image>" +msgstr "" + +#. JqG95 +#: python_locations.xhp +msgctxt "" +"python_locations.xhp\n" +"par_id171636114787810\n" +"help.text" +msgid "<emph>Figure:</emph> Macro Library hierarchy" +msgstr "" + +#. dbwvM +#: python_locations.xhp +msgctxt "" +"python_locations.xhp\n" +"par_id801636114790638\n" +"help.text" +msgid "The containers are accessible in all %PRODUCTNAME programs through the user interface. Go to <menuitem>Tools > Macros > Organize Macros > Python</menuitem>, to open the Python Macros dialog." +msgstr "" + +#. FU5EC +#: python_locations.xhp +msgctxt "" +"python_locations.xhp\n" +"par_id801636114808666\n" +"help.text" +msgid "Three library containers are shown in the Macro From list:" +msgstr "" + +#. RnBRr +#: python_locations.xhp +msgctxt "" +"python_locations.xhp\n" +"par_id321636114854594\n" +"help.text" +msgid "<emph>My Macros:</emph> personal macros available for the %PRODUCTNAME user" +msgstr "" + +#. bDXrr +#: python_locations.xhp +msgctxt "" +"python_locations.xhp\n" +"par_id471636114847530\n" +"help.text" +msgid "<emph>Application Macros:</emph> system macros distributed with %PRODUCTNAME for every computer user" +msgstr "" + +#. kVY4C +#: python_locations.xhp +msgctxt "" +"python_locations.xhp\n" +"par_id191636114858218\n" +"help.text" +msgid "<emph>Document macros:</emph> every document can contain macro libraries available in that document for all users" msgstr "" #. iEtmS @@ -2074,22 +2281,22 @@ msgctxt "" msgid "Python Script Locations" msgstr "" -#. cmghv +#. AMBK6 #: python_locations.xhp msgctxt "" "python_locations.xhp\n" "par_id121551089455774\n" "help.text" -msgid "Refer to <link href=\"text/sbasic/python/python_session.xhp\" name=\"Getting Session Information\">Getting Session Information</link> in order to get programmatic access to Python script locations." +msgid "Refer to <link href=\"text/sbasic/python/python_session.xhp\">Getting Session Information</link> in order to get programmatic access to Python script locations." msgstr "" -#. QGXPA +#. GDrUs #: python_locations.xhp msgctxt "" "python_locations.xhp\n" "hd_id591544049572647\n" "help.text" -msgid "%PRODUCTNAME Macros container" +msgid "Application Macros" msgstr "" #. xBzRT @@ -2200,67 +2407,13 @@ msgctxt "" msgid "Libraries, Modules and Macros" msgstr "" -#. KnZCV +#. 24e7J #: python_locations.xhp msgctxt "" "python_locations.xhp\n" "par_id181544209916707\n" "help.text" -msgid "Like BASIC macros, Python macros can be organized in libraries, modules and macros." -msgstr "" - -#. LoK2E -#: python_locations.xhp -msgctxt "" -"python_locations.xhp\n" -"hd_id21544209865082\n" -"help.text" -msgid "Creating a Python Library" -msgstr "" - -#. R2uCF -#: python_locations.xhp -msgctxt "" -"python_locations.xhp\n" -"par_id191544209928221\n" -"help.text" -msgid "Libraries are folders in the container tree. To create a library, add a folder in the target container. The library name is the folder name." -msgstr "" - -#. hFS3L -#: python_locations.xhp -msgctxt "" -"python_locations.xhp\n" -"hd_id31544209872869\n" -"help.text" -msgid "Creating a Python Module." -msgstr "" - -#. djeua -#: python_locations.xhp -msgctxt "" -"python_locations.xhp\n" -"par_id161544209936743\n" -"help.text" -msgid "A module is a python file in the library or the container. Create a module adding a file in the container." -msgstr "" - -#. Paoju -#: python_locations.xhp -msgctxt "" -"python_locations.xhp\n" -"hd_id151544209895574\n" -"help.text" -msgid "Python macros" -msgstr "" - -#. CBeyB -#: python_locations.xhp -msgctxt "" -"python_locations.xhp\n" -"par_id61544209944591\n" -"help.text" -msgid "A macro is a python object in the module." +msgid "Python macros can be organized in libraries, modules and macros. Use the Macro Library hierarchy as a guide when creating or installing new macros in module files, new module files in library folders or new library folders in containers." msgstr "" #. Zcfxg @@ -2281,13 +2434,13 @@ msgctxt "" msgid "<bookmark_value>Platform;isLinux</bookmark_value> <bookmark_value>Platform;isMacOsX</bookmark_value> <bookmark_value>Platform;isWindows</bookmark_value> <bookmark_value>Platform;ComputerName</bookmark_value> <bookmark_value>Platform;OSName</bookmark_value> <bookmark_value>API;ConfigurationAccess</bookmark_value> <bookmark_value>Tools;GetRegistryContent</bookmark_value>" msgstr "" -#. uMBGn +#. drCq4 #: python_platform.xhp msgctxt "" "python_platform.xhp\n" "N0509\n" "help.text" -msgid "<variable id=\"pythonplatform\"><link href=\"text/sbasic/python/python_platform.xhp\" name=\"platform01\">Identifying the operating system</link></variable>" +msgid "<variable id=\"pythonplatform\"><link href=\"text/sbasic/python/python_platform.xhp\">Identifying the operating system</link></variable>" msgstr "" #. vqduy @@ -2443,31 +2596,31 @@ msgctxt "" msgid "Python : Programming with Python" msgstr "" -#. bG2BP +#. BG8VW #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0218\n" "help.text" -msgid "<bookmark_value>Python;Programming</bookmark_value> <bookmark_value>XSCRIPTCONTEXT;Python</bookmark_value> <bookmark_value>uno.py</bookmark_value>" +msgid "<bookmark_value>Python;Programming</bookmark_value> <bookmark_value>XSCRIPTCONTEXT;Python</bookmark_value> <bookmark_value>XSCRIPTCONTEXT;getComponentContext</bookmark_value> <bookmark_value>XSCRIPTCONTEXT;getDesktop</bookmark_value> <bookmark_value>XSCRIPTCONTEXT;getDocument</bookmark_value> <bookmark_value>uno.py;getComponentContext</bookmark_value> <bookmark_value>uno.py;getDesktop</bookmark_value> <bookmark_value>uno.py;getDocument</bookmark_value>" msgstr "" -#. CU6JS +#. sZPDY #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "hd_id691546462755220\n" "help.text" -msgid "<variable id=\"pythonprogrammingheading\"><link href=\"text/sbasic/python/python_programming.xhp\" name=\"python programming\">Programming with Python Scripts</link></variable>" +msgid "<variable id=\"pythonprogrammingheading\"><link href=\"text/sbasic/python/python_programming.xhp\">Programming with Python Scripts</link></variable>" msgstr "" -#. BjiFe +#. Mc7G4 #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0220\n" "help.text" -msgid "A Python macro is a function within a .py file, identified as a module. Unlike %PRODUCTNAME Basic and its dozen of <link href=\"text/sbasic/shared/uno_objects.xhp\" name=\"UNO objects functions or services\">UNO objects functions or services</link>, Python macros use the <literal>XSCRIPTCONTEXT</literal> UNO single object, shared with JavaScript and BeanShell. The <literal>g_exportedScripts</literal> global tuple explicitly lists selectable macros from a module. Python modules hold autonomous code logic, and are independent from one another." +msgid "A Python macro is a function within a .py file, identified as a module. Unlike %PRODUCTNAME Basic and its dozen of <link href=\"text/sbasic/shared/uno_objects.xhp\">UNO objects functions or services</link>, Python macros use the <literal>XSCRIPTCONTEXT</literal> UNO single object, shared with JavaScript and BeanShell. The <literal>g_exportedScripts</literal> global tuple explicitly lists selectable macros from a module. Python modules hold autonomous code logic, and are independent from one another." msgstr "" #. 8Ri8m @@ -2479,13 +2632,13 @@ msgctxt "" msgid "XSCRIPTCONTEXT Global Variable" msgstr "" -#. xnRGE +#. 8GP6t #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0222\n" "help.text" -msgid "Genuine Basic UNO facilities can be inferred from <literal>XSCRIPTCONTEXT</literal> global variable. Refer to %PRODUCTNAME API for a complete <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1script_1_1provider_1_1XScriptContext.html\" name=\"description of XSCRIPTCONTEXT\">description of XSCRIPTCONTEXT</link>. <literal>XSCRIPTCONTEXT</literal> methods summarize as:" +msgid "Genuine Basic UNO facilities can be inferred from <literal>XSCRIPTCONTEXT</literal> global variable. Refer to %PRODUCTNAME API for a complete <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1script_1_1provider_1_1XScriptContext.html\">description of XSCRIPTCONTEXT</link>. <literal>XSCRIPTCONTEXT</literal> methods summarize as:" msgstr "" #. U6KbS @@ -2578,22 +2731,31 @@ msgctxt "" msgid "<literal>XSCRIPTCONTEXT</literal> is not provided to imported modules." msgstr "" -#. dURCV +#. FxPgc #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0241\n" "help.text" -msgid "%PRODUCTNAME Basic libraries contain classes, routines and variables, Python modules contain classes, functions and variables. Common pieces of reusable Python or UNO features must be stored in <link href=\"text/sbasic/python/python_locations.xhp\" name=\"My macros\">My macros</link> within <literal>(User Profile)/Scripts/python/pythonpath</literal>. Python libraries help organize modules in order to prevent module name collisions. Import <literal>uno.py</literal> inside shared modules." +msgid "%PRODUCTNAME Basic libraries contain classes, routines and variables, Python modules contain classes, functions and variables. Common pieces of reusable Python or UNO features must be stored in <link href=\"text/sbasic/python/python_locations.xhp\">My macros</link> within <literal>(User Profile)/Scripts/python/pythonpath</literal>. Python libraries help organize modules in order to prevent module name collisions. Import <literal>uno.py</literal> inside shared modules." msgstr "" -#. a2xVe +#. EGdaE #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0242\n" "help.text" -msgid "Genuine BASIC UNO facilities can be inferred using <literal>uno.py</literal> module. Use <link href=\"text/sbasic/python/python_shell.xhp\" name=\"Python interactive shell\">Python interactive shell</link> to get a complete module description using <literal>dir()</literal> and <literal>help()</literal> Python commands." +msgid "Genuine BASIC UNO facilities can be inferred using <literal>uno.py</literal> module. Use <link href=\"text/sbasic/python/python_shell.xhp\">Python interactive shell</link> to get a complete module description using <literal>dir()</literal> and <literal>help()</literal> Python commands." +msgstr "" + +#. SsAZa +#: python_programming.xhp +msgctxt "" +"python_programming.xhp\n" +"bm_id391659034206678\n" +"help.text" +msgid "<bookmark_value>uno.py</bookmark_value> <bookmark_value>uno.py;absolutize</bookmark_value> <bookmark_value>uno.py;createUnoStruct</bookmark_value> <bookmark_value>uno.py;fileUrlToSystemPath</bookmark_value> <bookmark_value>uno.py;getClass</bookmark_value> <bookmark_value>uno.py;getComponentContext</bookmark_value> <bookmark_value>uno.py;Enum</bookmark_value> <bookmark_value>uno.py;getConstantByName</bookmark_value> <bookmark_value>uno.py;isInterface</bookmark_value> <bookmark_value>uno.py;systemPathToFileUrl</bookmark_value>" msgstr "" #. Gi6iz @@ -2704,13 +2866,13 @@ msgctxt "" msgid "Returns a file URL for the given system path." msgstr "" -#. GEMGY +#. CRVmL #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0272\n" "help.text" -msgid "<emph>LibreLogo</emph> and <emph>TableSample</emph> installation shared scripts use <literal>uno.py</literal> module." +msgid "<emph>LibreLogo</emph>, <emph>NamedRanges</emph>, <emph>SetCellColor</emph> and <emph>TableSample</emph> preinstalled scripts use <literal>uno.py</literal> module." msgstr "" #. 9NieC @@ -2740,22 +2902,22 @@ msgctxt "" msgid "Basic UNO features" msgstr "" -#. 8EWYh +#. wSBYY #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0284\n" "help.text" -msgid "See <link href=\"text/sbasic/python/python_dialogs.xhp\" name=\"Opening a Dialog\">Opening a Dialog</link>" +msgid "See <link href=\"text/sbasic/python/python_dialogs.xhp\">Opening a Dialog</link>" msgstr "" -#. F2cFF +#. ucBDS #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0286\n" "help.text" -msgid "See <link href=\"text/sbasic/python/python_listener.xhp\" name=\"Creating a Listener\">Creating a Listener</link>" +msgid "See <link href=\"text/sbasic/python/python_listener.xhp\">Creating a Listener</link>" msgstr "" #. LNUaK @@ -2767,29 +2929,29 @@ msgctxt "" msgid "See UNO data types" msgstr "" -#. 4vWGa +#. pFbcP #: python_programming.xhp msgctxt "" "python_programming.xhp\n" -"N0297\n" +"N1297\n" "help.text" msgid "Importing an embedded Module" msgstr "" -#. SGVBE +#. GPRuc #: python_programming.xhp msgctxt "" "python_programming.xhp\n" -"N0298\n" +"N1298\n" "help.text" -msgid "Similarly to %PRODUCTNAME Basic that supports browsing and dynamic loading of libraries, Python libraries can be explored and imported on demand. For more information on library containers, visit <link href=\"https://api.libreoffice.org/\" name=\"API Documentation site\">%PRODUCTNAME Application Programming Interface</link> (API) or download <link href=\"https://www.libreoffice.org/download/download/\" name=\"SDK download page\">%PRODUCTNAME Software Development Kit</link> (SDK)." +msgid "Similarly to %PRODUCTNAME Basic that supports browsing and dynamic loading of libraries, Python libraries can be explored and imported on demand. For more information on library containers, visit <link href=\"https://api.libreoffice.org/\">%PRODUCTNAME Application Programming Interface</link> (API) or download <link href=\"https://www.libreoffice.org/download/download/\">%PRODUCTNAME Software Development Kit</link> (SDK)." msgstr "" -#. VtFrH +#. SEeXV #: python_programming.xhp msgctxt "" "python_programming.xhp\n" -"N0299\n" +"N3299\n" "help.text" msgid "Importing a Python document embedded module is illustrated below, exception handling is not detailed:" msgstr "" @@ -2866,13 +3028,13 @@ msgctxt "" msgid "ui = load_library(\"my_gui\",'screen_io') # add <lib> path + import <module>" msgstr "" -#. HFcCm +#. yjHXX #: python_programming.xhp msgctxt "" "python_programming.xhp\n" "N0321\n" "help.text" -msgid "<link href=\"text/sbasic/shared/uno_objects.xhp\" name=\"UNO objects page\">Basic UNO Objects, Functions and Services</link>" +msgid "<link href=\"text/sbasic/shared/uno_objects.xhp\">Basic UNO Objects, Functions and Services</link>" msgstr "" #. zRBRa @@ -2893,13 +3055,13 @@ msgctxt "" msgid "<bookmark_value>Python;InputBox</bookmark_value> <bookmark_value>Python;MsgBox</bookmark_value> <bookmark_value>Python;Print</bookmark_value> <bookmark_value>API;script.provider.MasterScriptProvider: Screen Input/Output</bookmark_value> <bookmark_value>API;script.provider.XScript: Screen Input/Output</bookmark_value>" msgstr "" -#. fovpz +#. aSpmm #: python_screen.xhp msgctxt "" "python_screen.xhp\n" "N0434\n" "help.text" -msgid "<variable id=\"ioscreen\"><link href=\"text/sbasic/python/python_screen.xhp\" name=\"IO to screen\">Input/Output to Screen</link></variable>" +msgid "<variable id=\"ioscreen\"><link href=\"text/sbasic/python/python_screen.xhp\">Input/Output to Screen</link></variable>" msgstr "" #. qCLEs @@ -2911,13 +3073,13 @@ msgctxt "" msgid "Python standard output file is not available when running Python macros from <menuitem>Tools – Macros - Run Macro</menuitem>... menu. Presenting the output of a module requires the Python interactive console. Features such as <literal>input()</literal>, <literal>print()</literal>, <literal>repr()</literal> and <literal>str()</literal> are available from the Python shell." msgstr "" -#. NHHFB +#. ftsGT #: python_screen.xhp msgctxt "" "python_screen.xhp\n" -"N0436\n" +"msgbox_tip\n" "help.text" -msgid "The <link href=\"https://extensions.libreoffice.org/extensions/apso-alternative-script-organizer-for-python\" name=\"apso\">Alternative Python Script Organizer</link> (APSO) extension offers a msgbox() function out of its <literal>apso_utils</literal> module." +msgid "%PRODUCTNAME <literal>msgbox</literal> Python module proposes a <literal>msgbox()</literal> method that is illustrated in <link href=\"text/sbasic/python/python_handler.xhp\">Creating Event Listeners</link> and <link href=\"text/sbasic/python/python_handler.xhp\">Creating a dialog handler</link> example pages." msgstr "" #. aPSDz @@ -2956,22 +3118,22 @@ msgctxt "" msgid "Installation:" msgstr "" -#. QDrDk +#. 6J2px #: python_screen.xhp msgctxt "" "python_screen.xhp\n" "N0450\n" "help.text" -msgid "Copy <literal>screen_io</literal> Python module in <link href=\"text/sbasic/python/python_locations.xhp\" name=\"User macros\">My macros</link> within <UserProfile>/Scripts/python/pythonpath," +msgid "Copy <literal>screen_io</literal> Python module in <link href=\"text/sbasic/python/python_locations.xhp\">My macros</link> within <UserProfile>/Scripts/python/pythonpath," msgstr "" -#. bckjW +#. g98C5 #: python_screen.xhp msgctxt "" "python_screen.xhp\n" "N0451\n" "help.text" -msgid "Copy <literal>uiScripts</literal> Basic module in <link href=\"text/sbasic/python/python_locations.xhp\" name=\"User macros\">My macros</link> Standard Basic library," +msgid "Copy <literal>uiScripts</literal> Basic module in <link href=\"text/sbasic/python/python_locations.xhp\">My macros</link> Standard Basic library," msgstr "" #. XAthB @@ -3019,6 +3181,15 @@ msgctxt "" msgid "\"\"\"Outputs the specified strings or numeric expressions in a dialog box.\"\"\"" msgstr "" +#. L833Z +#: python_screen.xhp +msgctxt "" +"python_screen.xhp\n" +"par_id161655364816553\n" +"help.text" +msgid "<literal>MsgBox</literal> and <literal>InputBox</literal> methods from the <link href=\"text/sbasic/shared/03/sf_basic.xhp\">Basic service</link> included in <link href=\"text/sbasic/shared/03/lib_ScriptForge.xhp\"> the ScriptForge libraries</link> call directly their native Basic counterparts." +msgstr "" + #. EYqxJ #: python_screen.xhp msgctxt "" @@ -3028,6 +3199,15 @@ msgctxt "" msgid "<literal>uiScripts</literal> Basic module" msgstr "" +#. enXba +#: python_screen.xhp +msgctxt "" +"python_screen.xhp\n" +"tip_APSO\n" +"help.text" +msgid "The <link href=\"https://extensions.libreoffice.org/extensions/apso-alternative-script-organizer-for-python\">Alternative Python Script Organizer</link> (APSO) extension offers a msgbox() function out of its <literal>apso_utils</literal> module." +msgstr "" + #. CGnPe #: python_session.xhp msgctxt "" @@ -3046,13 +3226,13 @@ msgctxt "" msgid "<bookmark_value>Session;UserName</bookmark_value> <bookmark_value>Session;SharedScripts</bookmark_value> <bookmark_value>Session;SharedPythonScripts</bookmark_value> <bookmark_value>Session;UserProfile</bookmark_value> <bookmark_value>Session;UserScripts</bookmark_value> <bookmark_value>Session;UserPythonScripts</bookmark_value> <bookmark_value>API;PathSubstitution</bookmark_value>" msgstr "" -#. EvmoA +#. qBME3 #: python_session.xhp msgctxt "" "python_session.xhp\n" "N0340\n" "help.text" -msgid "<variable id=\"pythonsession\"><link href=\"text/sbasic/python/python_session.xhp\" name=\"session01\">Getting Session Information</link></variable>" +msgid "<variable id=\"pythonsession\"><link href=\"text/sbasic/python/python_session.xhp\">Getting Session Information</link></variable>" msgstr "" #. nmTjF @@ -3352,22 +3532,22 @@ msgctxt "" msgid "Python Interactive Shell" msgstr "" -#. LUGZ7 +#. uRFzN #: python_shell.xhp msgctxt "" "python_shell.xhp\n" "N0117\n" "help.text" -msgid "<bookmark_value>Python console</bookmark_value> <bookmark_value>Python Interactive Shell</bookmark_value>" +msgid "<bookmark_value>Python console</bookmark_value> <bookmark_value>Python Interactive Shell</bookmark_value> <bookmark_value>Python;Shell</bookmark_value>" msgstr "" -#. PmoqF +#. 6dAy2 #: python_shell.xhp msgctxt "" "python_shell.xhp\n" "N0118\n" "help.text" -msgid "<variable id=\"pythonshell1\"><link href=\"text/sbasic/python/python_shell.xhp\" name=\"python shell\">Running Python Interactive Console</link></variable>" +msgid "<variable id=\"pythonshell1\"><link href=\"text/sbasic/python/python_shell.xhp\">Running Python Interactive Console</link></variable>" msgstr "" #. Met9b @@ -3379,38 +3559,119 @@ msgctxt "" msgid "The Python interactive console, also known as Python interpreter or Python shell, provides programmers with a quick way to execute commands and try out and test code without creating a file. UNO objects introspection as well as %PRODUCTNAME Python modules documentation can be obtained from the terminal." msgstr "" -#. MZodx +#. fk6sx +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"hd_id381633446811095\n" +"help.text" +msgid "Using the Terminal" +msgstr "" + +#. CNFdD +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"par_id801633601715910\n" +"help.text" +msgid "From a %PRODUCTNAME copy included in a GNU/Linux platform, use the terminal as shown:" +msgstr "" + +#. vWPwe +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"par_id531633444780190\n" +"help.text" +msgid "<literal>whereis</literal> or <literal>type</literal> terminal commands help locate Python interactive console:" +msgstr "" + +#. ZXEeE +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"par_id851633601202270\n" +"help.text" +msgid "From a full-featured %PRODUCTNAME installed package, a Basic or Python script locates the embedded copy of Python console." +msgstr "" + +#. 5HhXz #: python_shell.xhp msgctxt "" "python_shell.xhp\n" "N0121\n" "help.text" -msgid "Using a Basic macro:" +msgid "Using a Basic macro" msgstr "" -#. vXGF7 +#. nHPAA +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"par_id71707747845585\n" +"help.text" +msgid "This routine resorts to <link href=\"text/sbasic/python/python_platform.xhp\">Platform class module</link> in order to distinguish the actual operating system." +msgstr "" + +#. KhWLk #: python_shell.xhp msgctxt "" "python_shell.xhp\n" "N0127\n" "help.text" -msgid "Using a Python macro:" +msgid "Using a Python macro" msgstr "" -#. oBg3T +#. 3FCJH #: python_shell.xhp msgctxt "" "python_shell.xhp\n" "N0141\n" "help.text" -msgid "Usage:" +msgid "Example output" msgstr "" -#. EzwwC +#. MxDtE #: python_shell.xhp msgctxt "" "python_shell.xhp\n" "N0142\n" "help.text" -msgid "<image src=\"media/helpimg/python/python_shell.png\" id=\"N0143\"><alt id=\"N0144\">Python Interactive Console</alt></image>" +msgid "<image src=\"media/helpimg/python/python_interactive_console.png\" id=\"N0143\"><alt id=\"N0143\">Python Interactive Console</alt></image>" +msgstr "" + +#. 8Ei5d +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"hd_id311633513620803\n" +"help.text" +msgid "Alternative console" +msgstr "" + +#. R53nU +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"par_id81632760673283\n" +"help.text" +msgid "Use <link href=\"https://extensions.libreoffice.org/extensions/apso-alternative-script-organizer-for-Python\">APSO extension</link> console as an alternative:" +msgstr "" + +#. 6h9CS +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"N0144\n" +"help.text" +msgid "<image src=\"media/helpimg/python/python_shell.png\" id=\"N0144\"><alt id=\"N0144\">APSO console</alt></image>" +msgstr "" + +#. MRf8v +#: python_shell.xhp +msgctxt "" +"python_shell.xhp\n" +"par_id351633599611244\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/sf_exception.xhp?#PythonShell\"><literal>PythonShell</literal></link> function in <link href=\"text/sbasic/shared/03/sf_exception.xhp\"><literal>ScriptForge.Exception</literal></link> service" msgstr "" |