Difference between revisions of "Tips For Python Script Extensions"

From Inkscape Wiki
Jump to navigation Jump to search
(New page: Test Category:Extensions)
 
(Superseded by inkex API introduced in Inkscape 1.0)
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Test
{{outdated}}


==Adding Translation Capability==


One can add the ability to have Python text messages included for translation. To provide an error message, rather than using the Python <tt>sys.stderr</tt>, use the provided <tt>errormsg()</tt> function from inkex.py in conjunction with <tt>gettext</tt>.


You must include the following at the beginning of your Python script:
import inkex
inkex.localize()
Note: In prior versions (0.49), you will have to include the following lines instead:
import inkex
import gettext
_ = gettext.gettext
Where you wish to have an error message, write the following:
inkex.errormsg(_("This will be written to Python stderr"))
Of course, you may also change "_" to something else if you wish.


[[Category:Extensions]]
[[Category:Extensions]]

Revision as of 03:10, 15 December 2019

This page is outdated. It is kept for historical reasons, e.g. to document specific decisions in Inkscape development.

Adding Translation Capability

One can add the ability to have Python text messages included for translation. To provide an error message, rather than using the Python sys.stderr, use the provided errormsg() function from inkex.py in conjunction with gettext.

You must include the following at the beginning of your Python script:

import inkex
inkex.localize()

Note: In prior versions (0.49), you will have to include the following lines instead:

import inkex
import gettext
_ = gettext.gettext

Where you wish to have an error message, write the following:

inkex.errormsg(_("This will be written to Python stderr"))

Of course, you may also change "_" to something else if you wish.