Recent changes to Localisation

Localisation modified by Jussi Pakkanen

Jussi Pakkanen — Thu, 04 Sep 2014 08:02:21 -0000

--- v3
+++ v4
@@ -1,3 +1,10 @@
+The Meson build system has moved
+==
+
+The new home of Meson's documentation is [here](https://github.com/jpakkane/meson/wiki). The information below is preserved only for posterity. It should be considered out of date.
+
+-------
+
 Localisation with Gettext
 =======

Localisation modified by Jussi Pakkanen

Jussi Pakkanen — Thu, 12 Sep 2013 20:20:18 -0000

--- v2
+++ v3
@@ -10,7 +10,7 @@
     src/subdir/file3.c
     include/mything/somefile.h

-We also need to define an array of strings containing all the locales we want to generate. This is done in the Meson file in the po subdirectory. Assuming we want to generate Finnish and German localisation info, the definition would look like this.
+We also need to define an array of strings containing all the locales we want to generate. This is done in the Meson file in the po subdirectory. Assuming we want to generate Finnish and German localisations, the definition would look like this.

     langs = ['fi', 'de']

@@ -24,6 +24,8 @@

     ninja pot

+If the pot file does not yet exist, it will be created. It is recommended to inspect it manually afterwards and fill in e.g. proper copyright and contact information.
+
 Meson does not currently have built in commands for generating po files from the pot file. This is because translations are usually done by people who are not developers and thus have their own workflows.

 ---

Localisation modified by Jussi Pakkanen

Jussi Pakkanen — Thu, 12 Sep 2013 20:16:54 -0000

--- v1
+++ v2
@@ -1,8 +1,30 @@
 Localisation with Gettext
 =======

+Localising your application with GNU Gettext takes a little effort but is quite straightforward. This documentation assumes that you have a po subdirectory at your project root directory that contains all the localisation info.

+The first thing you need is a file called POTFILES. It lists all the source files that Gettext should scan in order to find strings to translate. The syntax of the file is one line per source file and the line must contain the relative path from source root. A sample POTFILES might look like this.

+    src/file1.c
+    src/file2.c
+    src/subdir/file3.c
+    include/mything/somefile.h
+
+We also need to define an array of strings containing all the locales we want to generate. This is done in the Meson file in the po subdirectory. Assuming we want to generate Finnish and German localisation info, the definition would look like this.
+
+    langs = ['fi', 'de']
+
+Then we need to generate the main pot file. Usually this is generated manually or exists already. If not, see later on how to generate it using Meson. The potfile can have any name but is usually the name of the Gettext package. Let's say the project is called *intltest*. In this case the corresponding pot file would be called inltest.pot.
+
+For each language listed in the array above we need a corresponding .po file. This has to be generated manually, see the Gettext manual for details. Once we have all this, we can define the localisation to Meson with this command.
+
+    gettext('intltest', languages : langs)
+
+The first argument is the Gettext package name. This causes two things to happen. The first is that Meson will generate binary mo files and put them to their proper locations when doing an install. The second is that it creates a build rule to regenerate the main pot file. If you are using the Ninja backend, this is how you would invoke the rebuild.
+
+    ninja pot
+
+Meson does not currently have built in commands for generating po files from the pot file. This is because translations are usually done by people who are not developers and thus have their own workflows.

 ---

Localisation modified by Jussi Pakkanen

Jussi Pakkanen — Thu, 12 Sep 2013 19:57:26 -0000

Localisation with Gettext

Back to index.