OwlBurst/Ponysearch
1
0
Fork 0
forked from Ponysearch/Ponysearch
Code Pull requests Activity

Merge pull request #498 from pointhi/gh-pages

Browse source 
[enh] improve translation documentation
This commit is contained in:
Adam Tauber 2016-01-21 16:47:38 +01:00
commit fe79b635e0
1 changed files with 21 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
docs/dev/translation.rst
View file

@ -6,23 +6,29 @@ run these commands in the root directory of searx
Add new language Add new language
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
``pybabel init -i messages.pot -d searx/translations -l it`` .. code:: shell
pybabel init -i messages.pot -d searx/translations -l it
Update .po files Update .po files
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
``./utils/update-translations.sh`` .. code:: shell
./utils/update-translations.sh
You may have errors here. In that case, edit the You may have errors here. In that case, edit the
``update-translations.sh`` script to change ``pybabel`` to ``update-translations.sh`` script to change ``pybabel`` to
``pybabel-python2`` ``pybabel-python2`` or ``pybabel2``
After this step, you can modify the .po files. After this step, you can modify the .po files.
Compile translations Compile translations
~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~
``pybabel compile -d searx/translations`` .. code:: shell
pybabel compile -d searx/translations
Transifex stuff Transifex stuff
~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~
@ -32,12 +38,14 @@ Init Project
.. code:: shell .. code:: shell
tx init # Transifex instance: https://www.transifex.com/asciimoo/searx/
tx set --auto-local -r searx.messagespo 'searx/translations/<lang>/LC_MESSAGES/messages.po' \ tx set --auto-local -r searx.messagespo 'searx/translations/<lang>/LC_MESSAGES/messages.po' \
--source-lang en --type PO --source-file messages.pot --execute --source-lang en --type PO --source-file messages.pot --execute
http://docs.transifex.com/developer/client/set http://docs.transifex.com/client/init/
*TODO: mapping between transifex and searx* http://docs.transifex.com/client/set/
Get translations Get translations
^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^
@ -46,29 +54,27 @@ Get translations
tx pull -a tx pull -a
http://docs.transifex.com/developer/client/pull http://docs.transifex.com/client/pull
Upload source File Upload source File
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
:: .. code:: shell
tx push -s tx push -s
Upload all Translation Upload all Translation
^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^
:: .. code:: shell
tx push -s -t tx push -s -t
upload specifc Translation (only for admins) upload specifc Translation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~
:: .. code:: shell
tx push -t -l tr tx push -t -l tr
http://docs.transifex.com/developer/client/push http://docs.transifex.com/client/push
*TODO: upload empty files? (new translations)*