Subversion Repositories Scribus

Rev

Rev 12804 | Rev 12937 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
10940 cbradney 1
<?xml version="1.0" encoding="utf-8"?>
12804 cbradney 2
<!DOCTYPE TS><TS version="1.1" language="en_GB">
10940 cbradney 3
<context>
12918 cbradney 4
    <name></name>
5
    <message>
6
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="21"/>
7
        <source>getColorNames() -&gt; list
8
 
9
Returns a list containing the names of all defined colors in the document.
10
If no document is open, returns a list of the default document colors.
11
</source>
12
        <translation type="unfinished">getColorNames() -&gt; list
13
 
14
Returns a list containing the names of all defined colours in the document.
15
If no document is open, returns a list of the default document colours.
16
</translation>
17
    </message>
18
    <message>
19
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="35"/>
20
        <source>getColor(&quot;name&quot;) -&gt; tuple
21
 
22
Returns a tuple (C, M, Y, K) containing the four color components of the
23
color &quot;name&quot; from the current document. If no document is open, returns
24
the value of the named color from the default document colors.
25
 
26
May raise NotFoundError if the named color wasn&apos;t found.
27
May raise ValueError if an invalid color name is specified.
28
</source>
29
        <translation type="unfinished">getColor(&quot;name&quot;) -&gt; tuple
30
 
31
Returns a tuple (C, M, Y, K) containing the four colour components of the
32
colour &quot;name&quot; from the current document. If no document is open, returns
33
the value of the named colour from the default document colours.
34
 
35
May raise NotFoundError if the named colour wasn&apos;t found.
36
May raise ValueError if an invalid colour name is specified.
37
</translation>
38
    </message>
39
    <message>
40
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="50"/>
41
        <source>getColorAsRGB(&quot;name&quot;) -&gt; tuple
42
 
43
Returns a tuple (R,G,B) containing the three color components of the
44
color &quot;name&quot; from the current document, converted to the RGB color
45
space. If no document is open, returns the value of the named color
46
from the default document colors.
47
 
48
May raise NotFoundError if the named color wasn&apos;t found.
49
May raise ValueError if an invalid color name is specified.
50
</source>
51
        <translation type="unfinished">getColorAsRGB(&quot;name&quot;) -&gt; tuple
52
 
53
Returns a tuple (R,G,B) containing the three colour components of the
54
colour &quot;name&quot; from the current document, converted to the RGB colour
55
space. If no document is open, returns the value of the named colour
56
from the default document colours.
57
 
58
May raise NotFoundError if the named colour wasn&apos;t found.
59
May raise ValueError if an invalid colour name is specified.
60
</translation>
61
    </message>
62
    <message>
63
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="64"/>
64
        <source>changeColor(&quot;name&quot;, c, m, y, k)
65
 
66
Changes the color &quot;name&quot; to the specified CMYK value. The color value is
67
defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
68
Color components should be in the range from 0 to 255.
69
 
70
May raise NotFoundError if the named color wasn&apos;t found.
71
May raise ValueError if an invalid color name is specified.
72
</source>
73
        <translation type="unfinished">changeColour(&quot;name&quot;, c, m, y, k)
74
 
75
Changes the colour &quot;name&quot; to the specified CMYK value. The colour value is
76
defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
77
Colour components should be in the range from 0 to 255.
78
 
79
May raise NotFoundError if the named colour wasn&apos;t found.
80
May raise ValueError if an invalid colour name is specified.
81
</translation>
82
    </message>
83
    <message>
84
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="77"/>
85
        <source>defineColor(&quot;name&quot;, c, m, y, k)
86
 
87
Defines a new color &quot;name&quot;. The color Value is defined via four components:
88
c = Cyan, m = Magenta, y = Yellow and k = Black. Color components should be in
89
the range from 0 to 255.
90
 
91
May raise ValueError if an invalid color name is specified.
92
</source>
93
        <translation type="unfinished">defineColor(&quot;name&quot;, c, m, y, k)
94
 
95
Defines a new colour &quot;name&quot;. The colour Value is defined via four components:
96
c = Cyan, m = Magenta, y = Yellow and k = Black. Colour components should be in
97
the range from 0 to 255.
98
 
99
May raise ValueError if an invalid colour name is specified.
100
</translation>
101
    </message>
102
    <message>
103
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="94"/>
104
        <source>deleteColor(&quot;name&quot;, &quot;replace&quot;)
105
 
106
Deletes the color &quot;name&quot;. Every occurence of that color is replaced by the
107
color &quot;replace&quot;. If not specified, &quot;replace&quot; defaults to the color
108
&quot;None&quot; - transparent.
109
 
110
deleteColor works on the default document colors if there is no document open.
111
In that case, &quot;replace&quot;, if specified, has no effect.
112
 
113
May raise NotFoundError if a named color wasn&apos;t found.
114
May raise ValueError if an invalid color name is specified.
115
</source>
116
        <translation type="unfinished">deleteColor(&quot;name&quot;, &quot;replace&quot;)
117
 
118
Deletes the colour &quot;name&quot;. Every occurence of that colour is replaced by the
119
colour &quot;replace&quot;. If not specified, &quot;replace&quot; defaults to the colour
120
&quot;None&quot; - transparent.
121
 
122
deleteColor works on the default document colours if there is no document open.
123
In that case, &quot;replace&quot;, if specified, has no effect.
124
 
125
May raise NotFoundError if a named colour wasn&apos;t found.
126
May raise ValueError if an invalid colour name is specified.
127
</translation>
128
    </message>
129
    <message>
130
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="106"/>
131
        <source>replaceColor(&quot;name&quot;, &quot;replace&quot;)
132
 
133
Every occurence of the color &quot;name&quot; is replaced by the color &quot;replace&quot;.
134
 
135
May raise NotFoundError if a named color wasn&apos;t found.
136
May raise ValueError if an invalid color name is specified.
137
</source>
138
        <translation type="unfinished">replaceColor(&quot;name&quot;, &quot;replace&quot;)
139
 
140
Every occurence of the colour &quot;name&quot; is replaced by the colour &quot;replace&quot;.
141
 
142
May raise NotFoundError if a named colour wasn&apos;t found.
143
May raise ValueError if an invalid colour name is specified.
144
</translation>
145
    </message>
146
    <message>
147
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="22"/>
148
        <source>newDocDialog() -&gt; bool
149
 
150
Displays the &quot;New Document&quot; dialog box. Creates a new document if the user
151
accepts the settings. Does not create a document if the user presses cancel.
152
Returns true if a new document was created.
153
</source>
154
        <translation type="unfinished">newDocDialog() -&gt; bool
155
 
156
Displays the &quot;New Document&quot; dialog box. Creates a new document if the user
157
accepts the settings. Does not create a document if the user presses cancel.
158
Returns true if a new document was created.
159
</translation>
160
    </message>
161
    <message>
162
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="46"/>
163
        <source>fileDialog(&quot;caption&quot;, [&quot;filter&quot;, &quot;defaultname&quot;, haspreview, issave, isdir]) -&gt; string with filename
164
 
165
Shows a File Open dialog box with the caption &quot;caption&quot;. Files are filtered
166
with the filter string &quot;filter&quot;. A default filename or file path can also
167
supplied, leave this string empty when you don&apos;t want to use it.  A value of
168
True for haspreview enables a small preview widget in the FileSelect box.  When
169
the issave parameter is set to True the dialog acts like a &quot;Save As&quot; dialog
170
otherwise it acts like a &quot;File Open Dialog&quot;. When the isdir parameter is True
171
the dialog shows and returns only directories. The default for all of the
172
optional parameters is False.
173
 
174
The filter, if specified, takes the form &apos;comment (*.type *.type2 ...)&apos;.
175
For example &apos;Images (*.png *.xpm *.jpg)&apos;.
176
 
177
Refer to the Qt-Documentation for QFileDialog for details on filters.
178
 
179
Example: fileDialog(&apos;Open input&apos;, &apos;CSV files (*.csv)&apos;)
180
Example: fileDialog(&apos;Save report&apos;, defaultname=&apos;report.txt&apos;, issave=True)
181
</source>
182
        <translation type="unfinished">fileDialog(&quot;caption&quot;, [&quot;filter&quot;, &quot;defaultname&quot;, haspreview, issave, isdir]) -&gt; string with filename
183
 
184
Shows a File Open dialog box with the caption &quot;caption&quot;. Files are filtered
185
with the filter string &quot;filter&quot;. A default filename or file path can also
186
supplied, leave this string empty when you don&apos;t want to use it.  A value of
187
True for haspreview enables a small preview widget in the FileSelect box.  When
188
the issave parameter is set to True the dialog acts like a &quot;Save As&quot; dialog
189
otherwise it acts like a &quot;File Open Dialog&quot;. When the isdir parameter is True
190
the dialog shows and returns only directories. The default for all of the
191
optional parameters is False.
192
 
193
The filter, if specified, takes the form &apos;comment (*.type *.type2 ...)&apos;.
194
For example &apos;Images (*.png *.xpm *.jpg)&apos;.
195
 
196
Refer to the Qt-Documentation for QFileDialog for details on filters.
197
 
198
Example: fileDialog(&apos;Open input&apos;, &apos;CSV files (*.csv)&apos;)
199
Example: fileDialog(&apos;Save report&apos;, defaultname=&apos;report.txt&apos;, issave=True)
200
</translation>
201
    </message>
202
    <message>
203
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="88"/>
204
        <source>messageBox(&quot;caption&quot;, &quot;message&quot;,
205
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
206
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
207
 
208
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
209
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
210
button, OK, is displayed. Only the caption and message arguments are required,
211
though setting an icon and appropriate button(s) is strongly
212
recommended. The message text may contain simple HTML-like markup.
213
 
214
Returns the number of the button the user pressed. Button numbers start
215
at 1.
216
 
217
For the icon and the button parameters there are predefined constants available
218
with the same names as in the Qt Documentation. These are the BUTTON_* and
219
ICON_* constants defined in the module. There are also two extra constants that
220
can be binary-ORed with button constants:
221
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
222
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
223
 
224
Usage examples:
225
result = messageBox(&apos;Script failed&apos;,
226
                    &apos;This script only works when you have a text frame selected.&apos;,
227
                    ICON_ERROR)
228
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
229
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
230
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
231
 
232
Defined button and icon constants:
233
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
234
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
235
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
236
</source>
237
        <translation type="unfinished">messageBox(&quot;caption&quot;, &quot;message&quot;,
238
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
239
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
240
 
241
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
242
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
243
button, OK, is displayed. Only the caption and message arguments are required,
244
though setting an icon and appropriate button(s) is strongly
245
recommended. The message text may contain simple HTML-like markup.
246
 
247
Returns the number of the button the user pressed. Button numbers start
248
at 1.
249
 
250
For the icon and the button parameters there are predefined constants available
251
with the same names as in the Qt Documentation. These are the BUTTON_* and
252
ICON_* constants defined in the module. There are also two extra constants that
253
can be binary-ORed with button constants:
254
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
255
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
256
 
257
Usage examples:
258
result = messageBox(&apos;Script failed&apos;,
259
                    &apos;This script only works when you have a text frame selected.&apos;,
260
                    ICON_ERROR)
261
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
262
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
263
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
264
 
265
Defined button and icon constants:
266
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
267
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
268
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
269
</translation>
270
    </message>
271
    <message>
272
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="101"/>
273
        <source>valueDialog(caption, message [,defaultvalue]) -&gt; string
274
 
275
Shows the common &apos;Ask for string&apos; dialog and returns its value as a string
276
Parameters: window title, text in the window and optional &apos;default&apos; value.
277
 
278
Example: valueDialog(&apos;title&apos;, &apos;text in the window&apos;, &apos;optional&apos;)
279
</source>
280
        <translation type="unfinished">valueDialog(caption, message [,defaultvalue]) -&gt; string
281
 
282
Shows the common &apos;Ask for string&apos; dialog and returns its value as a string
283
Parameters: window title, text in the window and optional &apos;default&apos; value.
284
 
285
Example: valueDialog(&apos;title&apos;, &apos;text in the window&apos;, &apos;optional&apos;)
286
</translation>
287
    </message>
288
    <message>
289
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="111"/>
290
        <source>newStyleDialog() -&gt; string
291
 
292
Shows &apos;Create new paragraph style&apos; dialog. Function returns real
293
style name or None when user cancels the dialog.
294
</source>
295
        <translation type="unfinished">newStyleDialog() -&gt; string
296
 
297
Shows &apos;Create new paragraph style&apos; dialog. Function returns real
298
style name or None when user cancels the dialog.
299
</translation>
300
    </message>
301
    <message>
302
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="55"/>
303
        <source>newDocument(size, margins, orientation, firstPageNumber,
304
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
305
 
306
Creates a new document and returns true if successful. The parameters have the
307
following meaning:
308
 
309
size = A tuple (width, height) describing the size of the document. You can
310
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
311
 
312
margins = A tuple (left, right, top, bottom) describing the document
313
margins
314
 
315
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
316
 
317
firstPageNumer = is the number of the first page in the document used for
318
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
319
numbers if you&apos;re creating a document in several parts.
320
 
321
unit: this value sets the measurement units used by the document. Use a
322
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
323
UNIT_PICAS, UNIT_POINTS.
324
 
325
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
326
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
327
PAGE_4 is 4-fold.
328
 
329
firstPageOrder = What is position of first page in the document.
330
Indexed from 0 (0 = first).
331
 
332
numPage = Number of pages to be created.
333
 
334
The values for width, height and the margins are expressed in the given unit
335
for the document. PAPER_* constants are expressed in points. If your document
336
is not in points, make sure to account for this.
337
 
338
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
339
PAGE_4, 3, 1)
340
 
341
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
342
</source>
343
        <translation type="unfinished">newDocument(size, margins, orientation, firstPageNumber,
344
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
345
 
346
Creates a new document and returns true if successful. The parameters have the
347
following meaning:
348
 
349
size = A tuple (width, height) describing the size of the document. You can
350
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
351
 
352
margins = A tuple (left, right, top, bottom) describing the document
353
margins
354
 
355
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
356
 
357
firstPageNumer = is the number of the first page in the document used for
358
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
359
numbers if you&apos;re creating a document in several parts.
360
 
361
unit: this value sets the measurement units used by the document. Use a
362
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
363
UNIT_PICAS, UNIT_POINTS.
364
 
365
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
366
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
367
PAGE_4 is 4-fold.
368
 
369
firstPageOrder = What is position of first page in the document.
370
Indexed from 0 (0 = first).
371
 
372
numPage = Number of pages to be created.
373
 
374
The values for width, height and the margins are expressed in the given unit
375
for the document. PAPER_* constants are expressed in points. If your document
376
is not in points, make sure to account for this.
377
 
378
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
379
PAGE_4, 3, 1)
380
 
381
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
382
</translation>
383
    </message>
384
    <message>
385
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="96"/>
386
        <source>newDoc(size, margins, orientation, firstPageNumber,
387
                   unit, facingPages, firstSideLeft) -&gt; bool
388
 
389
WARNING: Obsolete procedure! Use newDocument instead.
390
 
391
Creates a new document and returns true if successful. The parameters have the
392
following meaning:
393
 
394
    size = A tuple (width, height) describing the size of the document. You can
395
    use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
396
 
397
    margins = A tuple (left, right, top, bottom) describing the document
398
    margins
399
 
400
    orientation = the page orientation - constants PORTRAIT, LANDSCAPE
401
 
402
    firstPageNumer = is the number of the first page in the document used for
403
    pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
404
    numbers if you&apos;re creating a document in several parts.
405
 
406
    unit: this value sets the measurement units used by the document. Use a
407
    predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
408
    UNIT_PICAS, UNIT_POINTS.
409
 
410
    facingPages = FACINGPAGES, NOFACINGPAGES
411
 
412
    firstSideLeft = FIRSTPAGELEFT, FIRSTPAGERIGHT
413
 
414
The values for width, height and the margins are expressed in the given unit
415
for the document. PAPER_* constants are expressed in points. If your document
416
is not in points, make sure to account for this.
417
 
418
example: newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS,
419
                FACINGPAGES, FIRSTPAGERIGHT)
420
</source>
421
        <translation type="unfinished">newDoc(size, margins, orientation, firstPageNumber,
422
                   unit, facingPages, firstSideLeft) -&gt; bool
423
 
424
WARNING: Obsolete procedure! Use newDocument instead.
425
 
426
Creates a new document and returns true if successful. The parameters have the
427
following meaning:
428
 
429
    size = A tuple (width, height) describing the size of the document. You can
430
    use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
431
 
432
    margins = A tuple (left, right, top, bottom) describing the document
433
    margins
434
 
435
    orientation = the page orientation - constants PORTRAIT, LANDSCAPE
436
 
437
    firstPageNumer = is the number of the first page in the document used for
438
    pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
439
    numbers if you&apos;re creating a document in several parts.
440
 
441
    unit: this value sets the measurement units used by the document. Use a
442
    predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
443
    UNIT_PICAS, UNIT_POINTS.
444
 
445
    facingPages = FACINGPAGES, NOFACINGPAGES
446
 
447
    firstSideLeft = FIRSTPAGELEFT, FIRSTPAGERIGHT
448
 
449
The values for width, height and the margins are expressed in the given unit
450
for the document. PAPER_* constants are expressed in points. If your document
451
is not in points, make sure to account for this.
452
 
453
example: newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS,
454
                FACINGPAGES, FIRSTPAGERIGHT)
455
</translation>
456
    </message>
457
    <message>
458
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="108"/>
459
        <source>closeDoc()
460
 
461
Closes the current document without prompting to save.
462
 
463
May throw NoDocOpenError if there is no document to close
464
</source>
465
        <translation type="unfinished">closeDoc()
466
 
467
Closes the current document without prompting to save.
468
 
469
May throw NoDocOpenError if there is no document to close
470
</translation>
471
    </message>
472
    <message>
473
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="117"/>
474
        <source>haveDoc() -&gt; bool
475
 
476
Returns true if there is a document open.
477
</source>
478
        <translation type="unfinished">haveDoc() -&gt; bool
479
 
480
Returns true if there is a document open.
481
</translation>
482
    </message>
483
    <message>
484
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="128"/>
485
        <source>openDoc(&quot;name&quot;)
486
 
487
Opens the document &quot;name&quot;.
488
 
489
May raise ScribusError if the document could not be opened.
490
</source>
491
        <translation type="unfinished">openDoc(&quot;name&quot;)
492
 
493
Opens the document &quot;name&quot;.
494
 
495
May raise ScribusError if the document could not be opened.
496
</translation>
497
    </message>
498
    <message>
499
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="141"/>
500
        <source>saveDoc()
501
 
502
Saves the current document with its current name, returns true if successful.
503
If the document has not already been saved, this may bring up an interactive
504
save file dialog.
505
 
506
If the save fails, there is currently no way to tell.
507
</source>
508
        <translation type="unfinished">saveDoc()
509
 
510
Saves the current document with its current name, returns true if successful.
511
If the document has not already been saved, this may bring up an interactive
512
save file dialog.
513
 
514
If the save fails, there is currently no way to tell.
515
</translation>
516
    </message>
517
    <message>
518
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="152"/>
519
        <source>saveDocAs(&quot;name&quot;)
520
 
521
Saves the current document under the new name &quot;name&quot; (which may be a full or
522
relative path).
523
 
524
May raise ScribusError if the save fails.
525
</source>
526
        <translation type="unfinished">saveDocAs(&quot;name&quot;)
527
 
528
Saves the current document under the new name &quot;name&quot; (which may be a full or
529
relative path).
530
 
531
May raise ScribusError if the save fails.
532
</translation>
533
    </message>
534
    <message>
535
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="162"/>
536
        <source>setInfo(&quot;author&quot;, &quot;info&quot;, &quot;description&quot;) -&gt; bool
537
 
538
Sets the document information. &quot;Author&quot;, &quot;Info&quot;, &quot;Description&quot; are
539
strings.
540
</source>
541
        <translation type="unfinished">setInfo(&quot;author&quot;, &quot;info&quot;, &quot;description&quot;) -&gt; bool
542
 
543
Sets the document information. &quot;Author&quot;, &quot;Info&quot;, &quot;Description&quot; are
544
strings.
545
</translation>
546
    </message>
547
    <message>
548
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="173"/>
549
        <source>setMargins(lr, rr, tr, br)
550
 
551
Sets the margins of the document, Qt::DockLeft(lr), Qt::DockRight(rr), Qt::DockTop(tr) and Qt::DockBottom(br)
552
margins are given in the measurement units of the document - see UNIT_&lt;type&gt;
553
constants.
554
</source>
555
        <translation type="unfinished">setMargins(lr, rr, tr, br)
556
 
557
Sets the margins of the document, Qt::DockLeft(lr), Qt::DockRight(rr), Qt::DockTop(tr) and Qt::DockBottom(br)
558
margins are given in the measurement units of the document - see UNIT_&lt;type&gt;
559
constants.
560
</translation>
561
    </message>
562
    <message>
563
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="185"/>
564
        <source>setUnit(type)
565
 
566
Changes the measurement unit of the document. Possible values for &quot;unit&quot; are
567
defined as constants UNIT_&lt;type&gt;.
568
 
569
May raise ValueError if an invalid unit is passed.
570
</source>
571
        <translation type="unfinished">setUnit(type)
572
 
573
Changes the measurement unit of the document. Possible values for &quot;unit&quot; are
574
defined as constants UNIT_&lt;type&gt;.
575
 
576
May raise ValueError if an invalid unit is passed.
577
</translation>
578
    </message>
579
    <message>
580
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="196"/>
581
        <source>getUnit() -&gt; integer (Scribus unit constant)
582
 
583
Returns the measurement units of the document. The returned value will be one
584
of the UNIT_* constants:
585
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
586
</source>
587
        <translation type="unfinished">getUnit() -&gt; integer (Scribus unit constant)
588
 
589
Returns the measurement units of the document. The returned value will be one
590
of the UNIT_* constants:
591
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
592
</translation>
593
    </message>
594
    <message>
595
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="206"/>
596
        <source>loadStylesFromFile(&quot;filename&quot;)
597
 
598
Loads paragraph styles from the Scribus document at &quot;filename&quot; into the
599
current document.
600
</source>
601
        <translation type="unfinished">loadStylesFromFile(&quot;filename&quot;)
602
 
