source/text/sbasic/python/python_2_basic.xhp | 128 +++++++++++++--------------
1 file changed, 64 insertions(+), 64 deletions(-)
New commits:
commit b21bc34d745fb5a50b1cad84b3bfc44c3229aeda
Author: Gabor Kelemen <kelem...@gnome.hu>
AuthorDate: Tue Aug 6 21:43:05 2019 +0200
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Wed Aug 7 11:47:11 2019 +0200
Don't translate example code snippets
Also avoid errors at 'make translations' such as:
Helpex warning: invalid po attributes extracted from
/home/gabor/src/core/helpcontent2/source/text/sbasic/python/python_2_basic.xhp
No string specified!
GroupID: N0344
Helpex warning: invalid po attributes extracted from
/home/gabor/src/core/helpcontent2/source/text/sbasic/python/python_2_basic.xhp
No string specified!
GroupID: N0382
Helpex warning: invalid po attributes extracted from
/home/gabor/src/core/helpcontent2/source/text/sbasic/python/python_2_basic.xhp
No string specified!
GroupID: N0387
Helpex warning: invalid po attributes extracted from
/home/gabor/src/core/helpcontent2/source/text/sbasic/python/python_2_basic.xhp
No string specified!
GroupID: N0393
Helpex warning: invalid po attributes extracted from
/home/gabor/src/core/helpcontent2/source/text/sbasic/python/python_2_basic.xhp
No string specified!
GroupID: N0395
Helpex warning: invalid po attributes extracted from
/home/gabor/src/core/helpcontent2/source/text/sbasic/python/python_2_basic.xhp
No string specified!
GroupID: N0400
Helpex warning: invalid po attributes extracted from
/home/gabor/src/core/helpcontent2/source/text/sbasic/python/python_2_basic.xhp
No string specified!
GroupID: N0405
Helpex warning: invalid po attributes extracted from
/home/gabor/src/core/helpcontent2/source/text/sbasic/python/python_2_basic.xhp
No string specified!
GroupID: N0417
Change-Id: I0715209dd8cf7b044a2914cfbcd3cfabdeab66ed
Reviewed-on: https://gerrit.libreoffice.org/77073
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
Tested-by: Olivier Hallot <olivier.hal...@libreoffice.org>
diff --git a/source/text/sbasic/python/python_2_basic.xhp
b/source/text/sbasic/python/python_2_basic.xhp
index 19c10e5df..ab4a46ea6 100644
--- a/source/text/sbasic/python/python_2_basic.xhp
+++ b/source/text/sbasic/python/python_2_basic.xhp
@@ -40,27 +40,27 @@
<bookmark_value>API;XScriptProvider: Retrieving Basic
scripts</bookmark_value>
</bookmark>
<pycode>
- <paragraph role="pycode" id="N0342">import uno</paragraph>
- <paragraph role="pycode" id="N0343">from
com.sun.star.script.provider import Xscript</paragraph>
- <paragraph role="pycode" id="N0344"> </paragraph>
- <paragraph role="pycode" id="N0345">def
getBasicScript(macro='Main', module='Module1',
library='Standard',</paragraph>
- <paragraph role="pycode" id="N0346"> isEmbedded=False)
-> XScript:</paragraph>
+ <paragraph role="pycode" id="N0342" localize="false">import
uno</paragraph>
+ <paragraph role="pycode" id="N0343" localize="false">from
com.sun.star.script.provider import Xscript</paragraph>
+ <paragraph role="pycode" id="N0344" localize="false">
</paragraph>
+ <paragraph role="pycode" id="N0345" localize="false">def
getBasicScript(macro='Main', module='Module1',
library='Standard',</paragraph>
+ <paragraph role="pycode" id="N0346" localize="false">
isEmbedded=False) -> XScript:</paragraph>
<paragraph role="pycode" id="N0347"> '''Grab
Basic script object before invocation.'''</paragraph>
- <paragraph role="pycode" id="N0348"> ctx =
uno.getComponentContext()</paragraph>
- <paragraph role="pycode" id="N0349"> smgr =
ctx.ServiceManager</paragraph>
- <paragraph role="pycode" id="N0350"> if
isEmbedded:</paragraph>
- <paragraph role="pycode" id="N0351"> desktop =
smgr.createInstanceWithContext('com.sun.star.frame.Desktop',
ctx)</paragraph>
- <paragraph role="pycode" id="N0352"> scriptPro =
desktop.CurrentComponent.getScriptProvider()</paragraph>
- <paragraph role="pycode" id="N0353"> location =
"document"</paragraph>
- <paragraph role="pycode" id="N0354"> else:</paragraph>
- <paragraph role="pycode" id="N0355"> mspf =
smgr.createInstanceWithContext(</paragraph>
- <paragraph role="pycode" id="N0356">
"com.sun.star.script.provider.MasterScriptProviderFactory",
ctx)</paragraph>
- <paragraph role="pycode" id="N0357"> scriptPro =
mspf.createScriptProvider("")</paragraph>
- <paragraph role="pycode" id="N0358"> location =
"application"</paragraph>
- <paragraph role="pycode" id="N0359"> scriptName =
"vnd.sun.star.script:"+library+"."+module+"."+macro+
\</paragraph>
- <paragraph role="pycode" id="N0360">
"?language=Basic&location="+location</paragraph>
- <paragraph role="pycode" id="N0361"> xScript =
scriptPro.getScript(scriptName)</paragraph>
- <paragraph role="pycode" id="N0362"> return
xScript</paragraph>
+ <paragraph role="pycode" id="N0348" localize="false"> ctx =
uno.getComponentContext()</paragraph>
+ <paragraph role="pycode" id="N0349" localize="false"> smgr
= ctx.ServiceManager</paragraph>
+ <paragraph role="pycode" id="N0350" localize="false"> if
isEmbedded:</paragraph>
+ <paragraph role="pycode" id="N0351" localize="false">
desktop =
smgr.createInstanceWithContext('com.sun.star.frame.Desktop',
ctx)</paragraph>
+ <paragraph role="pycode" id="N0352" localize="false">
scriptPro = desktop.CurrentComponent.getScriptProvider()</paragraph>
+ <paragraph role="pycode" id="N0353" localize="false">
location = "document"</paragraph>
+ <paragraph role="pycode" id="N0354" localize="false">
else:</paragraph>
+ <paragraph role="pycode" id="N0355" localize="false">
mspf = smgr.createInstanceWithContext(</paragraph>
+ <paragraph role="pycode" id="N0356" localize="false">
"com.sun.star.script.provider.MasterScriptProviderFactory",
ctx)</paragraph>
+ <paragraph role="pycode" id="N0357" localize="false">
scriptPro = mspf.createScriptProvider("")</paragraph>
+ <paragraph role="pycode" id="N0358" localize="false">
location = "application"</paragraph>
+ <paragraph role="pycode" id="N0359" localize="false">
scriptName =
"vnd.sun.star.script:"+library+"."+module+"."+macro+
\</paragraph>
+ <paragraph role="pycode" id="N0360" localize="false">
"?language=Basic&location="+location</paragraph>
+ <paragraph role="pycode" id="N0361" localize="false">
xScript = scriptPro.getScript(scriptName)</paragraph>
+ <paragraph role="pycode" id="N0362" localize="false">
return xScript</paragraph>
</pycode>
</section>
<h2 id="N0363">Executing %PRODUCTNAME Basic Scripts</h2>
@@ -83,62 +83,62 @@
<paragraph role="paragraph" id="N0373">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.</paragraph>
<tip id="N0374">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 ASPO extension debugger allows object introspection using
either Xray either MRI extensions.</tip>
<pycode>
- <paragraph role="pycode" id="N0375">def xray(myObject):</paragraph>
- <paragraph role="pycode" id="N0376"> script =
getBasicScript(library="XrayTool", module="_Main",
macro="Xray")</paragraph>
- <paragraph role="pycode" id="N0377"> script.invoke((myObject,),
(), ())</paragraph>
+ <paragraph role="pycode" id="N0375" localize="false">def
xray(myObject):</paragraph>
+ <paragraph role="pycode" id="N0376" localize="false"> script =
getBasicScript(library="XrayTool", module="_Main",
macro="Xray")</paragraph>
+ <paragraph role="pycode" id="N0377" localize="false">
script.invoke((myObject,), (), ())</paragraph>
</pycode>
<h3 id="N0378">Examples of Embedded Scripts in Documents</h3>
<paragraph role="paragraph" id="N0379"><literal>*args</literal>Python
simplified syntax can be used in conjunction with %PRODUCTNAME Basic routines
that accept a variable number of arguments. Below <literal>Print</literal> and
<literal>SUM</literal> Python functions call their Basic
<literal>Print</literal> and <literal>SUM</literal> counterparts, using
aforementioned <literal>getBasicScript</literal> function. Exception handling
is not detailed.</paragraph>
<pycode>
- <paragraph role="pycode" id="N0380"># -*- coding: utf-8
-*-</paragraph>
- <paragraph role="pycode" id="N0381">from __future__ import
unicode_literals</paragraph>
- <paragraph role="pycode" id="N0382"> </paragraph>
- <paragraph role="pycode" id="N0383">def Print(*args):</paragraph>
+ <paragraph role="pycode" id="N0380" localize="false"># -*- coding:
utf-8 -*-</paragraph>
+ <paragraph role="pycode" id="N0381" localize="false">from __future__
import unicode_literals</paragraph>
+ <paragraph role="pycode" id="N0382" localize="false"> </paragraph>
+ <paragraph role="pycode" id="N0383" localize="false">def
Print(*args):</paragraph>
<paragraph role="pycode" id="N0384"> """Outputs the
specified strings or numeric expressions in a dialog
box."""</paragraph>
- <paragraph role="pycode" id="N0385"> xScript =
getBasicScript("Print", "Scripting",
embedded=True)</paragraph>
- <paragraph role="pycode" id="N0386"> xScript.invoke((args), (),
())</paragraph>
- <paragraph role="pycode" id="N0387"> </paragraph>
- <paragraph role="pycode" id="N0388">def SUM(*args):</paragraph>
+ <paragraph role="pycode" id="N0385" localize="false"> xScript =
getBasicScript("Print", "Scripting",
embedded=True)</paragraph>
+ <paragraph role="pycode" id="N0386" localize="false">
xScript.invoke((args), (), ())</paragraph>
+ <paragraph role="pycode" id="N0387" localize="false"> </paragraph>
+ <paragraph role="pycode" id="N0388" localize="false">def
SUM(*args):</paragraph>
<paragraph role="pycode" id="N0389"> """SUM the
specified number expression."""</paragraph>
- <paragraph role="pycode" id="N0390"> xScript =
getBasicScript("SUM", "Scripting",
embedded=True)</paragraph>
- <paragraph role="pycode" id="N0391"> res = xScript.invoke((args),
(), ())</paragraph>
- <paragraph role="pycode" id="N0392"> return res[0]</paragraph>
- <paragraph role="pycode" id="N0393"> </paragraph>
- <paragraph role="pycode" id="N0394"># def getBasicScript() # see
above</paragraph>
- <paragraph role="pycode" id="N0395"> </paragraph>
- <paragraph role="pycode" id="N0396">def playWithArgs():</paragraph>
- <paragraph role="pycode" id="N0397"> Print("Fun with *args
", -9.81, 297864.681974, 8762E-137)</paragraph>
- <paragraph role="pycode" id="N0398"> Print(SUM(45, -9.81,
297864.681974))</paragraph>
- <paragraph role="pycode" id="N0399"> Print(SUM(45, -9.81,
297864.681974, 8762E+137))</paragraph>
- <paragraph role="pycode" id="N0400"> </paragraph>
- <paragraph role="pycode" id="N0401">g_exportedScripts =
(playWithArgs,)</paragraph>
+ <paragraph role="pycode" id="N0390" localize="false"> xScript =
getBasicScript("SUM", "Scripting",
embedded=True)</paragraph>
+ <paragraph role="pycode" id="N0391" localize="false"> res =
xScript.invoke((args), (), ())</paragraph>
+ <paragraph role="pycode" id="N0392" localize="false"> return
res[0]</paragraph>
+ <paragraph role="pycode" id="N0393" localize="false"> </paragraph>
+ <paragraph role="pycode" id="N0394" localize="false"># def
getBasicScript() # see above</paragraph>
+ <paragraph role="pycode" id="N0395" localize="false"> </paragraph>
+ <paragraph role="pycode" id="N0396" localize="false">def
playWithArgs():</paragraph>
+ <paragraph role="pycode" id="N0397" localize="false">
Print("Fun with *args ", -9.81, 297864.681974, 8762E-137)</paragraph>
+ <paragraph role="pycode" id="N0398" localize="false">
Print(SUM(45, -9.81, 297864.681974))</paragraph>
+ <paragraph role="pycode" id="N0399" localize="false">
Print(SUM(45, -9.81, 297864.681974, 8762E+137))</paragraph>
+ <paragraph role="pycode" id="N0400" localize="false"> </paragraph>
+ <paragraph role="pycode" id="N0401"
localize="false">g_exportedScripts = (playWithArgs,)</paragraph>
</pycode>
<paragraph role="paragraph" id="N0402">The %PRODUCTNAME Basic
<literal>Print</literal> and <literal>SUM</literal> document-based routines
accept a variable number of arguments. The <literal>Private</literal> or
<literal>Public</literal> attributes have no effect. The arguments type
checking is skipped for clarity.</paragraph>
<bascode>
- <paragraph role="bascode" id="N0403">Option Compatible '
"Standard.Scripting" module</paragraph>
- <paragraph role="bascode" id="N0404">Option Explicit</paragraph>
- <paragraph role="bascode" id="N0405"> </paragraph>
- <paragraph role="bascode" id="N0406">Private Sub Print(ParamArray
args() As Variant, Optional sep As String = " ")</paragraph>
+ <paragraph role="bascode" id="N0403" localize="false">Option
Compatible ' "Standard.Scripting" module</paragraph>
+ <paragraph role="bascode" id="N0404" localize="false">Option
Explicit</paragraph>
+ <paragraph role="bascode" id="N0405" localize="false"> </paragraph>
+ <paragraph role="bascode" id="N0406" localize="false">Private Sub
Print(ParamArray args() As Variant, Optional sep As String = "
")</paragraph>
<paragraph role="bascode" id="N0407"> ''' Print
item list of variable number '''</paragraph>
<paragraph role="bascode" id="N0408"> ' all CStr()
convertible args are accepted</paragraph>
- <paragraph role="bascode" id="N0409"> Dim str As String, i As
Integer</paragraph>
- <paragraph role="bascode" id="N0410"> If UBound(args) >= 0
Then</paragraph>
- <paragraph role="bascode" id="N0411"> For i = 0 To
UBound(args)</paragraph>
- <paragraph role="bascode" id="N0412"> str = str +
Cstr(args(i))+ sep </paragraph>
- <paragraph role="bascode" id="N0413"> Next i</paragraph>
- <paragraph role="bascode" id="N0414"> End If</paragraph>
- <paragraph role="bascode" id="N0415"> Print str</paragraph>
- <paragraph role="bascode" id="N0416"> End Sub '
Standard.Scripting.Print()</paragraph>
- <paragraph role="bascode" id="N0417"> </paragraph>
- <paragraph role="bascode" id="N0418">Public Function SUM(ParamArray
args() As Variant) As Variant</paragraph>
+ <paragraph role="bascode" id="N0409" localize="false"> Dim str As
String, i As Integer</paragraph>
+ <paragraph role="bascode" id="N0410" localize="false"> If
UBound(args) >= 0 Then</paragraph>
+ <paragraph role="bascode" id="N0411" localize="false"> For i =
0 To UBound(args)</paragraph>
+ <paragraph role="bascode" id="N0412" localize="false"> str
= str + Cstr(args(i))+ sep </paragraph>
+ <paragraph role="bascode" id="N0413" localize="false"> Next
i</paragraph>
+ <paragraph role="bascode" id="N0414" localize="false"> End
If</paragraph>
+ <paragraph role="bascode" id="N0415" localize="false"> Print
str</paragraph>
+ <paragraph role="bascode" id="N0416" localize="false"> End Sub
' Standard.Scripting.Print()</paragraph>
+ <paragraph role="bascode" id="N0417" localize="false"> </paragraph>
+ <paragraph role="bascode" id="N0418" localize="false">Public Function
SUM(ParamArray args() As Variant) As Variant</paragraph>
<paragraph role="bascode" id="N0419"> ''' SUM a
variable list of numbers '''</paragraph>
- <paragraph role="bascode" id="N0420"> Dim ndx As
Integer</paragraph>
- <paragraph role="bascode" id="N0421"> If UBound(args) >= 0
Then</paragraph>
- <paragraph role="bascode" id="N0422"> For ndx = 0 To
UBound(args)</paragraph>
- <paragraph role="bascode" id="N0423"> SUM = SUM +
args(ndx)</paragraph>
- <paragraph role="bascode" id="N0424"> Next ndx</paragraph>
- <paragraph role="bascode" id="N0425"> End If</paragraph>
- <paragraph role="bascode" id="N0426">End Function '
Standard.Scripting.SUM()</paragraph>
+ <paragraph role="bascode" id="N0420" localize="false"> Dim ndx As
Integer</paragraph>
+ <paragraph role="bascode" id="N0421" localize="false"> If
UBound(args) >= 0 Then</paragraph>
+ <paragraph role="bascode" id="N0422" localize="false"> For ndx
= 0 To UBound(args)</paragraph>
+ <paragraph role="bascode" id="N0423" localize="false"> SUM
= SUM + args(ndx)</paragraph>
+ <paragraph role="bascode" id="N0424" localize="false"> Next
ndx</paragraph>
+ <paragraph role="bascode" id="N0425" localize="false"> End
If</paragraph>
+ <paragraph role="bascode" id="N0426" localize="false">End Function
' Standard.Scripting.SUM()</paragraph>
</bascode>
<section id="relatedtopics" >
<!-- WIP
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
