mirror of
https://github.com/LibreOffice/help.git
synced 2026-01-28 07:41:52 +00:00
7e42394ecb
Replacement done with
find . -name \*.xhp -print0 |xargs -0 -P 0 perl -CS -pi -e \
's#(<link[^>]*?) +name *="[^"]*" *( [^>]+|) *>#$1$2>#g'
(note some inconsistencies with space between name and = and also having
empty value, and some more complicated expression to also clear up
double space before/after the attribute)
translation files will be prepped with:
find */helpcontent2 -name \*.po -print0 |xargs -0 -P 0 perl -CS -pi -e \
$'s#(<link[^>]*?) +name=(?:\\\\"[^"]*\\\\"|\'[^\']*\') *( [^>]+|) *(/?>)#$1$2$3#g unless /^#/'
(note that not all languages use the " as quote character for the
attributes, but that also single quotes appera in the po file. Hence
the use of the shell $'string' syntax to be able to quote ' as \'
It also requires to quote the backslash, so that it needs to be escaped
once for the shell, then another time for perl. Also don't work on
obsolete strings (those are prefixed with #~ in the po files)
Also note that <link..></link> gets turned into <link ../> during
translation extraction (along with removal of the space between the
attribute name and the value), so the pattern needs to be slightly
different here)
Change-Id: I95e53a08e6b0095cd894109ea0de154cc4859d8f
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/143713
Tested-by: Jenkins
Reviewed-by: Christian Lohmaier <lohmaier+LibreOffice@googlemail.com>
57 lines
4.2 KiB
XML
57 lines
4.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<helpdocument version="1.0">
|
||
<!--
|
||
* This file is part of the LibreOffice project.
|
||
*
|
||
* This Source Code Form is subject to the terms of the Mozilla Public
|
||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
||
*
|
||
-->
|
||
<meta>
|
||
<topic id="pythonmain0000" indexer="include" status="PUBLISH">
|
||
<title id="tit" xml-lang="en-US">Python Scripts</title>
|
||
<filename>/text/sbasic/python/main0000.xhp</filename>
|
||
</topic>
|
||
</meta>
|
||
<body>
|
||
<bookmark xml-lang="en-US" branch="index" id="bm_id491543348147708">
|
||
<bookmark_value>macros;Python scripts</bookmark_value>
|
||
<bookmark_value>Python;macros</bookmark_value>
|
||
<bookmark_value>scripts;Python</bookmark_value>
|
||
</bookmark>
|
||
<h1 id="hd_id3154232"><variable id="pythonscriptshelp"><link href="text/sbasic/python/main0000.xhp">%PRODUCTNAME Python Scripts Help</link></variable></h1>
|
||
|
||
<section id="pythonold">
|
||
<paragraph id="par_id3153894" role="paragraph" xml-lang="en-US">%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></paragraph>
|
||
<paragraph id="par_id3147226" role="paragraph" xml-lang="en-US">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.</paragraph>
|
||
</section>
|
||
<h2 id="hd_id3146957">Working with Python Scripts in %PRODUCTNAME</h2>
|
||
<paragraph role="paragraph" id="N0102">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.</paragraph>
|
||
<switch select="sys">
|
||
<case select="UNIX">
|
||
<warning id="par_id131568902936659">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.</warning>
|
||
</case>
|
||
</switch>
|
||
<embed href="text/shared/guide/scripting.xhp#scripting"/>
|
||
<section id="pyContent">
|
||
<embed href="text/sbasic/python/python_ide.xhp#pythonideh1"/>
|
||
<embed href="text/sbasic/python/python_locations.xhp#pythonlocations1"/>
|
||
<embed href="text/sbasic/python/python_shell.xhp#pythonshell1"/>
|
||
<embed href="text/sbasic/python/python_programming.xhp#pythonprogrammingheading"/>
|
||
<embed href="text/sbasic/python/python_examples.xhp#pythonexamples2"/>
|
||
<embed href="text/sbasic/python/python_2_basic.xhp#py2ba_h1"/>
|
||
<embed href="text/sbasic/shared/03/sf_intro.xhp#title"/>
|
||
</section>
|
||
|
||
<section id="pyModules">
|
||
<h2 id="hd_id901655365903313">%PRODUCTNAME Python Modules</h2>
|
||
<paragraph role="paragraph" id="par_id21655367848705"><link href="text/sbasic/python/python_screen.xhp"><literal>msgbox</literal> module</link></paragraph>
|
||
<paragraph role="paragraph" id="par_id801655368030968"><link href="text/sbasic/shared/03/lib_ScriptForge.xhp"><literal>scriptforge</literal> module</link></paragraph>
|
||
<paragraph role="paragraph" id="par_id12655637848750"><link href="text/sbasic/python/python_programming.xhp#uno"><literal>uno</literal> module</link></paragraph>
|
||
</section>
|
||
|
||
<embed href="text/swriter/main0000.xhp#helpabouthelp"/>
|
||
</body>
|
||
</helpdocument>
|