Translations.rst 2.2 KB
Newer Older
1 2 3 4 5 6 7 8 9 10
.. _translations:

Translations
============

A common way of contributing is by adding translations to our various projects. The translations are contributed via a public `Zanata server <https://translate.zanata.org/>`_. If you are interested in contributing a tranlsation, here is the process:

Create an account
^^^^^^^^^^^^^^^^^

David Boddie's avatar
David Boddie committed
11
The public Zanata server requires you to first create an account with them. Once you have done this, log in and you will be taken to your dashboard.
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

Join a language team
^^^^^^^^^^^^^^^^^^^^

In order to have write access to a certain language, you will first need to join the corresponding language team. On your dashboard, you should see the "Join a language team" link where you can search for and join a specific team.

Find our projects
^^^^^^^^^^^^^^^^^

Once you're a part of a language team, click the "Explore" icon on the left panel to search for our projects. For example, you can search for "phosh" and you should find our phosh project. The page for the project should list versions so click the latest version listed to access the list of languages available for translation.

.. image:: phosh-project-page.png
   :width: 700px
   :height: 200px
   :align: center

Add a translation
^^^^^^^^^^^^^^^^^

Select the language for which you wish to add a translation (under the Languages column) and then select the project name (under the Documents column).

.. image:: phosh-get-to-translation.png
   :width: 700px
   :height: 200px
   :align: center 

David Boddie's avatar
David Boddie committed
38
Now you should have the translation page displayed where you can see the English text on the left half of the screen and add a translation to the right half of the screen (with suggestions on the bottom part of the screen).
39 40 41 42 43 44 45 46 47 48 49 50

.. image:: phosh-translate-page.png
   :width: 700px
   :height: 300px
   :align: center 

Note that if you are not part of the corresponding language team (or an admin for the project), then you will not be able to enter text for translating these fields.

What's next?
^^^^^^^^^^^^

Every time the Librem 5 team releases a new version of the project, the new translations will be grabbed from Zanata. By adding a translation in Zanata, you are creating a .po file that will get picked up in the next release of the project.