"SfR Fresh" - the SfR Freeware/Shareware Archive 
Member "scribus-1.3.3.12/scribus/po/scribus.sk_SK.ts" of archive scribus-1.3.3.12.tar.gz:
As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers.
Alternatively you can here view or download the uninterpreted source code file.
That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
1 <!DOCTYPE TS><TS>
2 <context>
3 <name></name>
4 <message>
5 <source>getColorNames() -> list
6
7 Returns a list containing the names of all defined colors in the document.
8 If no document is open, returns a list of the default document colors.
9 </source>
10 <translation type="unfinished"></translation>
11 </message>
12 <message>
13 <source>newDocDialog() -> bool
14
15 Displays the "New Document" dialog box. Creates a new document if the user
16 accepts the settings. Does not create a document if the user presses cancel.
17 Returns true if a new document was created.
18 </source>
19 <translation type="unfinished"></translation>
20 </message>
21 <message>
22 <source>getFillColor(["name"]) -> string
23
24 Returns the name of the fill color of the object "name".
25 If "name" is not given the currently selected item is used.
26 </source>
27 <translation type="unfinished"></translation>
28 </message>
29 <message>
30 <source>moveObject(dx, dy [, "name"])
31
32 Moves the object "name" by dx and dy relative to its current position. The
33 distances are expressed in the current measurement unit of the document (see
34 UNIT constants). If "name" is not given the currently selected item is used.
35 If the object "name" belongs to a group, the whole group is moved.
36 </source>
37 <translation type="unfinished"></translation>
38 </message>
39 <message>
40 <source>setRedraw(bool)
41
42 Disables page redraw when bool = False, otherwise redrawing is enabled.
43 This change will persist even after the script exits, so make sure to call
44 setRedraw(True) in a finally: clause at the top level of your script.
45 </source>
46 <translation type="unfinished"></translation>
47 </message>
48 <message>
49 <source>createRect(x, y, width, height, ["name"]) -> string
50
51 Creates a new rectangle on the current page and returns its name. The
52 coordinates are given in the current measurement units of the document
53 (see UNIT constants). "name" should be a unique identifier for the object
54 because you need this name to reference that object in future. If "name"
55 is not given Scribus will create one for you.
56
57 May raise NameExistsError if you explicitly pass a name that's already used.
58 </source>
59 <translation type="unfinished"></translation>
60 </message>
61 <message>
62 <source>newPage(where [,"masterpage"])
63
64 Creates a new page. If "where" is -1 the new Page is appended to the
65 document, otherwise the new page is inserted before "where". Page numbers are
66 counted from 1 upwards, no matter what the displayed first page number of your
67 document is. The optional parameter "masterpage" specifies the name of the
68 master page for the new page.
69
70 May raise IndexError if the page number is out of range
71 </source>
72 <translation type="unfinished"></translation>
73 </message>
74 <message>
75 <source>setGradientFill(type, "color1", shade1, "color2", shade2, ["name"])
76
77 Sets the gradient fill of the object "name" to type. Color descriptions are
78 the same as for setFillColor() and setFillShade(). See the constants for
79 available types (FILL_<type>).
80 </source>
81 <translation type="unfinished"></translation>
82 </message>
83 <message>
84 <source>getFontSize(["name"]) -> float
85
86 Returns the font size in points for the text frame "name". If this text
87 frame has some text selected the value assigned to the first character of
88 the selection is returned.
89 If "name" is not given the currently selected item is used.
90 </source>
91 <translation type="unfinished"></translation>
92 </message>
93 <message>
94 <source>messagebarText("string")
95
96 Writes the "string" into the Scribus message bar (status line). The text
97 must be UTF8 encoded or 'unicode' string(recommended).
98 </source>
99 <translation type="unfinished"></translation>
100 </message>
101 <message>
102 <source>importSVG("string")
103
104 The "string" must be a valid filename for a SVG image. The text
105 must be UTF8 encoded or 'unicode' string(recommended).
106 </source>
107 <translation type="unfinished"></translation>
108 </message>
109 <message>
110 <source>newDocument(size, margins, orientation, firstPageNumber,
111 unit, pagesType, firstPageOrder) -> bool
112
113 Creates a new document and returns true if successful. The parameters have the
114 following meaning:
115
116 size = A tuple (width, height) describing the size of the document. You can
117 use predefined constants named PAPER_<paper_type> e.g. PAPER_A4 etc.
118
119 margins = A tuple (left, right, top, bottom) describing the document
120 margins
121
122 orientation = the page orientation - constants PORTRAIT, LANDSCAPE
123
124 firstPageNumer = is the number of the first page in the document used for
125 pagenumbering. While you'll usually want 1, it's useful to have higher
126 numbers if you're creating a document in several parts.
127
128 unit: this value sets the measurement units used by the document. Use a
129 predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
130 UNIT_PICAS, UNIT_POINTS.
131
132 pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
133 PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
134 PAGE_4 is 4-fold.
135
136 firstPageOrder = What is position of first page in the document.
137 Indexed from 0 (0 = first).
138
139 numPage = Number of pages to be created.
140
141 The values for width, height and the margins are expressed in the given unit
142 for the document. PAPER_* constants are expressed in points. If your document
143 is not in points, make sure to account for this.
144
145 example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
146 PAGE_4, 3, 1)
147
148 May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
149 </source>
150 <translation type="unfinished"></translation>
151 </message>
152 </context>
153 <context>
154 <name>@default</name>
155 <message>
156 <source>getColor("name") -> tuple
157
158 Returns a tuple (C, M, Y, K) containing the four color components of the
159 color "name" from the current document. If no document is open, returns
160 the value of the named color from the default document colors.
161
162 May raise NotFoundError if the named color wasn't found.
163 May raise ValueError if an invalid color name is specified.
164 </source>
165 <translation type="unfinished"></translation>
166 </message>
167 <message>
168 <source>getColorAsRGB("name") -> tuple
169
170 Returns a tuple (R,G,B) containing the three color components of the
171 color "name" from the current document, converted to the RGB color
172 space. If no document is open, returns the value of the named color
173 from the default document colors.
174
175 May raise NotFoundError if the named color wasn't found.
176 May raise ValueError if an invalid color name is specified.
177 </source>
178 <translation type="unfinished"></translation>
179 </message>
180 <message>
181 <source>changeColor("name", c, m, y, k)
182
183 Changes the color "name" to the specified CMYK value. The color value is
184 defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
185 Color components should be in the range from 0 to 255.
186
187 May raise NotFoundError if the named color wasn't found.
188 May raise ValueError if an invalid color name is specified.
189 </source>
190 <translation type="unfinished"></translation>
191 </message>
192 <message>
193 <source>defineColor("name", c, m, y, k)
194
195 Defines a new color "name". The color Value is defined via four components:
196 c = Cyan, m = Magenta, y = Yello and k = Black. Color components should be in
197 the range from 0 to 255.
198
199 May raise ValueError if an invalid color name is specified.
200 </source>
201 <translation type="unfinished"></translation>
202 </message>
203 <message>
204 <source>deleteColor("name", "replace")
205
206 Deletes the color "name". Every occurence of that color is replaced by the
207 color "replace". If not specified, "replace" defaults to the color
208 "None" - transparent.
209
210 deleteColor works on the default document colors if there is no document open.
211 In that case, "replace", if specified, has no effect.
212
213 May raise NotFoundError if a named color wasn't found.
214 May raise ValueError if an invalid color name is specified.
215 </source>
216 <translation type="unfinished"></translation>
217 </message>
218 <message>
219 <source>replaceColor("name", "replace")
220
221 Every occurence of the color "name" is replaced by the color "replace".
222
223 May raise NotFoundError if a named color wasn't found.
224 May raise ValueError if an invalid color name is specified.
225 </source>
226 <translation type="unfinished"></translation>
227 </message>
228 <message>
229 <source>fileDialog("caption", ["filter", "defaultname", haspreview, issave, isdir]) -> string with filename
230
231 Shows a File Open dialog box with the caption "caption". Files are filtered
232 with the filter string "filter". A default filename or file path can also
233 supplied, leave this string empty when you don't want to use it. A value of
234 True for haspreview enables a small preview widget in the FileSelect box. When
235 the issave parameter is set to True the dialog acts like a "Save As" dialog
236 otherwise it acts like a "File Open Dialog". When the isdir parameter is True
237 the dialog shows and returns only directories. The default for all of the
238 opional parameters is False.
239
240 The filter, if specified, takes the form 'comment (*.type *.type2 ...)'.
241 For example 'Images (*.png *.xpm *.jpg)'.
242
243 Refer to the Qt-Documentation for QFileDialog for details on filters.
244
245 Example: fileDialog('Open input', 'CSV files (*.csv)')
246 Example: fileDialog('Save report', defaultname='report.txt', issave=True)
247 </source>
248 <translation type="unfinished"></translation>
249 </message>
250 <message>
251 <source>messageBox("caption", "message",
252 icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
253 button2=BUTTON_NONE, button3=BUTTON_NONE) -> integer
254
255 Displays a message box with the title "caption", the message "message", and
256 an icon "icon" and up to 3 buttons. By default no icon is used and a single
257 button, OK, is displayed. Only the caption and message arguments are required,
258 though setting an icon and appropriate button(s) is strongly
259 recommended. The message text may contain simple HTML-like markup.
260
261 Returns the number of the button the user pressed. Button numbers start
262 at 1.
263
264 For the icon and the button parameters there are predefined constants available
265 with the same names as in the Qt Documentation. These are the BUTTON_* and
266 ICON_* constants defined in the module. There are also two extra constants that
267 can be binary-ORed with button constants:
268 BUTTONOPT_DEFAULT Pressing enter presses this button.
269 BUTTONOPT_ESCAPE Pressing escape presses this button.
270
271 Usage examples:
272 result = messageBox('Script failed',
273 'This script only works when you have a text frame selected.',
274 ICON_ERROR)
275 result = messageBox('Monkeys!', 'Something went ook! <i>Was it a monkey?</i>',
276 ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
277 BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
278
279 Defined button and icon constants:
280 BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
281 BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
282 ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
283 </source>
284 <translation type="unfinished"></translation>
285 </message>
286 <message>
287 <source>valueDialog(caption, message [,defaultvalue]) -> string
288
289 Shows the common 'Ask for string' dialog and returns its value as a string
290 Parameters: window title, text in the window and optional 'default' value.
291
292 Example: valueDialog('title', 'text in the window', 'optional')
293 </source>
294 <translation type="unfinished"></translation>
295 </message>
296 <message>
297 <source>newStyleDialog() -> string
298
299 Shows 'Create new paragraph style' dialog. Function returns real
300 style name or None when user cancels the dialog.
301 </source>
302 <translation type="unfinished"></translation>
303 </message>
304 <message>
305 <source>closeDoc()
306
307 Closes the current document without prompting to save.
308
309 May throw NoDocOpenError if there is no document to close
310 </source>
311 <translation type="unfinished"></translation>
312 </message>
313 <message>
314 <source>haveDoc() -> bool
315
316 Returns true if there is a document open.
317 </source>
318 <translation type="unfinished"></translation>
319 </message>
320 <message>
321 <source>openDoc("name")
322
323 Opens the document "name".
324
325 May raise ScribusError if the document could not be opened.
326 </source>
327 <translation type="unfinished"></translation>
328 </message>
329 <message>
330 <source>saveDoc()
331
332 Saves the current document with its current name, returns true if successful.
333 If the document has not already been saved, this may bring up an interactive
334 save file dialog.
335
336 If the save fails, there is currently no way to tell.
337 </source>
338 <translation type="unfinished"></translation>
339 </message>
340 <message>
341 <source>saveDocAs("name")
342
343 Saves the current document under the new name "name" (which may be a full or
344 relative path).
345
346 May raise ScribusError if the save fails.
347 </source>
348 <translation type="unfinished"></translation>
349 </message>
350 <message>
351 <source>setMargins(lr, rr, tr, br)
352
353 Sets the margins of the document, Left(lr), Right(rr), Top(tr) and Bottom(br)
354 margins are given in the measurement units of the document - see UNIT_<type>
355 constants.
356 </source>
357 <translation type="unfinished"></translation>
358 </message>
359 <message>
360 <source>setUnit(type)
361
362 Changes the measurement unit of the document. Possible values for "unit" are
363 defined as constants UNIT_<type>.
364
365 May raise ValueError if an invalid unit is passed.
366 </source>
367 <translation type="unfinished"></translation>
368 </message>
369 <message>
370 <source>getUnit() -> integer (Scribus unit constant)
371
372 Returns the measurement units of the document. The returned value will be one
373 of the UNIT_* constants:
374 UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
375 </source>
376 <translation type="unfinished"></translation>
377 </message>
378 <message>
379 <source>loadStylesFromFile("filename")
380
381 Loads paragraph styles from the Scribus document at "filename" into the
382 current document.
383 </source>
384 <translation type="unfinished"></translation>
385 </message>
386 <message>
387 <source>setDocType(facingPages, firstPageLeft)
388
389 Sets the document type. To get facing pages set the first parameter to
390 FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead. If you want
391 to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
392 a right page use FIRSTPAGERIGHT.
393 </source>
394 <translation type="unfinished"></translation>
395 </message>
396 <message>
397 <source>getLineColor(["name"]) -> string
398
399 Returns the name of the line color of the object "name".
400 If "name" is not given the currently selected item is used.
401 </source>
402 <translation type="unfinished"></translation>
403 </message>
404 <message>
405 <source>getLineWidth(["name"]) -> integer
406
407 Returns the line width of the object "name". If "name"
408 is not given the currently selected Item is used.
409 </source>
410 <translation type="unfinished"></translation>
411 </message>
412 <message>
413 <source>getLineShade(["name"]) -> integer
414
415 Returns the shading value of the line color of the object "name".
416 If "name" is not given the currently selected item is used.
417 </source>
418 <translation type="unfinished"></translation>
419 </message>
420 <message>
421 <source>getLineJoin(["name"]) -> integer (see contants)
422
423 Returns the line join style of the object "name". If "name" is not given
424 the currently selected item is used. The join types are:
425 JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND
426 </source>
427 <translation type="unfinished"></translation>
428 </message>
429 <message>
430 <source>getLineEnd(["name"]) -> integer (see constants)
431
432 Returns the line cap style of the object "name". If "name" is not given the
433 currently selected item is used. The cap types are:
434 CAP_FLAT, CAP_ROUND, CAP_SQUARE
435 </source>
436 <translation type="unfinished"></translation>
437 </message>
438 <message>
439 <source>getLineStyle(["name"]) -> integer (see constants)
440
441 Returns the line style of the object "name". If "name" is not given the
442 currently selected item is used. Line style constants are:
443 LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
444 </source>
445 <translation type="unfinished"></translation>
446 </message>
447 <message>
448 <source>getFillShade(["name"]) -> integer
449
450 Returns the shading value of the fill color of the object "name".
451 If "name" is not given the currently selected item is used.
452 </source>
453 <translation type="unfinished"></translation>
454 </message>
455 <message>
456 <source>getCornerRadius(["name"]) -> integer
457
458 Returns the corner radius of the object "name". The radius isexpressed in points. If "name" is not given the currentlyselected item is used.
459 </source>
460 <translation type="unfinished"></translation>
461 </message>
462 <message>
463 <source>getImageScale(["name"]) -> (x,y)
464
465 Returns a (x, y) tuple containing the scaling values of the image frame
466 "name". If "name" is not given the currently selected item is used.
467 </source>
468 <translation type="unfinished"></translation>
469 </message>
470 <message>
471 <source>getImageName(["name"]) -> string
472
473 Returns the filename for the image in the image frame. If "name" is not
474 given the currently selected item is used.
475 </source>
476 <translation type="unfinished"></translation>
477 </message>
478 <message>
479 <source>getPosition(["name"]) -> (x,y)
480
481 Returns a (x, y) tuple with the position of the object "name".
482 If "name" is not given the currently selected item is used.The position is expressed in the actual measurement unit of the document
483 - see UNIT_<type> for reference.
484 </source>
485 <translation type="unfinished"></translation>
486 </message>
487 <message>
488 <source>getSize(["name"]) -> (width,height)
489
490 Returns a (width, height) tuple with the size of the object "name".
491 If "name" is not given the currently selected item is used. The size is
492 expressed in the current measurement unit of the document - see UNIT_<type>
493 for reference.
494 </source>
495 <translation type="unfinished"></translation>
496 </message>
497 <message>
498 <source>getRotation(["name"]) -> integer
499
500 Returns the rotation of the object "name". The value is expressed in degrees,
501 and clockwise is positive. If "name" is not given the currently selected item
502 is used.
503 </source>
504 <translation type="unfinished"></translation>
505 </message>
506 <message>
507 <source>getAllObjects() -> list
508
509 Returns a list containing the names of all objects on the current page.
510 </source>
511 <translation type="unfinished"></translation>
512 </message>
513 <message>
514 <source>getPropertyCType(object, property, includesuper=True)
515
516 Returns the name of the C type of `property' of `object'. See getProperty()
517 for details of arguments.
518
519 If `includesuper' is true, search inherited properties too.
520 </source>
521 <translation type="unfinished"></translation>
522 </message>
523 <message>
524 <source>getPropertyNames(object, includesuper=True)
525
526 Return a list of property names supported by `object'.
527 If `includesuper' is true, return properties supported
528 by parent classes as well.
529 </source>
530 <translation type="unfinished"></translation>
531 </message>
532 <message>
533 <source>getProperty(object, property)
534
535 Return the value of the property `property' of the passed `object'.
536
537 The `object' argument may be a string, in which case the named PageItem
538 is searched for. It may also be a PyCObject, which may point to any
539 C++ QObject instance.
540
541 The `property' argument must be a string, and is the name of the property
542 to look up on `object'.
543
544 The return value varies depending on the type of the property.
545 </source>
546 <translation type="unfinished"></translation>
547 </message>
548 <message>
549 <source>setProperty(object, property, value)
550
551 Set `property' of `object' to `value'. If `value' cannot be converted to a type
552 compatible with the type of `property', an exception is raised. An exception may
553 also be raised if the underlying setter fails.
554
555 See getProperty() for more information.
556 </source>
557 <translation type="unfinished"></translation>
558 </message>
559 <message>
560 <source>getChildren(object, ofclass=None, ofname=None, regexpmatch=False, recursive=True)
561
562 Return a list of children of `object', possibly restricted to children
563 of class named `ofclass' or children named `ofname'. If `recursive' is true,
564 search recursively through children, grandchildren, etc.
565
566 See QObject::children() in the Qt docs for more information.
567 </source>
568 <translation type="unfinished"></translation>
569 </message>
570 <message>
571 <source>getChild(object, childname, ofclass=None, recursive=True)
572
573 Return the first child of `object' named `childname', possibly restricting
574 the search to children of type name `ofclass'. If `recursive' is true,
575 search recursively through children, grandchildren, etc.
576 </source>
577 <translation type="unfinished"></translation>
578 </message>
579 <message>
580 <source>moveObjectAbs(x, y [, "name"])
581
582 Moves the object "name" to a new location. The coordinates are expressed in
583 the current measurement unit of the document (see UNIT constants). If "name"
584 is not given the currently selected item is used. If the object "name"
585 belongs to a group, the whole group is moved.
586 </source>
587 <translation type="unfinished"></translation>
588 </message>
589 <message>
590 <source>rotateObject(rot [, "name"])
591
592 Rotates the object "name" by "rot" degrees relatively. The object is
593 rotated by the vertex that is currently selected as the rotation point - by
594 default, the top left vertext at zero rotation. Positive values mean counter
595 clockwise rotation when the default rotation point is used. If "name" is not
596 given the currently selected item is used.
597 </source>
598 <translation type="unfinished"></translation>
599 </message>
600 <message>
601 <source>rotateObjectAbs(rot [, "name"])
602
603 Sets the rotation of the object "name" to "rot". Positve values
604 mean counter clockwise rotation. If "name" is not given the currently
605 selected item is used.
606 </source>
607 <translation type="unfinished"></translation>
608 </message>
609 <message>
610 <source>sizeObject(width, height [, "name"])
611
612 Resizes the object "name" to the given width and height. If "name"
613 is not given the currently selected item is used.
614 </source>
615 <translation type="unfinished"></translation>
616 </message>
617 <message>
618 <source>getSelectedObject([nr]) -> string
619
620 Returns the name of the selected object. "nr" if given indicates the number
621 of the selected object, e.g. 0 means the first selected object, 1 means the
622 second selected Object and so on.
623 </source>
624 <translation type="unfinished"></translation>
625 </message>
626 <message>
627 <source>selectionCount() -> integer
628
629 Returns the number of selected objects.
630 </source>
631 <translation type="unfinished"></translation>
632 </message>
633 <message>
634 <source>selectObject("name")
635
636 Selects the object with the given "name".
637 </source>
638 <translation type="unfinished"></translation>
639 </message>
640 <message>
641 <source>deselectAll()
642
643 Deselects all objects in the whole document.
644 </source>
645 <translation type="unfinished"></translation>
646 </message>
647 <message>
648 <source>groupObjects(list)
649
650 Groups the objects named in "list" together. "list" must contain the names
651 of the objects to be grouped. If "list" is not given the currently selected
652 items are used.
653 </source>
654 <translation type="unfinished"></translation>
655 </message>
656 <message>
657 <source>unGroupObjects("name")
658
659 Destructs the group the object "name" belongs to.If "name" is not given the currently selected item is used.</source>
660 <translation type="unfinished"></translation>
661 </message>
662 <message>
663 <source>scaleGroup(factor [,"name"])
664
665 Scales the group the object "name" belongs to. Values greater than 1 enlarge
666 the group, values smaller than 1 make the group smaller e.g a value of 0.5
667 scales the group to 50 % of its original size, a value of 1.5 scales the group
668 to 150 % of its original size. The value for "factor" must be greater than
669 0. If "name" is not given the currently selected item is used.
670
671 May raise ValueError if an invalid scale factor is passed.
672 </source>
673 <translation type="unfinished"></translation>
674 </message>
675 <message>
676 <source>loadImage("filename" [, "name"])
677
678 Loads the picture "picture" into the image frame "name". If "name" is
679 not given the currently selected item is used.
680
681 May raise WrongFrameTypeError if the target frame is not an image frame
682 </source>
683 <translation type="unfinished"></translation>
684 </message>
685 <message>
686 <source>scaleImage(x, y [, "name"])
687
688 Sets the scaling factors of the picture in the image frame "name".
689 If "name" is not given the currently selected item is used. A number of 1
690 means 100 %.
691
692 May raise WrongFrameTypeError if the target frame is not an image frame
693 </source>
694 <translation type="unfinished"></translation>
695 </message>
696 <message>
697 <source>lockObject(["name"]) -> bool
698
699 Locks the object "name" if it's unlocked or unlock it if it's locked.
700 If "name" is not given the currently selected item is used. Returns true
701 if locked.
702 </source>
703 <translation type="unfinished"></translation>
704 </message>
705 <message>
706 <source>isLocked(["name"]) -> bool
707
708 Returns true if is the object "name" locked. If "name" is not given the
709 currently selected item is used.
710 </source>
711 <translation type="unfinished"></translation>
712 </message>
713 <message>
714 <source>setScaleImageToFrame(scaletoframe, proportional=None, name=<selection>)
715
716 Sets the scale to frame on the selected or specified image frame to `scaletoframe'.
717 If `proportional' is specified, set fixed aspect ratio scaling to `proportional'.
718 Both `scaletoframe' and `proportional' are boolean.
719
720 May raise WrongFrameTypeError.
721 </source>
722 <translation type="unfinished"></translation>
723 </message>
724 <message>
725 <source>getFontNames() -> list
726
727 Returns a list with the names of all available fonts.
728 </source>
729 <translation type="unfinished"></translation>
730 </message>
731 <message>
732 <source>getXFontNames() -> list of tuples
733
734 Returns a larger font info. It's a list of the tuples with:
735 [ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
736 </source>
737 <translation type="unfinished"></translation>
738 </message>
739 <message>
740 <source>renderFont("name", "filename", "sample", size, format="PPM") -> bool
741
742 Creates an image preview of font "name" with given text "sample" and size.
743 If "filename" is not "", image is saved into "filename". Otherwise
744 image data is returned as a string. The optional "format" argument
745 specifies the image format to generate, and supports any format allowed
746 by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
747
748 May raise NotFoundError if the specified font can't be found.
749 May raise ValueError if an empty sample or filename is passed.
750 </source>
751 <translation type="unfinished"></translation>
752 </message>
753 <message>
754 <source>getLayers() -> list
755
756 Returns a list with the names of all defined layers.
757 </source>
758 <translation type="unfinished"></translation>
759 </message>
760 <message>
761 <source>setActiveLayer("name")
762
763 Sets the active layer to the layer named "name".
764
765 May raise NotFoundError if the layer can't be found.
766 May raise ValueError if the layer name isn't acceptable.
767 </source>
768 <translation type="unfinished"></translation>
769 </message>
770 <message>
771 <source>getActiveLayer() -> string
772
773 Returns the name of the current active layer.
774 </source>
775 <translation type="unfinished"></translation>
776 </message>
777 <message>
778 <source>sentToLayer("layer" [, "name"])
779
780 Sends the object "name" to the layer "layer". The layer must exist.
781 If "name" is not given the currently selected item is used.
782
783 May raise NotFoundError if the layer can't be found.
784 May raise ValueError if the layer name isn't acceptable.
785 </source>
786 <translation type="unfinished"></translation>
787 </message>
788 <message>
789 <source>setLayerVisible("layer", visible)
790
791 Sets the layer "layer" to be visible or not. If is the visible set to false
792 the layer is invisible.
793
794 May raise NotFoundError if the layer can't be found.
795 May raise ValueError if the layer name isn't acceptable.
796 </source>
797 <translation type="unfinished"></translation>
798 </message>
799 <message>
800 <source>setLayerPrintable("layer", printable)
801
802 Sets the layer "layer" to be printable or not. If is the printable set to
803 false the layer won't be printed.
804
805 May raise NotFoundError if the layer can't be found.
806 May raise ValueError if the layer name isn't acceptable.
807 </source>
808 <translation type="unfinished"></translation>
809 </message>
810 <message>
811 <source>isLayerPrintable("layer") -> bool
812
813 Returns whether the layer "layer" is visible or not, a value of True means
814 that the layer "layer" is visible, a value of False means that the layer
815 "layer" is invisible.
816
817 May raise NotFoundError if the layer can't be found.
818 May raise ValueError if the layer name isn't acceptable.
819 </source>
820 <translation type="unfinished"></translation>
821 </message>
822 <message>
823 <source>isLayerPrintable("layer") -> bool
824
825 Returns whether the layer "layer" is printable or not, a value of True means
826 that the layer "layer" can be printed, a value of False means that printing
827 the layer "layer" is disabled.
828
829 May raise NotFoundError if the layer can't be found.
830 May raise ValueError if the layer name isn't acceptable.
831 </source>
832 <translation type="unfinished"></translation>
833 </message>
834 <message>
835 <source>deleteLayer("layer")
836
837 Deletes the layer with the name "layer". Nothing happens if the layer doesn't
838 exists or if it's the only layer in the document.
839
840 May raise NotFoundError if the layer can't be found.
841 May raise ValueError if the layer name isn't acceptable.
842 </source>
843 <translation type="unfinished"></translation>
844 </message>
845 <message>
846 <source>createLayer(layer)
847
848 Creates a new layer with the name "name".
849
850 May raise ValueError if the layer name isn't acceptable.
851 </source>
852 <translation type="unfinished"></translation>
853 </message>
854 <message>
855 <source>getGuiLanguage() -> string
856
857 Returns a string with the -lang value.
858 </source>
859 <translation type="unfinished"></translation>
860 </message>
861 <message>
862 <source>createEllipse(x, y, width, height, ["name"]) -> string
863
864 Creates a new ellipse on the current page and returns its name.
865 The coordinates are given in the current measurement units of the document
866 (see UNIT constants). "name" should be a unique identifier for the object
867 because you need this name for further referencing of that object. If "name"
868 is not given Scribus will create one for you.
869
870 May raise NameExistsError if you explicitly pass a name that's already used.
871 </source>
872 <translation type="unfinished"></translation>
873 </message>
874 <message>
875 <source>createImage(x, y, width, height, ["name"]) -> string
876
877 Creates a new picture frame on the current page and returns its name. The
878 coordinates are given in the current measurement units of the document.
879 "name" should be a unique identifier for the object because you need this
880 name for further access to that object. If "name" is not given Scribus will
881 create one for you.
882
883 May raise NameExistsError if you explicitly pass a name that's already used.
884 </source>
885 <translation type="unfinished"></translation>
886 </message>
887 <message>
888 <source>createText(x, y, width, height, ["name"]) -> string
889
890 Creates a new text frame on the actual page and returns its name.
891 The coordinates are given in the actual measurement unit of the document (see
892 UNIT constants). "name" should be a unique identifier for the object because
893 you need this name for further referencing of that object. If "name" is not
894 given Scribus will create one for you.
895
896 May raise NameExistsError if you explicitly pass a name that's already used.
897 </source>
898 <translation type="unfinished"></translation>
899 </message>
900 <message>
901 <source>createLine(x1, y1, x2, y2, ["name"]) -> string
902
903 Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
904 its name. The coordinates are given in the current measurement unit of the
905 document (see UNIT constants). "name" should be a unique identifier for the
906 object because you need this name for further access to that object. If
907 "name" is not given Scribus will create one for you.
908
909 May raise NameExistsError if you explicitly pass a name that's already used.
910 </source>
911 <translation type="unfinished"></translation>
912 </message>
913 <message>
914 <source>createPolyLine(list, ["name"]) -> string
915
916 Creates a new polyline and returns its name. The points for the polyline are
917 stored in the list "list" in the following order: [x1, y1, x2, y2...xn. yn].
918 The coordinates are given in the current measurement units of the document (see
919 UNIT constants). "name" should be a unique identifier for the object because
920 you need this name for further access to that object. If "name" is not given
921 Scribus will create one for you.
922
923 May raise NameExistsError if you explicitly pass a name that's already used.
924 May raise ValueError if an insufficient number of points is passed or if
925 the number of values passed don't group into points without leftovers.
926 </source>
927 <translation type="unfinished"></translation>
928 </message>
929 <message>
930 <source>createPolygon(list, ["name"]) -> string
931
932 Creates a new polygon and returns its name. The points for the polygon are
933 stored in the list "list" in the following order: [x1, y1, x2, y2...xn. yn].
934 At least three points are required. There is no need to repeat the first point
935 to close the polygon. The polygon is automatically closed by connecting the
936 first and the last point. The coordinates are given in the current measurement
937 units of the document (see UNIT constants). "name" should be a unique
938 identifier for the object because you need this name for further access to that
939 object. If "name" is not given Scribus will create one for you.
940
941 May raise NameExistsError if you explicitly pass a name that's already used.
942 May raise ValueError if an insufficient number of points is passed or if
943 the number of values passed don't group into points without leftovers.
944 </source>
945 <translation type="unfinished"></translation>
946 </message>
947 <message>
948 <source>createBezierLine(list, ["name"]) -> string
949
950 Creates a new bezier curve and returns its name. The points for the bezier
951 curve are stored in the list "list" in the following order:
952 [x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
953 In the points list, x and y mean the x and y coordinates of the point and kx
954 and ky meaning the control point for the curve. The coordinates are given in
955 the current measurement units of the document (see UNIT constants). "name"
956 should be a unique identifier for the object because you need this name for
957 further access to that object. If "name" is not given Scribus will create one
958 for you.
959
960 May raise NameExistsError if you explicitly pass a name that's already used.
961 May raise ValueError if an insufficient number of points is passed or if
962 the number of values passed don't group into points without leftovers.
963 </source>
964 <translation type="unfinished"></translation>
965 </message>
966 <message>
967 <source>createPathText(x, y, "textbox", "beziercurve", ["name"]) -> string
968
969 Creates a new pathText by merging the two objects "textbox" and
970 "beziercurve" and returns its name. The coordinates are given in the current
971 measurement unit of the document (see UNIT constants). "name" should be a
972 unique identifier for the object because you need this name for further access
973 to that object. If "name" is not given Scribus will create one for you.
974
975 May raise NameExistsError if you explicitly pass a name that's already used.
976 May raise NotFoundError if one or both of the named base object don't exist.
977 </source>
978 <translation type="unfinished"></translation>
979 </message>
980 <message>
981 <source>deleteObject(["name"])
982
983 Deletes the item with the name "name". If "name" is not given the currently
984 selected item is deleted.
985 </source>
986 <translation type="unfinished"></translation>
987 </message>
988 <message>
989 <source>textFlowsAroundFrame("name" [, state])
990
991 Enables/disables "Text Flows Around Frame" feature for object "name".
992 Called with parameters string name and optional boolean "state". If "state"
993 is not passed, text flow is toggled.
994 </source>
995 <translation type="unfinished"></translation>
996 </message>
997 <message>
998 <source>objectExists(["name"]) -> bool
999
1000 Test if an object with specified name really exists in the document.
1001 The optional parameter is the object name. When no object name is given,
1002 returns True if there is something selected.
1003 </source>
1004 <translation type="unfinished"></translation>
1005 </message>
1006 <message>
1007 <source>setStyle("style" [, "name"])
1008
1009 Apply the named "style" to the object named "name". If is no object name
1010 given, it's applied on the selected object.
1011 </source>
1012 <translation type="unfinished"></translation>
1013 </message>
1014 <message>
1015 <source>getAllStyles() -> list
1016
1017 Return a list of the names of all paragraph styles in the current document.
1018 </source>
1019 <translation type="unfinished"></translation>
1020 </message>
1021 <message>
1022 <source>currentPage() -> integer
1023
1024 Returns the number of the current working page. Page numbers are counted from 1
1025 upwards, no matter what the displayed first page number of your document is.
1026 </source>
1027 <translation type="unfinished"></translation>
1028 </message>
1029 <message>
1030 <source>redrawAll()
1031
1032 Redraws all pages.
1033 </source>
1034 <translation type="unfinished"></translation>
1035 </message>
1036 <message>
1037 <source>savePageAsEPS("name")
1038
1039 Saves the current page as an EPS to the file "name".
1040
1041 May raise ScribusError if the save failed.
1042 </source>
1043 <translation type="unfinished"></translation>
1044 </message>
1045 <message>
1046 <source>deletePage(nr)
1047
1048 Deletes the given page. Does nothing if the document contains only one page.
1049 Page numbers are counted from 1 upwards, no matter what the displayed first
1050 page number is.
1051
1052 May raise IndexError if the page number is out of range
1053 </source>
1054 <translation type="unfinished"></translation>
1055 </message>
1056 <message>
1057 <source>gotoPage(nr)
1058
1059 Moves to the page "nr" (that is, makes the current page "nr"). Note that
1060 gotoPage doesn't (curently) change the page the user's view is displaying, it
1061 just sets the page that script commands will operates on.
1062
1063 May raise IndexError if the page number is out of range.
1064 </source>
1065 <translation type="unfinished"></translation>
1066 </message>
1067 <message>
1068 <source>pageCount() -> integer
1069
1070 Returns the number of pages in the document.
1071 </source>
1072 <translation type="unfinished"></translation>
1073 </message>
1074 <message>
1075 <source>getHGuides() -> list
1076
1077 Returns a list containing positions of the horizontal guides. Values are in the
1078 document's current units - see UNIT_<type> constants.
1079 </source>
1080 <translation type="unfinished"></translation>
1081 </message>
1082 <message>
1083 <source>setHGuides(list)
1084
1085 Sets horizontal guides. Input parameter must be a list of guide positions
1086 measured in the current document units - see UNIT_<type> constants.
1087
1088 Example: setHGuides(getHGuides() + [200.0, 210.0] # add new guides without any lost
1089 setHGuides([90,250]) # replace current guides entirely
1090 </source>
1091 <translation type="unfinished"></translation>
1092 </message>
1093 <message>
1094 <source>getVGuides()
1095
1096 See getHGuides.
1097 </source>
1098 <translation type="unfinished"></translation>
1099 </message>
1100 <message>
1101 <source>setVGuides()
1102
1103 See setHGuides.
1104 </source>
1105 <translation type="unfinished"></translation>
1106 </message>
1107 <message>
1108 <source>getPageSize() -> tuple
1109
1110 Returns a tuple with page dimensions measured in the document's current units.
1111 See UNIT_<type> constants and getPageMargins()
1112 </source>
1113 <translation type="unfinished"></translation>
1114 </message>
1115 <message>
1116 <source>getPageItems() -> list
1117
1118 Returns a list of tuples with items on the current page. The tuple is:
1119 (name, objectType, order) E.g. [('Text1', 4, 0), ('Image1', 2, 1)]
1120 means that object named 'Text1' is a text frame (type 4) and is the first at
1121 the page...
1122 </source>
1123 <translation type="unfinished"></translation>
1124 </message>
1125 <message>
1126 <source>getPageMargins()
1127
1128 Returns the page margins as a (top, left, right, bottom) tuple in the current
1129 units. See UNIT_<type> constants and getPageSize().
1130 </source>
1131 <translation type="unfinished"></translation>
1132 </message>
1133 <message>
1134 <source>setFillColor("color", ["name"])
1135
1136 Sets the fill color of the object "name" to the color "color". "color"
1137 is the name of one of the defined colors. If "name" is not given the
1138 currently selected item is used.
1139 </source>
1140 <translation type="unfinished"></translation>
1141 </message>
1142 <message>
1143 <source>setLineColor("color", ["name"])
1144
1145 Sets the line color of the object "name" to the color "color". If "name"
1146 is not given the currently selected item is used.
1147 </source>
1148 <translation type="unfinished"></translation>
1149 </message>
1150 <message>
1151 <source>setLineWidth(width, ["name"])
1152
1153 Sets line width of the object "name" to "width". "width" must be in the
1154 range from 0.0 to 12.0 inclusive, and is measured in points. If "name" is not
1155 given the currently selected item is used.
1156
1157 May raise ValueError if the line width is out of bounds.
1158 </source>
1159 <translation type="unfinished"></translation>
1160 </message>
1161 <message>
1162 <source>setLineShade(shade, ["name"])
1163
1164 Sets the shading of the line color of the object "name" to "shade".
1165 "shade" must be an integer value in the range from 0 (lightest) to 100
1166 (full color intensity). If "name" is not given the currently selected item
1167 is used.
1168
1169 May raise ValueError if the line shade is out of bounds.
1170 </source>
1171 <translation type="unfinished"></translation>
1172 </message>
1173 <message>
1174 <source>setLineJoin(join, ["name"])
1175
1176 Sets the line join style of the object "name" to the style "join".
1177 If "name" is not given the currently selected item is used. There are
1178 predefined constants for join - JOIN_<type>.
1179 </source>
1180 <translation type="unfinished"></translation>
1181 </message>
1182 <message>
1183 <source>setLineEnd(endtype, ["name"])
1184
1185 Sets the line cap style of the object "name" to the style "cap".
1186 If "name" is not given the currently selected item is used. There are
1187 predefined constants for "cap" - CAP_<type>.
1188 </source>
1189 <translation type="unfinished"></translation>
1190 </message>
1191 <message>
1192 <source>setLineStyle(style, ["name"])
1193
1194 Sets the line style of the object "name" to the style "style". If "name"
1195 is not given the currently selected item is used. There are predefined
1196 constants for "style" - LINE_<style>.
1197 </source>
1198 <translation type="unfinished"></translation>
1199 </message>
1200 <message>
1201 <source>setFillShade(shade, ["name"])
1202
1203 Sets the shading of the fill color of the object "name" to "shade".
1204 "shade" must be an integer value in the range from 0 (lightest) to 100
1205 (full Color intensity). If "name" is not given the currently selected
1206 Item is used.
1207
1208 May raise ValueError if the fill shade is out of bounds.
1209 </source>
1210 <translation type="unfinished"></translation>
1211 </message>
1212 <message>
1213 <source>setCornerRadius(radius, ["name"])
1214
1215 Sets the corner radius of the object "name". The radius is expressed
1216 in points. If "name" is not given the currently selected item is used.
1217
1218 May raise ValueError if the corner radius is negative.
1219 </source>
1220 <translation type="unfinished"></translation>
1221 </message>
1222 <message>
1223 <source>setMultiLine("namedStyle", ["name"])
1224
1225 Sets the line style of the object "name" to the named style "namedStyle".
1226 If "name" is not given the currently selected item is used.
1227
1228 May raise NotFoundError if the line style doesn't exist.
1229 </source>
1230 <translation type="unfinished"></translation>
1231 </message>
1232 <message>
1233 <source>getFont(["name"]) -> string
1234
1235 Returns the font name for the text frame "name". If this text frame
1236 has some text selected the value assigned to the first character
1237 of the selection is returned. If "name" is not given the currently
1238 selected item is used.
1239 </source>
1240 <translation type="unfinished"></translation>
1241 </message>
1242 <message>
1243 <source>getTextLength(["name"]) -> integer
1244
1245 Returns the length of the text in the text frame "name".
1246 If "name" is not given the currently selected item is used.
1247 </source>
1248 <translation type="unfinished"></translation>
1249 </message>
1250 <message>
1251 <source>getText(["name"]) -> string
1252
1253 Returns the text of the text frame "name". If this text frame has some text
1254 selected, the selected text is returned. All text in the frame, not just
1255 currently visible text, is returned. If "name" is not given the currently
1256 selected item is used.
1257 </source>
1258 <translation type="unfinished"></translation>
1259 </message>
1260 <message>
1261 <source>getAllText(["name"]) -> string
1262
1263 Returns the text of the text frame "name" and of all text frames which are
1264 linked with this frame. If this textframe has some text selected, the selected
1265 text is returned. If "name" is not given the currently selected item is
1266 used.
1267 </source>
1268 <translation type="unfinished"></translation>
1269 </message>
1270 <message>
1271 <source>getLineSpacing(["name"]) -> float
1272
1273 Returns the line spacing ("leading") of the text frame "name" expressed in
1274 points. If "name" is not given the currently selected item is used.
1275 </source>
1276 <translation type="unfinished"></translation>
1277 </message>
1278 <message>
1279 <source>getColumnGap(["name"]) -> float
1280
1281 Returns the column gap size of the text frame "name" expressed in points. If
1282 "name" is not given the currently selected item is used.
1283 </source>
1284 <translation type="unfinished"></translation>
1285 </message>
1286 <message>
1287 <source>getColumns(["name"]) -> integer
1288
1289 Gets the number of columns of the text frame "name". If "name" is not
1290 given the currently selected item is used.
1291 </source>
1292 <translation type="unfinished"></translation>
1293 </message>
1294 <message>
1295 <source>setText("text", ["name"])
1296
1297 Sets the text of the text frame "name" to the text of the string "text".
1298 Text must be UTF8 encoded - use e.g. unicode(text, 'iso-8859-2'). See the FAQ
1299 for more details. If "name" is not given the currently selected item is
1300 used.
1301 </source>
1302 <translation type="unfinished"></translation>
1303 </message>
1304 <message>
1305 <source>insertText("text", pos, ["name"])
1306
1307 Inserts the text "text" at the position "pos" into the text frame "name".
1308 Text must be UTF encoded (see setText() as reference) The first character has an
1309 index of 0. Inserting at position -1 appends text to the frame. If "name" is
1310 not given the currently selected Item is used.
1311
1312 May throw IndexError for an insertion out of bounds.
1313 </source>
1314 <translation type="unfinished"></translation>
1315 </message>
1316 <message>
1317 <source>setFont("font", ["name"])
1318
1319 Sets the font of the text frame "name" to "font". If there is some text
1320 selected only the selected text is changed. If "name" is not given the
1321 currently selected item is used.
1322
1323 May throw ValueError if the font cannot be found.
1324 </source>
1325 <translation type="unfinished"></translation>
1326 </message>
1327 <message>
1328 <source>setFontSize(size, ["name"])
1329
1330 Sets the font size of the text frame "name" to "size". "size" is treated
1331 as a value in points. If there is some text selected only the selected text is
1332 changed. "size" must be in the range 1 to 512. If "name" is not given the
1333 currently selected item is used.
1334
1335 May throw ValueError for a font size that's out of bounds.
1336 </source>
1337 <translation type="unfinished"></translation>
1338 </message>
1339 <message>
1340 <source>setLineSpacing(size, ["name"])
1341
1342 Sets the line spacing ("leading") of the text frame "name" to "size".
1343 "size" is a value in points. If "name" is not given the currently selected
1344 item is used.
1345
1346 May throw ValueError if the line spacing is out of bounds.
1347 </source>
1348 <translation type="unfinished"></translation>
1349 </message>
1350 <message>
1351 <source>setColumnGap(size, ["name"])
1352
1353 Sets the column gap of the text frame "name" to the value "size". If
1354 "name" is not given the currently selected item is used.
1355
1356 May throw ValueError if the column gap is out of bounds (must be positive).
1357 </source>
1358 <translation type="unfinished"></translation>
1359 </message>
1360 <message>
1361 <source>setColumns(nr, ["name"])
1362
1363 Sets the number of columns of the text frame "name" to the integer "nr".
1364 If "name" is not given the currently selected item is used.
1365
1366 May throw ValueError if number of columns is not at least one.
1367 </source>
1368 <translation type="unfinished"></translation>
1369 </message>
1370 <message>
1371 <source>setTextAlignment(align, ["name"])
1372
1373 Sets the text alignment of the text frame "name" to the specified alignment.
1374 If "name" is not given the currently selected item is used. "align" should
1375 be one of the ALIGN_ constants defined in this module - see dir(scribus).
1376
1377 May throw ValueError for an invalid alignment constant.
1378 </source>
1379 <translation type="unfinished"></translation>
1380 </message>
1381 <message>
1382 <source>selectText(start, count, ["name"])
1383
1384 Selects "count" characters of text in the text frame "name" starting from the
1385 character "start". Character counting starts at 0. If "count" is zero, any
1386 text selection will be cleared. If "name" is not given the currently
1387 selected item is used.
1388
1389 May throw IndexError if the selection is outside the bounds of the text.
1390 </source>
1391 <translation type="unfinished"></translation>
1392 </message>
1393 <message>
1394 <source>deleteText(["name"])
1395
1396 Deletes any text in the text frame "name". If there is some text selected,
1397 only the selected text will be deleted. If "name" is not given the currently
1398 selected item is used.
1399 </source>
1400 <translation type="unfinished"></translation>
1401 </message>
1402 <message>
1403 <source>setTextColor("color", ["name"])
1404
1405 Sets the text color of the text frame "name" to the color "color". If there
1406 is some text selected only the selected text is changed. If "name" is not
1407 given the currently selected item is used.
1408 </source>
1409 <translation type="unfinished"></translation>
1410 </message>
1411 <message>
1412 <source>setTextStroke("color", ["name"])
1413
1414 Set "color" of the text stroke. If "name" is not given the currently
1415 selected item is used.
1416 </source>
1417 <translation type="unfinished"></translation>
1418 </message>
1419 <message>
1420 <source>setTextShade(shade, ["name"])
1421
1422 Sets the shading of the text color of the object "name" to "shade". If
1423 there is some text selected only the selected text is changed. "shade" must
1424 be an integer value in the range from 0 (lightest) to 100 (full color
1425 intensity). If "name" is not given the currently selected item is
1426 used.
1427 </source>
1428 <translation type="unfinished"></translation>
1429 </message>
1430 <message>
1431 <source>linkTextFrames("fromname", "toname")
1432
1433 Link two text frames. The frame named "fromname" is linked to the
1434 frame named "toname". The target frame must be an empty text frame
1435 and must not link to or be linked from any other frames already.
1436
1437 May throw ScribusException if linking rules are violated.
1438 </source>
1439 <translation type="unfinished"></translation>
1440 </message>
1441 <message>
1442 <source>unlinkTextFrames("name")
1443
1444 Remove the specified (named) object from the text frame flow/linkage. If the
1445 frame was in the middle of a chain, the previous and next frames will be
1446 connected, eg 'a->b->c' becomes 'a->c' when you unlinkTextFrames(b)'
1447
1448 May throw ScribusException if linking rules are violated.
1449 </source>
1450 <translation type="unfinished"></translation>
1451 </message>
1452 <message>
1453 <source>traceText(["name"])
1454
1455 Convert the text frame "name" to outlines. If "name" is not given the
1456 currently selected item is used.</source>
1457 <translation type="unfinished"></translation>
1458 </message>
1459 <message>
1460 <source>textOverflows(["name", nolinks]) -> integer
1461
1462 Returns the actual number of overflowing characters in text frame "name".
1463 If is nolinks set to non zero value it takes only one frame - it doesn't
1464 use text frame linking. Without this parameter it search all linking chain.
1465
1466 May raise WrongFrameTypeError if the target frame is not an text frame
1467 </source>
1468 <translation type="unfinished"></translation>
1469 </message>
1470 <message>
1471 <source>setPDFBookmark("toggle", ["name"])
1472
1473 Sets wether (toggle = 1) the text frame "name" is a bookmark nor not.
1474 If "name" is not given the currently selected item is used.
1475
1476 May raise WrongFrameTypeError if the target frame is not a text frame
1477 </source>
1478 <translation type="unfinished"></translation>
1479 </message>
1480 <message>
1481 <source>isPDFBookmark(["name"]) -> bool
1482
1483 Returns true if the text frame "name" is a PDF bookmark.
1484 If "name" is not given the currently selected item is used.
1485
1486 May raise WrongFrameTypeError if the target frame is not a text frame
1487 </source>
1488 <translation type="unfinished"></translation>
1489 </message>
1490 <message>
1491 <source>progressReset()
1492
1493 Cleans up the Scribus progress bar previous settings. It is called before the
1494 new progress bar use. See progressSet.
1495 </source>
1496 <translation type="unfinished"></translation>
1497 </message>
1498 <message>
1499 <source>progressTotal(max)
1500
1501 Sets the progress bar's maximum steps value to the specified number.
1502 See progressSet.
1503 </source>
1504 <translation type="unfinished"></translation>
1505 </message>
1506 <message>
1507 <source>progressSet(nr)
1508
1509 Set the progress bar position to "nr", a value relative to the previously set
1510 progressTotal. The progress bar uses the concept of steps; you give it the
1511 total number of steps and the number of steps completed so far and it will
1512 display the percentage of steps that have been completed. You can specify the
1513 total number of steps with progressTotal(). The current number of steps is set
1514 with progressSet(). The progress bar can be rewound to the beginning with
1515 progressReset(). [based on info taken from Trolltech's Qt docs]
1516 </source>
1517 <translation type="unfinished"></translation>
1518 </message>
1519 <message>
1520 <source>setCursor()
1521
1522 [UNSUPPORTED!] This might break things, so steer clear for now.
1523 </source>
1524 <translation type="unfinished"></translation>
1525 </message>
1526 <message>
1527 <source>docChanged(bool)
1528
1529 Enable/disable save icon in the Scribus icon bar and the Save menu item. It's
1530 useful to call this procedure when you're changing the document, because Scribus
1531 won't automatically notice when you change the document using a script.
1532 </source>
1533 <translation type="unfinished"></translation>
1534 </message>
1535 <message>
1536 <source>newDoc(size, margins, orientation, firstPageNumber,
1537 unit, facingPages, firstSideLeft) -> bool
1538
1539 WARNING: Obsolete procedure! Use newDocument instead.
1540
1541 Creates a new document and returns true if successful. The parameters have the
1542 following meaning:
1543
1544 size = A tuple (width, height) describing the size of the document. You can
1545 use predefined constants named PAPER_<paper_type> e.g. PAPER_A4 etc.
1546
1547 margins = A tuple (left, right, top, bottom) describing the document
1548 margins
1549
1550 orientation = the page orientation - constants PORTRAIT, LANDSCAPE
1551
1552 firstPageNumer = is the number of the first page in the document used for
1553 pagenumbering. While you'll usually want 1, it's useful to have higher
1554 numbers if you're creating a document in several parts.
1555
1556 unit: this value sets the measurement units used by the document. Use a
1557 predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
1558 UNIT_PICAS, UNIT_POINTS.
1559
1560 facingPages = FACINGPAGES, NOFACINGPAGES
1561
1562 firstSideLeft = FIRSTPAGELEFT, FIRSTPAGERIGHT
1563
1564 The values for width, height and the margins are expressed in the given unit
1565 for the document. PAPER_* constants are expressed in points. If your document
1566 is not in points, make sure to account for this.
1567
1568 example: newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS,
1569 FACINGPAGES, FIRSTPAGERIGHT)
1570 </source>
1571 <translation type="unfinished"></translation>
1572 </message>
1573 <message>
1574 <source>closeMasterPage()
1575
1576 Closes the currently active master page, if any, and returns editing
1577 to normal. Begin editing with editMasterPage().
1578 </source>
1579 <translation type="unfinished"></translation>
1580 </message>
1581 <message>
1582 <source>masterPageNames()
1583
1584 Returns a list of the names of all master pages in the document.
1585 </source>
1586 <translation type="unfinished"></translation>
1587 </message>
1588 <message>
1589 <source>editMasterPage(pageName)
1590
1591 Enables master page editing and opens the named master page
1592 for editing. Finish editing with closeMasterPage().
1593 </source>
1594 <translation type="unfinished"></translation>
1595 </message>
1596 <message>
1597 <source>createMasterPage(page