searxng/docs/dev/translation.rst
Markus Heiser debcbab561 [fix] add missing transifex configuration (./tx/config)
BTW: update the documentation about transifex usage

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
2021-07-03 19:31:31 +02:00

1.6 KiB

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.