Subversion Repositories Scribus

Rev

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

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