[enh] initial structure

docs/dev/translation.rst

@@ -0,0 +1,74 @@
+Translation
+===========
+
+run these commands in the root directory of searx
+
+Add new language
+~~~~~~~~~~~~~~~~
+
+``pybabel init -i messages.pot -d searx/translations -l it``
+
+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``
+
+After this step, you can modify the .po files.
+
+Compile translations
+~~~~~~~~~~~~~~~~~~~~
+
+``pybabel compile -d searx/translations``
+
+Transifex stuff
+~~~~~~~~~~~~~~~
+
+Init Project
+^^^^^^^^^^^^
+
+.. code:: shell
+
+    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/developer/client/set
+
+*TODO: mapping between transifex and searx*
+
+Get translations
+^^^^^^^^^^^^^^^^
+
+.. code:: shell
+
+    tx pull -a
+
+http://docs.transifex.com/developer/client/pull
+
+Upload source File
+^^^^^^^^^^^^^^^^^^
+
+::
+
+    tx push -s
+
+Upload all Translation
+^^^^^^^^^^^^^^^^^^^^^^
+
+::
+
+    tx push -s -t
+
+upload specifc Translation (only for admins)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+::
+
+    tx push -t -l tr
+
+http://docs.transifex.com/developer/client/push
+
+*TODO: upload empty files? (new translations)*