603
Loads paragraph styles from the Scribus document at &quot;filename&quot; into the
604
current document.
605
</translation>
606
    </message>
607
    <message>
608
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="218"/>
609
        <source>setDocType(facingPages, firstPageLeft)
610
 
611
Sets the document type. To get facing pages set the first parameter to
612
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
613
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
614
a right page use FIRSTPAGERIGHT.
615
</source>
616
        <translation type="unfinished">setDocType(facingPages, firstPageLeft)
617
 
618
Sets the document type. To get facing pages set the first parameter to
619
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
620
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
621
a right page use FIRSTPAGERIGHT.
622
</translation>
623
    </message>
624
    <message>
625
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="226"/>
626
        <source>closeMasterPage()
627
 
628
Closes the currently active master page, if any, and returns editing
629
to normal. Begin editing with editMasterPage().
630
</source>
631
        <translation type="unfinished">closeMasterPage()
632
 
633
Closes the currently active master page, if any, and returns editing
634
to normal. Begin editing with editMasterPage().
635
</translation>
636
    </message>
637
    <message>
638
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="233"/>
639
        <source>masterPageNames()
640
 
641
Returns a list of the names of all master pages in the document.
642
</source>
643
        <translation type="unfinished">masterPageNames()
644
 
645
Returns a list of the names of all master pages in the document.
646
</translation>
647
    </message>
648
    <message>
649
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="241"/>
650
        <source>editMasterPage(pageName)
651
 
652
Enables master page editing and opens the named master page
653
for editing. Finish editing with closeMasterPage().
654
</source>
655
        <translation type="unfinished">editMasterPage(pageName)
656
 
657
Enables master page editing and opens the named master page
658
for editing. Finish editing with closeMasterPage().
659
</translation>
660
    </message>
661
    <message>
662
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="249"/>
663
        <source>createMasterPage(pageName)
664
 
665
Creates a new master page named pageName and opens it for
666
editing.
667
</source>
668
        <translation type="unfinished">createMasterPage(pageName)
669
 
670
Creates a new master page named pageName and opens it for
671
editing.
672
</translation>
673
    </message>
674
    <message>
675
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="256"/>
676
        <source>deleteMasterPage(pageName)
677
 
678
Delete the named master page.
679
</source>
680
        <translation type="unfinished">deleteMasterPage(pageName)
681
 
682
Delete the named master page.
683
</translation>
684
    </message>
685
    <message>
686
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="21"/>
687
        <source>getFillColor([&quot;name&quot;]) -&gt; string
688
 
689
Returns the name of the fill color of the object &quot;name&quot;.
690
If &quot;name&quot; is not given the currently selected item is used.
691
</source>
692
        <translation type="unfinished">getFillColor([&quot;name&quot;]) -&gt; string
693
 
694
Returns the name of the fill colour of the object &quot;name&quot;.
695
If &quot;name&quot; is not given the currently selected item is used.
696
</translation>
697
    </message>
698
    <message>
699
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="31"/>
700
        <source>getFillTransparency([&quot;name&quot;]) -&gt; float
701
 
702
Returns the fill transparency of the object &quot;name&quot;. If &quot;name&quot;
703
is not given the currently selected Item is used.
704
</source>
705
        <translation type="unfinished">getFillTransparency([&quot;name&quot;]) -&gt; float
706
 
707
Returns the fill transparency of the object &quot;name&quot;. If &quot;name&quot;
708
is not given the currently selected Item is used.
709
</translation>
710
    </message>
711
    <message>
712
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="41"/>
713
        <source>getFillBlendmode([&quot;name&quot;]) -&gt; integer
714
 
715
Returns the fill blendmode of the object &quot;name&quot;. If &quot;name&quot;
716
is not given the currently selected Item is used.
717
</source>
718
        <translation type="unfinished">getFillBlendmode([&quot;name&quot;]) -&gt; integer
719
 
720
Returns the fill blendmode of the object &quot;name&quot;. If &quot;name&quot;
721
is not given the currently selected Item is used.
722
</translation>
723
    </message>
724
    <message>
725
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="51"/>
726
        <source>getLineColor([&quot;name&quot;]) -&gt; string
727
 
728
Returns the name of the line color of the object &quot;name&quot;.
729
If &quot;name&quot; is not given the currently selected item is used.
730
</source>
731
        <translation type="unfinished">getLineColor([&quot;name&quot;]) -&gt; string
732
 
733
Returns the name of the line colour of the object &quot;name&quot;.
734
If &quot;name&quot; is not given the currently selected item is used.
735
</translation>
736
    </message>
737
    <message>
738
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="61"/>
739
        <source>getLineTransparency([&quot;name&quot;]) -&gt; float
740
 
741
Returns the line transparency of the object &quot;name&quot;. If &quot;name&quot;
742
is not given the currently selected Item is used.
743
</source>
744
        <translation type="unfinished">getLineTransparency([&quot;name&quot;]) -&gt; float
745
 
746
Returns the line transparency of the object &quot;name&quot;. If &quot;name&quot;
747
is not given the currently selected Item is used.
748
</translation>
749
    </message>
750
    <message>
751
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="71"/>
752
        <source>getLineBlendmode([&quot;name&quot;]) -&gt; integer
753
 
754
Returns the line blendmode of the object &quot;name&quot;. If &quot;name&quot;
755
is not given the currently selected Item is used.
756
</source>
757
        <translation type="unfinished">getLineBlendmode([&quot;name&quot;]) -&gt; integer
758
 
759
Returns the line blendmode of the object &quot;name&quot;. If &quot;name&quot;
760
is not given the currently selected Item is used.
761
</translation>
762
    </message>
763
    <message>
764
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="81"/>
765
        <source>getLineWidth([&quot;name&quot;]) -&gt; integer
766
 
767
Returns the line width of the object &quot;name&quot;. If &quot;name&quot;
768
is not given the currently selected Item is used.
769
</source>
770
        <translation type="unfinished">getLineWidth([&quot;name&quot;]) -&gt; integer
771
 
772
Returns the line width of the object &quot;name&quot;. If &quot;name&quot;
773
is not given the currently selected Item is used.
774
</translation>
775
    </message>
776
    <message>
777
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="91"/>
778
        <source>getLineShade([&quot;name&quot;]) -&gt; integer
779
 
780
Returns the shading value of the line color of the object &quot;name&quot;.
781
If &quot;name&quot; is not given the currently selected item is used.
782
</source>
783
        <translation type="unfinished">getLineShade([&quot;name&quot;]) -&gt; integer
784
 
785
Returns the shading value of the line colour of the object &quot;name&quot;.
786
If &quot;name&quot; is not given the currently selected item is used.
787
</translation>
788
    </message>
789
    <message>
790
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="102"/>
791
        <source>getLineJoin([&quot;name&quot;]) -&gt; integer (see constants)
792
 
793
Returns the line join style of the object &quot;name&quot;. If &quot;name&quot; is not given
794
the currently selected item is used.  The join types are:
795
JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND
796
</source>
797
        <translation type="unfinished">getLineJoin([&quot;name&quot;]) -&gt; integer (see constants)
798
 
799
Returns the line join style of the object &quot;name&quot;. If &quot;name&quot; is not given
800
the currently selected item is used.  The join types are:
801
JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND
802
</translation>
803
    </message>
804
    <message>
805
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="113"/>
806
        <source>getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
807
 
808
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
809
currently selected item is used. The cap types are:
810
CAP_FLAT, CAP_ROUND, CAP_SQUARE
811
</source>
812
        <translation type="unfinished">getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
813
 
814
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
815
currently selected item is used. The cap types are:
816
CAP_FLAT, CAP_ROUND, CAP_SQUARE
817
</translation>
818
    </message>
819
    <message>
820
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="124"/>
821
        <source>getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
822
 
823
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
824
currently selected item is used. Line style constants are:
825
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
826
</source>
827
        <translation type="unfinished">getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
828
 
829
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
830
currently selected item is used. Line style constants are:
831
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
832
</translation>
833
    </message>
834
    <message>
835
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="134"/>
836
        <source>getFillShade([&quot;name&quot;]) -&gt; integer
837
 
838
Returns the shading value of the fill color of the object &quot;name&quot;.
839
If &quot;name&quot; is not given the currently selected item is used.
840
</source>
841
        <translation type="unfinished">getFillShade([&quot;name&quot;]) -&gt; integer
842
 
843
Returns the shading value of the fill colour of the object &quot;name&quot;.
844
If &quot;name&quot; is not given the currently selected item is used.
845
</translation>
846
    </message>
847
    <message>
848
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="145"/>
849
        <source>getCornerRadius([&quot;name&quot;]) -&gt; integer
850
 
851
Returns the corner radius of the object &quot;name&quot;. The radius is
852
expressed in points. If &quot;name&quot; is not given the currently
853
selected item is used.
854
</source>
855
        <translation type="unfinished">getCornerRadius([&quot;name&quot;]) -&gt; integer
856
 
857
Returns the corner radius of the object &quot;name&quot;. The radius is
858
expressed in points. If &quot;name&quot; is not given the currently
859
selected item is used.
860
</translation>
861
    </message>
862
    <message>
863
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="155"/>
864
        <source>getImageScale([&quot;name&quot;]) -&gt; (x,y)
865
 
866
Returns a (x, y) tuple containing the scaling values of the image frame
867
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
868
</source>
869
        <translation type="unfinished">getImageScale([&quot;name&quot;]) -&gt; (x,y)
870
 
871
Returns a (x, y) tuple containing the scaling values of the image frame
872
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
873
</translation>
874
    </message>
875
    <message>
876
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="165"/>
877
        <source>getImageName([&quot;name&quot;]) -&gt; string
878
 
879
Returns the filename for the image in the image frame. If &quot;name&quot; is not
880
given the currently selected item is used.
881
</source>
882
        <translation type="unfinished">getImageName([&quot;name&quot;]) -&gt; string
883
 
884
Returns the filename for the image in the image frame. If &quot;name&quot; is not
885
given the currently selected item is used.
886
</translation>
887
    </message>
888
    <message>
889
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="177"/>
890
        <source>getPosition([&quot;name&quot;]) -&gt; (x,y)
891
 
892
Returns a (x, y) tuple with the position of the object &quot;name&quot;.
893
If &quot;name&quot; is not given the currently selected item is used.
894
The position is expressed in the actual measurement unit of the document
895
- see UNIT_&lt;type&gt; for reference.
896
</source>
897
        <translation type="unfinished">getPosition([&quot;name&quot;]) -&gt; (x,y)
898
 
899
Returns a (x, y) tuple with the position of the object &quot;name&quot;.
900
If &quot;name&quot; is not given the currently selected item is used.
901
The position is expressed in the actual measurement unit of the document
902
- see UNIT_&lt;type&gt; for reference.
903
</translation>
904
    </message>
905
    <message>
906
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="189"/>
907
        <source>getSize([&quot;name&quot;]) -&gt; (width,height)
908
 
909
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
910
If &quot;name&quot; is not given the currently selected item is used. The size is
911
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
912
for reference.
913
</source>
914
        <translation type="unfinished">getSize([&quot;name&quot;]) -&gt; (width,height)
915
 
916
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
917
If &quot;name&quot; is not given the currently selected item is used. The size is
918
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
919
for reference.
920
</translation>
921
    </message>
922
    <message>
923
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="200"/>
924
        <source>getRotation([&quot;name&quot;]) -&gt; integer
925
 
926
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
927
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
928
is used.
929
</source>
930
        <translation type="unfinished">getRotation([&quot;name&quot;]) -&gt; integer
931
 
932
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
933
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
934
is used.
935
</translation>
936
    </message>
937
    <message>
938
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="209"/>
939
        <source>getAllObjects() -&gt; list
940
 
941
Returns a list containing the names of all objects on the current page.
942
</source>
943
        <translation type="unfinished">getAllObjects() -&gt; list
944
 
945
Returns a list containing the names of all objects on the current page.
946
</translation>
947
    </message>
948
    <message>
949
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="83"/>
950
        <source>getPropertyCType(object, property, includesuper=True)
951
 
952
Returns the name of the C type of `property&apos; of `object&apos;. See getProperty()
953
for details of arguments.
954
 
955
If `includesuper&apos; is true, search inherited properties too.
956
</source>
957
        <translation type="unfinished">getPropertyCType(object, property, includesuper=True)
958
 
959
Returns the name of the C type of `property&apos; of `object&apos;. See getProperty()
960
for details of arguments.
961
 
962
If `includesuper&apos; is true, search inherited properties too.
963
</translation>
964
    </message>
965
    <message>
966
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="101"/>
967
        <source>getPropertyNames(object, includesuper=True)
968
 
969
Return a list of property names supported by `object&apos;.
970
If `includesuper&apos; is true, return properties supported
971
by parent classes as well.
972
</source>
973
        <translation type="unfinished">getPropertyNames(object, includesuper=True)
974
 
975
Return a list of property names supported by `object&apos;.
976
If `includesuper&apos; is true, return properties supported
977
by parent classes as well.
978
</translation>
979
    </message>
980
    <message>
981
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="135"/>
982
        <source>getProperty(object, property)
983
 
984
Return the value of the property `property&apos; of the passed `object&apos;.
985
 
986
The `object&apos; argument may be a string, in which case the named PageItem
987
is searched for. It may also be a PyCObject, which may point to any
988
C++ QObject instance.
989
 
990
The `property&apos; argument must be a string, and is the name of the property
991
to look up on `object&apos;.
992
 
993
The return value varies depending on the type of the property.
994
</source>
995
        <translation type="unfinished">getProperty(object, property)
996
 
997
Return the value of the property `property&apos; of the passed `object&apos;.
998
 
999
The `object&apos; argument may be a string, in which case the named PageItem
1000
is searched for. It may also be a PyCObject, which may point to any
1001
C++ QObject instance.
1002
 
1003
The `property&apos; argument must be a string, and is the name of the property
1004
to look up on `object&apos;.
1005
 
1006
The return value varies depending on the type of the property.
1007
</translation>
1008
    </message>
1009
    <message>
1010
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="165"/>
1011
        <source>setProperty(object, property, value)
1012
 
1013
Set `property&apos; of `object&apos; to `value&apos;. If `value&apos; cannot be converted to a type
1014
compatible with the type of `property&apos;, an exception is raised. An exception may
1015
also be raised if the underlying setter fails.
1016
 
1017
See getProperty() for more information.
1018
</source>
1019
        <translation type="unfinished">setProperty(object, property, value)
1020
 
1021
Set `property&apos; of `object&apos; to `value&apos;. If `value&apos; cannot be converted to a type
1022
compatible with the type of `property&apos;, an exception is raised. An exception may
1023
also be raised if the underlying setter fails.
1024
 
1025
See getProperty() for more information.
1026
</translation>
1027
    </message>
1028
    <message>
1029
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="23"/>
1030
        <source>moveObject(dx, dy [, &quot;name&quot;])
1031
 
1032
Moves the object &quot;name&quot; by dx and dy relative to its current position. The
1033
distances are expressed in the current measurement unit of the document (see
1034
UNIT constants). If &quot;name&quot; is not given the currently selected item is used.
1035
If the object &quot;name&quot; belongs to a group, the whole group is moved.
1036
</source>
1037
        <translation type="unfinished">moveObject(dx, dy [, &quot;name&quot;])
1038
 
1039
Moves the object &quot;name&quot; by dx and dy relative to its current position. The
1040
distances are expressed in the current measurement unit of the document (see
1041
UNIT constants). If &quot;name&quot; is not given the currently selected item is used.
1042
If the object &quot;name&quot; belongs to a group, the whole group is moved.
1043
</translation>
1044
    </message>
1045
    <message>
1046
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="35"/>
1047
        <source>moveObjectAbs(x, y [, &quot;name&quot;])
1048
 
1049
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
1050
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
1051
is not given the currently selected item is used.  If the object &quot;name&quot;
1052
belongs to a group, the whole group is moved.
1053
</source>
1054
        <translation type="unfinished">moveObjectAbs(x, y [, &quot;name&quot;])
1055
 
1056
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
1057
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
1058
is not given the currently selected item is used.  If the object &quot;name&quot;
1059
belongs to a group, the whole group is moved.
1060
</translation>
1061
    </message>
1062
    <message>
1063
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="48"/>
1064
        <source>rotateObject(rot [, &quot;name&quot;])
1065
 
1066
Rotates the object &quot;name&quot; by &quot;rot&quot; degrees relatively. The object is
1067
rotated by the vertex that is currently selected as the rotation point - by
1068
default, the top left vertex at zero rotation. Positive values mean counter
1069
clockwise rotation when the default rotation point is used. If &quot;name&quot; is not
1070
given the currently selected item is used.
1071
</source>
1072
        <translation type="unfinished">rotateObject(rot [, &quot;name&quot;])
1073
 
1074
Rotates the object &quot;name&quot; by &quot;rot&quot; degrees relatively. The object is
1075
rotated by the vertex that is currently selected as the rotation point - by
1076
default, the top left vertex at zero rotation. Positive values mean counter
1077
clockwise rotation when the default rotation point is used. If &quot;name&quot; is not
1078
given the currently selected item is used.
1079
</translation>
1080
    </message>
1081
    <message>
1082
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="59"/>
1083
        <source>rotateObjectAbs(rot [, &quot;name&quot;])
1084
 
1085
Sets the rotation of the object &quot;name&quot; to &quot;rot&quot;. Positive values
1086
mean counter clockwise rotation. If &quot;name&quot; is not given the currently
1087
selected item is used.
1088
</source>
1089
        <translation type="unfinished">rotateObjectAbs(rot [, &quot;name&quot;])
1090
 
1091
Sets the rotation of the object &quot;name&quot; to &quot;rot&quot;. Positive values
1092
mean counter clockwise rotation. If &quot;name&quot; is not given the currently
1093
selected item is used.
1094
</translation>
1095
    </message>
1096
    <message>
1097
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="69"/>
1098
        <source>sizeObject(width, height [, &quot;name&quot;])
1099
 
1100
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
1101
is not given the currently selected item is used.
1102
</source>
1103
        <translation type="unfinished">sizeObject(width, height [, &quot;name&quot;])
1104
 
1105
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
1106
is not given the currently selected item is used.
1107
</translation>
1108
    </message>
1109
    <message>
1110
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="80"/>
1111
        <source>getSelectedObject([nr]) -&gt; string
1112
 
1113
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
1114
of the selected object, e.g. 0 means the first selected object, 1 means the
1115
second selected Object and so on.
1116
</source>
1117
        <translation type="unfinished">getSelectedObject([nr]) -&gt; string
1118
 
1119
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
1120
of the selected object, e.g. 0 means the first selected object, 1 means the
1121
second selected Object and so on.
1122
</translation>
1123
    </message>
1124
    <message>
1125
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="89"/>
1126
        <source>selectionCount() -&gt; integer
1127
 
1128
Returns the number of selected objects.
1129
</source>
1130
        <translation type="unfinished">selectionCount() -&gt; integer
1131
 
1132
Returns the number of selected objects.
1133
</translation>
1134
    </message>
1135
    <message>
1136
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="98"/>
1137
        <source>selectObject(&quot;name&quot;)
1138
 
1139
Selects the object with the given &quot;name&quot;.
1140
</source>
1141
        <translation type="unfinished">selectObject(&quot;name&quot;)
1142
 
1143
Selects the object with the given &quot;name&quot;.
1144
</translation>
1145
    </message>
1146
    <message>
1147
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="107"/>
1148
        <source>deselectAll()
1149
 
1150
Deselects all objects in the whole document.
1151
</source>
1152
        <translation type="unfinished">deselectAll()
1153
 
1154
Deselects all objects in the whole document.
1155
</translation>
1156
    </message>
1157
    <message>
1158
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="118"/>
1159
        <source>groupObjects(list)
1160
 
1161
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
1162
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
1163
items are used.
1164
</source>
1165
        <translation type="unfinished">groupObjects(list)
1166
 
1167
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
1168
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
1169
items are used.
1170
</translation>
1171
    </message>
1172
    <message>
1173
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="126"/>
1174
        <source>unGroupObjects(&quot;name&quot;)
1175
 
1176
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.</source>
1177
        <translation type="unfinished">unGroupObjects(&quot;name&quot;)
1178
 
1179
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.</translation>
1180
    </message>
1181
    <message>
1182
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="141"/>
1183
        <source>scaleGroup(factor [,&quot;name&quot;])
1184
 
1185
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
1186
the group, values smaller than 1 make the group smaller e.g a value of 0.5
1187
scales the group to 50 % of its original size, a value of 1.5 scales the group
1188
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
1189
0. If &quot;name&quot; is not given the currently selected item is used.
1190
 
1191
May raise ValueError if an invalid scale factor is passed.
1192
</source>
1193
        <translation type="unfinished">scaleGroup(factor [,&quot;name&quot;])
1194
 
1195
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
1196
the group, values smaller than 1 make the group smaller e.g a value of 0.5
1197
scales the group to 50 % of its original size, a value of 1.5 scales the group
1198
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
1199
0. If &quot;name&quot; is not given the currently selected item is used.
1200
 
1201
May raise ValueError if an invalid scale factor is passed.
1202
</translation>
1203
    </message>
1204
    <message>
1205
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="153"/>
1206
        <source>loadImage(&quot;filename&quot; [, &quot;name&quot;])
1207
 
1208
Loads the picture &quot;picture&quot; into the image frame &quot;name&quot;. If &quot;name&quot; is
1209
not given the currently selected item is used.
1210
 
1211
May raise WrongFrameTypeError if the target frame is not an image frame
1212
</source>
1213
        <translation type="unfinished">loadImage(&quot;filename&quot; [, &quot;name&quot;])
1214
 
1215
Loads the picture &quot;picture&quot; into the image frame &quot;name&quot;. If &quot;name&quot; is
1216
not given the currently selected item is used.
1217
 
1218
May raise WrongFrameTypeError if the target frame is not an image frame
1219
</translation>
1220
    </message>
1221
    <message>
1222
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="166"/>
1223
        <source>scaleImage(x, y [, &quot;name&quot;])
1224
 
1225
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
1226
If &quot;name&quot; is not given the currently selected item is used. A number of 1
1227
means 100 %.
1228
 
1229
May raise WrongFrameTypeError if the target frame is not an image frame
1230
</source>
1231
        <translation type="unfinished">scaleImage(x, y [, &quot;name&quot;])
1232
 
