Home Tajpi - Esperanto Keyboard
Scripting the program

Tajpi Script provides advanced configuration and text conversion/input utilities. It uses a simple syntax to configure hotkeys which can be activated at any time from the keyboard. The script file is called Tajpi.skr and resides in the Tajpi program folder, which by default is C:\Program Files (x86)\Tajpi.

In the following example, the hotkey Ctrl+R is configured to activate/deactivate Russian transliteration. The caret sign [^] stands for the Ctrl key, which is known as a modifier:

^R::rusa

To use more than one modifier with a hotkey, list them consecutively (the order doesn't matter). The following example uses ^!S to indicate Ctrl+Alt+S, and activates cyrillic transliteration:

^!S::cirila

You can use the following modifier symbols to define hotkeys:

Symbol Description
! Alt
^ Control
+ Shift
< Use the left key of the pair. e.g. <!a is the same as !a except that only the left Alt key will trigger it.
> Use the right key of the pair.

It is possible to completely leave out modifiers from a hotkey and just bind to a single key. For example the following hotkey will show the configuration window when pressing F12:

F12::agordi

Tajpi Script is case insensitive. The following hotkey pairs have exactly the same effect:

^+a::agordi
^+A::AGORDI

>!sPaCe::cIRIla
>!SpAcE::CiriLA

Anything after a semicolon is treated as a comment, and will be ignored:

;this is a comment
^+insert::rusa  ;this hotkey is active
;^+space::rusa   and this one is not

The name of the key to bind to should be spelt according to the drop down list at the bottom of the Tajpi configuration window (spaces may be left out however). When amending a script remember to save it and restart Tajpi.

The following commands may be used in your hotkeys:

Command Description
cirila Activates/deactivates Cirilic transliteration. When an Esperanto letter is typed, it will automatically appear as the most phonetically equivalent letter from the Cirilic alphabet. The following scheme is used:
a
а		b
б		c
ц		ĉ
ч		d
д		e
е		f
ф		g
г		ĝ
ѓ		h
х		ĥ
ћ		i
и		j
й		ĵ
ж		k
к		l
л		m
м		n
н		o
о		p
п		r
р		s
с		ŝ
ш		t
т		u
у		ŭ
ў		v
в		z
з
A
А		B
Б		C
Ц		Ĉ
Ч		D
Д		E
Е		F
Ф		G
Г		Ĝ
Ѓ		H
Х		Ĥ
Ћ		I
И		J
Й		Ĵ
Ж		K
К		L
Л		M
М		N
Н		O
О		P
П		R
Р		S
С		Ŝ
Ш		T
Т		U
У		Ŭ
Ў		V
В		Z
З
rusa Activates/deactivates Russian transliteration. When an Esperanto letter is typed, it will automatically appear as the most phonetically equivalent letter (or combination of letters) from the Russian alphabet. The following scheme is used, with the differences to the Cirilic scheme shown in red:
a
а		b
б		c
ц		ĉ
ч		d
д		e
е		f
ф		g
г		ĝ
дж		h
х		ĥ
х		i
и		j
й		ĵ
ж		k
к		l
л		m
м		n
н		o
о		p
п		r
р		s
с		ŝ
ш		t
т		u
у		ŭ
у		v
в		z
з
A
А		B
Б		C
Ц		Ĉ
Ч		D
Д		E
Е		F
Ф		G
Г		Ĝ
ДЖ		H
Х		Ĥ
Х		I
И		J
Й		Ĵ
Ж		K
К		L
Л		M
М		N
Н		O
О		P
П		R
Р		S
С		Ŝ
Ш		T
Т		U
У		Ŭ
У		V
В		Z
З
ssigi_elektitan Converts the currently selected text from X-system to diacritical Esperanto letters. Can be used in a text box or any text editor program such as Word or Notepad.
ssigi_tondujon Converts text held in the clipboard from X-system to diacritical Esperanto letters.
xigi_elektitan Converts any diacritical Esperanto letters in the currently selected text to X-system.
xigi_tondujon Converts any diacritical Esperanto letters in the text held in the clipboard to X-system.
higi_elektitan Converts any diacritical Esperanto letters in the currently selected text to H-system.
higi_tondujon Converts any diacritical Esperanto letters in the text held in the clipboard to H-system.
htmligi_elektitan Converts all symbols in the currently selected text to HTML entity codes. This can also be useful for determining the Unicode code-point value of a particular symbol, or series of symbols.
htmligi_tondujon Converts all symbols in the text held in the clipboard to HTML entity codes.
### The command may be a numerical value representing any Unicode symbol to be input to the system. The following hotkey inputs Ĉ upon pressing Ctrl+Alt+C: 
^!C::264
It is possible to specify a hexadecimal value by prepending with "&H". The following hotkey sends the ♥ symbol: 
^!H::&H2665
You can also send multiple symbols with one hotkey by delimiting the codes with a comma. The following sends AAA: 
^!A::65,65,65
See here for a complete list of Unicode symbols.
_[text] The command may be a peice of literal text to be input to the system, which must be prefixed with an underscore. The following hotkey inputs eĥoŝanĝo ĉiuĵaŭde when pressing Alt+E: 
!E::_eĥoŝanĝo ĉiuĵaŭde
Escape sequences may be used: \n for newline and \t for tab. Backslashes and semicolons must be escaped with a backslash in front of them.
agordi Shows the Tajpi configuration window.
alglui Toggles the option "Paste out of clipboard" in the configuration window.
english Changes the interface language to English.
esperanto Changes the interface language to Esperanto.
eliri Quits Tajpi.
helpo Shows the help file in the current interface language.
helpo_en Shows the English help file.
helpo_eo Shows the Esperanto help file.
html Toggles the option "HTML entity codes" in the configuration window.
klavkomando Activates/deactivates Tajpi. A hotkey for this is already present in the Tajpi configuration window, however you can add others with this command.
latina3 Sets the option "Latin-3" in the configuration window.
pri_tajpi Shows the "About Tajpi" window.
skripto Toggles TajpiScript on and off. Only this command will be recognized when TajpiScript is disabled.
unikodo Sets the option "Unicode" in the configuration window.

After editing the script you must save the script file and restart Tajpi. Note that TajpiScript recognizes ASCII and UTF-8 file formats only. Unicode formats other than UTF-8 are not supported.



Copyleft 2008- Thomas James Last updated 10-Jun-2016
tmj2005@gmail.com