diff --git a/_sources/dev/translation.txt b/_sources/dev/translation.txt index bc32eda9..ab4dd98c 100644 --- a/_sources/dev/translation.txt +++ b/_sources/dev/translation.txt @@ -1,80 +1,61 @@ Translation =========== -run these commands in the root directory of searx +Requirements +------------ -Add new language -~~~~~~~~~~~~~~~~ + * Transifex account -.. code:: shell + * Installed CLI tool of Transifex - pybabel init -i messages.pot -d searx/translations -l it +Init Transifex project +---------------------- -Update .po files -~~~~~~~~~~~~~~~~ - -.. code:: shell - - ./utils/update-translations.sh - -You may have errors here. In that case, edit the -``update-translations.sh`` script to change ``pybabel`` to -``pybabel-python2`` or ``pybabel2`` - -After this step, you can modify the .po files. - -Compile translations -~~~~~~~~~~~~~~~~~~~~ - -.. code:: shell - - pybabel compile -d searx/translations - -Transifex stuff -~~~~~~~~~~~~~~~ - -Init Project -^^^^^^^^^^^^ +After installing ``transifex`` using pip, run the following command to initialize the project. .. code:: shell 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``. + +.. code:: shell + + [main] + host = https://www.transifex.com + [searx.messagespo] + file_filter = searx/translations//LC_MESSAGES/messages.po + source_file = messages.pot + source_lang = en + type = PO + + +Then run ``tx set``: + +.. code:: shell + tx set --auto-local -r searx.messagespo 'searx/translations//LC_MESSAGES/messages.po' \ --source-lang en --type PO --source-file messages.pot --execute -http://docs.transifex.com/client/init/ -http://docs.transifex.com/client/set/ +Update translations +------------------- -Get translations -^^^^^^^^^^^^^^^^ +To retrieve the latest translations, pull it from Transifex. .. code:: shell tx pull -a -http://docs.transifex.com/client/pull - -Upload source File -^^^^^^^^^^^^^^^^^^ +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. .. code:: shell - tx push -s + pybabel compile -d searx/translations -Upload all Translation -^^^^^^^^^^^^^^^^^^^^^^ -.. code:: shell - - tx push -s -t - -upload specifc Translation -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code:: shell - - tx push -t -l tr - -http://docs.transifex.com/client/push +After the compilation is finished commit the ``.po`` and ``.mo`` files and create a PR. diff --git a/dev/translation.html b/dev/translation.html index 8db7d8a4..cab198e8 100644 --- a/dev/translation.html +++ b/dev/translation.html @@ -42,68 +42,50 @@

Translation

-

run these commands in the root directory of searx

-
-

Add new language

-
pybabel init -i messages.pot -d searx/translations -l it
-
+
+

Requirements

+
+
    +
  • Transifex account
    • +
  • Installed CLI tool of Transifex
    • +
+
-
-
-

Update .po files

-
./utils/update-translations.sh
-
-
-

You may have errors here. In that case, edit the -update-translations.sh script to change pybabel to -pybabel-python2 or pybabel2

-

After this step, you can modify the .po files.

-
-
-

Compile translations

-
pybabel compile -d searx/translations
-
-
-
-
-

Transifex stuff

-
-

Init Project

+
+

Init Transifex project

+

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

tx init # Transifex instance: https://www.transifex.com/asciimoo/searx/
-
-tx set --auto-local -r searx.messagespo 'searx/translations/<lang>/LC_MESSAGES/messages.po' \
+
+
+

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:

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

http://docs.transifex.com/client/init/

-

http://docs.transifex.com/client/set/

-
-

Get translations

+
+

Update translations

+

To retrieve the latest translations, pull it from Transifex.

tx pull -a
-

http://docs.transifex.com/client/pull

-
-
-

Upload source File

-
tx push -s
+
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.

+
pybabel compile -d searx/translations
 

 

-
-
-

Upload all Translation

-
tx push -s -t
-
-
-
-
-
-

upload specifc Translation

-
tx push -t -l tr
-
-
-

http://docs.transifex.com/client/push

+

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