1233
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
1234
If &quot;name&quot; is not given the currently selected item is used. A number of 1
1235
means 100 %.
1236
 
1237
May raise WrongFrameTypeError if the target frame is not an image frame
1238
</translation>
1239
    </message>
1240
    <message>
1241
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="177"/>
1242
        <source>lockObject([&quot;name&quot;]) -&gt; bool
1243
 
1244
Locks the object &quot;name&quot; if it&apos;s unlocked or unlock it if it&apos;s locked.
1245
If &quot;name&quot; is not given the currently selected item is used. Returns true
1246
if locked.
1247
</source>
1248
        <translation type="unfinished">lockObject([&quot;name&quot;]) -&gt; bool
1249
 
1250
Locks the object &quot;name&quot; if it&apos;s unlocked or unlock it if it&apos;s locked.
1251
If &quot;name&quot; is not given the currently selected item is used. Returns true
1252
if locked.
1253
</translation>
1254
    </message>
1255
    <message>
1256
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="187"/>
1257
        <source>isLocked([&quot;name&quot;]) -&gt; bool
1258
 
1259
Returns true if is the object &quot;name&quot; locked.  If &quot;name&quot; is not given the
1260
currently selected item is used.
1261
</source>
1262
        <translation type="unfinished">isLocked([&quot;name&quot;]) -&gt; bool
1263
 
1264
Returns true if is the object &quot;name&quot; locked.  If &quot;name&quot; is not given the
1265
currently selected item is used.
1266
</translation>
1267
    </message>
1268
    <message>
1269
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="199"/>
1270
        <source>setScaleImageToFrame(scaletoframe, proportional=None, name=&lt;selection&gt;)
1271
 
1272
Sets the scale to frame on the selected or specified image frame to `scaletoframe&apos;.
1273
If `proportional&apos; is specified, set fixed aspect ratio scaling to `proportional&apos;.
1274
Both `scaletoframe&apos; and `proportional&apos; are boolean.
1275
 
1276
May raise WrongFrameTypeError.
1277
</source>
1278
        <translation type="unfinished">setScaleImageToFrame(scaletoframe, proportional=None, name=&lt;selection&gt;)
1279
 
1280
Sets the scale to frame on the selected or specified image frame to `scaletoframe&apos;.
1281
If `proportional&apos; is specified, set fixed aspect ratio scaling to `proportional&apos;.
1282
Both `scaletoframe&apos; and `proportional&apos; are boolean.
1283
 
1284
May raise WrongFrameTypeError.
1285
</translation>
1286
    </message>
1287
    <message>
1288
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="24"/>
1289
        <source>setRedraw(bool)
1290
 
1291
Disables page redraw when bool = False, otherwise redrawing is enabled.
1292
This change will persist even after the script exits, so make sure to call
1293
setRedraw(True) in a finally: clause at the top level of your script.
1294
</source>
1295
        <translation type="unfinished">setRedraw(bool)
1296
 
1297
Disables page redraw when bool = False, otherwise redrawing is enabled.
1298
This change will persist even after the script exits, so make sure to call
1299
setRedraw(True) in a finally: clause at the top level of your script.
1300
</translation>
1301
    </message>
1302
    <message>
1303
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="33"/>
1304
        <source>getFontNames() -&gt; list
1305
 
1306
Returns a list with the names of all available fonts.
1307
</source>
1308
        <translation type="unfinished">getFontNames() -&gt; list
1309
 
1310
Returns a list with the names of all available fonts.
1311
</translation>
1312
    </message>
1313
    <message>
1314
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="43"/>
1315
        <source>getXFontNames() -&gt; list of tuples
1316
 
