summaryrefslogtreecommitdiff
path: root/docs/dev/translation.rst
blob: be0cf5befc5ab56e3de1411491fbf5f52af236e7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
.. _translation:

===========
Translation
===========

.. _weblate.bubu1.eu: https://weblate.bubu1.eu/projects/searxng/

Translation takes place on `weblate.bubu1.eu`_ ( `documentation <https://docs.weblate.org/en/latest/index.html>`_ ).

New messages on the master branch are extracted and pushed to Weblate automatically.

Every Friday, a GitHub workflow creates a pull request with the updated translations (messages.mo, messages.po, messages.mo files).

.. image:: https://weblate.bubu1.eu/widgets/searxng/-/searxng/svg-badge.svg
   :target: https://weblate.bubu1.eu/projects/searxng/

Weblate integration
===================

Weblate monitors the `translations branch <https://github.com/searxng/searxng/tree/translations>`_, not the master branch.

This branch contains only the .pot and pot files, nothing else.

Documentation
-------------

* `wlc <https://docs.weblate.org/en/latest/wlc.html>`_
* `pybabel <http://babel.pocoo.org/en/latest/cmdline.html>`_
* `weblate workflow <https://docs.weblate.org/en/latest/workflows.html>`_

Worfklow
--------

.. image:: translation.svg


wlc
---

All weblate integration is done by GitHub workflows, but if you want to use wlc, copy this content into `~/.config/weblate <https://docs.weblate.org/en/latest/wlc.html#wlc-config>`_ :

.. code-block:: ini

  [keys]
  https://weblate.bubu1.eu/api/ = APIKEY


Replace `APIKEY` by `your API key <https://weblate.bubu1.eu/accounts/profile/#api>`_.