5.11. GoogleTranslate Package¶

Available since version 2.10

Suggest translations using Google Translate online service, to/from any supported language.

5.11.1. Usage¶

By default, a Translate item is inserted into the Catalog using the default source and target language parameters provided by the configuration file.

Select the item and type the term(s) you wish to translate as item’s argument.

The plugin then queries the Google Translate service and adds the result as a suggestion in the results list.

The default action when pressing the Enter key is to copy the result to the clipboard. Press Ctrl+Enter for a list a available actions related to this result.

5.11.2. Custom Items¶

If you wish to have more “translate” items available with different predefined language parameters, it is possible to define extra items in the configuration file by declaring custom_item sections.

Refer to the default configuration file of the package for more information.

5.11.3. Search Grammar¶

For translation queries that do not necessitate the creation of custom items, it is possible to change the language parameters on-the-fly, at search time, without having to modify the configuration file.

To do so, select any item created by this plugin and to use one of following grammars as its argument:

A. <terms>
B. [[lang_in]:[lang_out]] <terms>
C. <terms> [[lang_in]:[lang_out]]

Examples:

fr:en Bonjour
:es Danke
en: Hello world
hello world en:
Que tal? -:en

Grammar A being the most basic, it fully relies on the source and target languages used to create the item that is currently selected (may it be the default item or a custom one).

Grammar B and C both allow to override item’s language code(s).

Example 2 forces the target language to be Spanish, but keeps the source language of the currently selected item.

Examples 3 and 4 are equivalent and secure the source language to be English.

Example 5 requests the translation of Que tal? from the auto language (Google will interpret this sentence as being Spanish) to English.

Tip

The placement of the : character matters. It makes the difference between the source and the target language.
For convenience, - can be used instead of auto as the source language.
If both grammars B and C are used in the same argument, C prevails.
If a source/target language code specified via this grammar is unknown, no warning message is issued and item’s code will silently be used. However it is possible to check what language code have been used in a particular query by having a look at item’s description line.

5.11.4. Google Translate Supported Languages¶

Code	Name	Input/Output
auto	Auto	input only
af	Afrikaans	both supported
am	Amharic	both supported
ar	Arabic	both supported
az	Azerbaijani	both supported
be	Belarusian	both supported
bg	Bulgarian	both supported
bn	Bengali	both supported
bs	Bosnian	both supported
ca	Catalan	both supported
ceb	Cebuano	both supported
co	Corsican	both supported
cs	Czech	both supported
cy	Welsh	both supported
da	Danish	both supported
de	German	both supported
el	Greek	both supported
en	English	both supported
eo	Esperanto	both supported
es	Spanish	both supported
et	Estonian	both supported
eu	Basque	both supported
fa	Persian	both supported
fi	Finnish	both supported
fr	French	both supported
fy	Frisian	both supported
ga	Irish	both supported
gd	Scots Gaelic	both supported
gl	Galician	both supported
gu	Gujarati	both supported
ha	Hausa	both supported
haw	Hawaiian	both supported
hi	Hindi	both supported
hmn	Hmong	both supported
hr	Croatian	both supported
ht	Haitian Creole	both supported
hu	Hungarian	both supported
hy	Armenian	both supported
id	Indonesian	both supported
ig	Igbo	both supported
is	Icelandic	both supported
it	Italian	both supported
iw	Hebrew	both supported
ja	Japanese	both supported
jw	Javanese	both supported
ka	Georgian	both supported
kk	Kazakh	both supported
km	Khmer	both supported
kn	Kannada	both supported
ko	Korean	both supported
ku	Kurdish (Kurmanji)	both supported
ky	Kyrgyz	both supported
la	Latin	both supported
lb	Luxembourgish	both supported
lo	Lao	both supported
lt	Lithuanian	both supported
lv	Latvian	both supported
mg	Malagasy	both supported
mi	Maori	both supported
mk	Macedonian	both supported
ml	Malayalam	both supported
mn	Mongolian	both supported
mr	Marathi	both supported
ms	Malay	both supported
mt	Maltese	both supported
my	Myanmar (Burmese)	both supported
ne	Nepali	both supported
nl	Dutch	both supported
no	Norwegian	both supported
ny	Chichewa	both supported
pa	Punjabi	both supported
pl	Polish	both supported
ps	Pashto	both supported
pt	Portuguese	both supported
ro	Romanian	both supported
ru	Russian	both supported
sd	Sindhi	both supported
si	Sinhala	both supported
sk	Slovak	both supported
sl	Slovenian	both supported
sm	Samoan	both supported
sn	Shona	both supported
so	Somali	both supported
sq	Albanian	both supported
sr	Serbian	both supported
st	Sesotho	both supported
su	Sundanese	both supported
sv	Swedish	both supported
sw	Swahili	both supported
ta	Tamil	both supported
te	Telugu	both supported
tg	Tajik	both supported
th	Thai	both supported
tl	Filipino	both supported
tr	Turkish	both supported
uk	Ukrainian	both supported
ur	Urdu	both supported
uz	Uzbek	both supported
vi	Vietnamese	both supported
xh	Xhosa	both supported
yi	Yiddish	both supported
yo	Yoruba	both supported
zh-CN	Chinese (Simplified)	both supported
zh-TW	Chinese (Traditional)	output only
zu	Zulu	both supported