searxng/docs/dev/translation.rst

Translation

Translation currently takes place on searx@transifex

Requirements

• Transifex account

Init Transifex project

After installing transifex using pip, run the following command to initialize the project.

./manage pyenv.cmd tx init # Transifex instance: https://www.transifex.com/asciimoo/searx/

After $HOME/.transifexrc is created, get a Transifex API key and insert it into the configuration file.

Create a configuration file for tx named $HOME/.tx/config.

[main]
host = https://www.transifex.com
[searx.messagespo]
file_filter = searx/translations/<lang>/LC_MESSAGES/messages.po
source_file = messages.pot
source_lang = en
type = PO

Then run tx set:

./manage pyenv.cmd tx set --auto-local \
    -r searx.messagespo 'searx/translations/<lang>/LC_MESSAGES/messages.po' \
    --source-lang en --type PO --source-file messages.pot --execute

Update translations

To retrieve the latest translations, pull it from Transifex.

./manage pyenv.cmd tx pull -a
[?] Enter your api token: ....

Then check the new languages. If strings translated are not enough, delete those folders, because those should not be compiled. Call the command below to compile the .po files.

./manage pyenv.cmd pybabel compile -d searx/translations

After the compilation is finished commit the .po and .mo files and create a PR.