Category:Scripts: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
Line 119: Line 119:


==[[Beginners Scripts]]==
==[[Beginners Scripts]]==
{| cellpadding=5px | borders=1px
This content has been moved to a separate page to reduce the enormity of this one.
! Script (w/ Screenshot) !! Scripter commands demonstrated
|-
| width=390px |<center>[[Elementary Rectangle]]</center> [[Image:Elementary_rectangle.png|frame|link=Elementary Rectangle|200x300px|center|alt=simple rectangle made with scribus python script|Elementary Rectangle generated from python]]
|newDocument, createRect, setCornerRadius, setLineWidth, setFillColor, setLineColor, saveDocAs
|-
| width=390px |<center>[[Drawing Circles with Radii]]</center> [[Image:myCircles.png|frame|link=Drawing Circles with Radii|200x300px|center|alt=Drawing Circles w/ Radii made with scribus python script|Drawing Circles with Radii generated from python]]
| newDocument, createLine, setLineWidth, setLineColor, zoomDocument, saveDocAs
|-
| width=390px |<center>[[Making a dot gradient]]</center> [[Image:DotGradient.png|frame|link=Making a dot gradient|200x300px|center|alt=Making a dot gradient made with scribus python script|Making a dot gradient generated from python]]
| newDocument, createEllipse, setLineWidth, setFillColor, setFillShade, saveDocAs, currentPage, setHGuides, messageBox, statusMessage, progressReset
|-
| width=390px |<center>[[Adding 'DRAFT' to a document]]</center> [[Image:Draft_example.png|frame|link=Adding 'DRAFT' to a document|200x300px|center|alt=Adding 'DRAFT' to a document made with scribus python script|Adding 'DRAFT' to a document generated from python]]
| haveDoc, createLayer, getActiveLayer, setActiveLayer, createText, setUnit, setText, setTextColor, setFontSize, rotateObject
|-
|
* [[Making layout grid with guides]]
| haveDoc, valueDialog, getUnit, setUnit, getPageSize, getPageMargins,
|-
|
* [[Creating Markers for positioning and cutting]]
| defineColor, createEllipse, setLineWidth, setLineColor, setFillColor, createLine, getPageSize, createRect
|-
|
* [[Creating Markers - another version]]
| valueDialog, getColor, getLayers, createLayer, setActiveLayer, setHGuides, setVGuides, getHGuides, getVGuides, createText, setTextColor, insertText, setFontSize, setLineSpacing, defineColor, createRect, groupObjects, createLine, setLineColor, setLineWidth, createEllipse, haveDoc, messageBox
|-
|
* [[Bleed, create markers and export a document to pdf]]
|-
|
* [[Drawing Lines and Python "For loops"]]
| newDocument, createLine, setLineWidth, setLineColor, setFillShade, createRect, saveDocAs
|-
|
* [[Making margins in Guttenberg way]]
| haveDoc, getUnit, setUnit, getPageSize, getPageMargins, setMargins, messageBox, statusMessage, progressReset
|-
|
* [[Generate a ten page layout with three columns on each page]]
|-
|
* [[Generating a Postnet barcode]]
| haveDoc, setUnit, valueDialog, createLine, setLineWidth, setLineColor, setFillColor
|-
|
* [[Generating a Code39 Barcode]]
| width=550px| haveDoc, createLine, setLineWidth, setLineColor, setFillColor, createText, setFont, setFontSize, setTextAlignment, valueDialog, messageBox, docChanged
|-
| createColor(),
* [[A Standard Form with Barcodes and Custom Entries]]
| newDoc, createLine, setLineWidth, setLineColor, setFillColor, createLayer, setActiveLayer, createText, setFont, setFontSize, setTextAlignment, selectText, setTextDistances, valueDialog, messageBox
|-
|
* [[Automatically Creating a Graph]]
| haveDoc, valueDialog, createLine, setLineWidth, setLineColor, setFillColor, createText, setTextColor, setText, setTextAlignment, setFont, setFontSize, rotateObject
|-
|
* [[Creating a Graph, Part 2]]
| haveDoc, valueDialog, setUnit, createLine, setLineWidth, setLineColor, setFillColor, createText, setTextColor, setText, setTextAlignment, setFont, setFontSize
|-
|
* [[Advanced Graphing]]
| fileDialog, haveDoc, setUnit, valueDialog, createLine, setLineWidth, setLineColor, setFillColor, createPolyLine
|-
|
* [[Making a Pie Chart]]
| valueDialog, messageBox, haveDoc, importSVG &ndash; ''much of the script involves mathematical calculations''
|-
|
* [[Import an image in the way office-programs do]]
| getPageSize, fileDialog, createImage, setScaleImageToFrame, setFillColor, setLineColor, getImageScale, sizeObject, haveDoc, messageBox<br>''This is an old script (Scribus 1.3.3.3), so be sure to check the precise names of commands. If you find errors, let us know or edit the wiki page to correct.''
|-
|
* [[Drawing a grid]]
| messageBox, createLine, setLineColor, haveDoc, statusMessage, progressReset<br>''There is a minor usage of Scribus commands here, but it does show how to set up a Tkinter dialog for multiple variable entry.''
|-
|
* [[Importing addresses from a text file]]
| newDoc, newPage, createText, setText, setTextAlignment, setFont, setFontSize<br>''This is almost a script fragment even though it could work on its own. What it shows is the basic operation to import information from a simple structured text file and incorporate into a document. Could be adapted for mail merge, for example.''
|-
|
* [[Scale an Image to Fill a Frame Proportionally]]
| haveDoc, selectionCount, getSelectedObject, setScaleImageToFrame, getImageScale, scaleImage, docChanged
|-
|
* [[Align an Image in its Frame]]
|-
|
* [[Image Wizard: Scale and Align an Image]]
|-
|
* [[Image Wizard Advanced]]
|-
|
* [[Split Image Across Gutter]]
|-
|
* [[Discovering an Item's Properties]]
| ''not sure if this script works''
|-
|
* [[Un-Flip all Selected Items]]
| haveDoc, selectionCount, getSelectedObject, setProperty, moveObject, docChanged
|-
|
* [[Remove Magenta Color]]
| replaceColor, docChanged<br>''This is a "script-let" really, but quickly shows how to change or delete colors in a document. No checking for errors.''
|-
|
* [[Extracting All Text from a Document]]
| haveDoc, fileDialog, messageBox, pageCount, getPageItems, gotoPage, getAllText, getImageFile
|-
|
* [[Convert RGB value to Hex]]
| valueDialog, messageBox<br>''This is a utility that just happens to run in Scribus, using the valueDialog and messageBox to do what the title says.''
|-
|
* [[Color Chart]]
| getPageSize, getPageMargins, createText, setFontSize, setTextAlignment, insertText, getColorNames, statusMessage, progressTotal, getColor, progressSet, haveDoc, openDoc, fileDialog, messageBox, getColorsFromDocument, newDocument, setUnit, deleteColor, defineColor, valueDialog, newPage, createRect, setFillColor, setLineColor
|-
|
* [[Book Spine Calculator]]
| messageBox, valueDialog
|-
|
* [[create tables out of csv data]]
|-
|
* [[Reduce the size of Scribus generated PDFs]]
|-
|
* [[Convert Typewriter Quotes to Typographic Quotes]]
|-
|
* [[Autoquote2]] &ndash; a new and improved Autoquote.py
|-
|
* [[copyObject() and pasteObject()]]
| haveDoc, selectionCount, messageBox, valueDialog, getSelectedObject, pageCount, currentPage, gotoPage. Also shows use of Python split function for parsing the input from valueDialog. copyObject and pasteObject are new commands that you will only have once you follow the directions to install them into your svn directory and rebuild Scribus.
|-
|
* [[Convert RGB imported colors to CMYK]]
| getColors(), defineColor(), replaceColor(), deleteColor()
|-
|
* [[Convert all colors to CMYK]]
| getColors(), defineColor(), replaceColor(), deleteColor()
|-
|
|-
|}


==Basic scripts==
==Basic scripts==

Revision as of 15:08, 8 November 2016

Other languages: Polski (pl) Portuguese (pt_BR)

Scripter

Here is documentation about the current scripting component in Scribus:

  • Scripter API -- Routines which can be used in scripts to control Scribus
  • Databases -- Scripts can interact with database software like MySQL or SQLite

This wiki is capable of letting users download raw code embedded into the pages and have it appear syntax highlighted.

  • So as to cite python script code with proper syntax hilight, use the following tag <syntaxhighlight lang='python'> instead of using the usual HTML tag <pre>.
  • See example and other possible tags : Wikitext for Raw Code Download

Note : A new script engine is currently being integrated into Scribus. The next steps will be to get the script engine to work (should already be ok), get the editor to work, revise the structure of the API, add new functions to the API and mostly : port scripts to the new scripter. See Scripter NG non-complete documentation about architecture

Pure Python Functions

The open() function is a pure python function and does not involve any Scribus code. Here are some pages with advices on how to handle unicode file names in python:

- http://docs.python.org/tutorial/inputoutput.html - http://www.evanjones.ca/python-utf8.html - http://boodebr.org/main/python/all-about-python-and-unicode

The string returned by the Scribus fileDialog() function is always Unicode UTF-8 encoded.

If file is not closed after python error within Scribus: This is up to you to handle python exceptions, Scribus cannot do that in your place

Script snippets

Needs some snippets

This section contains snippets you can use to create your own scripts.

It features:

  • reading a file
  • updating a status bar
  • selecting a frame
  • pausing the screen update

Script Template

Here is a script template with all setups. Use it as a starting point for writing your own script, fill in your application specific code. script template main(). There is also a template called boilerplate.py within Scribus Script directory.

Troubleshooting Scripts

The content is on another page, since this one has gotten a bit out of control in terms of its size.

Iterate over all elements on a page

page = 1
pagenum = scribus.pageCount()
content = []
while (page <= pagenum):
    scribus.gotoPage(page)
    d = scribus.getPageItems()
    for item in d:
        // do something
    page += 1

Get content like text from a frame

content = []
d = scribus.getPageItems()
for item in d:
    if (item[1] == 4):
        contents = scribus.getAllText(item[0])
        if (contents in content):
            contents = 'Duplication, perhaps linked-to frame'
            content.append(contents)
        elif (item[1] == 2):
            imgname = scribus.getImageFile(item[0])

ITEM TYPE

  • ItemType1 = 1,
  • ImageFrame = 2,
  • ItemType3 = 3,
  • TextFrame = 4,
  • Line = 5,
  • Polygon = 6,
  • PolyLine = 7,
  • PathText = 8,
  • LatexFrame = 9,
  • Multiple = 99

Auto-Output all Scripter Commands

From Scribus User http://meiradarocha.jor.br Mailinglist Feb. 2012

d = dir(scribus)
for j in d:
   try:
       exec 'res = '+j+'.__doc__'
       if res[0:5] == 'float':
           print '\nCONSTANT:\n',j,'\nVALUE: float'
           exec 'print '+j+'\n'
       elif res[0:5] == 'int(x':
           print '\nCONSTANT:\n',j,'\nVALUE: integer'
           exec 'print '+j+'\n'
       elif res[0:5] == 'tuple':
           print '\nTUPLE:\n',j,'\nVALUE:'
           exec 'print repr('+j+')\n'
       elif res[0:4] == 'str(':
           print '\nSTRING:\n',j,'\nVALUE:'
           exec 'print repr('+j+')\n'
       else:
           print '\nFUNCTION:\n'+j+'\n\nSYNTAX:'
           print res
   except: pass

Image Manipulation

  • Objects: Images -- Example Scripts that manipulate images in a Scribus document

Beginners Scripts

This content has been moved to a separate page to reduce the enormity of this one.

Basic scripts

Scripts which give you ideas how you can solve your tasks.

Full functional scripts

Scripts that are ready for achieving specific tasks

Scripting new Scribus' functions

Scripts which sketch new features which may be included in future releases of Scribus

Extension scripts and PyQt

Python issues

Other

Pages in category "Scripts"

The following 103 pages are in this category, out of 103 total.