qi.Translator API

Introduction

Translator is the way to internationalize strings. It works with qilinguist.

Reference

class qi.Translator
addDomain()

Add a new domain.

setCurrentLocale()

Set the locale.

setDefaultDomain()

Set the domain.

translate()

Translate a message from a domain to a locale

Translate a message from a domain to a locale

Translate a message from a domain to a locale

Translate a message from a domain to a locale

Translate a message with a context

Examples

Simple example:

import qi

tr = qi.Translator("my_app")
tr.setDefaultDomain("my_domain")
tr.setCurrentLocale("fr_FR")

translated_mess = tr.translate("Hi, I am %s!")

print translated_mess % ("Nicolas")
# > "Salut, je m'apelle Nicolas !"

# You can change domain only for a translation
print tr.translate("Hi!", "formal")
# > "Bonjour !" (means "Good morning!")

print tr.translate("Hi!", "casual")
# > "Salut !" (means "Hi bro!")

# You can also change language
print tr.translate("Hi!", "formal", "de_DE")
# > "Guten Tag !"

print tr.translate("Hi!", "casual", "de_DE")
# > "Hallo !"