1317
Returns a larger font info. It&apos;s a list of the tuples with:
1318
[ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1319
</source>
1320
        <translation type="unfinished">getXFontNames() -&gt; list of tuples
1321
 
1322
Returns a larger font info. It&apos;s a list of the tuples with:
1323
[ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1324
</translation>
1325
    </message>
1326
    <message>
1327
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="62"/>
1328
        <source>renderFont(&quot;name&quot;, &quot;filename&quot;, &quot;sample&quot;, size, format=&quot;PPM&quot;) -&gt; bool
1329
 
1330
Creates an image preview of font &quot;name&quot; with given text &quot;sample&quot; and size.
1331
If &quot;filename&quot; is not &quot;&quot;, image is saved into &quot;filename&quot;. Otherwise
1332
image data is returned as a string. The optional &quot;format&quot; argument
1333
specifies the image format to generate, and supports any format allowed
1334
by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
1335
 
1336
May raise NotFoundError if the specified font can&apos;t be found.
1337
May raise ValueError if an empty sample or filename is passed.
1338
</source>
1339
        <translation type="unfinished">renderFont(&quot;name&quot;, &quot;filename&quot;, &quot;sample&quot;, size, format=&quot;PPM&quot;) -&gt; bool
1340
 
1341
Creates an image preview of font &quot;name&quot; with given text &quot;sample&quot; and size.
1342
If &quot;filename&quot; is not &quot;&quot;, image is saved into &quot;filename&quot;. Otherwise
1343
image data is returned as a string. The optional &quot;format&quot; argument
1344
specifies the image format to generate, and supports any format allowed
1345
by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
1346
 
1347
May raise NotFoundError if the specified font can&apos;t be found.
1348
May raise ValueError if an empty sample or filename is passed.
1349
</translation>
1350
    </message>
1351
    <message>
1352
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="71"/>
1353
        <source>getLayers() -&gt; list
1354
 
1355
Returns a list with the names of all defined layers.
1356
</source>
1357
        <translation type="unfinished">getLayers() -&gt; list
1358
 
1359
Returns a list with the names of all defined layers.
1360
</translation>
1361
    </message>
1362
    <message>
1363
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="83"/>
1364
        <source>setActiveLayer(&quot;name&quot;)
1365
 
1366
Sets the active layer to the layer named &quot;name&quot;.
1367
 
1368
May raise NotFoundError if the layer can&apos;t be found.
1369
May raise ValueError if the layer name isn&apos;t acceptable.
1370
</source>
1371
        <translation type="unfinished">setActiveLayer(&quot;name&quot;)
1372
 
1373
Sets the active layer to the layer named &quot;name&quot;.
1374
 
1375
May raise NotFoundError if the layer can&apos;t be found.
1376
May raise ValueError if the layer name isn&apos;t acceptable.
1377
</translation>
1378
    </message>
1379
    <message>
1380
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="92"/>
1381
        <source>getActiveLayer() -&gt; string
1382
 
1383
Returns the name of the current active layer.
1384
</source>
1385
        <translation type="unfinished">getActiveLayer() -&gt; string
1386
 
1387
Returns the name of the current active layer.
1388
</translation>
1389
    </message>
1390
    <message>
1391
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="105"/>
1392
        <source>sentToLayer(&quot;layer&quot; [, &quot;name&quot;])
1393
 
1394
Sends the object &quot;name&quot; to the layer &quot;layer&quot;. The layer must exist.
1395
If &quot;name&quot; is not given the currently selected item is used.
1396
 
1397
May raise NotFoundError if the layer can&apos;t be found.
1398
May raise ValueError if the layer name isn&apos;t acceptable.
1399
</source>
1400
        <translation type="unfinished">sentToLayer(&quot;layer&quot; [, &quot;name&quot;])
1401
 
1402
Sends the object &quot;name&quot; to the layer &quot;layer&quot;. The layer must exist.
1403
If &quot;name&quot; is not given the currently selected item is used.
1404
 
1405
May raise NotFoundError if the layer can&apos;t be found.
1406
May raise ValueError if the layer name isn&apos;t acceptable.
1407
</translation>
1408
    </message>
1409
    <message>
1410
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="118"/>
1411
        <source>setLayerVisible(&quot;layer&quot;, visible)
1412
 
1413
Sets the layer &quot;layer&quot; to be visible or not. If is the visible set to false
1414
the layer is invisible.
1415
 
1416
May raise NotFoundError if the layer can&apos;t be found.
1417
May raise ValueError if the layer name isn&apos;t acceptable.
1418
</source>
1419
        <translation type="unfinished">setLayerVisible(&quot;layer&quot;, visible)
1420
 
1421
Sets the layer &quot;layer&quot; to be visible or not. If is the visible set to false
1422
the layer is invisible.
1423
 
1424
May raise NotFoundError if the layer can&apos;t be found.
1425
May raise ValueError if the layer name isn&apos;t acceptable.
1426
</translation>
1427
    </message>
1428
    <message>
1429
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="131"/>
1430
        <source>setLayerPrintable(&quot;layer&quot;, printable)
1431
 
1432
Sets the layer &quot;layer&quot; to be printable or not. If is the
1433
printable set to false the layer won&apos;t be printed.
1434
 
1435
May raise NotFoundError if the layer can&apos;t be found.
1436
May raise ValueError if the layer name isn&apos;t acceptable.
1437
</source>
1438
        <translation type="unfinished">setLayerPrintable(&quot;layer&quot;, printable)
1439
 
1440
Sets the layer &quot;layer&quot; to be printable or not. If is the
1441
printable set to false the layer won&apos;t be printed.
1442
 
1443
May raise NotFoundError if the layer can&apos;t be found.
1444
May raise ValueError if the layer name isn&apos;t acceptable.
1445
</translation>
1446
    </message>
1447
    <message>
1448
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="144"/>
1449
        <source>setLayerLocked(&quot;layer&quot;, locked)
1450
 
1451
Sets the layer &quot;layer&quot; to be locked or not. If locked is set to
1452
true the layer will be locked.
1453
 
1454
May raise NotFoundError if the layer can&apos;t be found.
1455
May raise ValueError if the layer name isn&apos;t acceptable.
1456
</source>
1457
        <translation type="unfinished">setLayerLocked(&quot;layer&quot;, locked)
1458
 
1459
Sets the layer &quot;layer&quot; to be locked or not. If locked is set to
1460
true the layer will be locked.
1461
 
1462
May raise NotFoundError if the layer can&apos;t be found.
1463
May raise ValueError if the layer name isn&apos;t acceptable.
1464
</translation>
1465
    </message>
1466
    <message>
1467
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="157"/>
1468
        <source>setLayerOutlined(&quot;layer&quot;, outline)
1469
 
1470
Sets the layer &quot;layer&quot; to be locked or not. If outline is set to
1471
true the layer will be displayed outlined.
1472
 
1473
May raise NotFoundError if the layer can&apos;t be found.
1474
May raise ValueError if the layer name isn&apos;t acceptable.
1475
</source>
1476
        <translation type="unfinished">setLayerOutlined(&quot;layer&quot;, outline)
1477
 
1478
Sets the layer &quot;layer&quot; to be locked or not. If outline is set to
1479
true the layer will be displayed outlined.
1480
 
1481
May raise NotFoundError if the layer can&apos;t be found.
1482
May raise ValueError if the layer name isn&apos;t acceptable.
1483
</translation>
1484
    </message>
1485
    <message>
1486
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="170"/>
1487
        <source>setLayerFlow(&quot;layer&quot;, flow)
1488
 
1489
Sets the layers &quot;layer&quot;  flowcontrol to flow. If flow is set to
1490
true text in layers above this one will flow around objects on this layer.
1491
 
1492
May raise NotFoundError if the layer can&apos;t be found.
1493
May raise ValueError if the layer name isn&apos;t acceptable.
1494
</source>
1495
        <translation type="unfinished">setLayerFlow(&quot;layer&quot;, flow)
1496
 
1497
Sets the layers &quot;layer&quot;  flowcontrol to flow. If flow is set to
1498
true text in layers above this one will flow around objects on this layer.
1499
 
1500
May raise NotFoundError if the layer can&apos;t be found.
1501
May raise ValueError if the layer name isn&apos;t acceptable.
1502
</translation>
1503
    </message>
1504
    <message>
1505
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="182"/>
1506
        <source>setLayerBlendmode(&quot;layer&quot;, blend)
1507
 
1508
Sets the layers &quot;layer&quot;  blendmode to blend.
1509
 
1510
May raise NotFoundError if the layer can&apos;t be found.
1511
May raise ValueError if the layer name isn&apos;t acceptable.
1512
</source>
1513
        <translation type="unfinished">setLayerBlendmode(&quot;layer&quot;, blend)
1514
 
1515
Sets the layers &quot;layer&quot;  blendmode to blend.
1516
 
1517
May raise NotFoundError if the layer can&apos;t be found.
1518
May raise ValueError if the layer name isn&apos;t acceptable.
1519
</translation>
1520
    </message>
1521
    <message>
1522
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="194"/>
1523
        <source>setLayerTransparency(&quot;layer&quot;, trans)
1524
 
1525
Sets the layers &quot;layer&quot;  transparency to trans.
1526
 
1527
May raise NotFoundError if the layer can&apos;t be found.
1528
May raise ValueError if the layer name isn&apos;t acceptable.
1529
</source>
1530
        <translation type="unfinished">setLayerTransparency(&quot;layer&quot;, trans)
1531
 
1532
Sets the layers &quot;layer&quot;  transparency to trans.
1533
 
1534
May raise NotFoundError if the layer can&apos;t be found.
1535
May raise ValueError if the layer name isn&apos;t acceptable.
1536
</translation>
1537
    </message>
1538
    <message>
1539
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="208"/>
1540
        <source>isLayerVisible(&quot;layer&quot;) -&gt; bool
1541
 
1542
Returns whether the layer &quot;layer&quot; is visible or not, a value of True means
1543
that the layer &quot;layer&quot; is visible, a value of False means that the layer
1544
&quot;layer&quot; is invisible.
1545
 
1546
May raise NotFoundError if the layer can&apos;t be found.
1547
May raise ValueError if the layer name isn&apos;t acceptable.
1548
</source>
1549
        <translation type="unfinished">isLayerVisible(&quot;layer&quot;) -&gt; bool
1550
 
1551
Returns whether the layer &quot;layer&quot; is visible or not, a value of True means
1552
that the layer &quot;layer&quot; is visible, a value of False means that the layer
1553
&quot;layer&quot; is invisible.
1554
 
1555
May raise NotFoundError if the layer can&apos;t be found.
1556
May raise ValueError if the layer name isn&apos;t acceptable.
1557
</translation>
1558
    </message>
1559
    <message>
1560
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="222"/>
1561
        <source>isLayerPrintable(&quot;layer&quot;) -&gt; bool
1562
 
1563
Returns whether the layer &quot;layer&quot; is printable or not, a value of True means
1564
that the layer &quot;layer&quot; can be printed, a value of False means that printing
1565
the layer &quot;layer&quot; is disabled.
1566
 
1567
May raise NotFoundError if the layer can&apos;t be found.
1568
May raise ValueError if the layer name isn&apos;t acceptable.
1569
</source>
1570
        <translation type="unfinished">isLayerPrintable(&quot;layer&quot;) -&gt; bool
1571
 
1572
Returns whether the layer &quot;layer&quot; is printable or not, a value of True means
1573
that the layer &quot;layer&quot; can be printed, a value of False means that printing
1574
the layer &quot;layer&quot; is disabled.
1575
 
1576
May raise NotFoundError if the layer can&apos;t be found.
1577
May raise ValueError if the layer name isn&apos;t acceptable.
1578
</translation>
1579
    </message>
1580
    <message>
1581
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="236"/>
1582
        <source>isLayerLocked(&quot;layer&quot;) -&gt; bool
1583
 
1584
Returns whether the layer &quot;layer&quot; is locked or not, a value of True means
1585
that the layer &quot;layer&quot; is editable, a value of False means that the layer
1586
&quot;layer&quot; is locked.
1587
 
1588
May raise NotFoundError if the layer can&apos;t be found.
1589
May raise ValueError if the layer name isn&apos;t acceptable.
1590
</source>
1591
        <translation type="unfinished">isLayerLocked(&quot;layer&quot;) -&gt; bool
1592
 
1593
Returns whether the layer &quot;layer&quot; is locked or not, a value of True means
1594
that the layer &quot;layer&quot; is editable, a value of False means that the layer
1595
&quot;layer&quot; is locked.
1596
 
1597
May raise NotFoundError if the layer can&apos;t be found.
1598
May raise ValueError if the layer name isn&apos;t acceptable.
1599
</translation>
1600
    </message>
1601
    <message>
1602
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="250"/>
1603
        <source>isLayerOutlined(&quot;layer&quot;) -&gt; bool
1604
 
1605
Returns whether the layer &quot;layer&quot; is outlined or not, a value of True means
1606
that the layer &quot;layer&quot; is outlined, a value of False means that the layer
1607
&quot;layer&quot; is normal.
1608
 
1609
May raise NotFoundError if the layer can&apos;t be found.
1610
May raise ValueError if the layer name isn&apos;t acceptable.
1611
</source>
1612
        <translation type="unfinished">isLayerOutlined(&quot;layer&quot;) -&gt; bool
1613
 
1614
Returns whether the layer &quot;layer&quot; is outlined or not, a value of True means
1615
that the layer &quot;layer&quot; is outlined, a value of False means that the layer
1616
&quot;layer&quot; is normal.
1617
 
1618
May raise NotFoundError if the layer can&apos;t be found.
1619
May raise ValueError if the layer name isn&apos;t acceptable.
1620
</translation>
1621
    </message>
1622
    <message>
1623
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="263"/>
1624
        <source>isLayerFlow(&quot;layer&quot;) -&gt; bool
1625
 
1626
Returns whether text flows around objects on layer &quot;layer&quot;, a value of True means
1627
that text flows around, a value of False means that the text does not flow around.
1628
 
1629
May raise NotFoundError if the layer can&apos;t be found.
1630
May raise ValueError if the layer name isn&apos;t acceptable.
1631
</source>
1632
        <translation type="unfinished">isLayerFlow(&quot;layer&quot;) -&gt; bool
1633
 
1634
Returns whether text flows around objects on layer &quot;layer&quot;, a value of True means
1635
that text flows around, a value of False means that the text does not flow around.
1636
 
1637
May raise NotFoundError if the layer can&apos;t be found.
1638
May raise ValueError if the layer name isn&apos;t acceptable.
1639
</translation>
1640
    </message>
1641
    <message>
1642
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="275"/>
1643
        <source>getLayerBlendmode(&quot;layer&quot;) -&gt; int
1644
 
1645
Returns the &quot;layer&quot; layer blendmode,
1646
 
1647
May raise NotFoundError if the layer can&apos;t be found.
1648
May raise ValueError if the layer name isn&apos;t acceptable.
1649
</source>
1650
        <translation type="unfinished">getLayerBlendmode(&quot;layer&quot;) -&gt; int
1651
 
1652
Returns the &quot;layer&quot; layer blendmode,
1653
 
1654
May raise NotFoundError if the layer can&apos;t be found.
1655
May raise ValueError if the layer name isn&apos;t acceptable.
1656
</translation>
1657
    </message>
1658
    <message>
1659
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="287"/>
1660
        <source>getLayerTransparency(&quot;layer&quot;) -&gt; float
1661
 
1662
Returns the &quot;layer&quot; layer transparency,
1663
 
1664
May raise NotFoundError if the layer can&apos;t be found.
1665
May raise ValueError if the layer name isn&apos;t acceptable.
1666
</source>
1667
        <translation type="unfinished">getLayerTransparency(&quot;layer&quot;) -&gt; float
1668
 
1669
Returns the &quot;layer&quot; layer transparency,
1670
 
1671
May raise NotFoundError if the layer can&apos;t be found.
1672
May raise ValueError if the layer name isn&apos;t acceptable.
1673
</translation>
1674
    </message>
1675
    <message>
1676
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="300"/>
1677
        <source>deleteLayer(&quot;layer&quot;)
1678
 
1679
Deletes the layer with the name &quot;layer&quot;. Nothing happens if the layer doesn&apos;t
1680
exists or if it&apos;s the only layer in the document.
1681
 
1682
May raise NotFoundError if the layer can&apos;t be found.
1683
May raise ValueError if the layer name isn&apos;t acceptable.
1684
</source>
1685
        <translation type="unfinished">deleteLayer(&quot;layer&quot;)
1686
 
1687
Deletes the layer with the name &quot;layer&quot;. Nothing happens if the layer doesn&apos;t
1688
exists or if it&apos;s the only layer in the document.
1689
 
1690
May raise NotFoundError if the layer can&apos;t be found.
1691
May raise ValueError if the layer name isn&apos;t acceptable.
1692
</translation>
1693
    </message>
1694
    <message>
1695
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="311"/>
1696
        <source>createLayer(layer)
1697
 
1698
Creates a new layer with the name &quot;name&quot;.
1699
 
1700
May raise ValueError if the layer name isn&apos;t acceptable.
1701
</source>
1702
        <translation type="unfinished">createLayer(layer)
1703
 
1704
Creates a new layer with the name &quot;name&quot;.
1705
 
1706
May raise ValueError if the layer name isn&apos;t acceptable.
1707
</translation>
1708
    </message>
1709
    <message>
1710
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="320"/>
1711
        <source>getGuiLanguage() -&gt; string
1712
 
1713
Returns a string with the -lang value.
1714
</source>
1715
        <translation type="unfinished">getGuiLanguage() -&gt; string
1716
 
1717
Returns a string with the -lang value.
1718
</translation>
1719
    </message>
1720
    <message>
1721
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="329"/>
1722
        <source>moveSelectionToFront()
1723
 
1724
Moves current selection to front.
1725
</source>
1726
        <translation type="unfinished">moveSelectionToFront()Moves current selection to front.</translation>
1727
    </message>
1728
    <message>
1729
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="338"/>
1730
        <source>moveSelectionToFront()
1731
 
1732
Moves current selection to back.
1733
</source>
1734
        <translation type="unfinished">moveSelectionToFront()Moves current selection to back.</translation>
1735
    </message>
1736
    <message>
1737
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="26"/>
1738
        <source>createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1739
 
1740
Creates a new rectangle on the current page and returns its name. The
1741
coordinates are given in the current measurement units of the document
1742
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1743
because you need this name to reference that object in future. If &quot;name&quot;
1744
is not given Scribus will create one for you.
1745
 
1746
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1747
</source>
1748
        <translation type="unfinished">createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1749
 
1750
Creates a new rectangle on the current page and returns its name. The
1751
coordinates are given in the current measurement units of the document
1752
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1753
because you need this name to reference that object in future. If &quot;name&quot;
1754
is not given Scribus will create one for you.
1755
 
1756
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1757
</translation>
1758
    </message>
1759
    <message>
1760
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="43"/>
1761
        <source>createEllipse(x, y, width, height, [&quot;name&quot;]) -&gt; string
1762
 
1763
Creates a new ellipse on the current page and returns its name.
1764
The coordinates are given in the current measurement units of the document
1765
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1766
because you need this name for further referencing of that object. If &quot;name&quot;
1767
is not given Scribus will create one for you.
1768
 
1769
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1770
</source>
1771
        <translation type="unfinished">createEllipse(x, y, width, height, [&quot;name&quot;]) -&gt; string
1772
 
1773
Creates a new ellipse on the current page and returns its name.
1774
The coordinates are given in the current measurement units of the document
1775
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1776
because you need this name for further referencing of that object. If &quot;name&quot;
1777
is not given Scribus will create one for you.
1778
 
1779
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1780
</translation>
1781
    </message>
1782
    <message>
1783
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="60"/>
1784
        <source>createImage(x, y, width, height, [&quot;name&quot;]) -&gt; string
1785
 
1786
Creates a new picture frame on the current page and returns its name. The
1787
coordinates are given in the current measurement units of the document.
1788
&quot;name&quot; should be a unique identifier for the object because you need this
1789
name for further access to that object. If &quot;name&quot; is not given Scribus will
1790
create one for you.
1791
 
1792
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1793
</source>
1794
        <translation type="unfinished">createImage(x, y, width, height, [&quot;name&quot;]) -&gt; string
1795
 
1796
Creates a new picture frame on the current page and returns its name. The
1797
coordinates are given in the current measurement units of the document.
1798
&quot;name&quot; should be a unique identifier for the object because you need this
1799
name for further access to that object. If &quot;name&quot; is not given Scribus will
1800
create one for you.
1801
 
1802
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1803
</translation>
1804
    </message>
1805
    <message>
1806
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="75"/>
1807
        <source>createText(x, y, width, height, [&quot;name&quot;]) -&gt; string
1808
 
1809
Creates a new text frame on the actual page and returns its name.
1810
The coordinates are given in the actual measurement unit of the document (see
1811
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1812
you need this name for further referencing of that object. If &quot;name&quot; is not
1813
given Scribus will create one for you.
1814
 
1815
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1816
</source>
1817
        <translation type="unfinished">createText(x, y, width, height, [&quot;name&quot;]) -&gt; string
1818
 
1819
Creates a new text frame on the actual page and returns its name.
1820
The coordinates are given in the actual measurement unit of the document (see
1821
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1822
you need this name for further referencing of that object. If &quot;name&quot; is not
1823
given Scribus will create one for you.
1824
 
1825
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1826
</translation>
1827
    </message>
1828
    <message>
1829
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="90"/>
1830
        <source>createLine(x1, y1, x2, y2, [&quot;name&quot;]) -&gt; string
1831
 
1832
Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
1833
its name. The coordinates are given in the current measurement unit of the
1834
document (see UNIT constants). &quot;name&quot; should be a unique identifier for the
1835
object because you need this name for further access to that object. If
1836
&quot;name&quot; is not given Scribus will create one for you.
1837
 
1838
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1839
</source>
1840
        <translation type="unfinished">createLine(x1, y1, x2, y2, [&quot;name&quot;]) -&gt; string
1841
 
1842
Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
1843
its name. The coordinates are given in the current measurement unit of the
1844
document (see UNIT constants). &quot;name&quot; should be a unique identifier for the
1845
object because you need this name for further access to that object. If
1846
&quot;name&quot; is not given Scribus will create one for you.
1847
 
1848
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1849
</translation>
1850
    </message>
1851
    <message>
1852
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="108"/>
1853
        <source>createPolyLine(list, [&quot;name&quot;]) -&gt; string
1854
 
1855
Creates a new polyline and returns its name. The points for the polyline are
1856
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1857
The coordinates are given in the current measurement units of the document (see
1858
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1859
you need this name for further access to that object. If &quot;name&quot; is not given
1860
Scribus will create one for you.
1861
 
1862
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1863
May raise ValueError if an insufficient number of points is passed or if
1864
the number of values passed don&apos;t group into points without leftovers.
1865
</source>
1866
        <translation type="unfinished">createPolyLine(list, [&quot;name&quot;]) -&gt; string
1867
 
1868
Creates a new polyline and returns its name. The points for the polyline are
1869
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1870
The coordinates are given in the current measurement units of the document (see
1871
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1872
you need this name for further access to that object. If &quot;name&quot; is not given
1873
Scribus will create one for you.
1874
 
1875
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1876
May raise ValueError if an insufficient number of points is passed or if
1877
the number of values passed don&apos;t group into points without leftovers.
1878
</translation>
1879
    </message>
1880
    <message>
1881
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="128"/>
1882
        <source>createPolygon(list, [&quot;name&quot;]) -&gt; string
1883
 
1884
Creates a new polygon and returns its name. The points for the polygon are
1885
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1886
At least three points are required. There is no need to repeat the first point
1887
to close the polygon. The polygon is automatically closed by connecting the
1888
first and the last point.  The coordinates are given in the current measurement
1889
units of the document (see UNIT constants).  &quot;name&quot; should be a unique
1890
identifier for the object because you need this name for further access to that
1891
object. If &quot;name&quot; is not given Scribus will create one for you.
1892
 
1893
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1894
May raise ValueError if an insufficient number of points is passed or if
1895
the number of values passed don&apos;t group into points without leftovers.
1896
</source>
1897
        <translation type="unfinished">createPolygon(list, [&quot;name&quot;]) -&gt; string
1898
 
1899
Creates a new polygon and returns its name. The points for the polygon are
1900
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1901
At least three points are required. There is no need to repeat the first point
1902
to close the polygon. The polygon is automatically closed by connecting the
1903
first and the last point.  The coordinates are given in the current measurement
1904
units of the document (see UNIT constants).  &quot;name&quot; should be a unique
1905
identifier for the object because you need this name for further access to that
1906
object. If &quot;name&quot; is not given Scribus will create one for you.
1907
 
1908
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1909
May raise ValueError if an insufficient number of points is passed or if
1910
the number of values passed don&apos;t group into points without leftovers.
1911
</translation>
1912
    </message>
1913
    <message>
1914
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="149"/>
1915
        <source>createBezierLine(list, [&quot;name&quot;]) -&gt; string
1916
 
1917
Creates a new bezier curve and returns its name. The points for the bezier
1918
curve are stored in the list &quot;list&quot; in the following order:
1919
[x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
1920
In the points list, x and y mean the x and y coordinates of the point and kx
1921
and ky meaning the control point for the curve.  The coordinates are given in
1922
the current measurement units of the document (see UNIT constants). &quot;name&quot;
1923
should be a unique identifier for the object because you need this name for
1924
further access to that object. If &quot;name&quot; is not given Scribus will create one
1925
for you.
1926
 
1927
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1928
May raise ValueError if an insufficient number of points is passed or if
1929
the number of values passed don&apos;t group into points without leftovers.
1930
</source>
1931
        <translation type="unfinished">createBezierLine(list, [&quot;name&quot;]) -&gt; string
1932
 
1933
Creates a new bezier curve and returns its name. The points for the bezier
1934
curve are stored in the list &quot;list&quot; in the following order:
1935
[x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
1936
In the points list, x and y mean the x and y coordinates of the point and kx
1937
and ky meaning the control point for the curve.  The coordinates are given in
1938
the current measurement units of the document (see UNIT constants). &quot;name&quot;
1939
should be a unique identifier for the object because you need this name for
1940
further access to that object. If &quot;name&quot; is not given Scribus will create one
1941
for you.
1942
 
1943
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1944
May raise ValueError if an insufficient number of points is passed or if
1945
the number of values passed don&apos;t group into points without leftovers.
1946
</translation>
1947
    </message>
1948
    <message>
1949
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="165"/>
1950
        <source>createPathText(x, y, &quot;textbox&quot;, &quot;beziercurve&quot;, [&quot;name&quot;]) -&gt; string
1951
 
1952
Creates a new pathText by merging the two objects &quot;textbox&quot; and
1953
&quot;beziercurve&quot; and returns its name. The coordinates are given in the current
1954
measurement unit of the document (see UNIT constants). &quot;name&quot; should be a
1955
unique identifier for the object because you need this name for further access
1956
to that object. If &quot;name&quot; is not given Scribus will create one for you.
1957
 
1958
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1959
May raise NotFoundError if one or both of the named base object don&apos;t exist.
1960
</source>
1961
        <translation type="unfinished">createPathText(x, y, &quot;textbox&quot;, &quot;beziercurve&quot;, [&quot;name&quot;]) -&gt; string
1962
 
1963
Creates a new pathText by merging the two objects &quot;textbox&quot; and
1964
&quot;beziercurve&quot; and returns its name. The coordinates are given in the current
1965
measurement unit of the document (see UNIT constants). &quot;name&quot; should be a
1966
unique identifier for the object because you need this name for further access
1967
to that object. If &quot;name&quot; is not given Scribus will create one for you.
1968
 
1969
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1970
May raise NotFoundError if one or both of the named base object don&apos;t exist.
1971
</translation>
1972
    </message>
1973
    <message>
1974
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="177"/>
1975
        <source>deleteObject([&quot;name&quot;])
1976
 
1977
Deletes the item with the name &quot;name&quot;. If &quot;name&quot; is not given the currently
1978
selected item is deleted.
1979
</source>
1980
        <translation type="unfinished">deleteObject([&quot;name&quot;])
1981
 
1982
Deletes the item with the name &quot;name&quot;. If &quot;name&quot; is not given the currently
1983
selected item is deleted.
1984
</translation>
1985
    </message>
1986
    <message>
1987
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="193"/>
1988
        <source>textFlowMode(&quot;name&quot; [, state])
1989
 
1990
Enables/disables &quot;Text Flows Around Frame&quot; feature for object &quot;name&quot;.
1991
Called with parameters string name and optional int &quot;state&quot; (0 &lt;= state &lt;= 3).
1992
Setting &quot;state&quot; to 0 will disable text flow.
1993
Setting &quot;state&quot; to 1 will make text flow around object frame.
1994
Setting &quot;state&quot; to 2 will make text flow around bounding box.
1995
Setting &quot;state&quot; to 3 will make text flow around contour line.
1996
If &quot;state&quot; is not passed, text flow is toggled.
1997
</source>
1998
        <translation type="unfinished">textFlowMode(&quot;name&quot; [, state])
1999
 
2000
Enables/disables &quot;Text Flows Around Frame&quot; feature for object &quot;name&quot;.
2001
Called with parameters string name and optional int &quot;state&quot; (0 &lt;= state &lt;= 3).
2002
Setting &quot;state&quot; to 0 will disable text flow.
2003
Setting &quot;state&quot; to 1 will make text flow around object frame.
2004
Setting &quot;state&quot; to 2 will make text flow around bounding box.
2005
Setting &quot;state&quot; to 3 will make text flow around contour line.
2006
If &quot;state&quot; is not passed, text flow is toggled.
2007
</translation>
2008
    </message>
2009
    <message>
2010
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="211"/>
2011
        <source>objectExists([&quot;name&quot;]) -&gt; bool
2012
 
2013
Test if an object with specified name really exists in the document.
2014
The optional parameter is the object name. When no object name is given,
2015
returns True if there is something selected.
2016
</source>
2017
        <translation type="unfinished">objectExists([&quot;name&quot;]) -&gt; bool
2018
 
2019
Test if an object with specified name really exists in the document.
2020
The optional parameter is the object name. When no object name is given,
2021
returns True if there is something selected.
2022
</translation>
2023
    </message>
2024
    <message>
2025
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="227"/>
2026
        <source>setStyle(&quot;style&quot; [, &quot;name&quot;])
2027
 
2028
Apply the named &quot;style&quot; to the object named &quot;name&quot;. If is no object name
2029
given, it&apos;s applied on the selected object.
2030
</source>
2031
        <translation type="unfinished">setStyle(&quot;style&quot; [, &quot;name&quot;])
2032
 
2033
Apply the named &quot;style&quot; to the object named &quot;name&quot;. If is no object name
2034
given, it&apos;s applied on the selected object.
2035
</translation>
2036
    </message>
2037
    <message>
2038
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="240"/>
2039
        <source>getAllStyles() -&gt; list
2040
 
2041
Return a list of the names of all paragraph styles in the current document.
2042
</source>
2043
        <translation type="unfinished">getAllStyles() -&gt; list
2044
 
2045
Return a list of the names of all paragraph styles in the current document.
2046
</translation>
2047
    </message>
2048
    <message>
2049
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="252"/>
2050
        <source>duplicateObject([&quot;name&quot;]) -&gt; string
2051
 
2052
creates a Duplicate of the selected Object (or Selection Group).
2053
</source>
2054
        <translation type="unfinished">duplicateObject([&quot;name&quot;]) -&gt; string
2055
 
2056
creates a Duplicate of the selected Object (or Selection Group).
2057
</translation>
2058
    </message>
2059
    <message>
2060
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="26"/>
2061
        <source>newPage(where [,&quot;masterpage&quot;])
2062
 
2063
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
2064
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
2065
counted from 1 upwards, no matter what the displayed first page number of your
2066
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
2067
master page for the new page.
2068
 
2069
May raise IndexError if the page number is out of range
2070
</source>
2071
        <translation type="unfinished">newPage(where [,&quot;masterpage&quot;])
2072
 
2073
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
2074
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
2075
counted from 1 upwards, no matter what the displayed first page number of your
2076
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
2077
master page for the new page.
2078
 
2079
May raise IndexError if the page number is out of range
2080
</translation>
2081
    </message>
2082
    <message>
2083
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="36"/>
2084
        <source>currentPage() -&gt; integer
2085
 
2086
Returns the number of the current working page. Page numbers are counted from 1
2087
upwards, no matter what the displayed first page number of your document is.
2088
</source>
2089
        <translation type="unfinished">currentPage() -&gt; integer
2090
 
2091
Returns the number of the current working page. Page numbers are counted from 1
2092
upwards, no matter what the displayed first page number of your document is.
2093
</translation>
2094
    </message>
2095
    <message>
2096
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="45"/>
2097
        <source>redrawAll()
2098
 
2099
Redraws all pages.
2100
</source>
2101
        <translation type="unfinished">redrawAll()
2102
 
2103
Redraws all pages.
2104
</translation>
2105
    </message>
2106
    <message>
2107
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="54"/>
2108
        <source>getPageType() -&gt; integer
2109
 
2110
Returns the type of the Page, 0 means left Page, 1 is a middle Page and 2 is a right Page
2111
</source>
2112
        <translation type="unfinished">getPageType() -&gt; integer
2113
 
2114
Returns the type of the Page, 0 means left Page, 1 is a middle Page and 2 is a right Page
2115
</translation>
2116
    </message>
2117
    <message>
2118
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="65"/>
2119
        <source>savePageAsEPS(&quot;name&quot;)
2120
 
2121
Saves the current page as an EPS to the file &quot;name&quot;.
2122
 
2123
May raise ScribusError if the save failed.
2124
</source>
2125
        <translation type="unfinished">savePageAsEPS(&quot;name&quot;)
2126
 
2127
Saves the current page as an EPS to the file &quot;name&quot;.
2128
 
2129
May raise ScribusError if the save failed.
2130
</translation>
2131
    </message>
2132
    <message>
2133
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="78"/>
2134
        <source>deletePage(nr)
2135
 
2136
Deletes the given page. Does nothing if the document contains only one page.
2137
Page numbers are counted from 1 upwards, no matter what the displayed first
2138
page number is.
2139
 
2140
May raise IndexError if the page number is out of range
2141
</source>
2142
        <translation type="unfinished">deletePage(nr)
2143
 
2144
Deletes the given page. Does nothing if the document contains only one page.
2145
Page numbers are counted from 1 upwards, no matter what the displayed first
2146
page number is.
2147
 
2148
May raise IndexError if the page number is out of range
2149
</translation>
2150
    </message>
2151
    <message>
2152
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="91"/>
2153
        <source>gotoPage(nr)
2154
 
2155
Moves to the page &quot;nr&quot; (that is, makes the current page &quot;nr&quot;). Note that
2156
gotoPage doesn&apos;t (currently) change the page the user&apos;s view is displaying, it
2157
just sets the page that script commands will operates on.
2158
 
2159
May raise IndexError if the page number is out of range.
2160
</source>
2161
        <translation type="unfinished">gotoPage(nr)
2162
 
2163
Moves to the page &quot;nr&quot; (that is, makes the current page &quot;nr&quot;). Note that
2164
gotoPage doesn&apos;t (currently) change the page the user&apos;s view is displaying, it
2165
just sets the page that script commands will operates on.
2166
 
2167
May raise IndexError if the page number is out of range.
2168
</translation>
2169
    </message>
2170
    <message>
2171
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="100"/>
2172
        <source>pageCount() -&gt; integer
2173
 
2174
Returns the number of pages in the document.
2175
</source>
2176
        <translation type="unfinished">pageCount() -&gt; integer
2177
 
2178
Returns the number of pages in the document.
2179
</translation>
2180
    </message>
2181
    <message>
2182
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="110"/>
2183
        <source>getHGuides() -&gt; list
2184
 
2185
Returns a list containing positions of the horizontal guides. Values are in the
2186
document&apos;s current units - see UNIT_&lt;type&gt; constants.
2187
</source>
2188
        <translation type="unfinished">getHGuides() -&gt; list
2189
 
2190
Returns a list containing positions of the horizontal guides. Values are in the
2191
document&apos;s current units - see UNIT_&lt;type&gt; constants.
2192
</translation>
2193
    </message>
2194
    <message>
2195
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="123"/>
2196
        <source>setHGuides(list)
2197
 
2198
Sets horizontal guides. Input parameter must be a list of guide positions
2199
measured in the current document units - see UNIT_&lt;type&gt; constants.
2200
 
2201
Example: setHGuides(getHGuides() + [200.0, 210.0] # add new guides without any lost
2202
         setHGuides([90,250]) # replace current guides entirely
2203
</source>
2204
        <translation type="unfinished">setHGuides(list)
2205
 
2206
Sets horizontal guides. Input parameter must be a list of guide positions
2207
measured in the current document units - see UNIT_&lt;type&gt; constants.
2208
 
2209
Example: setHGuides(getHGuides() + [200.0, 210.0] # add new guides without any lost
2210
         setHGuides([90,250]) # replace current guides entirely
2211
</translation>
2212
    </message>
2213
    <message>
2214
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="132"/>
2215
        <source>getVGuides()
2216
 
2217
See getHGuides.
2218
</source>
2219
        <translation type="unfinished">getVGuides()
2220
 
2221
See getHGuides.
2222
</translation>
2223
    </message>
2224
    <message>
2225
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="141"/>
2226
        <source>setVGuides()
2227
 
2228
See setHGuides.
2229
</source>
2230
        <translation type="unfinished">setVGuides()
2231
 
2232
See setHGuides.
2233
</translation>
2234
    </message>
2235
    <message>
2236
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="151"/>
2237
        <source>getPageSize() -&gt; tuple
2238
 
2239
Returns a tuple with page dimensions measured in the document&apos;s current units.
2240
See UNIT_&lt;type&gt; constants and getPageMargins()
2241
</source>
2242
        <translation type="unfinished">getPageSize() -&gt; tuple
2243
 
2244
Returns a tuple with page dimensions measured in the document&apos;s current units.
2245
See UNIT_&lt;type&gt; constants and getPageMargins()
2246
</translation>
2247
    </message>
2248
    <message>
2249
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="167"/>
2250
        <source>getPageItems() -&gt; list
2251
 
2252
Returns a list of tuples with items on the current page. The tuple is:
2253
(name, objectType, order) E.g. [(&apos;Text1&apos;, 4, 0), (&apos;Image1&apos;, 2, 1)]
2254
means that object named &apos;Text1&apos; is a text frame (type 4) and is the first at
2255
the page...
2256
</source>
2257
        <translation type="unfinished">getPageItems() -&gt; list
2258
 
2259
Returns a list of tuples with items on the current page. The tuple is:
2260
(name, objectType, order) E.g. [(&apos;Text1&apos;, 4, 0), (&apos;Image1&apos;, 2, 1)]
2261
means that object named &apos;Text1&apos; is a text frame (type 4) and is the first at
2262
the page...
2263
</translation>
2264
    </message>
2265
    <message>
2266
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="181"/>
2267
        <source>getPageMargins()
2268
 
2269
Returns the page margins as a (top, left, right, bottom) tuple in the current
2270
units. See UNIT_&lt;type&gt; constants and getPageSize().
2271
</source>
2272
        <translation type="unfinished">getPageMargins()
2273
 
2274
Returns the page margins as a (top, left, right, bottom) tuple in the current
2275
units. See UNIT_&lt;type&gt; constants and getPageSize().
2276
</translation>
2277
    </message>
2278
    <message>
2279
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="198"/>
2280
        <source>importPage(&quot;fromDoc&quot;, (pageList), [create, imortwhere, importwherePage])
2281
 
2282
Imports a set of pages (given as a tuple) from an existing document (the file name must be given). This functions maps the &quot;Page-&gt;Import&quot; dropdown menu function.
2283
fromDoc: string; the filename of the document to import pages from
2284
pageList: tuple with page numbers of pages to import
2285
create: number; 0 to replace existing pages, 1 (default) to insert new pages
2286
importWhere: number; the page number (of the current document) at which import the pages
2287
importWherePage: number; used if create==1; 0 to create pages before selected page; 1 to create pages after selected page; 2 (default) to create pages at the end of the document
2288
</source>
2289
        <translation type="unfinished">importPage(&quot;fromDoc&quot;, (pageList), [create, imortwhere, importwherePage])Imports a set of pages (given as a tuple) from an existing document (the file name must be given). This functions maps the &quot;Page-&gt;Import&quot; dropdown menu function.fromDoc: string; the filename of the document to import pages frompageList: tuple with page numbers of pages to importcreate: number; 0 to replace existing pages, 1 (default) to insert new pagesimportWhere: number; the page number (of the current document) at which import the pagesimportWherePage: number; used if create==1; 0 to create pages before selected page; 1 to create pages after selected page; 2 (default) to create pages at the end of the document</translation>
2290
    </message>
2291
    <message>
2292
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="22"/>
2293
        <source>setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
2294
 
2295
Sets the gradient fill of the object &quot;name&quot; to type. Color descriptions are
2296
the same as for setFillColor() and setFillShade(). See the constants for
2297
available types (FILL_&lt;type&gt;).
2298
</source>
2299
        <translation type="unfinished">setGradientFill(type, &quot;colour1&quot;, shade1, &quot;colour2&quot;, shade2, [&quot;name&quot;])
2300
 
2301
Sets the gradient fill of the object &quot;name&quot; to type. Colour descriptions are
2302
the same as for setFillColor() and setFillShade(). See the constants for
2303
available types (FILL_&lt;type&gt;).
2304
</translation>
2305
    </message>
2306
    <message>
2307
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="33"/>
2308
        <source>setFillColor(&quot;color&quot;, [&quot;name&quot;])
2309
 
2310
Sets the fill color of the object &quot;name&quot; to the color &quot;color&quot;. &quot;color&quot;
2311
is the name of one of the defined colors. If &quot;name&quot; is not given the
2312
currently selected item is used.
2313
</source>
2314
        <translation type="unfinished">setFillColor(&quot;color&quot;, [&quot;name&quot;])
2315
 
2316
Sets the fill colour of the object &quot;name&quot; to the colour &quot;color&quot;. &quot;color&quot;
2317
is the name of one of the defined colours. If &quot;name&quot; is not given the
2318
currently selected item is used.
2319
</translation>
2320
    </message>
2321
    <message>
2322
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="43"/>
2323
        <source>setFillTransparency(transparency, [&quot;name&quot;])
2324
 
2325
Sets the fill transparency of the object &quot;name&quot; to transparency
2326
If &quot;name&quot; is not given the currently selected item is used.
2327
</source>
2328
        <translation type="unfinished">setFillTransparency(transparency, [&quot;name&quot;])
2329
 
2330
Sets the fill transparency of the object &quot;name&quot; to transparency
2331
If &quot;name&quot; is not given the currently selected item is used.
2332
</translation>
2333
    </message>
2334
    <message>
2335
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="53"/>
2336
        <source>setFillBlendmode(blendmode, [&quot;name&quot;])
2337
 
2338
Sets the fill blendmode of the object &quot;name&quot; to blendmode
2339
If &quot;name&quot; is not given the currently selected item is used.
2340
</source>
2341
        <translation type="unfinished">setFillBlendmode(blendmode, [&quot;name&quot;])
2342
 
2343
Sets the fill blendmode of the object &quot;name&quot; to blendmode
2344
If &quot;name&quot; is not given the currently selected item is used.
2345
</translation>
2346
    </message>
2347
    <message>
2348
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="63"/>
2349
        <source>setLineColor(&quot;color&quot;, [&quot;name&quot;])
2350
 
2351
Sets the line color of the object &quot;name&quot; to the color &quot;color&quot;. If &quot;name&quot;
2352
is not given the currently selected item is used.
2353
</source>
2354
        <translation type="unfinished">setLineColor(&quot;color&quot;, [&quot;name&quot;])
2355
 
2356
Sets the line colour of the object &quot;name&quot; to the colour &quot;color&quot;. If &quot;name&quot;
2357
is not given the currently selected item is used.
2358
</translation>
2359
    </message>
2360
    <message>
2361
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="73"/>
2362
        <source>setLineTransparency(transparency, [&quot;name&quot;])
2363
 
2364
Sets the line transparency of the object &quot;name&quot; to transparency
2365
If &quot;name&quot; is not given the currently selected item is used.
2366
</source>
2367
        <translation type="unfinished">setLineTransparency(transparency, [&quot;name&quot;])
2368
 
2369
Sets the line transparency of the object &quot;name&quot; to transparency
2370
If &quot;name&quot; is not given the currently selected item is used.
2371
</translation>
2372
    </message>
2373
    <message>
2374
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="83"/>
2375
        <source>setLineBlendmode(blendmode, [&quot;name&quot;])
2376
 
2377
Sets the line blendmode of the object &quot;name&quot; to blendmode
2378
If &quot;name&quot; is not given the currently selected item is used.
2379
</source>
2380
        <translation type="unfinished">setLineBlendmode(blendmode, [&quot;name&quot;])
2381
 
2382
Sets the line blendmode of the object &quot;name&quot; to blendmode
2383
If &quot;name&quot; is not given the currently selected item is used.
2384
</translation>
2385
    </message>
2386
    <message>
2387
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="96"/>
2388
        <source>setLineWidth(width, [&quot;name&quot;])
2389
 
2390
Sets line width of the object &quot;name&quot; to &quot;width&quot;. &quot;width&quot; must be in the
2391
range from 0.0 to 12.0 inclusive, and is measured in points. If &quot;name&quot; is not
2392
given the currently selected item is used.
2393
 
2394
May raise ValueError if the line width is out of bounds.
2395
</source>
2396
        <translation type="unfinished">setLineWidth(width, [&quot;name&quot;])
2397
 
2398
Sets line width of the object &quot;name&quot; to &quot;width&quot;. &quot;width&quot; must be in the
2399
range from 0.0 to 12.0 inclusive, and is measured in points. If &quot;name&quot; is not
2400
given the currently selected item is used.
2401
 
2402
May raise ValueError if the line width is out of bounds.
2403
</translation>
2404
    </message>
2405
    <message>
2406
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="110"/>
2407
        <source>setLineShade(shade, [&quot;name&quot;])
2408
 
2409
Sets the shading of the line color of the object &quot;name&quot; to &quot;shade&quot;.
2410
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2411
(full color intensity). If &quot;name&quot; is not given the currently selected item
2412
is used.
2413
 
2414
May raise ValueError if the line shade is out of bounds.
2415
</source>
2416
        <translation type="unfinished">setLineShade(shade, [&quot;name&quot;])
2417
 
2418
Sets the shading of the line colour of the object &quot;name&quot; to &quot;shade&quot;.
2419
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2420
(full colour intensity). If &quot;name&quot; is not given the currently selected item
2421
is used.
2422
 
2423
May raise ValueError if the line shade is out of bounds.
2424
</translation>
2425
    </message>
2426
    <message>
2427
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="121"/>
2428
        <source>setLineJoin(join, [&quot;name&quot;])
2429
 
2430
Sets the line join style of the object &quot;name&quot; to the style &quot;join&quot;.
2431
If &quot;name&quot; is not given the currently selected item is used. There are
2432
predefined constants for join - JOIN_&lt;type&gt;.
2433
</source>
2434
        <translation type="unfinished">setLineJoin(join, [&quot;name&quot;])
2435
 
2436
Sets the line join style of the object &quot;name&quot; to the style &quot;join&quot;.
2437
If &quot;name&quot; is not given the currently selected item is used. There are
2438
predefined constants for join - JOIN_&lt;type&gt;.
2439
</translation>
2440
    </message>
2441
    <message>
2442
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="132"/>
2443
        <source>setLineEnd(endtype, [&quot;name&quot;])
2444
 
2445
Sets the line cap style of the object &quot;name&quot; to the style &quot;cap&quot;.
2446
If &quot;name&quot; is not given the currently selected item is used. There are
2447
predefined constants for &quot;cap&quot; - CAP_&lt;type&gt;.
2448
</source>
2449
        <translation type="unfinished">setLineEnd(endtype, [&quot;name&quot;])
2450
 
2451
Sets the line cap style of the object &quot;name&quot; to the style &quot;cap&quot;.
2452
If &quot;name&quot; is not given the currently selected item is used. There are
2453
predefined constants for &quot;cap&quot; - CAP_&lt;type&gt;.
2454
</translation>
2455
    </message>
2456
    <message>
2457
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="143"/>
2458
        <source>setLineStyle(style, [&quot;name&quot;])
2459
 
2460
Sets the line style of the object &quot;name&quot; to the style &quot;style&quot;. If &quot;name&quot;
2461
is not given the currently selected item is used. There are predefined
2462
constants for &quot;style&quot; - LINE_&lt;style&gt;.
2463
</source>
2464
        <translation type="unfinished">setLineStyle(style, [&quot;name&quot;])
2465
 
2466
Sets the line style of the object &quot;name&quot; to the style &quot;style&quot;. If &quot;name&quot;
2467
is not given the currently selected item is used. There are predefined
2468
constants for &quot;style&quot; - LINE_&lt;style&gt;.
2469
</translation>
2470
    </message>
2471
    <message>
2472
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="157"/>
2473
        <source>setFillShade(shade, [&quot;name&quot;])
2474
 
2475
Sets the shading of the fill color of the object &quot;name&quot; to &quot;shade&quot;.
2476
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2477
(full Color intensity). If &quot;name&quot; is not given the currently selected
2478
Item is used.
2479
 
2480
May raise ValueError if the fill shade is out of bounds.
2481
</source>
2482
        <translation type="unfinished">setFillShade(shade, [&quot;name&quot;])
2483
 
2484
Sets the shading of the fill colour of the object &quot;name&quot; to &quot;shade&quot;.
2485
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2486
(full Colour intensity). If &quot;name&quot; is not given the currently selected
2487
Item is used.
2488
 
2489
May raise ValueError if the fill shade is out of bounds.
2490
</translation>
2491
    </message>
2492
    <message>
2493
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="169"/>
2494
        <source>setCornerRadius(radius, [&quot;name&quot;])
2495
 
2496
Sets the corner radius of the object &quot;name&quot;. The radius is expressed
2497
in points. If &quot;name&quot; is not given the currently selected item is used.
2498
 
2499
May raise ValueError if the corner radius is negative.
2500
</source>
2501
        <translation type="unfinished">setCornerRadius(radius, [&quot;name&quot;])
2502
 
2503
Sets the corner radius of the object &quot;name&quot;. The radius is expressed
2504
in points. If &quot;name&quot; is not given the currently selected item is used.
2505
 
2506
May raise ValueError if the corner radius is negative.
2507
</translation>
2508
    </message>
2509
    <message>
2510
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="181"/>
2511
        <source>setMultiLine(&quot;namedStyle&quot;, [&quot;name&quot;])
2512
 
2513
Sets the line style of the object &quot;name&quot; to the named style &quot;namedStyle&quot;.
2514
If &quot;name&quot; is not given the currently selected item is used.
2515
 
2516
May raise NotFoundError if the line style doesn&apos;t exist.
2517
</source>
2518
        <translation type="unfinished">setMultiLine(&quot;namedStyle&quot;, [&quot;name&quot;])
2519
 
2520
Sets the line style of the object &quot;name&quot; to the named style &quot;namedStyle&quot;.
2521
If &quot;name&quot; is not given the currently selected item is used.
2522
 
2523
May raise NotFoundError if the line style doesn&apos;t exist.
2524
</translation>
2525
    </message>
2526
    <message>
2527
        <location filename="../../scribus/plugins/scriptplugin/cmdstyle.h" line="43"/>
2528
        <source>createParagraphStyle(...)
2529
 
2530
Creates a paragraph style. This function takes the following keyword parameters:
2531
 
2532
&quot;name&quot; [required] -&gt; specifies the name of the paragraphstyle to create
2533
 
2534
linespacingmode [optional] -&gt; specifies the linespacing mode; possible modes are:
2535
 
2536
fixed linespacing:          0
2537
 
2538
automatic linespacing:      1
2539
 
2540
baseline grid linespacing:  2
2541
 
2542
linespacing [optional] -&gt; specifies the linespacing if using fixed linespacing
2543
 
2544
alignment [optional] -&gt; specifies the alignment of the paragraph
2545
 
2546
-&gt; left:     0
2547
 
2548
-&gt; center:   1
2549
 
2550
-&gt; right:    2
2551
 
2552
-&gt; justify:  3
2553
 
2554
-&gt; extend:   4
2555
 
2556
leftmargin [optional], rightmargin [optional] -&gt; specify the margin
2557
 
2558
gapbefore [optional], gapafter [optional] -&gt; specify the gaps to the heading and following paragraphs
2559
 
2560
firstindent [optional] -&gt; the indent of the first line
2561
 
2562
hasdropcap [optional] -&gt; specifies if there are caps (1 = yes, 0 = no)
2563
 
2564
dropcaplines [optional] -&gt; height (in lines) of the caps if used
2565
 
2566
dropcapoffset [optional] -&gt; offset of the caps if used
2567
 
2568
&quot;charstyle&quot; [optional] -&gt; char style to use
2569
 
2570
</source>
2571
        <translation type="unfinished">createParagraphStyle(...)Creates a paragraph style. This function takes the following keyword parameters:&quot;name&quot; [required] -&gt; specifies the name of the paragraphstyle to createlinespacingmode [optional] -&gt; specifies the linespacing mode; possible modes are:fixed linespacing:          0automatic linespacing:      1baseline grid linespacing:  2linespacing [optional] -&gt; specifies the linespacing if using fixed linespacingalignment [optional] -&gt; specifies the alignment of the paragraph-&gt; left:     0-&gt; center:   1-&gt; right:    2-&gt; justify:  3-&gt; extend:   4leftmargin [optional], rightmargin [optional] -&gt; specify the margingapbefore [optional], gapafter [optional] -&gt; specify the gaps to the heading and following paragraphsfirstindent [optional] -&gt; the indent of the first linehasdropcap [optional] -&gt; specifies if there are caps (1 = yes, 0 = no)dropcaplines [optional] -&gt; height (in lines) of the caps if useddropcapoffset [optional] -&gt; offset of the caps if used&quot;charstyle&quot; [optional] -&gt; char style to use</translation>
2572
    </message>
2573
    <message>
2574
        <location filename="../../scribus/plugins/scriptplugin/cmdstyle.h" line="80"/>
2575
        <source>createCharStyle(...)
2576
 
2577
Creates a character style. This function takes the following keyword parameters:
2578
 
2579
&quot;name&quot; [required] -&gt; name of the char style to create
2580
 
2581
&quot;font&quot; [optional] -&gt; name of the font to use
2582
 
2583
fontsize [optional] -&gt; font size to set (double)
2584
 
2585
&quot;features&quot; [optional] -&gt; nearer typographic details can be defined by a string that might contain the following phrases comma-seperated (without spaces!):
2586
 
2587
-&gt; inherit
2588
 
2589
-&gt; bold
2590
 
2591
-&gt; italic
2592
 
2593
-&gt; underline
2594
 
2595
-&gt; underlinewords
2596
 
2597
-&gt; strike
2598
 
2599
-&gt; superscript
2600
 
2601
-&gt; subscript
2602
 
2603
-&gt; outline
2604
 
2605
-&gt; shadowed
2606
 
2607
-&gt; allcaps
2608
 
2609
-&gt; smallcaps
2610
 
2611
&quot;fillcolor&quot; [optional], &quot;fillshade&quot; [optional] -&gt; specify fill options
2612
 
2613
&quot;strokecolor&quot; [optional], &quot;strokeshade&quot; [optional] -&gt; specify stroke options
2614
 
2615
baselineoffset [optional] -&gt; offset of the baseline
2616
 
2617
shadowxoffset [optional], shadowyoffset [optional] -&gt; offset of the shadow if used
2618
 
2619
outlinewidth [optional] -&gt; width of the outline if used
2620
 
2621
underlineoffset [optional], underlinewidth [optional] -&gt; underline options if used
2622
 
2623
strikethruoffset [optional], strikethruwidth [optional] -&gt; strikethru options if used
2624
 
2625
scaleh [optional], scalev [optional] -&gt; scale of the chars
2626
 
2627
tracking [optional] -&gt; tracking of the text
2628
 
2629
&quot;language&quot; [optional] -&gt; language code
2630
 
2631
</source>
2632
        <translation type="unfinished">createCharStyle(...)Creates a character style. This function takes the following keyword parameters:&quot;name&quot; [required] -&gt; name of the char style to create&quot;font&quot; [optional] -&gt; name of the font to usefontsize [optional] -&gt; font size to set (double)&quot;features&quot; [optional] -&gt; nearer typographic details can be defined by a string that might contain the following phrases comma-seperated (without spaces!):-&gt; inherit-&gt; bold-&gt; italic-&gt; underline-&gt; underlinewords-&gt; strike-&gt; superscript-&gt; subscript-&gt; outline-&gt; shadowed-&gt; allcaps-&gt; smallcaps&quot;fillcolour&quot; [optional], &quot;fillshade&quot; [optional] -&gt; specify fill options&quot;strokecolour&quot; [optional], &quot;strokeshade&quot; [optional] -&gt; specify stroke optionsbaselineoffset [optional] -&gt; offset of the baselineshadowxoffset [optional], shadowyoffset [optional] -&gt; offset of the shadow if usedoutlinewidth [optional] -&gt; width of the outline if usedunderlineoffset [optional], underlinewidth [optional] -&gt; underline options if usedstrikethruoffset [optional], strikethruwidth [optional] -&gt; strikethru options if usedscaleh [optional], scalev [optional] -&gt; scale of the charstracking [optional] -&gt; tracking of the text&quot;language&quot; [optional] -&gt; language code</translation>
2633
    </message>
2634
    <message>
2635
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="23"/>
2636
        <source>getFontSize([&quot;name&quot;]) -&gt; float
2637
 
2638
Returns the font size in points for the text frame &quot;name&quot;. If this text
2639
frame has some text selected the value assigned to the first character of
2640
the selection is returned.
2641
If &quot;name&quot; is not given the currently selected item is used.
2642
</source>
2643
        <translation type="unfinished">getFontSize([&quot;name&quot;]) -&gt; float
2644
 
2645
Returns the font size in points for the text frame &quot;name&quot;. If this text
2646
frame has some text selected the value assigned to the first character of
2647
the selection is returned.
2648
If &quot;name&quot; is not given the currently selected item is used.
2649
</translation>
2650
    </message>
2651
    <message>
2652
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="35"/>
2653
        <source>getFont([&quot;name&quot;]) -&gt; string
2654
 
2655
Returns the font name for the text frame &quot;name&quot;. If this text frame
2656
has some text selected the value assigned to the first character
2657
of the selection is returned. If &quot;name&quot; is not given the currently
2658
selected item is used.
2659
</source>
2660
        <translation type="unfinished">getFont([&quot;name&quot;]) -&gt; string
2661
 
2662
Returns the font name for the text frame &quot;name&quot;. If this text frame
2663
has some text selected the value assigned to the first character
2664
of the selection is returned. If &quot;name&quot; is not given the currently
2665
selected item is used.
2666
</translation>
2667
    </message>
2668
    <message>
2669
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="45"/>
2670
        <source>getTextLength([&quot;name&quot;]) -&gt; integer
2671
 
2672
Returns the length of the text in the text frame &quot;name&quot;.
2673
If &quot;name&quot; is not given the currently selected item is used.
2674
</source>
2675
        <translation type="unfinished">getTextLength([&quot;name&quot;]) -&gt; integer
2676
 
2677
Returns the length of the text in the text frame &quot;name&quot;.
2678
If &quot;name&quot; is not given the currently selected item is used.
2679
</translation>
2680
    </message>
2681
    <message>
2682
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="55"/>
2683
        <source>getTextLines([&quot;name&quot;]) -&gt; integer
2684
 
2685
Returns the number of lines of the text in the text frame &quot;name&quot;.
2686
If &quot;name&quot; is not given the currently selected item is used.
2687
</source>
2688
        <translation type="unfinished">getTextLines([&quot;name&quot;]) -&gt; integer
2689
 
2690
Returns the number of lines of the text in the text frame &quot;name&quot;.
2691
If &quot;name&quot; is not given the currently selected item is used.
2692
</translation>
2693
    </message>
2694
    <message>
2695
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="67"/>
2696
        <source>getText([&quot;name&quot;]) -&gt; string
2697
 
2698
Returns the text of the text frame &quot;name&quot;. If this text frame has some text
2699
selected, the selected text is returned. All text in the frame, not just
2700
currently visible text, is returned. If &quot;name&quot; is not given the currently
2701
selected item is used.
2702
</source>
2703
        <translation type="unfinished">getText([&quot;name&quot;]) -&gt; string
2704
 
2705
Returns the text of the text frame &quot;name&quot;. If this text frame has some text
2706
selected, the selected text is returned. All text in the frame, not just
2707
currently visible text, is returned. If &quot;name&quot; is not given the currently
2708
selected item is used.
2709
</translation>
2710
    </message>
2711
    <message>
2712
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="79"/>
2713
        <source>getAllText([&quot;name&quot;]) -&gt; string
2714
 
2715
Returns the text of the text frame &quot;name&quot; and of all text frames which are
2716
linked with this frame. If this textframe has some text selected, the selected
2717
text is returned. If &quot;name&quot; is not given the currently selected item is
2718
used.
2719
</source>
2720
        <translation type="unfinished">getAllText([&quot;name&quot;]) -&gt; string
2721
 
2722
Returns the text of the text frame &quot;name&quot; and of all text frames which are
2723
linked with this frame. If this textframe has some text selected, the selected
2724
text is returned. If &quot;name&quot; is not given the currently selected item is
2725
used.
2726
</translation>
2727
    </message>
2728
    <message>
2729
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="89"/>
2730
        <source>getLineSpacing([&quot;name&quot;]) -&gt; float
2731
 
2732
Returns the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; expressed in
2733
points. If &quot;name&quot; is not given the currently selected item is used.
2734
</source>
2735
        <translation type="unfinished">getLineSpacing([&quot;name&quot;]) -&gt; float
2736
 
2737
Returns the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; expressed in
2738
points. If &quot;name&quot; is not given the currently selected item is used.
2739
</translation>
2740
    </message>
2741
    <message>
2742
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="100"/>
2743
        <source>getTextDistances([&quot;name&quot;]) -&gt; tuple
2744
 
2745
Returns the text distances of the text frame &quot;name&quot; expressed in points. The
2746
distances are returned as a tuple like (left, right, top, bottom). If &quot;name&quot;
2747
is not given the currently selected item is used.
2748
</source>
2749
        <translation type="unfinished">getTextDistances([&quot;name&quot;]) -&gt; tupleReturns the text distances of the text frame &quot;name&quot; expressed in points. Thedistances are returned as a tuple like (left, right, top, bottom). If &quot;name&quot;is not given the currently selected item is used.</translation>
2750
    </message>
2751
    <message>
2752
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="110"/>
2753
        <source>getColumnGap([&quot;name&quot;]) -&gt; float
2754
 
2755
Returns the column gap size of the text frame &quot;name&quot; expressed in points. If
2756
&quot;name&quot; is not given the currently selected item is used.
2757
</source>
2758
        <translation type="unfinished">getColumnGap([&quot;name&quot;]) -&gt; float
2759
 
2760
Returns the column gap size of the text frame &quot;name&quot; expressed in points. If
2761
&quot;name&quot; is not given the currently selected item is used.
2762
</translation>
2763
    </message>
2764
    <message>
2765
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="120"/>
2766
        <source>getColumns([&quot;name&quot;]) -&gt; integer
2767
 
2768
Gets the number of columns of the text frame &quot;name&quot;. If &quot;name&quot; is not
2769
given the currently selected item is used.
2770
</source>
2771
        <translation type="unfinished">getColumns([&quot;name&quot;]) -&gt; integer
2772
 
2773
Gets the number of columns of the text frame &quot;name&quot;. If &quot;name&quot; is not
2774
given the currently selected item is used.
2775
</translation>
2776
    </message>
2777
    <message>
2778
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="132"/>
2779
        <source>setText(&quot;text&quot;, [&quot;name&quot;])
2780
 
2781
Sets the text of the text frame &quot;name&quot; to the text of the string &quot;text&quot;.
2782
Text must be UTF8 encoded - use e.g. unicode(text, &apos;iso-8859-2&apos;). See the FAQ
2783
for more details. If &quot;name&quot; is not given the currently selected item is
2784
used.
2785
</source>
2786
        <translation type="unfinished">setText(&quot;text&quot;, [&quot;name&quot;])
2787
 
2788
Sets the text of the text frame &quot;name&quot; to the text of the string &quot;text&quot;.
2789
Text must be UTF8 encoded - use e.g. unicode(text, &apos;iso-8859-2&apos;). See the FAQ
2790
for more details. If &quot;name&quot; is not given the currently selected item is
2791
used.
2792
</translation>
2793
    </message>
2794
    <message>
2795
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="146"/>
2796
        <source>insertText(&quot;text&quot;, pos, [&quot;name&quot;])
2797
 
2798
Inserts the text &quot;text&quot; at the position &quot;pos&quot; into the text frame &quot;name&quot;.
2799
Text must be UTF encoded (see setText() as reference) The first character has an
2800
index of 0. Inserting text at position -1 appends it to the frame. If &quot;name&quot; is
2801
not given the currently selected Item is used.
2802
 
2803
May throw IndexError for an insertion out of bounds.
2804
</source>
2805
        <translation type="unfinished">insertText(&quot;text&quot;, pos, [&quot;name&quot;])
2806
 
2807
Inserts the text &quot;text&quot; at the position &quot;pos&quot; into the text frame &quot;name&quot;.
2808
Text must be UTF encoded (see setText() as reference) The first character has an
2809
index of 0. Inserting text at position -1 appends it to the frame. If &quot;name&quot; is
2810
not given the currently selected Item is used.
2811
 
2812
May throw IndexError for an insertion out of bounds.
2813
</translation>
2814
    </message>
2815
    <message>
2816
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="159"/>
2817
        <source>setFont(&quot;font&quot;, [&quot;name&quot;])
2818
 
2819
Sets the font of the text frame &quot;name&quot; to &quot;font&quot;. If there is some text
2820
selected only the selected text is changed.  If &quot;name&quot; is not given the
2821
currently selected item is used.
2822
 
2823
May throw ValueError if the font cannot be found.
2824
</source>
2825
        <translation type="unfinished">setFont(&quot;font&quot;, [&quot;name&quot;])
2826
 
2827
Sets the font of the text frame &quot;name&quot; to &quot;font&quot;. If there is some text
2828
selected only the selected text is changed.  If &quot;name&quot; is not given the
2829
currently selected item is used.
2830
 
2831
May throw ValueError if the font cannot be found.
2832
</translation>
2833
    </message>
2834
    <message>
2835
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="173"/>
2836
        <source>setFontSize(size, [&quot;name&quot;])
2837
 
2838
Sets the font size of the text frame &quot;name&quot; to &quot;size&quot;. &quot;size&quot; is treated
2839
as a value in points. If there is some text selected only the selected text is
2840
changed. &quot;size&quot; must be in the range 1 to 512. If &quot;name&quot; is not given the
2841
currently selected item is used.
2842
 
2843
May throw ValueError for a font size that&apos;s out of bounds.
2844
</source>
2845
        <translation type="unfinished">setFontSize(size, [&quot;name&quot;])
2846
 
2847
Sets the font size of the text frame &quot;name&quot; to &quot;size&quot;. &quot;size&quot; is treated
2848
as a value in points. If there is some text selected only the selected text is
2849
changed. &quot;size&quot; must be in the range 1 to 512. If &quot;name&quot; is not given the
2850
currently selected item is used.
2851
 
2852
May throw ValueError for a font size that&apos;s out of bounds.
2853
</translation>
2854
    </message>
2855
    <message>
2856
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="186"/>
2857
        <source>setLineSpacing(size, [&quot;name&quot;])
2858
 
2859
Sets the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; to &quot;size&quot;.
2860
&quot;size&quot; is a value in points. If &quot;name&quot; is not given the currently selected
2861
item is used.
2862
 
2863
May throw ValueError if the line spacing is out of bounds.
2864
</source>
2865
        <translation type="unfinished">setLineSpacing(size, [&quot;name&quot;])
2866
 
2867
Sets the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; to &quot;size&quot;.
2868
&quot;size&quot; is a value in points. If &quot;name&quot; is not given the currently selected
2869
item is used.
2870
 
2871
May throw ValueError if the line spacing is out of bounds.
2872
</translation>
2873
    </message>
2874
    <message>
2875
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="199"/>
2876
        <source>setTextDistances(left, right, top, bottom, [&quot;name&quot;])
2877
 
2878
Sets the text distances of the text frame &quot;name&quot; to the values &quot;left&quot;
2879
&quot;right&quot;, &quot;top&quot; and &quot;bottom&quot;. If &quot;name&quot; is not given the currently
2880
selected item is used.
2881
 
2882
May throw ValueError if any of the distances are out of bounds (must be positive).
2883
</source>
2884
        <translation type="unfinished">setTextDistances(left, right, top, bottom, [&quot;name&quot;])Sets the text distances of the text frame &quot;name&quot; to the values &quot;left&quot;&quot;right&quot;, &quot;top&quot; and &quot;bottom&quot;. If &quot;name&quot; is not given the currentlyselected item is used.May throw ValueError if any of the distances are out of bounds (must be positive).</translation>
2885
    </message>
2886
    <message>
2887
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="211"/>
2888
        <source>setColumnGap(size, [&quot;name&quot;])
2889
 
2890
Sets the column gap of the text frame &quot;name&quot; to the value &quot;size&quot;. If
2891
&quot;name&quot; is not given the currently selected item is used.
2892
 
2893
May throw ValueError if the column gap is out of bounds (must be positive).
2894
</source>
2895
        <translation type="unfinished">setColumnGap(size, [&quot;name&quot;])
2896
 
2897
Sets the column gap of the text frame &quot;name&quot; to the value &quot;size&quot;. If
2898
&quot;name&quot; is not given the currently selected item is used.
2899
 
2900
May throw ValueError if the column gap is out of bounds (must be positive).
2901
</translation>
2902
    </message>
2903
    <message>
2904
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="223"/>
2905
        <source>setColumns(nr, [&quot;name&quot;])
2906
 
2907
Sets the number of columns of the text frame &quot;name&quot; to the integer &quot;nr&quot;.
2908
If &quot;name&quot; is not given the currently selected item is used.
2909
 
2910
May throw ValueError if number of columns is not at least one.
2911
</source>
2912
        <translation type="unfinished">setColumns(nr, [&quot;name&quot;])
2913
 
2914
Sets the number of columns of the text frame &quot;name&quot; to the integer &quot;nr&quot;.
2915
If &quot;name&quot; is not given the currently selected item is used.
2916
 
2917
May throw ValueError if number of columns is not at least one.
2918
</translation>
2919
    </message>
2920
    <message>
2921
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="236"/>
2922
        <source>setTextAlignment(align, [&quot;name&quot;])
2923
 
2924
Sets the text alignment of the text frame &quot;name&quot; to the specified alignment.
2925
If &quot;name&quot; is not given the currently selected item is used. &quot;align&quot; should
2926
be one of the ALIGN_ constants defined in this module - see dir(scribus).
2927
 
2928
May throw ValueError for an invalid alignment constant.
2929
</source>
2930
        <translation type="unfinished">setTextAlignment(align, [&quot;name&quot;])
2931
 
2932
Sets the text alignment of the text frame &quot;name&quot; to the specified alignment.
2933
If &quot;name&quot; is not given the currently selected item is used. &quot;align&quot; should
2934
be one of the ALIGN_ constants defined in this module - see dir(scribus).
2935
 
2936
May throw ValueError for an invalid alignment constant.
2937
</translation>
2938
    </message>
2939
    <message>
2940
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="250"/>
2941
        <source>selectText(start, count, [&quot;name&quot;])
2942
 
2943
Selects &quot;count&quot; characters of text in the text frame &quot;name&quot; starting from the
2944
character &quot;start&quot;. Character counting starts at 0. If &quot;count&quot; is zero, any
2945
text selection will be cleared.  If &quot;name&quot; is not given the currently
2946
selected item is used.
2947
 
2948
May throw IndexError if the selection is outside the bounds of the text.
2949
</source>
2950
        <translation type="unfinished">selectText(start, count, [&quot;name&quot;])
2951
 
2952
Selects &quot;count&quot; characters of text in the text frame &quot;name&quot; starting from the
2953
character &quot;start&quot;. Character counting starts at 0. If &quot;count&quot; is zero, any
2954
text selection will be cleared.  If &quot;name&quot; is not given the currently
2955
selected item is used.
2956
 
2957
May throw IndexError if the selection is outside the bounds of the text.
2958
</translation>
2959
    </message>
2960
    <message>
2961
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="261"/>
2962
        <source>deleteText([&quot;name&quot;])
2963
 
2964
Deletes any text in the text frame &quot;name&quot;. If there is some text selected,
2965
only the selected text will be deleted. If &quot;name&quot; is not given the currently
2966
selected item is used.
2967
</source>
2968
        <translation type="unfinished">deleteText([&quot;name&quot;])
2969
 
2970
Deletes any text in the text frame &quot;name&quot;. If there is some text selected,
2971
only the selected text will be deleted. If &quot;name&quot; is not given the currently
2972
selected item is used.
2973
</translation>
2974
    </message>
2975
    <message>
2976
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="272"/>
2977
        <source>setTextColor(&quot;color&quot;, [&quot;name&quot;])
2978
 
2979
Sets the text color of the text frame &quot;name&quot; to the color &quot;color&quot;. If there
2980
is some text selected only the selected text is changed. If &quot;name&quot; is not
2981
given the currently selected item is used.
2982
</source>
2983
        <translation type="unfinished">setTextColor(&quot;color&quot;, [&quot;name&quot;])
2984
 
2985
Sets the text colour of the text frame &quot;name&quot; to the colour &quot;color&quot;. If there
2986
is some text selected only the selected text is changed. If &quot;name&quot; is not
2987
given the currently selected item is used.
2988
</translation>
2989
    </message>
2990
    <message>
2991
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="282"/>
2992
        <source>setTextStroke(&quot;color&quot;, [&quot;name&quot;])
2993
 
2994
Set &quot;color&quot; of the text stroke. If &quot;name&quot; is not given the currently
2995
selected item is used.
2996
</source>
2997
        <translation type="unfinished">setTextStroke(&quot;color&quot;, [&quot;name&quot;])
2998
 
2999
Set &quot;color&quot; of the text stroke. If &quot;name&quot; is not given the currently
3000
selected item is used.
3001
</translation>
3002
    </message>
3003
    <message>
3004
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="295"/>
3005
        <source>setTextShade(shade, [&quot;name&quot;])
3006
 
3007
Sets the shading of the text color of the object &quot;name&quot; to &quot;shade&quot;. If
3008
there is some text selected only the selected text is changed. &quot;shade&quot; must
3009
be an integer value in the range from 0 (lightest) to 100 (full color
3010
intensity). If &quot;name&quot; is not given the currently selected item is
3011
used.
3012
</source>
3013
        <translation type="unfinished">setTextShade(shade, [&quot;name&quot;])
3014
 
3015
Sets the shading of the text colour of the object &quot;name&quot; to &quot;shade&quot;. If
3016
there is some text selected only the selected text is changed. &quot;shade&quot; must
3017
be an integer value in the range from 0 (lightest) to 100 (full colour
3018
intensity). If &quot;name&quot; is not given the currently selected item is
3019
used.
3020
</translation>
3021
    </message>
3022
    <message>
3023
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="308"/>
3024
        <source>linkTextFrames(&quot;fromname&quot;, &quot;toname&quot;)
3025
 
3026
Link two text frames. The frame named &quot;fromname&quot; is linked to the
3027
frame named &quot;toname&quot;. The target frame must be an empty text frame
3028
and must not link to or be linked from any other frames already.
3029
 
3030
May throw ScribusException if linking rules are violated.
3031
</source>
3032
        <translation type="unfinished">linkTextFrames(&quot;fromname&quot;, &quot;toname&quot;)
3033
 
3034
Link two text frames. The frame named &quot;fromname&quot; is linked to the
3035
frame named &quot;toname&quot;. The target frame must be an empty text frame
3036
and must not link to or be linked from any other frames already.
3037
 
3038
May throw ScribusException if linking rules are violated.
3039
</translation>
3040
    </message>
3041
    <message>
3042
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="325"/>
3043
        <source>unlinkTextFrames(&quot;name&quot;)
3044
 
3045
Remove the specified (named) object from the text frame flow/linkage. If the
3046
frame was in the middle of a chain, the previous and next frames will be
3047
connected, eg &apos;a-&gt;b-&gt;c&apos; becomes &apos;a-&gt;c&apos; when you unlinkTextFrames(b)&apos;
3048
 
3049
May throw ScribusException if linking rules are violated.
3050
</source>
3051
        <translation type="unfinished">unlinkTextFrames(&quot;name&quot;)
3052
 
3053
Remove the specified (named) object from the text frame flow/linkage. If the
3054
frame was in the middle of a chain, the previous and next frames will be
3055
connected, eg &apos;a-&gt;b-&gt;c&apos; becomes &apos;a-&gt;c&apos; when you unlinkTextFrames(b)&apos;
3056
 
3057
May throw ScribusException if linking rules are violated.
3058
</translation>
3059
    </message>
3060
    <message>
3061
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="338"/>
3062
        <source>traceText([&quot;name&quot;])
3063
 
3064
Convert the text frame &quot;name&quot; to outlines. If &quot;name&quot; is not given the
3065
currently selected item is used.</source>
3066
        <translation type="unfinished">traceText([&quot;name&quot;])
3067
 
3068
Convert the text frame &quot;name&quot; to outlines. If &quot;name&quot; is not given the
3069
currently selected item is used.</translation>
3070
    </message>
3071
    <message>
3072
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="352"/>
3073
        <source>textOverflows([&quot;name&quot;, nolinks]) -&gt; integer
3074
 
3075
Returns the actual number of overflowing characters in text frame &quot;name&quot;.
3076
If is nolinks set to non zero value it takes only one frame - it doesn&apos;t
3077
use text frame linking. Without this parameter it search all linking chain.
3078
 
3079
May raise WrongFrameTypeError if the target frame is not an text frame
3080
</source>
3081
        <translation type="unfinished">textOverflows([&quot;name&quot;, nolinks]) -&gt; integer
3082
 
3083
Returns the actual number of overflowing characters in text frame &quot;name&quot;.
3084
If is nolinks set to non zero value it takes only one frame - it doesn&apos;t
3085
use text frame linking. Without this parameter it search all linking chain.
3086
 
3087
May raise WrongFrameTypeError if the target frame is not an text frame
3088
</translation>
3089
    </message>
3090
    <message>
3091
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="365"/>
3092
        <source>hyphenateText([&quot;name&quot;]) -&gt; bool
3093
 
3094
Does hyphenation on text frame &quot;name&quot;.
3095
If &quot;name&quot; is not given the currently selected item is used.
3096
 
3097
May raise WrongFrameTypeError if the target frame is not a text frame
3098
</source>
3099
        <translation type="unfinished">hyphenateText([&quot;name&quot;]) -&gt; boolDoes hyphenation on text frame &quot;name&quot;.If &quot;name&quot; is not given the currently selected item is used.May raise WrongFrameTypeError if the target frame is not a text frame</translation>
3100
    </message>
3101
    <message>
3102
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="379"/>
3103
        <source>dehyphenateText([&quot;name&quot;]) -&gt; bool
3104
 
3105
Does dehyphenation on text frame &quot;name&quot;.
3106
If &quot;name&quot; is not given the currently selected item is used.
3107
 
3108
May raise WrongFrameTypeError if the target frame is not a text frame
3109
</source>
3110
        <translation type="unfinished">dehyphenateText([&quot;name&quot;]) -&gt; boolDoes dehyphenation on text frame &quot;name&quot;.If &quot;name&quot; is not given the currently selected item is used.May raise WrongFrameTypeError if the target frame is not a text frame</translation>
3111
    </message>
3112
    <message>
3113
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="394"/>
3114
        <source>setPDFBookmark(&quot;toggle&quot;, [&quot;name&quot;])
3115
 
3116
Sets whether (toggle = 1) the text frame &quot;name&quot; is a bookmark nor not.
3117
If &quot;name&quot; is not given the currently selected item is used.
3118
 
3119
May raise WrongFrameTypeError if the target frame is not a text frame
3120
</source>
3121
        <translation type="unfinished">setPDFBookmark(&quot;toggle&quot;, [&quot;name&quot;])
3122
 
3123
Sets whether (toggle = 1) the text frame &quot;name&quot; is a bookmark nor not.
3124
If &quot;name&quot; is not given the currently selected item is used.
3125
 
3126
May raise WrongFrameTypeError if the target frame is not a text frame
3127
</translation>
3128
    </message>
3129
    <message>
3130
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="406"/>
3131
        <source>isPDFBookmark([&quot;name&quot;]) -&gt; bool
3132
 
3133
Returns true if the text frame &quot;name&quot; is a PDF bookmark.
3134
If &quot;name&quot; is not given the currently selected item is used.
3135
 
3136
May raise WrongFrameTypeError if the target frame is not a text frame
3137
</source>
3138
        <translation type="unfinished">isPDFBookmark([&quot;name&quot;]) -&gt; bool
3139
 
3140
Returns true if the text frame &quot;name&quot; is a PDF bookmark.
3141
If &quot;name&quot; is not given the currently selected item is used.
3142
 
3143
May raise WrongFrameTypeError if the target frame is not a text frame
3144
</translation>
3145
    </message>
3146
    <message>
3147
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="21"/>
3148
        <source>messagebarText(&quot;string&quot;)
3149
 
3150
Writes the &quot;string&quot; into the Scribus message bar (status line). The text
3151
must be UTF8 encoded or &apos;unicode&apos; string(recommended).
3152
</source>
3153
        <translation type="unfinished">messagebarText(&quot;string&quot;)
3154
 
3155
Writes the &quot;string&quot; into the Scribus message bar (status line). The text
3156
must be UTF8 encoded or &apos;unicode&apos; string(recommended).
3157
</translation>
3158
    </message>
3159
    <message>
3160
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="34"/>
3161
        <source>progressReset()
3162
 
3163
Cleans up the Scribus progress bar previous settings. It is called before the
3164
new progress bar use. See progressSet.
3165
</source>
3166
        <translation type="unfinished">progressReset()
3167
 
3168
Cleans up the Scribus progress bar previous settings. It is called before the
3169
new progress bar use. See progressSet.
3170
</translation>
3171
    </message>
3172
    <message>
3173
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="47"/>
3174
        <source>progressTotal(max)
3175
 
3176
Sets the progress bar&apos;s maximum steps value to the specified number.
3177
See progressSet.
3178
</source>
3179
        <translation type="unfinished">progressTotal(max)
3180
 
3181
Sets the progress bar&apos;s maximum steps value to the specified number.
3182
See progressSet.
3183
</translation>
3184
    </message>
3185
    <message>
3186
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="61"/>
3187
        <source>progressSet(nr)
3188
 
3189
Set the progress bar position to &quot;nr&quot;, a value relative to the previously set
3190
progressTotal. The progress bar uses the concept of steps; you give it the
3191
total number of steps and the number of steps completed so far and it will
3192
display the percentage of steps that have been completed. You can specify the
3193
total number of steps with progressTotal(). The current number of steps is set
3194
with progressSet(). The progress bar can be rewound to the beginning with
3195
progressReset(). [based on info taken from Trolltech&apos;s Qt docs]
3196
</source>
3197
        <translation type="unfinished">progressSet(nr)
3198
 
3199
Set the progress bar position to &quot;nr&quot;, a value relative to the previously set
3200
progressTotal. The progress bar uses the concept of steps; you give it the
3201
total number of steps and the number of steps completed so far and it will
3202
display the percentage of steps that have been completed. You can specify the
3203
total number of steps with progressTotal(). The current number of steps is set
3204
with progressSet(). The progress bar can be rewound to the beginning with
3205
progressReset(). [based on info taken from Trolltech&apos;s Qt docs]
3206
</translation>
3207
    </message>
3208
    <message>
3209
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="69"/>
3210
        <source>setCursor()
3211
 
3212
[UNSUPPORTED!] This might break things, so steer clear for now.
3213
</source>
3214
        <translation type="unfinished">setCursor()
3215
 
3216
[UNSUPPORTED!] This might break things, so steer clear for now.
3217
</translation>
3218
    </message>
3219
    <message>
3220
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="83"/>
3221
        <source>docChanged(bool)
3222
 
3223
Enable/disable save icon in the Scribus icon bar and the Save menu item. It&apos;s
3224
useful to call this procedure when you&apos;re changing the document, because Scribus
3225
won&apos;t automatically notice when you change the document using a script.
3226
</source>
3227
        <translation type="unfinished">docChanged(bool)
3228
 
3229
Enable/disable save icon in the Scribus icon bar and the Save menu item. It&apos;s
3230
useful to call this procedure when you&apos;re changing the document, because Scribus
3231
won&apos;t automatically notice when you change the document using a script.
3232
</translation>
3233
    </message>
3234
    <message>
3235
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="95"/>
3236
        <source>zoomDocument(double)
3237
 
3238
Zoom the document in main GUI window. Actions have whole number
3239
values like 20.0, 100.0, etc. Zoom to Fit uses -100 as a marker.
3240
</source>
3241
        <translation type="unfinished">zoomDocument(double)
3242
 
3243
Zoom the document in main GUI window. Actions have whole number
3244
values like 20.0, 100.0, etc. Zoom to Fit uses -100 as a marker.
3245
</translation>
3246
    </message>
3247
    <message>
3248
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="106"/>
3249
        <source>scrollDocument(x,y)
3250
 
3251
Scroll the document in main GUI window by x and y.
3252
</source>
3253
        <translation type="unfinished">scrollDocument(x,y)Scroll the document in main GUI window by x and y.</translation>
3254
    </message>
3255
    <message>
3256
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="21"/>
3257
        <source>placeSVG(&quot;filename&quot;, x, y)
3258
 
3259
Places the SVG &quot;filename&quot; onto the current page,
3260
x and y specify the coordinate of the topleft corner of the SVG placed on the page
3261
 
3262
If loading was successful, the selection contains the imported SVG
3263
</source>
3264
        <translation type="unfinished">placeSVG(&quot;filename&quot;, x, y)
3265
 
3266
Places the SVG &quot;filename&quot; onto the current page,
3267
x and y specify the coordinate of the topleft corner of the SVG placed on the page
3268
 
3269
If loading was successful, the selection contains the imported SVG
3270
</translation>
3271
    </message>
3272
    <message>
3273
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="33"/>
3274
        <source>placeEPS(&quot;filename&quot;, x, y)
3275
 
3276
Places the EPS &quot;filename&quot; onto the current page,
3277
x and y specify the coordinate of the topleft corner of the EPS placed on the page
3278
 
3279
If loading was successful, the selection contains the imported EPS
3280
</source>
3281
        <translation type="unfinished">placeEPS(&quot;filename&quot;, x, y)
3282
 
3283
Places the EPS &quot;filename&quot; onto the current page,
3284
x and y specify the coordinate of the topleft corner of the EPS placed on the page
3285
 
3286
If loading was successful, the selection contains the imported EPS
3287
</translation>
3288
    </message>
3289
    <message>
3290
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="45"/>
3291
        <source>placeSXD(&quot;filename&quot;, x, y)
3292
 
3293
Places the SXD &quot;filename&quot; onto the current page,
3294
x and y specify the coordinate of the topleft corner of the SXD placed on the page
3295
 
3296
If loading was successful, the selection contains the imported SXD
3297
</source>
3298
        <translation type="unfinished">placeSXD(&quot;filename&quot;, x, y)
3299
 
3300
Places the SXD &quot;filename&quot; onto the current page,
3301
x and y specify the coordinate of the topleft corner of the SXD placed on the page
3302
 
3303
If loading was successful, the selection contains the imported SXD
3304
</translation>
3305
    </message>
3306
    <message>
3307
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="57"/>
3308
        <source>placeODG(&quot;filename&quot;, x, y)
3309
 
3310
Places the ODG &quot;filename&quot; onto the current page,
3311
x and y specify the coordinate of the topleft corner of the ODG placed on the page
3312
 
3313
If loading was successful, the selection contains the imported ODG
3314
</source>
3315
        <translation type="unfinished">placeODG(&quot;filename&quot;, x, y)
3316
 
3317
Places the ODG &quot;filename&quot; onto the current page,
3318
x and y specify the coordinate of the topleft corner of the ODG placed on the page
3319
 
3320
If loading was successful, the selection contains the imported ODG
3321
</translation>
3322
    </message>
3323
</context>
3324
<context>
12281 cbradney 3325
    <name>@default</name>
6773 cbradney 3326
    <message>
12612 cbradney 3327
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="21"/>
10940 cbradney 3328
        <source>getColorNames() -&gt; list
6773 cbradney 3329
 
3330
Returns a list containing the names of all defined colors in the document.
3331
If no document is open, returns a list of the default document colors.
3332
</source>
12918 cbradney 3333
        <translation type="obsolete">getColorNames() -&gt; list
6773 cbradney 3334
 
3335
Returns a list containing the names of all defined colours in the document.
3336
If no document is open, returns a list of the default document colours.
3337
</translation>
3338
    </message>
3339
    <message>
12612 cbradney 3340
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="22"/>
10940 cbradney 3341
        <source>newDocDialog() -&gt; bool
6773 cbradney 3342
 
3343
Displays the &quot;New Document&quot; dialog box. Creates a new document if the user
3344
accepts the settings. Does not create a document if the user presses cancel.
3345
Returns true if a new document was created.
3346
</source>
12918 cbradney 3347
        <translation type="obsolete">newDocDialog() -&gt; bool
6773 cbradney 3348
 
3349
Displays the &quot;New Document&quot; dialog box. Creates a new document if the user
3350
accepts the settings. Does not create a document if the user presses cancel.
3351
Returns true if a new document was created.
3352
</translation>
3353
    </message>
3354
    <message>
12612 cbradney 3355
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="21"/>
10940 cbradney 3356
        <source>getFillColor([&quot;name&quot;]) -&gt; string
6773 cbradney 3357
 
3358
Returns the name of the fill color of the object &quot;name&quot;.
3359
If &quot;name&quot; is not given the currently selected item is used.
3360
</source>
12918 cbradney 3361
        <translation type="obsolete">getFillColor([&quot;name&quot;]) -&gt; string
6773 cbradney 3362
 
3363
Returns the name of the fill colour of the object &quot;name&quot;.
3364
If &quot;name&quot; is not given the currently selected item is used.
3365
</translation>
3366
    </message>
3367
    <message>
12612 cbradney 3368
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="23"/>
10940 cbradney 3369
        <source>moveObject(dx, dy [, &quot;name&quot;])
6773 cbradney 3370
 
3371
Moves the object &quot;name&quot; by dx and dy relative to its current position. The
3372
distances are expressed in the current measurement unit of the document (see
3373
UNIT constants). If &quot;name&quot; is not given the currently selected item is used.
3374
If the object &quot;name&quot; belongs to a group, the whole group is moved.
3375
</source>
12918 cbradney 3376
        <translation type="obsolete">moveObject(dx, dy [, &quot;name&quot;])
6773 cbradney 3377
 
3378
Moves the object &quot;name&quot; by dx and dy relative to its current position. The
3379
distances are expressed in the current measurement unit of the document (see
3380
UNIT constants). If &quot;name&quot; is not given the currently selected item is used.
3381
If the object &quot;name&quot; belongs to a group, the whole group is moved.
3382
</translation>
3383
    </message>
3384
    <message>
12612 cbradney 3385
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="24"/>
10940 cbradney 3386
        <source>setRedraw(bool)
6773 cbradney 3387
 
3388
Disables page redraw when bool = False, otherwise redrawing is enabled.
3389
This change will persist even after the script exits, so make sure to call
3390
setRedraw(True) in a finally: clause at the top level of your script.
3391
</source>
12918 cbradney 3392
        <translation type="obsolete">setRedraw(bool)
6773 cbradney 3393
 
3394
Disables page redraw when bool = False, otherwise redrawing is enabled.
3395
This change will persist even after the script exits, so make sure to call
3396
setRedraw(True) in a finally: clause at the top level of your script.
3397
</translation>
3398
    </message>
3399
    <message>
12612 cbradney 3400
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="26"/>
10940 cbradney 3401
        <source>createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
6773 cbradney 3402
 
3403
Creates a new rectangle on the current page and returns its name. The
3404
coordinates are given in the current measurement units of the document
3405
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
3406
because you need this name to reference that object in future. If &quot;name&quot;
3407
is not given Scribus will create one for you.
3408
 
10940 cbradney 3409
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
6773 cbradney 3410
</source>
12918 cbradney 3411
        <translation type="obsolete">createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
6773 cbradney 3412
 
3413
Creates a new rectangle on the current page and returns its name. The
3414
coordinates are given in the current measurement units of the document
3415
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
3416
because you need this name to reference that object in future. If &quot;name&quot;
3417
is not given Scribus will create one for you.
3418
 
10940 cbradney 3419
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
6773 cbradney 3420
</translation>
3421
    </message>
3422
    <message>
12612 cbradney 3423
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="26"/>
10940 cbradney 3424
        <source>newPage(where [,&quot;masterpage&quot;])
6773 cbradney 3425
 
3426
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
3427
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
3428
counted from 1 upwards, no matter what the displayed first page number of your
3429
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
3430
master page for the new page.
3431
 
3432
May raise IndexError if the page number is out of range
3433
</source>
12918 cbradney 3434
        <translation type="obsolete">newPage(where [,&quot;masterpage&quot;])
6773 cbradney 3435
 
3436
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
3437
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
3438
counted from 1 upwards, no matter what the displayed first page number of your
3439
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
3440
master page for the new page.
3441
 
3442
May raise IndexError if the page number is out of range
3443
</translation>
3444
    </message>
3445
    <message>
12612 cbradney 3446
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="22"/>
10940 cbradney 3447
        <source>setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
6773 cbradney 3448
 
3449
Sets the gradient fill of the object &quot;name&quot; to type. Color descriptions are
3450
the same as for setFillColor() and setFillShade(). See the constants for
10940 cbradney 3451
available types (FILL_&lt;type&gt;).
6773 cbradney 3452
</source>
12918 cbradney 3453
        <translation type="obsolete">setGradientFill(type, &quot;colour1&quot;, shade1, &quot;colour2&quot;, shade2, [&quot;name&quot;])
6773 cbradney 3454
 
3455
Sets the gradient fill of the object &quot;name&quot; to type. Colour descriptions are
3456
the same as for setFillColor() and setFillShade(). See the constants for
10940 cbradney 3457
available types (FILL_&lt;type&gt;).
6773 cbradney 3458
</translation>
3459
    </message>
3460
    <message>
12612 cbradney 3461
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="23"/>
10940 cbradney 3462
        <source>getFontSize([&quot;name&quot;]) -&gt; float
6773 cbradney 3463
 
3464
Returns the font size in points for the text frame &quot;name&quot;. If this text
3465
frame has some text selected the value assigned to the first character of
3466
the selection is returned.
3467
If &quot;name&quot; is not given the currently selected item is used.
3468
</source>
12918 cbradney 3469
        <translation type="obsolete">getFontSize([&quot;name&quot;]) -&gt; float
6773 cbradney 3470
 
3471
Returns the font size in points for the text frame &quot;name&quot;. If this text
3472
frame has some text selected the value assigned to the first character of
3473
the selection is returned.
3474
If &quot;name&quot; is not given the currently selected item is used.
3475
</translation>
3476
    </message>
3477
    <message>
12612 cbradney 3478
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="21"/>
10940 cbradney 3479
        <source>messagebarText(&quot;string&quot;)
6773 cbradney 3480
 
3481
Writes the &quot;string&quot; into the Scribus message bar (status line). The text
10940 cbradney 3482
must be UTF8 encoded or &apos;unicode&apos; string(recommended).
6773 cbradney 3483
</source>
12918 cbradney 3484
        <translation type="obsolete">messagebarText(&quot;string&quot;)
6773 cbradney 3485
 
3486
Writes the &quot;string&quot; into the Scribus message bar (status line). The text
10940 cbradney 3487
must be UTF8 encoded or &apos;unicode&apos; string(recommended).
6773 cbradney 3488
</translation>
3489
    </message>
3490
    <message>
12612 cbradney 3491
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="55"/>
10940 cbradney 3492
        <source>newDocument(size, margins, orientation, firstPageNumber,
3493
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
6773 cbradney 3494
 
3495
Creates a new document and returns true if successful. The parameters have the
3496
following meaning:
3497
 
3498
size = A tuple (width, height) describing the size of the document. You can
10940 cbradney 3499
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
6773 cbradney 3500
 
3501
margins = A tuple (left, right, top, bottom) describing the document
3502
margins
3503
 
3504
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
3505
 
3506
firstPageNumer = is the number of the first page in the document used for
10940 cbradney 3507
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
3508
numbers if you&apos;re creating a document in several parts.
6773 cbradney 3509
 
3510
unit: this value sets the measurement units used by the document. Use a
3511
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
3512
UNIT_PICAS, UNIT_POINTS.
3513
 
3514
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
3515
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
3516
PAGE_4 is 4-fold.
3517
 
3518
firstPageOrder = What is position of first page in the document.
3519
Indexed from 0 (0 = first).
3520
 
3521
numPage = Number of pages to be created.
3522
 
3523
The values for width, height and the margins are expressed in the given unit
3524
for the document. PAPER_* constants are expressed in points. If your document
3525
is not in points, make sure to account for this.
3526
 
3527
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
3528
PAGE_4, 3, 1)
3529
 
3530
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
3531
</source>
12918 cbradney 3532
        <translation type="obsolete">newDocument(size, margins, orientation, firstPageNumber,
10940 cbradney 3533
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
6773 cbradney 3534
 
3535
Creates a new document and returns true if successful. The parameters have the
3536
following meaning:
3537
 
3538
size = A tuple (width, height) describing the size of the document. You can
10940 cbradney 3539
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
6773 cbradney 3540
 
3541
margins = A tuple (left, right, top, bottom) describing the document
3542
margins
3543
 
3544
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
3545
 
3546
firstPageNumer = is the number of the first page in the document used for
10940 cbradney 3547
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
3548
numbers if you&apos;re creating a document in several parts.
6773 cbradney 3549
 
3550
unit: this value sets the measurement units used by the document. Use a
3551
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
3552
UNIT_PICAS, UNIT_POINTS.
3553
 
3554
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
3555
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
3556
PAGE_4 is 4-fold.
3557
 
3558
firstPageOrder = What is position of first page in the document.
3559
Indexed from 0 (0 = first).
3560
 
3561
numPage = Number of pages to be created.
3562
 
3563
The values for width, height and the margins are expressed in the given unit
3564
for the document. PAPER_* constants are expressed in points. If your document
3565
is not in points, make sure to account for this.
3566
 
3567
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
3568
PAGE_4, 3, 1)
3569
 
3570
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
3571
</translation>
3572
    </message>
9729 cbradney 3573
    <message>
12612 cbradney 3574
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="21"/>
10940 cbradney 3575
        <source>placeSVG(&quot;filename&quot;, x, y)
9729 cbradney 3576
 
3577
Places the SVG &quot;filename&quot; onto the current page,
3578
x and y specify the coordinate of the topleft corner of the SVG placed on the page
3579
 
3580
If loading was successful, the selection contains the imported SVG
3581
</source>
12918 cbradney 3582
        <translation type="obsolete">placeSVG(&quot;filename&quot;, x, y)
10874 cbradney 3583
 
3584
Places the SVG &quot;filename&quot; onto the current page,
3585
x and y specify the coordinate of the topleft corner of the SVG placed on the page
3586
 
3587
If loading was successful, the selection contains the imported SVG
3588
</translation>
9729 cbradney 3589
    </message>
6773 cbradney 3590
    <message>
12281 cbradney 3591
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="35"/>
10940 cbradney 3592
        <source>getColor(&quot;name&quot;) -&gt; tuple
6773 cbradney 3593
 
3594
Returns a tuple (C, M, Y, K) containing the four color components of the
3595
color &quot;name&quot; from the current document. If no document is open, returns
3596
the value of the named color from the default document colors.
3597
 
10940 cbradney 3598
May raise NotFoundError if the named color wasn&apos;t found.
6773 cbradney 3599
May raise ValueError if an invalid color name is specified.
3600
</source>
12918 cbradney 3601
        <translation type="obsolete">getColor(&quot;name&quot;) -&gt; tuple
6773 cbradney 3602
 
3603
Returns a tuple (C, M, Y, K) containing the four colour components of the
3604
colour &quot;name&quot; from the current document. If no document is open, returns
3605
the value of the named colour from the default document colours.
3606
 
10940 cbradney 3607
May raise NotFoundError if the named colour wasn&apos;t found.
6773 cbradney 3608
May raise ValueError if an invalid colour name is specified.
3609
</translation>
3610
    </message>
3611
    <message>
12281 cbradney 3612
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="50"/>
10940 cbradney 3613
        <source>getColorAsRGB(&quot;name&quot;) -&gt; tuple
6773 cbradney 3614
 
3615
Returns a tuple (R,G,B) containing the three color components of the
3616
color &quot;name&quot; from the current document, converted to the RGB color
3617
space. If no document is open, returns the value of the named color
3618
from the default document colors.
3619
 
10940 cbradney 3620
May raise NotFoundError if the named color wasn&apos;t found.
6773 cbradney 3621
May raise ValueError if an invalid color name is specified.
3622
</source>
12918 cbradney 3623
        <translation type="obsolete">getColorAsRGB(&quot;name&quot;) -&gt; tuple
6773 cbradney 3624
 
3625
Returns a tuple (R,G,B) containing the three colour components of the
3626
colour &quot;name&quot; from the current document, converted to the RGB colour
3627
space. If no document is open, returns the value of the named colour
3628
from the default document colours.
3629
 
10940 cbradney 3630
May raise NotFoundError if the named colour wasn&apos;t found.
6773 cbradney 3631
May raise ValueError if an invalid colour name is specified.
3632
</translation>
3633
    </message>
3634
    <message>
12281 cbradney 3635
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="64"/>
10940 cbradney 3636
        <source>changeColor(&quot;name&quot;, c, m, y, k)
6773 cbradney 3637
 
3638
Changes the color &quot;name&quot; to the specified CMYK value. The color value is
3639
defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
3640
Color components should be in the range from 0 to 255.
3641
 
10940 cbradney 3642
May raise NotFoundError if the named color wasn&apos;t found.
6773 cbradney 3643
May raise ValueError if an invalid color name is specified.
3644
</source>
12918 cbradney 3645
        <translation type="obsolete">changeColour(&quot;name&quot;, c, m, y, k)
6773 cbradney 3646
 
3647
Changes the colour &quot;name&quot; to the specified CMYK value. The colour value is
3648
defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
3649
Colour components should be in the range from 0 to 255.
3650
 
10940 cbradney 3651
May raise NotFoundError if the named colour wasn&apos;t found.
6773 cbradney 3652
May raise ValueError if an invalid colour name is specified.
3653
</translation>
3654
    </message>
3655
    <message>
12281 cbradney 3656
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="94"/>
10940 cbradney 3657
        <source>deleteColor(&quot;name&quot;, &quot;replace&quot;)
6773 cbradney 3658
 
3659
Deletes the color &quot;name&quot;. Every occurence of that color is replaced by the
3660
color &quot;replace&quot;. If not specified, &quot;replace&quot; defaults to the color
3661
&quot;None&quot; - transparent.
3662
 
3663
deleteColor works on the default document colors if there is no document open.
3664
In that case, &quot;replace&quot;, if specified, has no effect.
3665
 
10940 cbradney 3666
May raise NotFoundError if a named color wasn&apos;t found.
6773 cbradney 3667
May raise ValueError if an invalid color name is specified.
3668
</source>
12918 cbradney 3669
        <translation type="obsolete">deleteColor(&quot;name&quot;, &quot;replace&quot;)
6773 cbradney 3670
 
3671
Deletes the colour &quot;name&quot;. Every occurence of that colour is replaced by the
3672
colour &quot;replace&quot;. If not specified, &quot;replace&quot; defaults to the colour
3673
&quot;None&quot; - transparent.
3674
 
3675
deleteColor works on the default document colours if there is no document open.
3676
In that case, &quot;replace&quot;, if specified, has no effect.
3677
 
10940 cbradney 3678
May raise NotFoundError if a named colour wasn&apos;t found.
6773 cbradney 3679
May raise ValueError if an invalid colour name is specified.
3680
</translation>
3681
    </message>
3682
    <message>
12281 cbradney 3683
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="106"/>
10940 cbradney 3684
        <source>replaceColor(&quot;name&quot;, &quot;replace&quot;)
6773 cbradney 3685
 
3686
Every occurence of the color &quot;name&quot; is replaced by the color &quot;replace&quot;.
3687
 
10940 cbradney 3688
May raise NotFoundError if a named color wasn&apos;t found.
6773 cbradney 3689
May raise ValueError if an invalid color name is specified.
3690
</source>
12918 cbradney 3691
        <translation type="obsolete">replaceColor(&quot;name&quot;, &quot;replace&quot;)
6773 cbradney 3692
 
3693
Every occurence of the colour &quot;name&quot; is replaced by the colour &quot;replace&quot;.
3694
 
10940 cbradney 3695
May raise NotFoundError if a named colour wasn&apos;t found.
6773 cbradney 3696
May raise ValueError if an invalid colour name is specified.
3697
</translation>
3698
    </message>
3699
    <message>
12281 cbradney 3700
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="88"/>
10940 cbradney 3701
        <source>messageBox(&quot;caption&quot;, &quot;message&quot;,
6773 cbradney 3702
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
10940 cbradney 3703
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
6773 cbradney 3704
 
3705
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
3706
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
3707
button, OK, is displayed. Only the caption and message arguments are required,
3708
though setting an icon and appropriate button(s) is strongly
3709
recommended. The message text may contain simple HTML-like markup.
3710
 
3711
Returns the number of the button the user pressed. Button numbers start
3712
at 1.
3713
 
3714
For the icon and the button parameters there are predefined constants available
3715
with the same names as in the Qt Documentation. These are the BUTTON_* and
3716
ICON_* constants defined in the module. There are also two extra constants that
3717
can be binary-ORed with button constants:
3718
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
3719
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
3720
 
3721
Usage examples:
10940 cbradney 3722
result = messageBox(&apos;Script failed&apos;,
3723
                    &apos;This script only works when you have a text frame selected.&apos;,
6773 cbradney 3724
                    ICON_ERROR)
10940 cbradney 3725
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
6773 cbradney 3726
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
3727
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
3728
 
3729
Defined button and icon constants:
3730
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
3731
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
3732
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
3733
</source>
12918 cbradney 3734
        <translation type="obsolete">messageBox(&quot;caption&quot;, &quot;message&quot;,
6773 cbradney 3735
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
10940 cbradney 3736
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
6773 cbradney 3737
 
3738
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
3739
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
3740
button, OK, is displayed. Only the caption and message arguments are required,
3741
though setting an icon and appropriate button(s) is strongly
3742
recommended. The message text may contain simple HTML-like markup.
3743
 
3744
Returns the number of the button the user pressed. Button numbers start
3745
at 1.
3746
 
3747
For the icon and the button parameters there are predefined constants available
3748
with the same names as in the Qt Documentation. These are the BUTTON_* and
3749
ICON_* constants defined in the module. There are also two extra constants that
3750
can be binary-ORed with button constants:
3751
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
3752
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
3753
 
3754
Usage examples:
10940 cbradney 3755
result = messageBox(&apos;Script failed&apos;,
3756
                    &apos;This script only works when you have a text frame selected.&apos;,
6773 cbradney 3757
                    ICON_ERROR)
10940 cbradney 3758
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
6773 cbradney 3759
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
3760
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
3761
 
3762
Defined button and icon constants:
3763
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
3764
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
3765
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
3766
</translation>
3767
    </message>
3768
    <message>
12281 cbradney 3769
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="101"/>
10940 cbradney 3770
        <source>valueDialog(caption, message [,defaultvalue]) -&gt; string
6773 cbradney 3771
 
10940 cbradney 3772
Shows the common &apos;Ask for string&apos; dialog and returns its value as a string
3773
Parameters: window title, text in the window and optional &apos;default&apos; value.
6773 cbradney 3774
 
10940 cbradney 3775
Example: valueDialog(&apos;title&apos;, &apos;text in the window&apos;, &apos;optional&apos;)
6773 cbradney 3776
</source>
12918 cbradney 3777
        <translation type="obsolete">valueDialog(caption, message [,defaultvalue]) -&gt; string
6773 cbradney 3778
 
10940 cbradney 3779
Shows the common &apos;Ask for string&apos; dialog and returns its value as a string
3780
Parameters: window title, text in the window and optional &apos;default&apos; value.
6773 cbradney 3781
 
10940 cbradney 3782
Example: valueDialog(&apos;title&apos;, &apos;text in the window&apos;, &apos;optional&apos;)
6773 cbradney 3783
</translation>
3784
    </message>
3785
    <message>
12281 cbradney 3786
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="108"/>
10940 cbradney 3787
        <source>closeDoc()
6773 cbradney 3788
 
3789
Closes the current document without prompting to save.
3790
 
3791
May throw NoDocOpenError if there is no document to close
3792
</source>
12918 cbradney 3793
        <translation type="obsolete">closeDoc()
6773 cbradney 3794
 
3795
Closes the current document without prompting to save.
3796
 
3797
May throw NoDocOpenError if there is no document to close
3798
</translation>
3799
    </message>
3800
    <message>
12281 cbradney 3801
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="117"/>
10940 cbradney 3802
        <source>haveDoc() -&gt; bool
6773 cbradney 3803
 
3804
Returns true if there is a document open.
3805
</source>
12918 cbradney 3806
        <translation type="obsolete">haveDoc() -&gt; bool
6773 cbradney 3807
 
3808
Returns true if there is a document open.
3809
</translation>
3810
    </message>
3811
    <message>
12281 cbradney 3812
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="128"/>
10940 cbradney 3813
        <source>openDoc(&quot;name&quot;)
6773 cbradney 3814
 
3815
Opens the document &quot;name&quot;.
3816
 
3817
May raise ScribusError if the document could not be opened.
3818
</source>
12918 cbradney 3819
        <translation type="obsolete">openDoc(&quot;name&quot;)
6773 cbradney 3820
 
3821
Opens the document &quot;name&quot;.
3822
 
3823
May raise ScribusError if the document could not be opened.
3824
</translation>
3825
    </message>
3826
    <message>
12281 cbradney 3827
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="141"/>
10940 cbradney 3828
        <source>saveDoc()
6773 cbradney 3829
 
3830
Saves the current document with its current name, returns true if successful.
3831
If the document has not already been saved, this may bring up an interactive
3832
save file dialog.
3833
 
3834
If the save fails, there is currently no way to tell.
3835
</source>
12918 cbradney 3836
        <translation type="obsolete">saveDoc()
6773 cbradney 3837
 
3838
Saves the current document with its current name, returns true if successful.
3839
If the document has not already been saved, this may bring up an interactive
3840
save file dialog.
3841
 
3842
If the save fails, there is currently no way to tell.
3843
</translation>
3844
    </message>
3845
    <message>
12281 cbradney 3846
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="152"/>
10940 cbradney 3847
        <source>saveDocAs(&quot;name&quot;)
6773 cbradney 3848
 
3849
Saves the current document under the new name &quot;name&quot; (which may be a full or
3850
relative path).
3851
 
3852
May raise ScribusError if the save fails.
3853
</source>
12918 cbradney 3854
        <translation type="obsolete">saveDocAs(&quot;name&quot;)
6773 cbradney 3855
 
3856
Saves the current document under the new name &quot;name&quot; (which may be a full or
3857
relative path).
3858
 
3859
May raise ScribusError if the save fails.
3860
</translation>
3861
    </message>
3862
    <message>
12281 cbradney 3863
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="185"/>
10940 cbradney 3864
        <source>setUnit(type)
6773 cbradney 3865
 
3866
Changes the measurement unit of the document. Possible values for &quot;unit&quot; are
10940 cbradney 3867
defined as constants UNIT_&lt;type&gt;.
6773 cbradney 3868
 
3869
May raise ValueError if an invalid unit is passed.
3870
</source>
12918 cbradney 3871
        <translation type="obsolete">setUnit(type)
6773 cbradney 3872
 
3873
Changes the measurement unit of the document. Possible values for &quot;unit&quot; are
10940 cbradney 3874
defined as constants UNIT_&lt;type&gt;.
6773 cbradney 3875
 
3876
May raise ValueError if an invalid unit is passed.
3877
</translation>
3878
    </message>
3879
    <message>
12281 cbradney 3880
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="196"/>
10940 cbradney 3881
        <source>getUnit() -&gt; integer (Scribus unit constant)
6773 cbradney 3882
 
3883
Returns the measurement units of the document. The returned value will be one
3884
of the UNIT_* constants:
3885
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
3886
</source>
12918 cbradney 3887
        <translation type="obsolete">getUnit() -&gt; integer (Scribus unit constant)
6773 cbradney 3888
 
3889
Returns the measurement units of the document. The returned value will be one
3890
of the UNIT_* constants:
3891
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
3892
</translation>
3893
    </message>
3894
    <message>
12281 cbradney 3895
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="206"/>
10940 cbradney 3896
        <source>loadStylesFromFile(&quot;filename&quot;)
6773 cbradney 3897
 
3898
Loads paragraph styles from the Scribus document at &quot;filename&quot; into the
3899
current document.
3900
</source>
12918 cbradney 3901
        <translation type="obsolete">loadStylesFromFile(&quot;filename&quot;)
6773 cbradney 3902
 
3903
Loads paragraph styles from the Scribus document at &quot;filename&quot; into the
3904
current document.
3905
</translation>
3906
    </message>
3907
    <message>
12281 cbradney 3908
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="218"/>
10940 cbradney 3909
        <source>setDocType(facingPages, firstPageLeft)
6773 cbradney 3910
 
3911
Sets the document type. To get facing pages set the first parameter to
3912
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
3913
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
3914
a right page use FIRSTPAGERIGHT.
3915
</source>
12918 cbradney 3916
        <translation type="obsolete">setDocType(facingPages, firstPageLeft)
6773 cbradney 3917
 
3918
Sets the document type. To get facing pages set the first parameter to
3919
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
3920
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
3921
a right page use FIRSTPAGERIGHT.
3922
</translation>
3923
    </message>
3924
    <message>
12281 cbradney 3925
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="51"/>
10940 cbradney 3926
        <source>getLineColor([&quot;name&quot;]) -&gt; string
6773 cbradney 3927
 
3928
Returns the name of the line color of the object &quot;name&quot;.
3929
If &quot;name&quot; is not given the currently selected item is used.
3930
</source>
12918 cbradney 3931
        <translation type="obsolete">getLineColor([&quot;name&quot;]) -&gt; string
6773 cbradney 3932
 
3933
Returns the name of the line colour of the object &quot;name&quot;.
3934
If &quot;name&quot; is not given the currently selected item is used.
3935
</translation>
3936
    </message>
3937
    <message>
12281 cbradney 3938
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="81"/>
10940 cbradney 3939
        <source>getLineWidth([&quot;name&quot;]) -&gt; integer
6773 cbradney 3940
 
3941
Returns the line width of the object &quot;name&quot;. If &quot;name&quot;
3942
is not given the currently selected Item is used.
3943
</source>
12918 cbradney 3944
        <translation type="obsolete">getLineWidth([&quot;name&quot;]) -&gt; integer
6773 cbradney 3945
 
3946
Returns the line width of the object &quot;name&quot;. If &quot;name&quot;
3947
is not given the currently selected Item is used.
3948
</translation>
3949
    </message>
3950
    <message>
12281 cbradney 3951
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="91"/>
10940 cbradney 3952
        <source>getLineShade([&quot;name&quot;]) -&gt; integer
6773 cbradney 3953
 
3954
Returns the shading value of the line color of the object &quot;name&quot;.
3955
If &quot;name&quot; is not given the currently selected item is used.
3956
</source>
12918 cbradney 3957
        <translation type="obsolete">getLineShade([&quot;name&quot;]) -&gt; integer
6773 cbradney 3958
 
3959
Returns the shading value of the line colour of the object &quot;name&quot;.
3960
If &quot;name&quot; is not given the currently selected item is used.
3961
</translation>
3962
    </message>
3963
    <message>
12281 cbradney 3964
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="113"/>
10940 cbradney 3965
        <source>getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
6773 cbradney 3966
 
3967
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3968
currently selected item is used. The cap types are:
3969
CAP_FLAT, CAP_ROUND, CAP_SQUARE
3970
</source>
12918 cbradney 3971
        <translation type="obsolete">getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
6773 cbradney 3972
 
3973
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3974
currently selected item is used. The cap types are:
3975
CAP_FLAT, CAP_ROUND, CAP_SQUARE
3976
</translation>
3977
    </message>
3978
    <message>
12281 cbradney 3979
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="124"/>
10940 cbradney 3980
        <source>getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
6773 cbradney 3981
 
3982
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3983
currently selected item is used. Line style constants are:
3984
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
3985
</source>
12918 cbradney 3986
        <translation type="obsolete">getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
6773 cbradney 3987
 
3988
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3989
currently selected item is used. Line style constants are:
3990
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
3991
</translation>
3992
    </message>
3993
    <message>
12281 cbradney 3994
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="134"/>
10940 cbradney 3995
        <source>getFillShade([&quot;name&quot;]) -&gt; integer
6773 cbradney 3996
 
3997
Returns the shading value of the fill color of the object &quot;name&quot;.
3998
If &quot;name&quot; is not given the currently selected item is used.
3999
</source>
12918 cbradney 4000
        <translation type="obsolete">getFillShade([&quot;name&quot;]) -&gt; integer
6773 cbradney 4001
 
4002
Returns the shading value of the fill colour of the object &quot;name&quot;.
4003
If &quot;name&quot; is not given the currently selected item is used.
4004
</translation>
4005
    </message>
4006
    <message>
12281 cbradney 4007
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="155"/>
10940 cbradney 4008
        <source>getImageScale([&quot;name&quot;]) -&gt; (x,y)
6773 cbradney 4009
 
4010
Returns a (x, y) tuple containing the scaling values of the image frame
4011
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
4012
</source>
12918 cbradney 4013
        <translation type="obsolete">getImageScale([&quot;name&quot;]) -&gt; (x,y)
6773 cbradney 4014
 
4015
Returns a (x, y) tuple containing the scaling values of the image frame
4016
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
4017
</translation>
4018
    </message>
4019
    <message>
12281 cbradney 4020
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="165"/>
10940 cbradney 4021
        <source>getImageName([&quot;name&quot;]) -&gt; string
6773 cbradney 4022
 
4023
Returns the filename for the image in the image frame. If &quot;name&quot; is not
4024
given the currently selected item is used.
4025
</source>
12918 cbradney 4026
        <translation type="obsolete">getImageName([&quot;name&quot;]) -&gt; string
6773 cbradney 4027
 
4028
Returns the filename for the image in the image frame. If &quot;name&quot; is not
4029
given the currently selected item is used.
4030
</translation>
4031
    </message>
4032
    <message>
12281 cbradney 4033
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="189"/>
10940 cbradney 4034
        <source>getSize([&quot;name&quot;]) -&gt; (width,height)
6773 cbradney 4035
 
4036
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
4037
If &quot;name&quot; is not given the currently selected item is used. The size is
10940 cbradney 4038
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
6773 cbradney 4039
for reference.
4040
</source>
12918 cbradney 4041
        <translation type="obsolete">getSize([&quot;name&quot;]) -&gt; (width,height)
6773 cbradney 4042
 
4043
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
4044
If &quot;name&quot; is not given the currently selected item is used. The size is
10940 cbradney 4045
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
6773 cbradney 4046
for reference.
4047
</translation>
4048
    </message>
4049
    <message>
12281 cbradney 4050
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="200"/>
10940 cbradney 4051
        <source>getRotation([&quot;name&quot;]) -&gt; integer
6773 cbradney 4052
 
4053
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
4054
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
4055
is used.
4056
</source>
12918 cbradney 4057
        <translation type="obsolete">getRotation([&quot;name&quot;]) -&gt; integer
6773 cbradney 4058
 
4059
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
4060
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
4061
is used.
4062
</translation>
4063
    </message>
4064
    <message>
12281 cbradney 4065
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="209"/>
10940 cbradney 4066
        <source>getAllObjects() -&gt; list
6773 cbradney 4067
 
4068
Returns a list containing the names of all objects on the current page.
4069
</source>
12918 cbradney 4070
        <translation type="obsolete">getAllObjects() -&gt; list
6773 cbradney 4071
 
4072
Returns a list containing the names of all objects on the current page.
4073
</translation>
4074
    </message>
4075
    <message>
12281 cbradney 4076
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="83"/>
10940 cbradney 4077
        <source>getPropertyCType(object, property, includesuper=True)
6773 cbradney 4078
 
10940 cbradney 4079
Returns the name of the C type of `property&apos; of `object&apos;. See getProperty()
6773 cbradney 4080
for details of arguments.
4081
 
10940 cbradney 4082
If `includesuper&apos; is true, search inherited properties too.
6773 cbradney 4083
</source>
12918 cbradney 4084
        <translation type="obsolete">getPropertyCType(object, property, includesuper=True)
6773 cbradney 4085
 
10940 cbradney 4086
Returns the name of the C type of `property&apos; of `object&apos;. See getProperty()
6773 cbradney 4087
for details of arguments.
4088
 
10940 cbradney 4089
If `includesuper&apos; is true, search inherited properties too.
6773 cbradney 4090
</translation>
4091
    </message>
4092
    <message>
12281 cbradney 4093
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="101"/>
10940 cbradney 4094
        <source>getPropertyNames(object, includesuper=True)
6773 cbradney 4095
 
10940 cbradney 4096
Return a list of property names supported by `object&apos;.
4097
If `includesuper&apos; is true, return properties supported
6773 cbradney 4098
by parent classes as well.
4099
</source>
12918 cbradney 4100
        <translation type="obsolete">getPropertyNames(object, includesuper=True)
6773 cbradney 4101
 
10940 cbradney 4102
Return a list of property names supported by `object&apos;.
4103
If `includesuper&apos; is true, return properties supported
6773 cbradney 4104
by parent classes as well.
4105
</translation>
4106
    </message>
4107
    <message>
12281 cbradney 4108
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="135"/>
10940 cbradney 4109
        <source>getProperty(object, property)
6773 cbradney 4110
 
10940 cbradney 4111
Return the value of the property `property&apos; of the passed `object&apos;.
6773 cbradney 4112
 
10940 cbradney 4113
The `object&apos; argument may be a string, in which case the named PageItem
6773 cbradney 4114
is searched for. It may also be a PyCObject, which may point to any
4115
C++ QObject instance.
4116
 
10940 cbradney 4117
The `property&apos; argument must be a string, and is the name of the property
4118
to look up on `object&apos;.
6773 cbradney 4119
 
4120
The return value varies depending on the type of the property.
4121
</source>
12918 cbradney 4122
        <translation type="obsolete">getProperty(object, property)
6773 cbradney 4123
 
10940 cbradney 4124
Return the value of the property `property&apos; of the passed `object&apos;.
6773 cbradney 4125
 
10940 cbradney 4126
The `object&apos; argument may be a string, in which case the named PageItem
6773 cbradney 4127
is searched for. It may also be a PyCObject, which may point to any
4128
C++ QObject instance.
4129
 
10940 cbradney 4130
The `property&apos; argument must be a string, and is the name of the property
4131
to look up on `object&apos;.
6773 cbradney 4132
 
4133
The return value varies depending on the type of the property.
4134
</translation>
4135
    </message>
4136
    <message>
12281 cbradney 4137
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="165"/>
10940 cbradney 4138
        <source>setProperty(object, property, value)
6773 cbradney 4139
 
10940 cbradney 4140
Set `property&apos; of `object&apos; to `value&apos;. If `value&apos; cannot be converted to a type
4141
compatible with the type of `property&apos;, an exception is raised. An exception may
6773 cbradney 4142
also be raised if the underlying setter fails.
4143
 
4144
See getProperty() for more information.
4145
</source>
12918 cbradney 4146
        <translation type="obsolete">setProperty(object, property, value)
6773 cbradney 4147
 
10940 cbradney 4148
Set `property&apos; of `object&apos; to `value&apos;. If `value&apos; cannot be converted to a type
4149
compatible with the type of `property&apos;, an exception is raised. An exception may
6773 cbradney 4150
also be raised if the underlying setter fails.
4151
 
4152
See getProperty() for more information.
4153
</translation>
4154
    </message>
4155
    <message>
12281 cbradney 4156
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="35"/>
10940 cbradney 4157
        <source>moveObjectAbs(x, y [, &quot;name&quot;])
6773 cbradney 4158
 
4159
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
4160
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
4161
is not given the currently selected item is used.  If the object &quot;name&quot;
4162
belongs to a group, the whole group is moved.
4163
</source>
12918 cbradney 4164
        <translation type="obsolete">moveObjectAbs(x, y [, &quot;name&quot;])
6773 cbradney 4165
 
4166
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
4167
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
4168
is not given the currently selected item is used.  If the object &quot;name&quot;
4169
belongs to a group, the whole group is moved.
4170
</translation>
4171
    </message>
4172
    <message>
12281 cbradney 4173
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="69"/>
10940 cbradney 4174
        <source>sizeObject(width, height [, &quot;name&quot;])
6773 cbradney 4175
 
4176
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
4177
is not given the currently selected item is used.
4178
</source>
12918 cbradney 4179
        <translation type="obsolete">sizeObject(width, height [, &quot;name&quot;])
6773 cbradney 4180
 
4181
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
4182
is not given the currently selected item is used.
4183
</translation>
4184
    </message>
4185
    <message>
12281 cbradney 4186
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="80"/>
10940 cbradney 4187
        <source>getSelectedObject([nr]) -&gt; string
6773 cbradney 4188
 
4189
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
4190
of the selected object, e.g. 0 means the first selected object, 1 means the
4191
second selected Object and so on.
4192
</source>
12918 cbradney 4193
        <translation type="obsolete">getSelectedObject([nr]) -&gt; string
6773 cbradney 4194
 
4195
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
4196
of the selected object, e.g. 0 means the first selected object, 1 means the
4197
second selected Object and so on.
4198
</translation>
4199
    </message>
4200
    <message>
12281 cbradney 4201
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="89"/>
10940 cbradney 4202
        <source>selectionCount() -&gt; integer
6773 cbradney 4203
 
4204
Returns the number of selected objects.
4205
</source>
12918 cbradney 4206
        <translation type="obsolete">selectionCount() -&gt; integer
6773 cbradney 4207
 
4208
Returns the number of selected objects.
4209
</translation>
4210
    </message>
4211
    <message>
12281 cbradney 4212
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="98"/>
10940 cbradney 4213
        <source>selectObject(&quot;name&quot;)
6773 cbradney 4214
 
4215
Selects the object with the given &quot;name&quot;.
4216
</source>
12918 cbradney 4217
        <translation type="obsolete">selectObject(&quot;name&quot;)
6773 cbradney 4218
 
4219
Selects the object with the given &quot;name&quot;.
4220
</translation>
4221
    </message>
4222
    <message>
12281 cbradney 4223
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="107"/>
10940 cbradney 4224
        <source>deselectAll()
6773 cbradney 4225
 
4226
Deselects all objects in the whole document.
4227
</source>
12918 cbradney 4228
        <translation type="obsolete">deselectAll()
6773 cbradney 4229
 
4230
Deselects all objects in the whole document.
4231
</translation>
4232
    </message>
4233
    <message>
12281 cbradney 4234
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="118"/>
10940 cbradney 4235
        <source>groupObjects(list)
6773 cbradney 4236
 
4237
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
4238
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
4239
items are used.
4240
</source>
12918 cbradney 4241
        <translation type="obsolete">groupObjects(list)
6773 cbradney 4242
 
4243
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
4244
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
4245
items are used.
4246
</translation>
4247
    </message>
4248
    <message>
12281 cbradney 4249
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="126"/>
10940 cbradney 4250
        <source>unGroupObjects(&quot;name&quot;)
6773 cbradney 4251
 
4252
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.</source>
12918 cbradney 4253
        <translation type="obsolete">unGroupObjects(&quot;name&quot;)
6773 cbradney 4254
 
4255
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.</translation>
4256
    </message>
4257
    <message>
12281 cbradney 4258
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="141"/>
10940 cbradney 4259
        <source>scaleGroup(factor [,&quot;name&quot;])
6773 cbradney 4260
 
4261
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
4262
the group, values smaller than 1 make the group smaller e.g a value of 0.5
4263
scales the group to 50 % of its original size, a value of 1.5 scales the group
4264
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
4265
0. If &quot;name&quot; is not given the currently selected item is used.
4266
 
4267
May raise ValueError if an invalid scale factor is passed.
4268
</source>
12918 cbradney 4269
        <translation type="obsolete">scaleGroup(factor [,&quot;name&quot;])
6773 cbradney 4270
 
4271
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
4272
the group, values smaller than 1 make the group smaller e.g a value of 0.5
4273
scales the group to 50 % of its original size, a value of 1.5 scales the group
4274
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
4275
0. If &quot;name&quot; is not given the currently selected item is used.
4276
 
4277
May raise ValueError if an invalid scale factor is passed.
4278
</translation>
4279
    </message>
4280
    <message>
12281 cbradney