Skip to content

Commit

Permalink
Language modifications (#1)
Browse files Browse the repository at this point in the history
  • Loading branch information
ewangi authored and clefebvre committed Jan 27, 2018
1 parent 7b6374f commit 5e3874d
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions docs/l10n.rst
@@ -1,5 +1,5 @@
.. note::
This chapter explains how translations work. It is useful to get a better understanding of the workflow and the technology but it isn't required to start translating Linux Mint. If you want to skip it, you can go straight to the next chapter.
This chapter explains how translations work. It is useful for getting a better understanding of the workflow and the technology but it isn't required in order to start translating Linux Mint. If you want to skip it, you can go straight to the next chapter.


Localization
Expand All @@ -23,23 +23,23 @@ Here's an example in Python. The code below creates two buttons. They're both la
At runtime, button2 will be properly translated, whereas button1 will always show in English.

If you run this code in French, you'll see a ``Yes`` button, and a ``Oui`` button.
If you run it in Spanish, you'll see a ``Yes`` button, and a ``Si`` button.
If you run it in Spanish, you'll see a ``Yes`` button, and a ```` button.

Of course, for this to work, French and Spanish translations for ``Yes`` have to be available. If they weren't, the second button would of show in English.
Of course, for this to work, French and Spanish translations for ``Yes`` have to be available. If they aren't, the second button will show in English.

POT Templates
=============

For each project, the Linux Mint developers extract all the English words and sentences and put everything that has to be translated into a ``.pot`` file which is called the ``PO template``.
For each project, the Linux Mint developers extract all the English words and sentences and put everything that has to be translated into a ``.pot`` file called the ``PO template``.

They then upload that file to Launchpad, where translators translate the words and sentences into their own languages.
They then upload that file to Launchpad, where translators can translate the words and sentences into their own languages.

PO files
========

The Linux Mint development team then downloads all the translations from Launchpad and packages them into the operating system.

The translations consist in ``.po`` files, and they are compiled and installed as ``.mo`` files on the filesystem, usually in ``/usr/share/locale``.
The translations consist of ``.po`` files that are compiled and installed as ``.mo`` files on the filesystem, usually in ``/usr/share/locale``.

They are packaged in their relevant applications, or sometimes in translations packages such as ``mint-translations`` (for the Mint tools) or ``cinnamon-l10n`` (for Cinnamon).
They are packaged in their relevant applications, or sometimes in translation packages such as ``mint-translations`` (for the Mint tools) or ``cinnamon-l10n`` (for Cinnamon).

0 comments on commit 5e3874d

Please sign in to comment.